@motionscript/latex 0.0.0-stage → 0.1.0-alpha.3

package/dist/browser/manifest.json

@@ -0,0 +1,11 @@
+{
+  "name": "@motionscript/latex",
+  "version": "0.1.0-alpha.3",
+  "exports": {
+    ".": "dist/browser/index.js"
+  },
+  "peers": [
+    "@motionscript/sdk"
+  ],
+  "assets": {}
+}

package/dist/cache.d.ts

@@ -0,0 +1,30 @@
+/**
+ * A bounded, least-recently-used memo.
+ *
+ * Sits under `geometry.ts`, and imports nothing, so it is testable in bare Node:
+ * everything else in this package reaches MathJax's browser adaptor at module
+ * scope, which means a test that touches it needs a DOM. The one piece of logic
+ * here worth being sure about — what gets thrown away when the memo is full —
+ * is exactly the piece that does not need one.
+ *
+ * Least-recently-used rather than oldest-first, and that matters for the shape
+ * of work this sees. A `Latex` node re-resolves its formula whenever `fontSize`
+ * changes, so animating the size of one formula inserts a fresh key every frame
+ * and would, under a first-in-first-out rule, walk the whole memo out of it in a
+ * couple of seconds — including the entries for every *other* formula in the
+ * scene, none of which had done anything wrong. Touching an entry on read keeps
+ * the formulas that are actually being asked for ahead of the ones streaming
+ * past.
+ */
+export interface BoundedCache<T> {
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    /** Entries held. For tests and for anyone measuring. */
+    readonly size: number;
+}
+/**
+ * @param limit Most entries to hold. One more arriving evicts the least
+ *              recently read or written.
+ */
+export declare function createBoundedCache<T>(limit: number): BoundedCache<T>;
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAChC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACjC,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CA8BpE"}

package/dist/cache.js

