silvery 0.19.2 → 0.21.0

package/dist/flexily-zero-adapter-C3Vj0fPt.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flexily-zero-adapter-C3Vj0fPt.mjs","names":["FlexilyNode"],"sources":["../packages/ag-term/src/adapters/flexily-zero-adapter.ts"],"sourcesContent":["/**\n * Flexily Layout Engine Adapter\n *\n * Wraps Flexily to implement the LayoutEngine interface.\n * Uses the default zero-allocation algorithm from flexily.\n */\n\nimport {\n  ALIGN_AUTO,\n  ALIGN_BASELINE,\n  ALIGN_CENTER,\n  ALIGN_FLEX_END,\n  ALIGN_FLEX_START,\n  ALIGN_SPACE_AROUND,\n  ALIGN_SPACE_BETWEEN,\n  ALIGN_SPACE_EVENLY,\n  ALIGN_STRETCH,\n  DIRECTION_LTR,\n  DISPLAY_FLEX,\n  DISPLAY_NONE,\n  EDGE_ALL,\n  EDGE_BOTTOM,\n  EDGE_HORIZONTAL,\n  EDGE_LEFT,\n  EDGE_RIGHT,\n  EDGE_TOP,\n  EDGE_VERTICAL,\n  // Constants\n  FLEX_DIRECTION_COLUMN,\n  FLEX_DIRECTION_COLUMN_REVERSE,\n  FLEX_DIRECTION_ROW,\n  FLEX_DIRECTION_ROW_REVERSE,\n  Node as FlexilyNode,\n  GUTTER_ALL,\n  GUTTER_COLUMN,\n  GUTTER_ROW,\n  JUSTIFY_CENTER,\n  JUSTIFY_FLEX_END,\n  JUSTIFY_FLEX_START,\n  JUSTIFY_SPACE_AROUND,\n  JUSTIFY_SPACE_BETWEEN,\n  JUSTIFY_SPACE_EVENLY,\n  MEASURE_MODE_AT_MOST,\n  MEASURE_MODE_EXACTLY,\n  MEASURE_MODE_MIN_CONTENT,\n  MEASURE_MODE_UNDEFINED,\n  OVERFLOW_HIDDEN,\n  OVERFLOW_SCROLL,\n  OVERFLOW_VISIBLE,\n  POSITION_TYPE_ABSOLUTE,\n  POSITION_TYPE_RELATIVE,\n  POSITION_TYPE_STATIC,\n  WRAP_NO_WRAP,\n  WRAP_WRAP,\n  WRAP_WRAP_REVERSE,\n} from \"flexily\"\n\n// Flexily UNIT_CQI / UNIT_CQMIN constants. Hardcoded at this seam rather than\n// imported from \"flexily\" because the published flexily@0.7.1 does not export\n// them yet — A0.2's export-bump (vendor/flexily commit fb61a79) hasn't shipped\n// to npm. Constants are stable per Phase 1 of @km/silvery/responsive-layout-\n// architecture-reframe; same shape as the CONTAINER_TYPE_INLINE_SIZE=1 hardcode\n// in applyBoxProps. When flexily 0.7.2+ ships with the new exports, this can be\n// replaced with a named import.\nconst UNIT_CQI = 6\nconst UNIT_CQMIN = 7\n\nimport type { FitWidthLane, LayoutNode, MeasureFunc, MeasureMode } from \"@silvery/ag/layout-types\"\nimport type {\n  AlignValue,\n  DirectionValue,\n  DisplayValue,\n  EdgeValue,\n  EngineCapabilities,\n  FlexDirectionValue,\n  GutterValue,\n  JustifyValue,\n  LayoutConstants,\n  LayoutEngine,\n  MeasureModeValue,\n  OverflowValue,\n  PositionTypeValue,\n  WrapValue,\n} from \"../layout-engine\"\n\n/**\n * Capabilities advertised by the flexily-zero adapter.\n *\n * All six A0 primitives shipped: four at A0.1 (engine-native CQ resolution at\n * vendor/flexily `46141e9`), one at A0.2 (fitWidth single-pass lane snap at\n * vendor/flexily `4b44bf9`), one at A0.3 (CSS math functions at vendor/flexily\n * `0aebb95`).\n *\n * - `containerQueries`     → A0.1 ✓ — Pass 1 freezeQuerySize + Pass 2 ancestor walk\n * - `containSize`          → A0.1 ✓ — Phase 9 inline-axis shrink-wrap gate\n * - `containerQueryUnits`  → A0.1 ✓ — UNIT_CQI / UNIT_CQMIN parsed and resolved\n * - `childStyleMutation`   → A0.1 ✓ — setContainerQueryStyle hook (A0.0 substrate)\n * - `fitWidth`             → A0.2 ✓ — Phase 3 lane-select prefix; single-pass lane snap\n * - `styleMathFunctions`   → A0.3 ✓ — UNIT_CALC + MathExpr; late-bound per\n *   vendor/flexily/docs/two-phase-layout.md\n */\nconst FLEXILY_CAPABILITIES: EngineCapabilities = Object.freeze({\n  containerQueries: true, // ✓ A0.1\n  containSize: true, // ✓ A0.1\n  containerQueryUnits: true, // ✓ A0.1\n  fitWidth: true, // ✓ A0.2\n  styleMathFunctions: true, // ✓ A0.3\n  childStyleMutation: true, // ✓ A0.1\n})\n\n// ============================================================================\n// Flexily Zero Node Adapter\n// ============================================================================\n\n/**\n * Wraps a Flexily zero-alloc node to implement LayoutNode interface.\n * Since Flexily already has a Yoga-compatible API, this is mostly delegation.\n */\nclass FlexilyZeroNodeAdapter implements LayoutNode {\n  private node: FlexilyNode\n\n  constructor(node: FlexilyNode) {\n    this.node = node\n  }\n\n  /** Get the underlying Flexily node (for tree operations) */\n  getFlexilyNode(): FlexilyNode {\n    return this.node\n  }\n\n  // Tree operations\n  insertChild(child: LayoutNode, index: number): void {\n    const flexilyChild = (child as FlexilyZeroNodeAdapter).getFlexilyNode()\n    this.node.insertChild(flexilyChild, index)\n  }\n\n  removeChild(child: LayoutNode): void {\n    const flexilyChild = (child as FlexilyZeroNodeAdapter).getFlexilyNode()\n    this.node.removeChild(flexilyChild)\n  }\n\n  free(): void {\n    this.node.free()\n  }\n\n  // Measure function\n  setMeasureFunc(measureFunc: MeasureFunc): void {\n    this.node.setMeasureFunc((width, widthMode, height, heightMode) => {\n      const widthModeStr = this.measureModeToString(widthMode)\n      const heightModeStr = this.measureModeToString(heightMode)\n      return measureFunc(width, widthModeStr, height, heightModeStr)\n    })\n  }\n\n  // Dirty tracking - forces layout recalculation\n  markDirty(): void {\n    this.node.markDirty()\n  }\n  isDirty(): boolean {\n    return this.node.isDirty()\n  }\n\n  private measureModeToString(mode: number): MeasureMode {\n    if (mode === MEASURE_MODE_EXACTLY) return \"exactly\"\n    if (mode === MEASURE_MODE_AT_MOST) return \"at-most\"\n    if (mode === MEASURE_MODE_MIN_CONTENT) return \"min-content\"\n    return \"undefined\"\n  }\n\n  // Dimension setters\n  setWidth(value: number): void {\n    this.node.setWidth(value)\n  }\n  setWidthPercent(value: number): void {\n    this.node.setWidthPercent(value)\n  }\n  setWidthAuto(): void {\n    this.node.setWidthAuto()\n  }\n  setWidthFitContent(): void {\n    this.node.setWidthFitContent()\n  }\n  setWidthSnugContent(): void {\n    this.node.setWidthSnugContent()\n  }\n  setHeight(value: number): void {\n    this.node.setHeight(value)\n  }\n  setHeightPercent(value: number): void {\n    this.node.setHeightPercent(value)\n  }\n  setHeightAuto(): void {\n    this.node.setHeightAuto()\n  }\n  setMinWidth(value: number): void {\n    this.node.setMinWidth(value)\n  }\n  setMinWidthPercent(value: number): void {\n    this.node.setMinWidthPercent(value)\n  }\n  setMinHeight(value: number): void {\n    this.node.setMinHeight(value)\n  }\n  setMinHeightPercent(value: number): void {\n    this.node.setMinHeightPercent(value)\n  }\n  setMaxWidth(value: number): void {\n    this.node.setMaxWidth(value)\n  }\n  setMaxWidthPercent(value: number): void {\n    this.node.setMaxWidthPercent(value)\n  }\n  setMaxHeight(value: number): void {\n    this.node.setMaxHeight(value)\n  }\n  setMaxHeightPercent(value: number): void {\n    this.node.setMaxHeightPercent(value)\n  }\n\n  // Flex properties\n  setFlexGrow(value: number): void {\n    this.node.setFlexGrow(value)\n  }\n  setFlexShrink(value: number): void {\n    this.node.setFlexShrink(value)\n  }\n  setFlexBasis(value: number): void {\n    this.node.setFlexBasis(value)\n  }\n  setFlexBasisPercent(value: number): void {\n    this.node.setFlexBasisPercent(value)\n  }\n  setFlexBasisAuto(): void {\n    this.node.setFlexBasisAuto()\n  }\n  setFlexDirection(direction: number): void {\n    this.node.setFlexDirection(direction)\n  }\n  setFlexWrap(wrap: number): void {\n    this.node.setFlexWrap(wrap)\n  }\n\n  // Alignment\n  setAlignItems(align: number): void {\n    this.node.setAlignItems(align)\n  }\n  setAlignSelf(align: number): void {\n    this.node.setAlignSelf(align)\n  }\n  setAlignContent(align: number): void {\n    this.node.setAlignContent(align)\n  }\n  setJustifyContent(justify: number): void {\n    this.node.setJustifyContent(justify)\n  }\n\n  // Spacing\n  setPadding(edge: number, value: number): void {\n    this.node.setPadding(edge, value)\n  }\n  setMargin(edge: number, value: number): void {\n    this.node.setMargin(edge, value)\n  }\n  setBorder(edge: number, value: number): void {\n    this.node.setBorder(edge, value)\n  }\n  setGap(gutter: number, value: number): void {\n    this.node.setGap(gutter, value)\n  }\n\n  // Display & Position\n  setDisplay(display: number): void {\n    this.node.setDisplay(display)\n  }\n  setPositionType(positionType: number): void {\n    this.node.setPositionType(positionType)\n  }\n  setPosition(edge: number, value: number): void {\n    this.node.setPosition(edge, value)\n  }\n  setPositionPercent(edge: number, value: number): void {\n    this.node.setPositionPercent(edge, value)\n  }\n  setOverflow(overflow: number): void {\n    this.node.setOverflow(overflow)\n  }\n\n  // Container queries (A0.1) — flexily supports both; advertised via FLEXILY_CAPABILITIES.\n  setContainerType(containerType: number): void {\n    this.node.setContainerType(containerType)\n  }\n  setContainSize(value: boolean): void {\n    this.node.setContainSize(value)\n  }\n\n  // Fit-width (A0.2) — translate FitWidthLane to flexily's { value, unit: UNIT_* }\n  // shape. Lane entries can be plain numbers (treated as UNIT_POINT) or objects\n  // with a \"cqi\"/\"cqmin\" unit string.\n  setFitWidth(lanes: readonly FitWidthLane[] | undefined): void {\n    if (lanes === undefined || lanes.length === 0) {\n      this.node.setFitWidth(undefined)\n      return\n    }\n    this.node.setFitWidth(\n      lanes.map((entry) => {\n        if (typeof entry === \"number\") return entry\n        const unit = entry.unit === \"cqi\" ? UNIT_CQI : UNIT_CQMIN\n        return { value: entry.value, unit }\n      }),\n    )\n  }\n\n  // Aspect Ratio\n  setAspectRatio(value: number): void {\n    this.node.setAspectRatio(value)\n  }\n\n  // Layout calculation\n  calculateLayout(width: number, height: number, direction?: number): void {\n    this.node.calculateLayout(width, height, direction ?? DIRECTION_LTR)\n  }\n\n  // Layout results\n  getComputedLeft(): number {\n    return this.node.getComputedLeft()\n  }\n  getComputedTop(): number {\n    return this.node.getComputedTop()\n  }\n  getComputedWidth(): number {\n    return this.node.getComputedWidth()\n  }\n  getComputedHeight(): number {\n    return this.node.getComputedHeight()\n  }\n}\n\n// ============================================================================\n// Flexily Zero Layout Engine\n// ============================================================================\n\n/**\n * Layout engine implementation using Flexily zero-allocation variant.\n * Optimized for high-frequency layout with reduced GC pressure.\n */\nexport class FlexilyZeroLayoutEngine implements LayoutEngine {\n  private _constants: LayoutConstants = {\n    // Flex Direction (cast from Flexily's plain numbers to branded types)\n    FLEX_DIRECTION_COLUMN: FLEX_DIRECTION_COLUMN as FlexDirectionValue,\n    FLEX_DIRECTION_COLUMN_REVERSE: FLEX_DIRECTION_COLUMN_REVERSE as FlexDirectionValue,\n    FLEX_DIRECTION_ROW: FLEX_DIRECTION_ROW as FlexDirectionValue,\n    FLEX_DIRECTION_ROW_REVERSE: FLEX_DIRECTION_ROW_REVERSE as FlexDirectionValue,\n\n    // Wrap\n    WRAP_NO_WRAP: WRAP_NO_WRAP as WrapValue,\n    WRAP_WRAP: WRAP_WRAP as WrapValue,\n    WRAP_WRAP_REVERSE: WRAP_WRAP_REVERSE as WrapValue,\n\n    // Align\n    ALIGN_AUTO: ALIGN_AUTO as AlignValue,\n    ALIGN_FLEX_START: ALIGN_FLEX_START as AlignValue,\n    ALIGN_CENTER: ALIGN_CENTER as AlignValue,\n    ALIGN_FLEX_END: ALIGN_FLEX_END as AlignValue,\n    ALIGN_STRETCH: ALIGN_STRETCH as AlignValue,\n    ALIGN_BASELINE: ALIGN_BASELINE as AlignValue,\n    ALIGN_SPACE_BETWEEN: ALIGN_SPACE_BETWEEN as AlignValue,\n    ALIGN_SPACE_AROUND: ALIGN_SPACE_AROUND as AlignValue,\n    ALIGN_SPACE_EVENLY: ALIGN_SPACE_EVENLY as AlignValue,\n\n    // Justify\n    JUSTIFY_FLEX_START: JUSTIFY_FLEX_START as JustifyValue,\n    JUSTIFY_CENTER: JUSTIFY_CENTER as JustifyValue,\n    JUSTIFY_FLEX_END: JUSTIFY_FLEX_END as JustifyValue,\n    JUSTIFY_SPACE_BETWEEN: JUSTIFY_SPACE_BETWEEN as JustifyValue,\n    JUSTIFY_SPACE_AROUND: JUSTIFY_SPACE_AROUND as JustifyValue,\n    JUSTIFY_SPACE_EVENLY: JUSTIFY_SPACE_EVENLY as JustifyValue,\n\n    // Edge\n    EDGE_LEFT: EDGE_LEFT as EdgeValue,\n    EDGE_TOP: EDGE_TOP as EdgeValue,\n    EDGE_RIGHT: EDGE_RIGHT as EdgeValue,\n    EDGE_BOTTOM: EDGE_BOTTOM as EdgeValue,\n    EDGE_HORIZONTAL: EDGE_HORIZONTAL as EdgeValue,\n    EDGE_VERTICAL: EDGE_VERTICAL as EdgeValue,\n    EDGE_ALL: EDGE_ALL as EdgeValue,\n\n    // Gutter\n    GUTTER_COLUMN: GUTTER_COLUMN as GutterValue,\n    GUTTER_ROW: GUTTER_ROW as GutterValue,\n    GUTTER_ALL: GUTTER_ALL as GutterValue,\n\n    // Display\n    DISPLAY_FLEX: DISPLAY_FLEX as DisplayValue,\n    DISPLAY_NONE: DISPLAY_NONE as DisplayValue,\n\n    // Position Type\n    POSITION_TYPE_STATIC: POSITION_TYPE_STATIC as PositionTypeValue,\n    POSITION_TYPE_RELATIVE: POSITION_TYPE_RELATIVE as PositionTypeValue,\n    POSITION_TYPE_ABSOLUTE: POSITION_TYPE_ABSOLUTE as PositionTypeValue,\n\n    // Overflow\n    OVERFLOW_VISIBLE: OVERFLOW_VISIBLE as OverflowValue,\n    OVERFLOW_HIDDEN: OVERFLOW_HIDDEN as OverflowValue,\n    OVERFLOW_SCROLL: OVERFLOW_SCROLL as OverflowValue,\n\n    // Direction\n    DIRECTION_LTR: DIRECTION_LTR as DirectionValue,\n\n    // Measure Mode\n    MEASURE_MODE_UNDEFINED: MEASURE_MODE_UNDEFINED as MeasureModeValue,\n    MEASURE_MODE_EXACTLY: MEASURE_MODE_EXACTLY as MeasureModeValue,\n    MEASURE_MODE_AT_MOST: MEASURE_MODE_AT_MOST as MeasureModeValue,\n  }\n\n  createNode(): LayoutNode {\n    return new FlexilyZeroNodeAdapter(FlexilyNode.create({ defaults: \"css\" }))\n  }\n\n  get constants(): LayoutConstants {\n    return this._constants\n  }\n\n  get name(): string {\n    return \"flexily-zero\"\n  }\n\n  get capabilities(): EngineCapabilities {\n    return FLEXILY_CAPABILITIES\n  }\n}\n\n/**\n * Internal-only Yoga-preset variant of FlexilyZeroLayoutEngine.\n *\n * Production silvery uses CSS-correct defaults via the standard\n * {@link FlexilyZeroLayoutEngine}. The Ink-compat layer (which mimics\n * Ink/Yoga semantics — `flexShrink:0`, `alignContent:flex-start`, no auto\n * min-size on flex items) needs Yoga-preset Nodes. This subclass is the\n * only sanctioned way to opt into Yoga semantics from inside silvery; do\n * not export from the public barrel and do not use in app code.\n */\nclass FlexilyZeroLayoutEngineYoga extends FlexilyZeroLayoutEngine {\n  override createNode(): LayoutNode {\n    return new FlexilyZeroNodeAdapter(FlexilyNode.create({ defaults: \"yoga\" }))\n  }\n}\n\n// ============================================================================\n// Initialization Helpers\n// ============================================================================\n\n/**\n * Create a Flexily zero-allocation layout engine with CSS-correct defaults.\n *\n * silvery's standard layout engine. Sets `flexShrink: 1`,\n * `alignContent: stretch`, and CSS §4.5 flex-item auto min-size on every\n * Node, matching browser flexbox semantics. Unlike Yoga, Flexily doesn't\n * require async initialization.\n *\n * Yoga-flavored semantics are deliberately not exposed here — consumers\n * needing Yoga compat should use `createFlexily({ defaults: \"yoga\" })` from\n * flexily directly. The Ink-compat layer is the single internal user that\n * stays on Yoga; it imports the `@internal` {@link createFlexilyZeroEngineForInkCompat}.\n */\nexport function createFlexilyZeroEngine(): FlexilyZeroLayoutEngine {\n  return new FlexilyZeroLayoutEngine()\n}\n\n/**\n * Yoga-preset variant for Ink-compat tests only.\n *\n * Do not use in production silvery code. The Ink-compat layer (`packages/ink`)\n * mimics Ink semantics, which match Yoga (`flexShrink:0`, `alignContent:flex-start`,\n * no auto min-size). When silvery's auto-generated Ink-compat tests render\n * through silvery's layout pipeline, they need Yoga-preset Nodes — that's\n * the one and only purpose of this factory.\n *\n * @internal Visible to silvery tests/compat/ink/helpers and packages/ink internals.\n */\nexport function createFlexilyZeroEngineForInkCompat(): FlexilyZeroLayoutEngine {\n  return new FlexilyZeroLayoutEngineYoga()\n}\n"],"mappings":"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"}

package/dist/{flexily-zero-adapter-CMxXhdOL.mjs → flexily-zero-adapter-C4lW_Ov5.mjs}

@@ -1,2 +1,2 @@
-import { n as createFlexilyZeroEngine } from "./flexily-zero-adapter-BlQa46nr.mjs";
+import { n as createFlexilyZeroEngine } from "./flexily-zero-adapter-C3Vj0fPt.mjs";
 export { createFlexilyZeroEngine };

package/dist/fonts-BFmhXDv7.mjs

@@ -0,0 +1,88 @@
+import { n as __esmMin } from "./chunk-BSw8zbkd.mjs";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+//#region ../termless/src/render/fonts.ts
+/**
+* Bundled fallback fonts — the canonical termless font assets.
+*
+* Four OFL-licensed faces ship inside `@termless/core` under `assets/fonts`:
+*
+*   - JetBrains Mono       — primary monospace face (broad Latin + box-drawing)
+*   - Noto Sans Symbols 2  — terminal symbol glyphs JetBrains Mono lacks
+*   - Symbols Nerd Font    — Nerd Font private-use icons (powerline, devicons,
+*                            the U+F0xx/U+E0xx glyphs TUIs like km use)
+*   - Noto Emoji (mono)    — emoji code points (📁 📋 📄, status emoji)
+*
+* Two render paths consume these:
+*
+*   - The `@resvg/resvg-js` SVG→raster path (`./view/gif.ts`, `./view/apng.ts`,
+*     `record --screenshot *.png`) — passes the font files to resvg's
+*     `font.fontFiles` so emoji/symbol code points resolve instead of tofu.
+*   - `@termless/ghostty`'s `@napi-rs/canvas` renderer — registers them
+*     process-wide via `GlobalFonts.registerFromPath`.
+*
+* Both packages resolve the directory through this module so there is a
+* single bundled copy, owned by `@termless/core` (the foundational package).
+*/
+/**
+* Resolve the bundled `assets/fonts` directory in both layouts:
+*   - dev:       `<pkg>/src/render/fonts.ts`  → `<pkg>/assets/fonts`
+*   - published: `<pkg>/dist/index.mjs`       → `<pkg>/assets/fonts`
+*
+* In dev the file sits two levels deep (`src/render/`), in a published build
+* one level deep (`dist/`). We probe upward for the first ancestor that has
+* an `assets/fonts` child so both layouts resolve without a build-time guess.
+*/
+function bundledFontsDir() {
+	let here = dirname(fileURLToPath(import.meta.url));
+	for (let i = 0; i < 4; i++) {
+		const candidate = join(here, "assets", "fonts");
+		if (existsSync(candidate)) return candidate;
+		here = dirname(here);
+	}
+	return join(dirname(fileURLToPath(import.meta.url)), "..", "..", "assets", "fonts");
+}
+/**
+* Absolute paths of the bundled font files that actually exist on disk.
+* Missing files are skipped silently — a partial fallback chain still beats
+* a hard failure, and the bundled-font test pins the happy path.
+*/
+function bundledFontFiles() {
+	const dir = bundledFontsDir();
+	const files = [];
+	for (const { file } of BUNDLED_FONTS) {
+		const path = join(dir, file);
+		if (existsSync(path)) files.push(path);
+	}
+	return files;
+}
+var BUNDLED_PRIMARY_FAMILY, BUNDLED_SYMBOL_FAMILY, BUNDLED_NERD_FAMILY, BUNDLED_EMOJI_FAMILY, BUNDLED_FONTS;
+var init_fonts = __esmMin((() => {
+	BUNDLED_PRIMARY_FAMILY = "TermlessMono";
+	BUNDLED_SYMBOL_FAMILY = "TermlessSymbols";
+	BUNDLED_NERD_FAMILY = "TermlessNerd";
+	BUNDLED_EMOJI_FAMILY = "TermlessEmoji";
+	BUNDLED_FONTS = [
+		{
+			file: "JetBrainsMono-Regular.ttf",
+			family: BUNDLED_PRIMARY_FAMILY
+		},
+		{
+			file: "NotoSansSymbols2-Regular.ttf",
+			family: BUNDLED_SYMBOL_FAMILY
+		},
+		{
+			file: "SymbolsNerdFontMono-Regular.ttf",
+			family: BUNDLED_NERD_FAMILY
+		},
+		{
+			file: "NotoEmoji-Regular.ttf",
+			family: BUNDLED_EMOJI_FAMILY
+		}
+	];
+}));
+//#endregion
+export { BUNDLED_SYMBOL_FAMILY as a, init_fonts as c, BUNDLED_PRIMARY_FAMILY as i, BUNDLED_FONTS as n, bundledFontFiles as o, BUNDLED_NERD_FAMILY as r, bundledFontsDir as s, BUNDLED_EMOJI_FAMILY as t };
+
+//# sourceMappingURL=fonts-BFmhXDv7.mjs.map

package/dist/fonts-BFmhXDv7.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"fonts-BFmhXDv7.mjs","names":[],"sources":["../../termless/src/render/fonts.ts"],"sourcesContent":["/**\n * Bundled fallback fonts — the canonical termless font assets.\n *\n * Four OFL-licensed faces ship inside `@termless/core` under `assets/fonts`:\n *\n *   - JetBrains Mono       — primary monospace face (broad Latin + box-drawing)\n *   - Noto Sans Symbols 2  — terminal symbol glyphs JetBrains Mono lacks\n *   - Symbols Nerd Font    — Nerd Font private-use icons (powerline, devicons,\n *                            the U+F0xx/U+E0xx glyphs TUIs like km use)\n *   - Noto Emoji (mono)    — emoji code points (📁 📋 📄, status emoji)\n *\n * Two render paths consume these:\n *\n *   - The `@resvg/resvg-js` SVG→raster path (`./view/gif.ts`, `./view/apng.ts`,\n *     `record --screenshot *.png`) — passes the font files to resvg's\n *     `font.fontFiles` so emoji/symbol code points resolve instead of tofu.\n *   - `@termless/ghostty`'s `@napi-rs/canvas` renderer — registers them\n *     process-wide via `GlobalFonts.registerFromPath`.\n *\n * Both packages resolve the directory through this module so there is a\n * single bundled copy, owned by `@termless/core` (the foundational package).\n */\n\nimport { dirname, join } from \"node:path\"\nimport { fileURLToPath } from \"node:url\"\nimport { existsSync } from \"node:fs\"\n\n/** Family names the bundled fonts are registered under (CSS `font-family`). */\nexport const BUNDLED_PRIMARY_FAMILY = \"TermlessMono\"\nexport const BUNDLED_SYMBOL_FAMILY = \"TermlessSymbols\"\nexport const BUNDLED_NERD_FAMILY = \"TermlessNerd\"\nexport const BUNDLED_EMOJI_FAMILY = \"TermlessEmoji\"\n\n/** One bundled font: a file name (relative to the fonts dir) + its family. */\nexport interface BundledFont {\n  file: string\n  family: string\n}\n\n/**\n * The bundled faces, in fallback order. The primary face is first; the\n * symbol + emoji faces follow so per-glyph fallback resolves in that order.\n */\nexport const BUNDLED_FONTS: readonly BundledFont[] = [\n  { file: \"JetBrainsMono-Regular.ttf\", family: BUNDLED_PRIMARY_FAMILY },\n  { file: \"NotoSansSymbols2-Regular.ttf\", family: BUNDLED_SYMBOL_FAMILY },\n  { file: \"SymbolsNerdFontMono-Regular.ttf\", family: BUNDLED_NERD_FAMILY },\n  { file: \"NotoEmoji-Regular.ttf\", family: BUNDLED_EMOJI_FAMILY },\n]\n\n/**\n * Resolve the bundled `assets/fonts` directory in both layouts:\n *   - dev:       `<pkg>/src/render/fonts.ts`  → `<pkg>/assets/fonts`\n *   - published: `<pkg>/dist/index.mjs`       → `<pkg>/assets/fonts`\n *\n * In dev the file sits two levels deep (`src/render/`), in a published build\n * one level deep (`dist/`). We probe upward for the first ancestor that has\n * an `assets/fonts` child so both layouts resolve without a build-time guess.\n */\nexport function bundledFontsDir(): string {\n  let here = dirname(fileURLToPath(import.meta.url))\n  for (let i = 0; i < 4; i++) {\n    const candidate = join(here, \"assets\", \"fonts\")\n    if (existsSync(candidate)) return candidate\n    here = dirname(here)\n  }\n  // Fall back to the dev layout (`src/render/` → two levels up) so callers\n  // get a deterministic path even when the assets are absent.\n  return join(dirname(fileURLToPath(import.meta.url)), \"..\", \"..\", \"assets\", \"fonts\")\n}\n\n/**\n * Absolute paths of the bundled font files that actually exist on disk.\n * Missing files are skipped silently — a partial fallback chain still beats\n * a hard failure, and the bundled-font test pins the happy path.\n */\nexport function bundledFontFiles(): string[] {\n  const dir = bundledFontsDir()\n  const files: string[] = []\n  for (const { file } of BUNDLED_FONTS) {\n    const path = join(dir, file)\n    if (existsSync(path)) files.push(path)\n  }\n  return files\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2DA,SAAgB,kBAA0B;CACxC,IAAI,OAAO,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAClD,MAAK,IAAI,IAAI,GAAG,IAAI,GAAG,KAAK;EAC1B,MAAM,YAAY,KAAK,MAAM,UAAU,QAAQ;AAC/C,MAAI,WAAW,UAAU,CAAE,QAAO;AAClC,SAAO,QAAQ,KAAK;;AAItB,QAAO,KAAK,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EAAE,MAAM,MAAM,UAAU,QAAQ;;;;;;;AAQrF,SAAgB,mBAA6B;CAC3C,MAAM,MAAM,iBAAiB;CAC7B,MAAM,QAAkB,EAAE;AAC1B,MAAK,MAAM,EAAE,UAAU,eAAe;EACpC,MAAM,OAAO,KAAK,KAAK,KAAK;AAC5B,MAAI,WAAW,KAAK,CAAE,OAAM,KAAK,KAAK;;AAExC,QAAO;;;;AAvDI,0BAAyB;AACzB,yBAAwB;AACxB,uBAAsB;AACtB,wBAAuB;AAYvB,iBAAwC;EACnD;GAAE,MAAM;GAA6B,QAAQ;GAAwB;EACrE;GAAE,MAAM;GAAgC,QAAQ;GAAuB;EACvE;GAAE,MAAM;GAAmC,QAAQ;GAAqB;EACxE;GAAE,MAAM;GAAyB,QAAQ;GAAsB;EAChE"}

package/dist/gif-C_AjaT9d.mjs

@@ -0,0 +1,188 @@
+import { n as __esmMin, o as __toESM } from "./chunk-BSw8zbkd.mjs";
+import { n as selectRasterizer, t as init_rasterizer } from "./rasterizer-CpEhJvdR.mjs";
+//#region ../termless/src/view/gif.ts
+async function loadGifenc() {
+	if (gifencModule) return gifencModule;
+	try {
+		gifencModule = await import("./gifenc-BOUT-KFB.mjs").then((m) => /* @__PURE__ */ __toESM(m.default, 1));
+		return gifencModule;
+	} catch {
+		throw new Error("createGif() requires gifenc. Install it:\n  bun add gifenc");
+	}
+}
+function svgHasChrome(svg) {
+	return /windowBar|windowTitle|<rect[^>]*rx="\d+"/.test(svg);
+}
+function svgContentOffset(svg, scale) {
+	const contentTransform = [...svg.matchAll(/<g[^>]*\btransform="translate\(\s*([\d.-]+)[,\s]+([\d.-]+)\s*\)"/g)].at(-1);
+	if (!contentTransform) return {
+		x: 0,
+		y: 0
+	};
+	return {
+		x: Math.round(Number(contentTransform[1]) * scale),
+		y: Math.round(Number(contentTransform[2]) * scale)
+	};
+}
+function compositeBitmap(base, overlay, offset) {
+	const pixels = new Uint8Array(base.pixels);
+	for (let y = 0; y < overlay.height; y++) {
+		const dy = y + offset.y;
+		if (dy < 0 || dy >= base.height) continue;
+		for (let x = 0; x < overlay.width; x++) {
+			const dx = x + offset.x;
+			if (dx < 0 || dx >= base.width) continue;
+			const si = (y * overlay.width + x) * 4;
+			const di = (dy * base.width + dx) * 4;
+			const srcAlpha = overlay.pixels[si + 3] / 255;
+			if (srcAlpha <= 0) continue;
+			if (srcAlpha >= 1) {
+				pixels[di] = overlay.pixels[si];
+				pixels[di + 1] = overlay.pixels[si + 1];
+				pixels[di + 2] = overlay.pixels[si + 2];
+				pixels[di + 3] = overlay.pixels[si + 3];
+				continue;
+			}
+			const dstAlpha = pixels[di + 3] / 255;
+			const outAlpha = srcAlpha + dstAlpha * (1 - srcAlpha);
+			if (outAlpha <= 0) continue;
+			const dstWeight = dstAlpha * (1 - srcAlpha) / outAlpha;
+			const srcWeight = srcAlpha / outAlpha;
+			pixels[di] = Math.round(overlay.pixels[si] * srcWeight + pixels[di] * dstWeight);
+			pixels[di + 1] = Math.round(overlay.pixels[si + 1] * srcWeight + pixels[di + 1] * dstWeight);
+			pixels[di + 2] = Math.round(overlay.pixels[si + 2] * srcWeight + pixels[di + 2] * dstWeight);
+			pixels[di + 3] = Math.round(outAlpha * 255);
+		}
+	}
+	return {
+		...base,
+		pixels
+	};
+}
+/**
+* Encode animation frames as an animated GIF.
+*
+* Each SVG frame is rasterized to RGBA pixels via the selected renderer
+* (`options.renderer`, default `auto`), then quantized to 256 colors and
+* written to a GIF stream via gifenc.
+*
+* @param frames - SVG frames with durations
+* @param options - Animation options plus optional `scale` and `renderer`
+* @returns GIF file as Uint8Array
+*/
+async function createGif(frames, options) {
+	if (frames.length === 0) throw new Error("createGif requires at least one frame");
+	const [{ GIFEncoder, quantize, applyPalette }, rasterizer] = await Promise.all([loadGifenc(), selectRasterizer(options?.renderer ?? "auto")]);
+	const defaultDuration = options?.defaultDuration ?? 100;
+	const loop = options?.loop ?? 0;
+	const scale = options?.scale ?? 2;
+	const forceSvg = options?.forceSvg === true;
+	const gif = GIFEncoder();
+	const rasterize = async (frame) => {
+		if (forceSvg || !frame.snapshot || !rasterizer.rasterizeCells) return rasterizer.rasterize(frame.svg, scale);
+		const cells = await rasterizer.rasterizeCells(frame.snapshot, scale);
+		if (!svgHasChrome(frame.svg)) return cells;
+		return compositeBitmap(await rasterizer.rasterize(frame.svg, scale), cells, svgContentOffset(frame.svg, scale));
+	};
+	try {
+		const sampleIdx = Math.floor(frames.length / 2);
+		const sample = await rasterize(frames[sampleIdx]);
+		const palette = quantize(sample.pixels, 255);
+		const TRANSPARENT_IDX = 255;
+		let prevIndexed = null;
+		for (let i = 0; i < frames.length; i++) {
+			const frame = frames[i];
+			const duration = frame.duration || defaultDuration;
+			const { pixels: rgba, width, height } = i === sampleIdx ? sample : await rasterize(frame);
+			const indexed = applyPalette(rgba, palette);
+			const canDiff = prevIndexed !== null && prevIndexed.length === indexed.length;
+			let frameData = indexed;
+			if (canDiff) {
+				const delta = new Uint8Array(indexed.length);
+				for (let p = 0; p < indexed.length; p++) delta[p] = indexed[p] === prevIndexed[p] ? TRANSPARENT_IDX : indexed[p];
+				frameData = delta;
+			}
+			gif.writeFrame(frameData, width, height, {
+				palette: i === 0 ? palette : void 0,
+				delay: duration,
+				repeat: i === 0 ? loop === 0 ? 0 : loop : void 0,
+				transparent: canDiff,
+				transparentIndex: TRANSPARENT_IDX,
+				dispose: 1
+			});
+			if ((i & 3) === 3) await new Promise((r) => setImmediate(r));
+			prevIndexed = indexed;
+		}
+	} finally {
+		await rasterizer.dispose?.();
+	}
+	gif.finish();
+	return gif.bytesView();
+}
+/**
+* Encode already-rasterized PNG frames as an animated GIF.
+*
+* Unlike {@link createGif}, the frames are pre-rendered PNGs — no SVG round-
+* trip, no `@resvg/resvg-js`. Used by the cross-backend compositor
+* (`../tape/compare-canvas.ts`), whose frames are composed PNGs.
+*
+* All frames are expected to share dimensions (the compositor guarantees this
+* by time-syncing the panel layout); a mismatched frame is letterboxed onto
+* the first frame's canvas size.
+*/
+async function createGifFromPngs(frames, options) {
+	if (frames.length === 0) throw new Error("createGifFromPngs requires at least one frame");
+	const { GIFEncoder, quantize, applyPalette } = await loadGifenc();
+	const defaultDuration = options?.defaultDuration ?? 100;
+	const loop = options?.loop ?? 0;
+	const decode = options?.decodePng ?? await (async () => {
+		const { decodePngRgba } = await import("./png-codec-QwOtJ8Zs.mjs");
+		return decodePngRgba;
+	})();
+	const gif = GIFEncoder();
+	let baseW = 0;
+	let baseH = 0;
+	for (let i = 0; i < frames.length; i++) {
+		const frame = frames[i];
+		const decoded = decode(frame.png);
+		if (i === 0) {
+			baseW = decoded.width;
+			baseH = decoded.height;
+		}
+		let rgba = decoded.data;
+		let width = decoded.width;
+		let height = decoded.height;
+		if (width !== baseW || height !== baseH) {
+			const padded = new Uint8Array(baseW * baseH * 4);
+			for (let y = 0; y < Math.min(height, baseH); y++) for (let x = 0; x < Math.min(width, baseW); x++) {
+				const si = (y * width + x) * 4;
+				const di = (y * baseW + x) * 4;
+				padded[di] = rgba[si];
+				padded[di + 1] = rgba[si + 1];
+				padded[di + 2] = rgba[si + 2];
+				padded[di + 3] = rgba[si + 3];
+			}
+			rgba = padded;
+			width = baseW;
+			height = baseH;
+		}
+		const palette = quantize(rgba, 256);
+		const indexed = applyPalette(rgba, palette);
+		gif.writeFrame(indexed, width, height, {
+			palette,
+			delay: frame.duration || defaultDuration,
+			repeat: i === 0 ? loop === 0 ? 0 : loop : void 0
+		});
+	}
+	gif.finish();
+	return gif.bytesView();
+}
+var gifencModule;
+var init_gif = __esmMin((() => {
+	init_rasterizer();
+	gifencModule = null;
+}));
+//#endregion
+export { createGifFromPngs as n, init_gif as r, createGif as t };
+
+//# sourceMappingURL=gif-C_AjaT9d.mjs.map

package/dist/gif-C_AjaT9d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gif-C_AjaT9d.mjs","names":[],"sources":["../../termless/src/view/gif.ts"],"sourcesContent":["/**\n * Animated GIF encoder for termless.\n *\n * Converts SVG frames to an animated GIF using gifenc (pure JS, no binary deps)\n * for GIF encoding. SVG → pixel rasterization goes through the **renderer**\n * (`./rasterizer.ts`): `canvas` (`@napi-rs/canvas`, high fidelity) when its\n * native binding loads, `resvg` (`@resvg/resvg-js`) as the cross-platform\n * fallback. The renderer is *not* hardwired — a default `out.gif` gets\n * `canvas` fidelity when the binding is available.\n *\n * `gifenc` is an optional/lazy-loaded dependency — throws a clear error if\n * missing.\n */\n\n// Module declarations live in ./gifenc.d.ts (picked up via tsconfig `include` glob).\nimport type { AnimationFrame, AnimationOptions } from \"./animation-types.ts\"\nimport { selectRasterizer, type RasterBitmap, type RendererKind } from \"./rasterizer.ts\"\n\n// Lazy-cached imports\nlet gifencModule: typeof import(\"gifenc\") | null = null\n\nasync function loadGifenc() {\n  if (gifencModule) return gifencModule\n  try {\n    gifencModule = await import(\"gifenc\")\n    return gifencModule\n  } catch {\n    throw new Error(\"createGif() requires gifenc. Install it:\\n  bun add gifenc\")\n  }\n}\n\nfunction svgHasChrome(svg: string): boolean {\n  return /windowBar|windowTitle|<rect[^>]*rx=\"\\d+\"/.test(svg)\n}\n\nfunction svgContentOffset(svg: string, scale: number): { x: number; y: number } {\n  const transforms = [...svg.matchAll(/<g[^>]*\\btransform=\"translate\\(\\s*([\\d.-]+)[,\\s]+([\\d.-]+)\\s*\\)\"/g)]\n  const contentTransform = transforms.at(-1)\n  if (!contentTransform) return { x: 0, y: 0 }\n  return {\n    x: Math.round(Number(contentTransform[1]) * scale),\n    y: Math.round(Number(contentTransform[2]) * scale),\n  }\n}\n\nfunction compositeBitmap(base: RasterBitmap, overlay: RasterBitmap, offset: { x: number; y: number }): RasterBitmap {\n  const pixels = new Uint8Array(base.pixels)\n  for (let y = 0; y < overlay.height; y++) {\n    const dy = y + offset.y\n    if (dy < 0 || dy >= base.height) continue\n    for (let x = 0; x < overlay.width; x++) {\n      const dx = x + offset.x\n      if (dx < 0 || dx >= base.width) continue\n\n      const si = (y * overlay.width + x) * 4\n      const di = (dy * base.width + dx) * 4\n      const srcAlpha = overlay.pixels[si + 3]! / 255\n      if (srcAlpha <= 0) continue\n      if (srcAlpha >= 1) {\n        pixels[di] = overlay.pixels[si]!\n        pixels[di + 1] = overlay.pixels[si + 1]!\n        pixels[di + 2] = overlay.pixels[si + 2]!\n        pixels[di + 3] = overlay.pixels[si + 3]!\n        continue\n      }\n\n      const dstAlpha = pixels[di + 3]! / 255\n      const outAlpha = srcAlpha + dstAlpha * (1 - srcAlpha)\n      if (outAlpha <= 0) continue\n\n      const dstWeight = (dstAlpha * (1 - srcAlpha)) / outAlpha\n      const srcWeight = srcAlpha / outAlpha\n      pixels[di] = Math.round(overlay.pixels[si]! * srcWeight + pixels[di]! * dstWeight)\n      pixels[di + 1] = Math.round(overlay.pixels[si + 1]! * srcWeight + pixels[di + 1]! * dstWeight)\n      pixels[di + 2] = Math.round(overlay.pixels[si + 2]! * srcWeight + pixels[di + 2]! * dstWeight)\n      pixels[di + 3] = Math.round(outAlpha * 255)\n    }\n  }\n  return { ...base, pixels }\n}\n\n/**\n * Encode animation frames as an animated GIF.\n *\n * Each SVG frame is rasterized to RGBA pixels via the selected renderer\n * (`options.renderer`, default `auto`), then quantized to 256 colors and\n * written to a GIF stream via gifenc.\n *\n * @param frames - SVG frames with durations\n * @param options - Animation options plus optional `scale` and `renderer`\n * @returns GIF file as Uint8Array\n */\nexport async function createGif(\n  frames: AnimationFrame[],\n  options?: AnimationOptions & { scale?: number; renderer?: RendererKind; forceSvg?: boolean },\n): Promise<Uint8Array> {\n  if (frames.length === 0) {\n    throw new Error(\"createGif requires at least one frame\")\n  }\n\n  const [{ GIFEncoder, quantize, applyPalette }, rasterizer] = await Promise.all([\n    loadGifenc(),\n    selectRasterizer(options?.renderer ?? \"auto\"),\n  ])\n\n  const defaultDuration = options?.defaultDuration ?? 100\n  const loop = options?.loop ?? 0\n  const scale = options?.scale ?? 2\n  const forceSvg = options?.forceSvg === true\n\n  const gif = GIFEncoder()\n\n  // Cell-native path: a renderer that exposes `rasterizeCells` (swash) skips\n  // the SVG round-trip when the frame carries a snapshot — that is what makes\n  // color emoji and exact glyph coverage survive into the GIF. If the SVG\n  // also carries chrome, rasterize the chrome SVG and overwrite only the\n  // terminal content rectangle with the cell-native bitmap.\n  const rasterize = async (frame: AnimationFrame) => {\n    if (forceSvg || !frame.snapshot || !rasterizer.rasterizeCells) {\n      return rasterizer.rasterize(frame.svg, scale)\n    }\n\n    const cells = await rasterizer.rasterizeCells(frame.snapshot, scale)\n    if (!svgHasChrome(frame.svg)) return cells\n\n    const chrome = await rasterizer.rasterize(frame.svg, scale)\n    return compositeBitmap(chrome, cells, svgContentOffset(frame.svg, scale))\n  }\n\n  // Shared global palette. A terminal recording's colour set barely changes\n  // frame to frame (theme + ANSI + anti-alias blends), so quantizing a fresh\n  // palette per frame — and re-embedding it in every frame — is pure bloat.\n  // Quantize ONCE from a representative content-bearing frame and reuse it as\n  // the GIF's global colour table. 255 colours, not 256: index 255 is\n  // reserved as the inter-frame transparency marker (below).\n  //\n  // The whole batch runs inside try/finally so the `browser` renderer's\n  // headless-Chromium instance is released even if encoding throws.\n  try {\n    const sampleIdx = Math.floor(frames.length / 2)\n    const sample = await rasterize(frames[sampleIdx]!)\n    const palette = quantize(sample.pixels, 255)\n    const TRANSPARENT_IDX = 255\n\n    // Inter-frame diffing. Successive terminal frames differ in only a handful\n    // of cells, so after frame 0 each frame is written as a *delta*: pixels\n    // unchanged from the previous frame become the transparent index, and the\n    // frame is composited over its predecessor (`dispose: 1` — do not dispose).\n    // Long runs of the transparent index compress near-free under LZW — the\n    // dominant GIF-size win for a recording.\n    let prevIndexed: Uint8Array | null = null\n\n    for (let i = 0; i < frames.length; i++) {\n      const frame = frames[i]!\n      const duration = frame.duration || defaultDuration\n\n      const { pixels: rgba, width, height } = i === sampleIdx ? sample : await rasterize(frame)\n      const indexed = applyPalette(rgba, palette)\n\n      // Delta-encode against the previous frame when dimensions match.\n      const canDiff = prevIndexed !== null && prevIndexed.length === indexed.length\n      let frameData = indexed\n      if (canDiff) {\n        const delta = new Uint8Array(indexed.length)\n        for (let p = 0; p < indexed.length; p++) {\n          delta[p] = indexed[p] === prevIndexed![p] ? TRANSPARENT_IDX : indexed[p]!\n        }\n        frameData = delta\n      }\n\n      gif.writeFrame(frameData, width, height, {\n        // Only the first frame carries the palette — it becomes the global\n        // colour table; later frames reference it (no per-frame local table).\n        palette: i === 0 ? palette : undefined,\n        delay: duration,\n        repeat: i === 0 ? (loop === 0 ? 0 : loop) : undefined,\n        // Frames after the first are deltas: transparent pixels show the\n        // composited prior frame through. `dispose: 1` keeps each frame in\n        // place so the next delta lands on top of it.\n        transparent: canDiff,\n        transparentIndex: TRANSPARENT_IDX,\n        dispose: 1,\n      })\n\n      // Yield to the event loop every frame so external progress UIs\n      // (spinners, ProgressBar) can tick. `gif.writeFrame` is CPU-bound\n      // (LZW encoding); without a yield the encoding loop monopolises\n      // the loop for the entire run and any silvery/react Spinner timer\n      // in the host process freezes mid-animation.\n      if ((i & 3) === 3) await new Promise<void>((r) => setImmediate(r))\n\n      // Compare the NEXT frame against this frame's full (un-delta'd) content.\n      prevIndexed = indexed\n    }\n  } finally {\n    // Release the headless-Chromium instance the `browser` renderer holds.\n    await rasterizer.dispose?.()\n  }\n\n  gif.finish()\n  return gif.bytesView()\n}\n\n/** One PNG-backed animation frame: pre-rasterized bytes + a display duration. */\nexport interface PngFrame {\n  /** PNG bytes of this frame. */\n  png: Uint8Array\n  /** Display duration in milliseconds. */\n  duration: number\n}\n\n/**\n * Encode already-rasterized PNG frames as an animated GIF.\n *\n * Unlike {@link createGif}, the frames are pre-rendered PNGs — no SVG round-\n * trip, no `@resvg/resvg-js`. Used by the cross-backend compositor\n * (`../tape/compare-canvas.ts`), whose frames are composed PNGs.\n *\n * All frames are expected to share dimensions (the compositor guarantees this\n * by time-syncing the panel layout); a mismatched frame is letterboxed onto\n * the first frame's canvas size.\n */\nexport async function createGifFromPngs(\n  frames: PngFrame[],\n  options?: AnimationOptions & { decodePng?: (png: Uint8Array) => { width: number; height: number; data: Uint8Array } },\n): Promise<Uint8Array> {\n  if (frames.length === 0) {\n    throw new Error(\"createGifFromPngs requires at least one frame\")\n  }\n  const { GIFEncoder, quantize, applyPalette } = await loadGifenc()\n  const defaultDuration = options?.defaultDuration ?? 100\n  const loop = options?.loop ?? 0\n\n  // Decoder: caller-supplied (the compositor passes its upng codec) or upng.\n  const decode =\n    options?.decodePng ??\n    (await (async () => {\n      const { decodePngRgba } = await import(\"../recording/tape/png-codec.ts\")\n      return decodePngRgba\n    })())\n\n  const gif = GIFEncoder()\n  let baseW = 0\n  let baseH = 0\n\n  for (let i = 0; i < frames.length; i++) {\n    const frame = frames[i]!\n    const decoded = decode(frame.png)\n    if (i === 0) {\n      baseW = decoded.width\n      baseH = decoded.height\n    }\n    let rgba = decoded.data\n    let width = decoded.width\n    let height = decoded.height\n    if (width !== baseW || height !== baseH) {\n      // Letterbox onto the base canvas (top-left aligned).\n      const padded = new Uint8Array(baseW * baseH * 4)\n      for (let y = 0; y < Math.min(height, baseH); y++) {\n        for (let x = 0; x < Math.min(width, baseW); x++) {\n          const si = (y * width + x) * 4\n          const di = (y * baseW + x) * 4\n          padded[di] = rgba[si]!\n          padded[di + 1] = rgba[si + 1]!\n          padded[di + 2] = rgba[si + 2]!\n          padded[di + 3] = rgba[si + 3]!\n        }\n      }\n      rgba = padded\n      width = baseW\n      height = baseH\n    }\n    const palette = quantize(rgba, 256)\n    const indexed = applyPalette(rgba, palette)\n    gif.writeFrame(indexed, width, height, {\n      palette,\n      delay: frame.duration || defaultDuration,\n      repeat: i === 0 ? (loop === 0 ? 0 : loop) : undefined,\n    })\n  }\n\n  gif.finish()\n  return gif.bytesView()\n}\n"],"mappings":"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"}

package/dist/gif-DaC4XrxA.mjs

@@ -0,0 +1,3 @@
+import { r as init_gif, t as createGif } from "./gif-C_AjaT9d.mjs";
+init_gif();
+export { createGif };