@servrox/console-fx 0.1.0

package/dist/layout/render.js

@@ -0,0 +1,98 @@
+import { LIMITS } from "../model/limits.js";
+import { fail } from "../validation/index.js";
+import { renderSvg } from "../renderers/svg.js";
+import { planSvgLayout } from "./planner.js";
+import { svgNumber } from "../renderers/svg-values.js";
+import { presentationDescriptor } from "../presentations/catalog.js";
+export function renderWithLayout(scene, motion, options) {
+    if (!options.layout && !options.sizing)
+        return renderSvg(scene, motion);
+    const plan = options.layout
+        ? planSvgLayout(scene, options.layout, options)
+        : undefined;
+    const output = renderSvg(scene, motion, plan);
+    const width = plan?.report.artboard.width ?? scene.surface.width;
+    const height = plan?.report.artboard.height ?? scene.surface.height;
+    const sizing = options.sizing;
+    const diagnostics = [
+        ...output.diagnostics,
+        ...(plan?.report.diagnostics ?? []),
+    ];
+    if (sizing?.mode === "container-experimental") {
+        if (sizing.maxWidth > width)
+            fail("unsupported-layout", "Container maximum width cannot exceed the image artboard.", ["sizing"]);
+        const ratio = height / width, fraction = sizing.fillFraction ?? 0.96;
+        if (sizing.maxWidth * ratio > LIMITS.svgHeight)
+            fail("invalid-options", "Proportional display height exceeds 400 pixels.", ["sizing"]);
+        diagnostics.push({
+            code: "experimental-container-sizing",
+            severity: "warning",
+            path: ["sizing"],
+            message: "Container sizing is experimental and requires qualification in the receiving DevTools.",
+        }, {
+            code: "display-readability-unknown",
+            severity: "warning",
+            path: ["sizing"],
+            message: "Actual display width and image-text readability are unknown. The complete native caption remains available.",
+        });
+        return {
+            ...output,
+            diagnostics,
+            width: sizing.maxWidth,
+            height: sizing.maxWidth * ratio,
+            carrierPadding: `min(${svgNumber((sizing.maxWidth * ratio) / 2)}px, ${svgNumber(50 * fraction * ratio)}%) min(${svgNumber(sizing.maxWidth / 2)}px, ${svgNumber(50 * fraction)}%)`,
+            sizing: {
+                mode: sizing.mode,
+                artboard: { width, height },
+                resolvedDisplayWidth: null,
+                resolvedDisplayHeight: null,
+                displayScale: null,
+                displayReadability: "unknown",
+            },
+            ...(plan ? { layout: plan.report } : {}),
+        };
+    }
+    const displayWidth = sizing?.width ?? width, displayHeight = (displayWidth * height) / width;
+    if (sizing && !plan) {
+        const descriptor = scene.presentation
+            ? presentationDescriptor(scene.presentation.profile)
+            : undefined;
+        const scale = (displayWidth / width) *
+            (descriptor
+                ? Math.min((width - 2 * scene.surface.padding) / 720, (height - 2 * scene.surface.padding) / 240)
+                : 1);
+        const runs = descriptor
+            ? descriptor.slots.map((s) => scene.lines[s.line].runs[s.run])
+            : scene.lines.flatMap((l) => l.runs);
+        if (runs.some((r) => r.text &&
+            r.style.fontSize * scale <
+                (descriptor?.group === "Useful" && r.style.fontSize >= 14 ? 12 : 8)))
+            fail("below-readable-size", "Fixed display sizing would violate the default readable font floor. Choose a larger width, explicit fitting or plain text.", ["sizing"]);
+    }
+    if (displayHeight > LIMITS.svgHeight)
+        fail("invalid-options", "Proportional display height exceeds 400 pixels.", [
+            "sizing",
+        ]);
+    return {
+        ...output,
+        width: displayWidth,
+        height: displayHeight,
+        diagnostics,
+        ...(plan ? { layout: plan.report } : {}),
+        ...(sizing || plan
+            ? {
+                sizing: {
+                    mode: "fixed",
+                    artboard: { width, height },
+                    resolvedDisplayWidth: displayWidth,
+                    resolvedDisplayHeight: displayHeight,
+                    displayScale: displayWidth / width,
+                    displayReadability: plan
+                        ? "meets-requested-floor"
+                        : "meets-default-floor",
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/layout/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/layout/render.ts"],"names":[],"mappings":"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"}

package/dist/layout/wrap.d.ts

@@ -0,0 +1,16 @@
+import type { TextRun } from "../model/types.js";
+export type FlowRun = TextRun & {
+    readonly sourceRun: number;
+};
+type Token = readonly FlowRun[];
+/** fit/v1 breaks only at complete graphemes, ASCII spaces and CJK letter boundaries.
+ * Tokens may cross style/run boundaries: styling cannot make an ID breakable.
+ */
+export declare function wrapTokens(runs: readonly FlowRun[]): readonly Token[];
+export declare function wrapTokensToRows(tokens: readonly Token[], width: number, occupiedWidth: (runs: readonly FlowRun[]) => number): FlowRun[][];
+/** Optional preflight lookahead. The caller stops this iterator at its byte/work budget.
+ * Actual line fragments are shaped whole, never inferred from summed glyph advances.
+ */
+export declare function wrappingAlternatives(tokens: readonly Token[]): Generator<FlowRun, void, unknown>;
+export {};
+//# sourceMappingURL=wrap.d.ts.map

package/dist/layout/wrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../src/layout/wrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAC/D,KAAK,KAAK,GAAG,SAAS,OAAO,EAAE,CAAC;AAkBhC;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,KAAK,EAAE,CAyBrE;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,SAAS,KAAK,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,KAAK,MAAM,GAClD,OAAO,EAAE,EAAE,CAYb;AAED;;GAEG;AACH,wBAAiB,oBAAoB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,qCAQ7D"}

package/dist/layout/wrap.js

@@ -0,0 +1,67 @@
+import { cinematicEffect } from "../renderers/cinematic/layout.js";
+const cjk = (text) => /^[\p{Script=Han}\p{Script=Hiragana}\p{Script=Katakana}]+$/u.test(text);
+function append(left, right) {
+    const result = [...left];
+    for (const run of right) {
+        const last = result.at(-1);
+        if (last?.sourceRun === run.sourceRun)
+            result[result.length - 1] = { ...last, text: last.text + run.text };
+        else
+            result.push(run);
+    }
+    return result;
+}
+/** fit/v1 breaks only at complete graphemes, ASCII spaces and CJK letter boundaries.
+ * Tokens may cross style/run boundaries: styling cannot make an ID breakable.
+ */
+export function wrapTokens(runs) {
+    // Without grapheme boundaries, retain the complete styled paragraph.
+    if (typeof Intl.Segmenter !== "function")
+        return [runs];
+    const segmenter = new Intl.Segmenter("und", { granularity: "grapheme" });
+    const pieces = runs.flatMap((run) => (cinematicEffect(run)
+        ? [run.text]
+        : [...segmenter.segment(run.text)].map((part) => part.segment)).map((text) => ({ ...run, text })));
+    const tokens = [];
+    let token = [];
+    for (const [i, piece] of pieces.entries()) {
+        token = append(token, [piece]);
+        const next = pieces[i + 1]?.text ?? "";
+        if (!/^[\u2060\ufeff]/u.test(next) &&
+            (piece.text.endsWith(" ") || (cjk(piece.text) && cjk(next)))) {
+            tokens.push(token);
+            token = [];
+        }
+    }
+    if (token.length || !tokens.length)
+        tokens.push(token);
+    return tokens;
+}
+export function wrapTokensToRows(tokens, width, occupiedWidth) {
+    const rows = [];
+    let row = [];
+    for (const token of tokens) {
+        const candidate = append(row, token);
+        if (occupiedWidth(candidate) > width && row.length) {
+            rows.push(row);
+            row = [...token];
+        }
+        else
+            row = candidate;
+    }
+    rows.push(row);
+    return rows;
+}
+/** Optional preflight lookahead. The caller stops this iterator at its byte/work budget.
+ * Actual line fragments are shaped whole, never inferred from summed glyph advances.
+ */
+export function* wrappingAlternatives(tokens) {
+    for (let start = 0; start < tokens.length; start++) {
+        let row = [];
+        for (let end = start; end < tokens.length; end++) {
+            row = append(row, tokens[end]);
+            yield* row.filter((run) => !cinematicEffect(run));
+        }
+    }
+}
+//# sourceMappingURL=wrap.js.map

package/dist/layout/wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap.js","sourceRoot":"","sources":["../../src/layout/wrap.ts"],"names":[],"mappings":"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"}

package/dist/model/layout.d.ts

@@ -0,0 +1,112 @@
+import type { ExportOptions, SceneV1, TextStyle, Diagnostic } from "./types.js";
+export interface LayoutRequest {
+    readonly algorithm: "fit/v1";
+    readonly width: number;
+    readonly maxHeight: number;
+    readonly variant: "standard" | "compact" | "auto";
+    readonly overflow: "error" | "wrap" | "shrink" | "wrap-then-shrink";
+    readonly minFontSize: number;
+}
+export type OutputSizing = {
+    readonly mode: "fixed";
+    readonly width: number;
+} | {
+    readonly mode: "container-experimental";
+    readonly maxWidth: number;
+    readonly fillFraction?: number;
+};
+export type MeasurementQuality = "authored-geometry" | "measured-local-font" | "estimated";
+export interface PaintBounds {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** Text is shaped as a complete fragment. The key is validated against every field. */
+export interface TextMeasurementRequest {
+    readonly key: string;
+    readonly algorithm: "fit/v1";
+    readonly profile: string;
+    readonly text: string;
+    readonly style: TextStyle;
+    readonly italic: boolean;
+    readonly direction: "ltr" | "rtl";
+    readonly environment: string;
+}
+export interface TextMeasurement {
+    readonly request: TextMeasurementRequest;
+    readonly advance: number;
+    readonly inkLeft: number;
+    readonly inkRight: number;
+    readonly ascent: number;
+    readonly descent: number;
+}
+export interface MeasurementSnapshot {
+    readonly kind: "consoleFxMeasurements";
+    readonly measurementVersion: 1;
+    readonly environment: string;
+    readonly records: readonly TextMeasurement[];
+}
+export interface LayoutFragment {
+    readonly sourceLine: number;
+    readonly sourceRun: number;
+    readonly slot?: string;
+    readonly text: string;
+    readonly x: number;
+    readonly baseline: number;
+    readonly fontSize: number;
+    readonly advance: number;
+    readonly ink: PaintBounds;
+    readonly paint: PaintBounds;
+    readonly quality: MeasurementQuality;
+}
+export interface LayoutReport {
+    readonly algorithm: "fit/v1";
+    readonly profile: string;
+    readonly variant: "standard" | "compact";
+    readonly artboard: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly paint: PaintBounds;
+    readonly fragments: readonly LayoutFragment[];
+    readonly glyphBounds: readonly {
+        readonly sourceLine: number;
+        readonly sourceRun: number;
+        readonly index: number;
+        readonly ink: PaintBounds;
+    }[];
+    readonly visualRows: number;
+    readonly contentScale: number;
+    readonly displayScale: number | null;
+    readonly resolvedDisplayWidth: number | null;
+    readonly resolvedDisplayHeight: number | null;
+    readonly displayReadability: "meets-requested-floor" | "unknown";
+    readonly measurementQuality: MeasurementQuality;
+    readonly measurementEnvironment: string | null;
+    readonly verdict: "fits-under-recorded-conditions" | "estimated-fit";
+    readonly measurementRequests: readonly TextMeasurementRequest[];
+    readonly shapingRequests: number;
+    readonly shrinkCandidates: number;
+    readonly segmentation: "fit/v1-grapheme-space-cjk";
+    readonly blurTolerance: "3-sigma";
+    readonly diagnostics: readonly Diagnostic[];
+}
+export interface RenderRecipeV1 {
+    readonly kind: "consoleFxRenderRecipe";
+    readonly recipeVersion: 1;
+    readonly scene: SceneV1;
+    readonly options: Omit<ExportOptions, "measurements" | "measurementEnvironment">;
+}
+export interface OutputSizingReport {
+    readonly mode: "fixed" | "container-experimental";
+    readonly artboard: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly resolvedDisplayWidth: number | null;
+    readonly resolvedDisplayHeight: number | null;
+    readonly displayScale: number | null;
+    readonly displayReadability: "meets-requested-floor" | "meets-default-floor" | "unknown";
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/model/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/model/layout.ts"],"names":[],"mappings":"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"}

package/dist/model/layout.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=layout.js.map

package/dist/model/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/model/layout.ts"],"names":[],"mappings":""}

package/dist/model/limits.d.ts

@@ -0,0 +1,19 @@
+export declare const LIMITS: Readonly<{
+    inputBytes: number;
+    textCodePoints: 2000;
+    lines: 8;
+    runs: 32;
+    effectsPerRun: 4;
+    animatedGraphemes: 80;
+    svgWidth: 1200;
+    svgHeight: 400;
+    svgElements: 1000;
+    motionMs: 5000;
+    snippetWarningBytes: number;
+    snippetBytes: number;
+    shareBytes: number;
+    history: 100;
+}>;
+export declare function utf8ByteLength(value: string): number;
+export declare function deepFreeze<T>(value: T): T;
+//# sourceMappingURL=limits.d.ts.map

package/dist/model/limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.d.ts","sourceRoot":"","sources":["../../src/model/limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;EAejB,CAAC;AAEH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMzC"}

package/dist/model/limits.js

@@ -0,0 +1,28 @@
+export const LIMITS = Object.freeze({
+    inputBytes: 64 * 1024,
+    textCodePoints: 2000,
+    lines: 8,
+    runs: 32,
+    effectsPerRun: 4,
+    animatedGraphemes: 80,
+    svgWidth: 1200,
+    svgHeight: 400,
+    svgElements: 1000,
+    motionMs: 5000,
+    snippetWarningBytes: 32 * 1024,
+    snippetBytes: 128 * 1024,
+    shareBytes: 8 * 1024,
+    history: 100,
+});
+export function utf8ByteLength(value) {
+    return new TextEncoder().encode(value).byteLength;
+}
+export function deepFreeze(value) {
+    if (value !== null && typeof value === "object") {
+        for (const child of Object.values(value))
+            deepFreeze(child);
+        Object.freeze(value);
+    }
+    return value;
+}
+//# sourceMappingURL=limits.js.map

package/dist/model/limits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../src/model/limits.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,UAAU,EAAE,EAAE,GAAG,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,EAAE;IACR,aAAa,EAAE,CAAC;IAChB,iBAAiB,EAAE,EAAE;IACrB,QAAQ,EAAE,IAAI;IACd,SAAS,EAAE,GAAG;IACd,WAAW,EAAE,IAAI;IACjB,QAAQ,EAAE,IAAI;IACd,mBAAmB,EAAE,EAAE,GAAG,IAAI;IAC9B,YAAY,EAAE,GAAG,GAAG,IAAI;IACxB,UAAU,EAAE,CAAC,GAAG,IAAI;IACpB,OAAO,EAAE,GAAG;CACb,CAAC,CAAC;AAEH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,UAAU,CAAI,KAAQ;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;YAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/model/types.d.ts

@@ -0,0 +1,267 @@
+import type { LayoutRequest, OutputSizing, MeasurementSnapshot, LayoutReport, OutputSizingReport } from "./layout.js";
+export type * from "./layout.js";
+export type Renderer = "css" | "svg" | "text";
+export type Target = "chromium" | "firefox" | "safari" | "node" | "bun" | "unknown";
+export type FontFamily = "sans" | "mono" | "serif";
+export type CardPresetId = "buildReceipt" | "requestTrace" | "serviceReady" | "commandCard" | "releaseBulletin" | "blueprint" | "contourMap" | "letterpress" | "signalHalftone" | "orbital";
+export type PresentationProfile = `${CardPresetId}/v1`;
+export type StatusTone = "success" | "warning" | "error" | "neutral";
+export type PresetPresentationInput = {
+    readonly kind: "presetCard";
+    readonly accent?: string;
+    readonly detail?: "minimal" | "standard";
+} & ({
+    readonly profile: "requestTrace/v1";
+    readonly tone?: StatusTone;
+} | {
+    readonly profile: Exclude<PresentationProfile, "requestTrace/v1">;
+    readonly tone?: never;
+});
+export type PresetPresentation = {
+    readonly kind: "presetCard";
+    readonly accent: string;
+    readonly detail: "minimal" | "standard";
+} & ({
+    readonly profile: "requestTrace/v1";
+    readonly tone: StatusTone;
+} | {
+    readonly profile: Exclude<PresentationProfile, "requestTrace/v1">;
+    readonly tone?: never;
+});
+export type CinematicProfile = "lightning-metal-v1" | "ice-cathedral-v1" | "liquid-chrome-v1" | "molten-gold-v1";
+export interface CinematicMetalEffectInput {
+    readonly kind: "cinematicMetal";
+    readonly profile?: CinematicProfile;
+    readonly color?: string;
+    readonly depth?: number;
+    readonly glow?: number;
+    readonly ornaments?: boolean;
+}
+export type EffectInput = CinematicMetalEffectInput | {
+    readonly kind: "badge";
+    readonly color?: string;
+} | {
+    readonly kind: "neon";
+    readonly color?: string;
+    readonly intensity?: number;
+} | {
+    readonly kind: "rgbSplit";
+    readonly offset?: number;
+} | {
+    readonly kind: "extruded";
+    readonly depth?: number;
+    readonly color?: string;
+} | {
+    readonly kind: "holographic";
+    readonly intensity?: number;
+} | {
+    readonly kind: "metallic";
+    readonly variant?: "gold" | "chrome";
+} | {
+    readonly kind: "crt";
+    readonly intensity?: number;
+} | {
+    readonly kind: "rainbow";
+    readonly saturation?: number;
+} | {
+    readonly kind: "glowPulse";
+    readonly periodMs?: number;
+    readonly intensity?: number;
+} | {
+    readonly kind: "gradientDrift";
+    readonly periodMs?: number;
+    readonly distance?: number;
+} | {
+    readonly kind: "wave";
+    readonly amplitude?: number;
+    readonly periodMs?: number;
+} | {
+    readonly kind: "indicator";
+    readonly color?: string;
+    readonly periodMs?: number;
+};
+type WithDefaults<T> = T extends EffectInput ? Readonly<Required<T>> : never;
+export type Effect = WithDefaults<EffectInput>;
+export type EffectKind = Effect["kind"];
+export interface TextStyle {
+    readonly color: string;
+    readonly fontSize: number;
+    readonly fontWeight: number;
+    readonly fontFamily: FontFamily;
+    readonly letterSpacing: number;
+}
+export interface Surface {
+    readonly width: number;
+    readonly height: number;
+    readonly background: string;
+    readonly padding: number;
+    readonly borderRadius: number;
+}
+export interface RunInput {
+    readonly text: string;
+    readonly style?: Partial<TextStyle>;
+    readonly effects?: readonly EffectInput[];
+}
+export interface LineInput {
+    readonly align?: "left" | "center" | "right";
+    readonly runs: readonly RunInput[];
+}
+export interface SceneInputV1 {
+    readonly schemaVersion: 1;
+    readonly label: string;
+    readonly presentation?: PresetPresentationInput;
+    readonly surface?: Partial<Surface>;
+    readonly lines: readonly LineInput[];
+    readonly motion?: {
+        readonly durationMs?: number;
+        readonly finish?: "freeze";
+    };
+}
+export interface TextRun {
+    readonly text: string;
+    readonly style: TextStyle;
+    readonly effects: readonly Effect[];
+}
+export interface SceneLine {
+    readonly align: "left" | "center" | "right";
+    readonly runs: readonly TextRun[];
+}
+export interface SceneV1 {
+    readonly schemaVersion: 1;
+    readonly label: string;
+    readonly presentation?: PresetPresentation;
+    readonly surface: Surface;
+    readonly lines: readonly SceneLine[];
+    readonly motion: {
+        readonly durationMs: number;
+        readonly finish: "freeze";
+    };
+}
+export interface Diagnostic {
+    readonly code: string;
+    readonly severity: "info" | "warning" | "error";
+    readonly path: readonly (string | number)[];
+    readonly message: string;
+}
+export type ValidationResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+    readonly diagnostics: readonly Diagnostic[];
+} | {
+    readonly ok: false;
+    readonly diagnostics: readonly Diagnostic[];
+};
+export type ParameterDescriptor = {
+    readonly type: "number";
+    readonly default: number;
+    readonly min: number;
+    readonly max: number;
+    readonly step: number;
+} | {
+    readonly type: "color";
+    readonly default: string;
+} | {
+    readonly type: "boolean";
+    readonly default: boolean;
+} | {
+    readonly type: "enum";
+    readonly default: string;
+    readonly values: readonly string[];
+};
+export interface EffectDescriptor {
+    readonly kind: EffectKind;
+    readonly displayName: string;
+    readonly family: string;
+    readonly scopes: readonly ("run" | "surface")[];
+    readonly parameters: Readonly<Record<string, ParameterDescriptor>>;
+    readonly renderers: readonly Renderer[];
+    readonly motion: "static" | "decorative";
+}
+export interface PresentationSlot {
+    readonly id: string;
+    readonly label: string;
+    readonly line: number;
+    readonly run: number;
+    readonly style: TextStyle;
+    readonly x: number;
+    readonly y: number;
+    readonly anchor: "start" | "end";
+    readonly safeWidth: number;
+    readonly maxCodePoints: number;
+    readonly values?: readonly string[];
+    readonly editableStyleKeys?: readonly (keyof TextStyle)[];
+}
+export interface PresentationStatus {
+    readonly slot: string;
+    readonly source: "text" | "tone";
+    readonly palettes: Readonly<Record<string, {
+        readonly background: string;
+        readonly ink: string;
+        readonly marker: string;
+        readonly stroke: string;
+    }>>;
+}
+export interface PresentationDescriptor {
+    readonly id: CardPresetId;
+    readonly profile: PresentationProfile;
+    readonly name: string;
+    readonly group: "Useful" | "Artful";
+    readonly accent: string;
+    readonly background: string;
+    readonly rows: readonly number[];
+    readonly slots: readonly PresentationSlot[];
+    readonly renderers: readonly Renderer[];
+    readonly editableStyleKeys: readonly (keyof TextStyle)[];
+    readonly parameters: Readonly<Record<string, ParameterDescriptor>>;
+    readonly accentGeometry: readonly string[];
+    readonly status?: PresentationStatus;
+}
+export type ConsoleArgs = readonly [format: string, ...values: string[]];
+export type CompiledPreview = {
+    readonly kind: "css";
+    readonly lines: readonly {
+        readonly runs: readonly {
+            readonly text: string;
+            readonly style: Readonly<Record<string, string>>;
+        }[];
+    }[];
+} | {
+    readonly kind: "svg";
+    readonly imageUri: string;
+    readonly width: number;
+    readonly height: number;
+    readonly alt: string;
+} | {
+    readonly kind: "text";
+    readonly text: string;
+};
+export interface CompileOptions {
+    readonly target?: Target;
+    readonly renderer?: Renderer;
+    readonly motion?: "allow" | "reduce";
+    readonly unsupported?: "error" | "fallback";
+    readonly layout?: LayoutRequest;
+    readonly sizing?: OutputSizing;
+    readonly measurements?: MeasurementSnapshot;
+    readonly measurementEnvironment?: string;
+}
+export interface CompiledConsole {
+    readonly args: ConsoleArgs;
+    readonly renderer: Renderer;
+    readonly text: string;
+    readonly animated: boolean;
+    readonly byteLength: number;
+    readonly preview: CompiledPreview;
+    readonly diagnostics: readonly Diagnostic[];
+    readonly layout?: LayoutReport;
+    readonly outputSizing?: OutputSizingReport;
+}
+export interface ExportOptions extends Omit<CompileOptions, "motion"> {
+    readonly motion?: "system" | "reduce";
+}
+export interface ExportedConsole {
+    readonly code: string;
+    readonly byteLength: number;
+    readonly diagnostics: readonly Diagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map