feat: 🎸 add a possibility to override cursor when using builder

src/kittik-slide/examples/builder.ts

@@ -0,0 +1,40 @@
+import { Canvas } from 'terminal-canvas';
+import { AnimationBuilder, ShapeBuilder, SlideBuilder } from '..';
+
+const cursor = Canvas.create().saveScreen().reset().hideCursor();
+
+SlideBuilder
+  .start()
+  .withCursor(cursor)
+  .withShape(
+    'Hello, World',
+    ShapeBuilder
+      .start('Rectangle')
+      .withText('Hello, World')
+      .withBackground('aqua')
+      .withForeground('green')
+      .withX('center')
+      .withY('middle')
+      .end()
+  )
+  .withShape(
+    'Footer',
+    ShapeBuilder
+      .start('FigText')
+      .withText('kittik (c) ghaiklor')
+      .withX('center')
+      .withY('bottom')
+      .end()
+  )
+  .withAnimation(
+    'Printing',
+    AnimationBuilder
+      .start('Print')
+      .end()
+  )
+  .withOrder('Hello, World', ['Printing'])
+  .withOrder('Footer', ['Printing'])
+  .end()
+  .render()
+  .finally(() => cursor.restoreScreen().showCursor())
+  .catch(e => console.error(e));

src/kittik-slide/spec/SlideBuilder.spec.ts

@@ -1,10 +1,12 @@
-import { SlideBuilder } from '../src/slide/SlideBuilder';
+import { Canvas } from 'terminal-canvas';
 import { ShapeBuilder, AnimationBuilder } from '../src/slide/Slide';
+import { SlideBuilder } from '../src/slide/SlideBuilder';
 
 describe('SlideBuilder', () => {
   it('Should properly instantiate slide via builder', () => {
     const slide = SlideBuilder
       .start()
+      .withCursor(Canvas.create())
       .withShape(
         'Hello, World',
         ShapeBuilder

src/kittik-slide/src/slide/Slide.ts

@@ -19,10 +19,10 @@ export { SlideBuilder } from './SlideBuilder';
 export { SlideDeclaration } from './SlideDeclaration';
 
 export class Slide {
-  readonly cursor: Canvas = Canvas.create();
   readonly shapes: Map<string, ShapeRenderable> = new Map();
   readonly animations: Map<string, Animationable> = new Map();
   readonly order: OrderDeclaration[] = [];
+  cursor: Canvas = Canvas.create();
 
   constructor (cursor?: Canvas, declaration?: SlideDeclaration) {
     if (cursor !== undefined) {

src/kittik-slide/src/slide/SlideBuilder.ts

@@ -1,10 +1,17 @@
 import { Animationable } from 'kittik-animation-basic';
+import { Canvas } from 'terminal-canvas';
 import { ShapeRenderable } from 'kittik-shape-basic';
 import { Slide } from './Slide';
 
 export class SlideBuilder {
   slide: Slide = new Slide();
 
+  withCursor (cursor: Canvas): this {
+    this.slide.cursor = cursor;
+
+    return this;
+  }
+
   withShape (name: string, shape: ShapeRenderable): this {
     this.slide.addShape(name, shape);