@@ -0,0 +1,53 @@
+/**
+ * A bounded, least-recently-used memo.
+ *
+ * Sits under `geometry.ts`, and imports nothing, so it is testable in bare Node:
+ * everything else in this package reaches MathJax's browser adaptor at module
+ * scope, which means a test that touches it needs a DOM. The one piece of logic
+ * here worth being sure about — what gets thrown away when the memo is full —
+ * is exactly the piece that does not need one.
+ *
+ * Least-recently-used rather than oldest-first, and that matters for the shape
+ * of work this sees. A `Latex` node re-resolves its formula whenever `fontSize`
+ * changes, so animating the size of one formula inserts a fresh key every frame
+ * and would, under a first-in-first-out rule, walk the whole memo out of it in a
+ * couple of seconds — including the entries for every *other* formula in the
+ * scene, none of which had done anything wrong. Touching an entry on read keeps
+ * the formulas that are actually being asked for ahead of the ones streaming
+ * past.
+ */
+/**
+ * @param limit Most entries to hold. One more arriving evicts the least
+ *              recently read or written.
+ */
+export function createBoundedCache(limit) {
+    // Insertion order is the eviction order, which is what makes a plain `Map`
+    // an LRU as long as every read re-inserts.
+    const entries = new Map();
+    return {
+        get(key) {
+            if (!entries.has(key))
+                return undefined;
+            const value = entries.get(key);
+            // Delete-then-set moves the key to the end, so the next eviction
+            // takes the genuinely coldest entry rather than the oldest one.
+            entries.delete(key);
+            entries.set(key, value);
+            return value;
+        },
+        set(key, value) {
+            entries.delete(key);
+            entries.set(key, value);
+            while (entries.size > limit) {
+                const coldest = entries.keys().next().value;
+                if (coldest === undefined)
+                    break;
+                entries.delete(coldest);
+            }
+        },
+        get size() {
+            return entries.size;
+        },
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,KAAa;IAC/C,2EAA2E;IAC3E,2CAA2C;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IAErC,OAAO;QACH,GAAG,CAAC,GAAG;YACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAM,CAAC;YACpC,iEAAiE;YACjE,gEAAgE;YAChE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,GAAG,CAAC,GAAG,EAAE,KAAK;YACV,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,OAAO,OAAO,CAAC,IAAI,GAAG,KAAK,EAAE,CAAC;gBAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;gBAC5C,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM;gBACjC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;QACL,CAAC;QAED,IAAI,IAAI;YACJ,OAAO,OAAO,CAAC,IAAI,CAAC;QACxB,CAAC;KACJ,CAAC;AACN,CAAC","sourcesContent":["/**\n * A bounded, least-recently-used memo.\n *\n * Sits under `geometry.ts`, and imports nothing, so it is testable in bare Node:\n * everything else in this package reaches MathJax's browser adaptor at module\n * scope, which means a test that touches it needs a DOM. The one piece of logic\n * here worth being sure about — what gets thrown away when the memo is full —\n * is exactly the piece that does not need one.\n *\n * Least-recently-used rather than oldest-first, and that matters for the shape\n * of work this sees. A `Latex` node re-resolves its formula whenever `fontSize`\n * changes, so animating the size of one formula inserts a fresh key every frame\n * and would, under a first-in-first-out rule, walk the whole memo out of it in a\n * couple of seconds — including the entries for every *other* formula in the\n * scene, none of which had done anything wrong. Touching an entry on read keeps\n * the formulas that are actually being asked for ahead of the ones streaming\n * past.\n */\n\nexport interface BoundedCache<T> {\n    get(key: string): T | undefined;\n    set(key: string, value: T): void;\n    /** Entries held. For tests and for anyone measuring. */\n    readonly size: number;\n}\n\n/**\n * @param limit Most entries to hold. One more arriving evicts the least\n *              recently read or written.\n */\nexport function createBoundedCache<T>(limit: number): BoundedCache<T> {\n    // Insertion order is the eviction order, which is what makes a plain `Map`\n    // an LRU as long as every read re-inserts.\n    const entries = new Map<string, T>();\n\n    return {\n        get(key) {\n            if (!entries.has(key)) return undefined;\n            const value = entries.get(key) as T;\n            // Delete-then-set moves the key to the end, so the next eviction\n            // takes the genuinely coldest entry rather than the oldest one.\n            entries.delete(key);\n            entries.set(key, value);\n            return value;\n        },\n\n        set(key, value) {\n            entries.delete(key);\n            entries.set(key, value);\n            while (entries.size > limit) {\n                const coldest = entries.keys().next().value;\n                if (coldest === undefined) break;\n                entries.delete(coldest);\n            }\n        },\n\n        get size() {\n            return entries.size;\n        },\n    };\n}\n"]}

package/dist/engine.d.ts

@@ -0,0 +1,5 @@
+export { buildLatexPath } from './geometry.js';
+export type { LatexToken, LatexPathResult } from './geometry.js';
+export { prepareLatexTween as defaultLatexMorph } from './tween.js';
+export type { AnimatedToken, LatexMorphStrategy } from './tween.js';
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/engine.js

@@ -0,0 +1,10 @@
+// The Latex "engine": MathJax-backed glyph-path building and morph
+// interpolation, kept separate from node.ts so `ms add latex` can copy just
+// the node declaration and import this behind `@motionscript/latex` instead
+// What gets copied is whatever this package's registry.json declares, which
+// for this component is node.ts; packages/site/scripts/build-registry.mjs
+// enforces that anything it reaches for is either copied alongside it or
+// re-exported from here.
+export { buildLatexPath } from './geometry.js';
+export { prepareLatexTween as defaultLatexMorph } from './tween.js';
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,4EAA4E;AAC5E,4EAA4E;AAC5E,4EAA4E;AAC5E,0EAA0E;AAC1E,yEAAyE;AACzE,yBAAyB;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAAE,iBAAiB,IAAI,iBAAiB,EAAE,MAAM,SAAS,CAAC","sourcesContent":["// The Latex \"engine\": MathJax-backed glyph-path building and morph\n// interpolation, kept separate from node.ts so `ms add latex` can copy just\n// the node declaration and import this behind `@motionscript/latex` instead\n// What gets copied is whatever this package's registry.json declares, which\n// for this component is node.ts; packages/site/scripts/build-registry.mjs\n// enforces that anything it reaches for is either copied alongside it or\n// re-exported from here.\nexport { buildLatexPath } from './geometry';\nexport type { LatexToken, LatexPathResult } from './geometry';\nexport { prepareLatexTween as defaultLatexMorph } from './tween';\nexport type { AnimatedToken, LatexMorphStrategy } from './tween';\n"]}

package/dist/geometry.d.ts

@@ -0,0 +1,40 @@
+import '@mathjax/src/js/input/tex/base/BaseConfiguration.js';
+import '@mathjax/src/js/input/tex/ams/AmsConfiguration.js';
+import '@mathjax/src/js/input/tex/boldsymbol/BoldsymbolConfiguration.js';
+import '@mathjax/src/js/input/tex/newcommand/NewcommandConfiguration.js';
+import '@mathjax/src/js/input/tex/cancel/CancelConfiguration.js';
+import '@mathjax/src/js/input/tex/color/ColorConfiguration.js';
+import '@mathjax/src/js/input/tex/mhchem/MhchemConfiguration.js';
+import '@mathjax/src/js/input/tex/physics/PhysicsConfiguration.js';
+import '@mathjax/src/js/input/tex/bbox/BboxConfiguration.js';
+import '@mathjax/src/js/input/tex/mathtools/MathtoolsConfiguration.js';
+import '@mathjax/mathjax-newcm-font/js/svg/dynamic/calligraphic.js';
+import '@mathjax/mathjax-newcm-font/js/svg/dynamic/double-struck.js';
+import '@mathjax/mathjax-newcm-font/js/svg/dynamic/fraktur.js';
+import '@mathjax/mathjax-newcm-font/js/svg/dynamic/monospace.js';
+import '@mathjax/mathjax-newcm-font/js/svg/dynamic/sans-serif.js';
+import '@mathjax/mathjax-newcm-font/js/svg/dynamic/script.js';
+import { PathCommand } from '@motionscript/sdk';
+/** A single rendered glyph or shape with its character key and path commands. */
+export interface LatexToken {
+    /** Character this token represents, or a synthetic key for non-glyph shapes. */
+    token: string;
+    path: PathCommand[];
+}
+export interface LatexPathResult {
+    /** All tokens in render order. */
+    tokens: LatexToken[];
+    /** Flat array of all path commands (for legacy single-path rendering). */
+    commands: PathCommand[];
+    width: number;
+    height: number;
+    /**
+     * Bounding box over every token, in token coordinate space:
+     * [minX, minY, maxX, maxY]. All tokens share this frame, so passing it as
+     * each path's center frame keeps their relative layout (instead of each
+     * glyph centering on its own bbox).
+     */
+    bounds: [number, number, number, number];
+}
+export declare function buildLatexPath(text: string, fontSize: number): LatexPathResult;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAQA,OAAO,qDAAqD,CAAC;AAC7D,OAAO,mDAAmD,CAAC;AAC3D,OAAO,iEAAiE,CAAC;AACzE,OAAO,iEAAiE,CAAC;AACzE,OAAO,yDAAyD,CAAC;AACjE,OAAO,uDAAuD,CAAC;AAC/D,OAAO,yDAAyD,CAAC;AACjE,OAAO,2DAA2D,CAAC;AACnE,OAAO,qDAAqD,CAAC;AAC7D,OAAO,+DAA+D,CAAC;AAGvE,OAAO,4DAA4D,CAAC;AACpE,OAAO,6DAA6D,CAAC;AACrE,OAAO,uDAAuD,CAAC;AAC/D,OAAO,yDAAyD,CAAC;AACjE,OAAO,0DAA0D,CAAC;AAClE,OAAO,sDAAsD,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAkDhD,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACvB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC5B,kCAAkC;IAClC,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5C;AAoDD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAiB9E"}