textmode.synth.js 1.0.0-beta.1 → 1.0.0-beta.3

package/dist/types/{lib → utils}/ArrayUtils.d.ts

@@ -50,18 +50,33 @@ export type EasingFunction = keyof typeof EASING_FUNCTIONS | ((t: number) => num
 /**
  * Extended array interface with modulation methods.
  *
- * Arrays in textmode.synth.js behave like Hydra - they cycle through values over time,
+ * Arrays in textmode.synth.js behave like hydra - they cycle through values over time,
  * creating dynamic, time-varying parameters. This enables complex animations without
  * manually tracking time or state.
+ *
+ * @example
+ * ```typescript
+ * const t = textmode.create({
+ *   width: 800,
+ *   height: 600,
+ *   plugins: [SynthPlugin]
+ * });
+ *
+ * // Rotating shape with eased animation
+ * t.layers.base.synth(
+ *   shape(4)
+ *     .rotate([-3.14, 3.14].ease('easeInOutCubic'))
+ * );
+ * ```
  */
 export interface ModulatedArray extends Array<number> {
-    /** Speed multiplier for array cycling */
+    /** Speed multiplier for array cycling @ignore */
     _speed?: number;
-    /** Smoothing amount (0-1) for interpolation */
+    /** Smoothing amount (0-1) for interpolation @ignore */
     _smooth?: number;
-    /** Easing function for interpolation */
+    /** Easing function for interpolation @ignore */
     _ease?: (t: number) => number;
-    /** Time offset for array cycling */
+    /** Time offset for array cycling @ignore */
     _offset?: number;
     /**
      * Set speed multiplier for array cycling.

package/dist/types/utils/ArrayUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtils.d.ts","sourceRoot":"","sources":["../../../src/utils/ArrayUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,gBAAgB;gBAChB,MAAM;oBACF,MAAM;qBACL,MAAM;uBACJ,MAAM;qBACR,MAAM;sBACL,MAAM;wBACJ,MAAM;qBAET,MAAM;sBACL,MAAM;wBACJ,MAAM;qBACT,MAAM;sBACL,MAAM;wBACJ,MAAM;aAEjB,MAAM;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAErF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,MAAM,CAAC;IACpD,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;CAC/C;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CA8CrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAuB5E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAExE"}

package/dist/types/utils/CharacterResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CharacterResolver.d.ts","sourceRoot":"","sources":["../../../src/utils/CharacterResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,UAAU,CAAM;IAExB;;;;;OAKG;IACI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,UAAU;IAiCtD,UAAU,IAAI,IAAI;CAK5B"}
+{"version":3,"file":"CharacterResolver.d.ts","sourceRoot":"","sources":["../../../src/utils/CharacterResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;GAGG;AACH,qBAAa,iBAAiB;IAC7B,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,UAAU,CAAM;IAExB;;;;;OAKG;IACI,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,UAAU;IAiCtD,UAAU,IAAI,IAAI;CAKzB"}

package/dist/types/utils/collectExternalLayerRefs.d.ts

@@ -0,0 +1,7 @@
+import type { TextmodeLayer } from 'textmode.js/layering';
+import type { SynthSource } from '../core/SynthSource';
+/**
+ * Collect all external layer references from a SynthSource and its nested chains.
+ */
+export declare function collectExternalLayerRefs(source: SynthSource): Map<string, TextmodeLayer>;
+//# sourceMappingURL=collectExternalLayerRefs.d.ts.map

package/dist/types/utils/collectExternalLayerRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectExternalLayerRefs.d.ts","sourceRoot":"","sources":["../../../src/utils/collectExternalLayerRefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAyCxF"}

package/dist/types/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Utilities module exports.
+ *
+ * This module provides utility classes and functions used throughout
+ * the synth engine.
+ *
+ * @module
+ */
+export { EASING_FUNCTIONS, initArrayUtils, getArrayValue, isModulatedArray, type EasingFunction, type ModulatedArray, } from './ArrayUtils';
+export { CharacterResolver } from './CharacterResolver';
+export { collectExternalLayerRefs } from './collectExternalLayerRefs';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,GACnB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAGxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textmode.synth.js",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "description": "Synth engine for textmode.js",
   "type": "module",
   "types": "./dist/types/index.d.ts",
@@ -18,21 +18,24 @@
     "build": "vite build && tsc",
     "preview": "vite preview",
     "build:docs": "typedoc",
-    "dev:docs": "typedoc --watch"
+    "dev:docs": "typedoc --watch",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\""
   },
   "devDependencies": {
     "@rollup/plugin-terser": "^0.4.4",
     "@types/node": "^24.5.2",
+    "prettier": "^3.7.4",
     "terser": "^5.44.0",
-    "typescript": "~5.8.3",
-    "vite": "^7.1.7",
-    "vite-plugin-css-injected-by-js": "^3.5.2",
+    "textmode.js": "^0.9.0-beta.2",
     "typedoc": "^0.28.13",
     "typedoc-plugin-markdown": "^4.7.0",
-    "typedoc-vitepress-theme": "^1.1.2"
+    "typedoc-vitepress-theme": "^1.1.2",
+    "typescript": "~5.8.3",
+    "vite": "^7.1.7"
   },
   "peerDependencies": {
-    "textmode.js": "^0.9.0-beta.1"
+    "textmode.js": "^0.9.0-beta.2"
   },
   "repository": {
     "type": "git",
@@ -40,10 +43,14 @@
   },
   "keywords": [
     "textmode",
-    "textmode.js"
+    "creative-coding",
+    "graphics",
+    "ascii-art",
+    "live-coding",
+    "synthesis"
   ],
   "author": "humanbydefinition",
-  "license": "MIT",
+  "license": "AGPL-3.0",
   "bugs": {
     "url": "https://github.com/humanbydefinition/textmode.synth.js/issues"
   },

package/dist/types/SynthPlugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"SynthPlugin.d.ts","sourceRoot":"","sources":["../../src/SynthPlugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACX,cAAc,EAEd,MAAM,qBAAqB,CAAC;AA4F7B;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,WAAW,EAAE,cA2QzB,CAAC"}

package/dist/types/lib/ArrayUtils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ArrayUtils.d.ts","sourceRoot":"","sources":["../../../src/lib/ArrayUtils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,gBAAgB;gBAChB,MAAM;oBACF,MAAM;qBACL,MAAM;uBACJ,MAAM;qBACR,MAAM;sBACL,MAAM;wBACJ,MAAM;qBACT,MAAM;sBACL,MAAM;wBACJ,MAAM;qBACT,MAAM;sBACL,MAAM;wBACJ,MAAM;aACjB,MAAM;CACf,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;AAErF;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,KAAK,CAAC,MAAM,CAAC;IACpD,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wCAAwC;IACxC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;CAC/C;AAgBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAuCrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,YAAY,GAAG,MAAM,CAwB5E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAMxE"}

package/dist/types/transforms/categories/charModifiers.d.ts

@@ -1,16 +0,0 @@
-/**
- * Character modifier transform definitions.
- *
- * These transforms modify character properties like flipping,
- * rotation, and color inversion.
- */
-import { type TransformDefinition } from '../TransformDefinition';
-export declare const charFlipX: TransformDefinition;
-export declare const charFlipY: TransformDefinition;
-export declare const charInvert: TransformDefinition;
-export declare const charRotate: TransformDefinition;
-/**
- * All character modifier transforms.
- */
-export declare const CHAR_MODIFY_TRANSFORMS: TransformDefinition[];
-//# sourceMappingURL=charModifiers.d.ts.map

package/dist/types/transforms/categories/charModifiers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"charModifiers.d.ts","sourceRoot":"","sources":["../../../../src/transforms/categories/charModifiers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAEnF,eAAO,MAAM,SAAS,qBAYpB,CAAC;AAEH,eAAO,MAAM,SAAS,qBAYpB,CAAC;AAEH,eAAO,MAAM,UAAU,qBAYrB,CAAC;AAEH,eAAO,MAAM,UAAU,qBAYrB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,EAKvD,CAAC"}