@hyperframes/core 0.7.110 → 0.7.111

package/dist/text/index.d.ts

@@ -1,3 +1,4 @@
 export { fitTextFontSize } from "./fitTextFontSize.js";
 export type { FitTextOptions, FitTextResult } from "./fitTextFontSize.js";
+export { pretext } from "./pretext.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/text/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/text/index.js

@@ -1,2 +1,3 @@
 export { fitTextFontSize } from "./fitTextFontSize.js";
+export { pretext } from "./pretext.js";
 //# sourceMappingURL=index.js.map

package/dist/text/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/text/pretext.d.ts

@@ -0,0 +1,45 @@
+import { layout, measureLineStats, measureNaturalWidth, prepare, prepareWithSegments } from "@chenglou/pretext";
+/**
+ * The text measurement surface exposed to compositions as
+ * `window.__hyperframes.pretext`.
+ *
+ * Measuring text by writing it into the DOM and reading it back forces a
+ * reflow, which is both slow per frame and a determinism risk (the value
+ * depends on when you read it). These measure off a canvas instead, so a
+ * composition can size a container, pick a font size, or decide a line break
+ * at any frame without disturbing layout. `fitTextFontSize` is itself built on
+ * `prepare` + `layout`.
+ *
+ * Note the split, because it decides where you call these: `prepare` (and
+ * `prepareWithSegments`) does the real font measurement and needs a canvas, so
+ * it only works in a browser, not in Node. Everything downstream of a prepared
+ * string is arithmetic and is cheap enough to run per frame.
+ *
+ * Deliberately omitted from this surface:
+ * - `clearCache` and `setLocale` mutate process-global state. A composition
+ *   calling either would change how *other* compositions measure, which breaks
+ *   the guarantee that the same file renders the same video every time.
+ *   Withholding `clearCache` does not strand memory: the cache is keyed by
+ *   (segment, font) where segments come from `Intl.Segmenter` at word
+ *   granularity, so it grows with the number of distinct *words* a composition
+ *   renders, not with frames. A counter or typewriter re-measuring every frame
+ *   reuses the same entries. Only genuinely new words allocate, which bounds it
+ *   at a composition's vocabulary.
+ * - The incremental cursor API (`layoutNextLine`, `walkLineRanges`, and
+ *   friends) has no caller yet. Add it when something needs it.
+ *
+ * @see packages/core/src/runtime/entry.ts for where this is attached.
+ */
+export declare const pretext: {
+    /** Measure a string for a CSS font (e.g. `"700 48px Inter"`). */
+    readonly prepare: typeof prepare;
+    /** Line count and total height for a prepared string at a given width. */
+    readonly layout: typeof layout;
+    /** Like `prepare`, but retains segments so widths can be measured. */
+    readonly prepareWithSegments: typeof prepareWithSegments;
+    /** Line count plus `maxLineWidth` — the widest rendered line. */
+    readonly measureLineStats: typeof measureLineStats;
+    /** Width the string would occupy on a single unwrapped line. */
+    readonly measureNaturalWidth: typeof measureNaturalWidth;
+};
+//# sourceMappingURL=pretext.d.ts.map

package/dist/text/pretext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretext.d.ts","sourceRoot":"","sources":["../../src/text/pretext.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,OAAO;IAClB,iEAAiE;;IAEjE,0EAA0E;;IAE1E,sEAAsE;;IAEtE,iEAAiE;;IAEjE,gEAAgE;;CAExD,CAAC"}

package/dist/text/pretext.js

@@ -0,0 +1,45 @@
+import { layout, measureLineStats, measureNaturalWidth, prepare, prepareWithSegments, } from "@chenglou/pretext";
+/**
+ * The text measurement surface exposed to compositions as
+ * `window.__hyperframes.pretext`.
+ *
+ * Measuring text by writing it into the DOM and reading it back forces a
+ * reflow, which is both slow per frame and a determinism risk (the value
+ * depends on when you read it). These measure off a canvas instead, so a
+ * composition can size a container, pick a font size, or decide a line break
+ * at any frame without disturbing layout. `fitTextFontSize` is itself built on
+ * `prepare` + `layout`.
+ *
+ * Note the split, because it decides where you call these: `prepare` (and
+ * `prepareWithSegments`) does the real font measurement and needs a canvas, so
+ * it only works in a browser, not in Node. Everything downstream of a prepared
+ * string is arithmetic and is cheap enough to run per frame.
+ *
+ * Deliberately omitted from this surface:
+ * - `clearCache` and `setLocale` mutate process-global state. A composition
+ *   calling either would change how *other* compositions measure, which breaks
+ *   the guarantee that the same file renders the same video every time.
+ *   Withholding `clearCache` does not strand memory: the cache is keyed by
+ *   (segment, font) where segments come from `Intl.Segmenter` at word
+ *   granularity, so it grows with the number of distinct *words* a composition
+ *   renders, not with frames. A counter or typewriter re-measuring every frame
+ *   reuses the same entries. Only genuinely new words allocate, which bounds it
+ *   at a composition's vocabulary.
+ * - The incremental cursor API (`layoutNextLine`, `walkLineRanges`, and
+ *   friends) has no caller yet. Add it when something needs it.
+ *
+ * @see packages/core/src/runtime/entry.ts for where this is attached.
+ */
+export const pretext = {
+    /** Measure a string for a CSS font (e.g. `"700 48px Inter"`). */
+    prepare,
+    /** Line count and total height for a prepared string at a given width. */
+    layout,
+    /** Like `prepare`, but retains segments so widths can be measured. */
+    prepareWithSegments,
+    /** Line count plus `maxLineWidth` — the widest rendered line. */
+    measureLineStats,
+    /** Width the string would occupy on a single unwrapped line. */
+    measureNaturalWidth,
+};
+//# sourceMappingURL=pretext.js.map

package/dist/text/pretext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretext.js","sourceRoot":"","sources":["../../src/text/pretext.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,iEAAiE;IACjE,OAAO;IACP,0EAA0E;IAC1E,MAAM;IACN,sEAAsE;IACtE,mBAAmB;IACnB,iEAAiE;IACjE,gBAAgB;IAChB,gEAAgE;IAChE,mBAAmB;CACX,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/core",
-  "version": "0.7.110",
+  "version": "0.7.111",
   "description": "",
   "repository": {
     "type": "git",
@@ -266,9 +266,9 @@
     "bpm-detective": "^2.0.5",
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
-    "@hyperframes/lint": "0.7.110",
-    "@hyperframes/studio-server": "0.7.110",
-    "@hyperframes/parsers": "0.7.110"
+    "@hyperframes/parsers": "0.7.111",
+    "@hyperframes/lint": "0.7.111",
+    "@hyperframes/studio-server": "0.7.111"
   },
   "devDependencies": {
     "@types/jsdom": "^28.0.0",