@grahlnn/comps 0.1.8 → 0.1.9

package/dist/torph/index.d.ts

@@ -1 +1,2 @@
-export * from "./src/components/Torph";
+export { Torph } from "./src/components/Torph";
+export type { TorphProps } from "./src/components/Torph";

package/dist/torph/src/components/Torph.d.ts

@@ -1,114 +1,5 @@
-import { type CSSProperties } from "react";
-import { type PretextMorphMeasurementBackend } from "../utils/text-layout/pretextMorph";
-export type SupportedWhiteSpace = "normal" | "nowrap" | "pre-wrap";
-export type MorphCharacterLayout = {
-    glyph: string;
-    key: string;
-    left: number;
-    top: number;
-    width: number;
-    height: number;
-};
-export type MorphSnapshot = {
-    text: string;
-    renderText: string;
-    width: number;
-    height: number;
-    graphemes: MorphCharacterLayout[];
-};
-export type MorphMeasurement = {
-    snapshot: MorphSnapshot;
-    layoutInlineSize: number;
-    reservedInlineSize: number | null;
-    flowInlineSize: number | null;
-    rootOrigin: {
-        left: number;
-        top: number;
-    };
-};
-export type MorphVisualBridge = {
-    offsetX: number;
-    offsetY: number;
-};
-export type MorphLiveItem = MorphCharacterLayout & {
-    kind: "move" | "enter";
-    fromLeft: number | null;
-    fromTop: number | null;
-};
-export type MorphRenderPlan = {
-    frameWidth: number;
-    frameHeight: number;
-    layoutInlineSizeFrom: number;
-    layoutInlineSizeTo: number;
-    sourceRenderText: string;
-    targetRenderText: string;
-    visualBridge: MorphVisualBridge;
-    liveItems: MorphLiveItem[];
-    exitItems: MorphCharacterLayout[];
-};
-type LayoutContext = {
-    display: string;
-    direction: string;
-    font: string;
-    fontFeatureSettings: string;
-    fontVariationSettings: string;
-    letterSpacingPx: number;
-    lineHeightPx: number;
-    parentDisplay: string;
-    textTransform: string;
-    whiteSpace: SupportedWhiteSpace;
-    width: number;
-    wordSpacingPx: number;
-    measurementVersion: number;
-};
-type MorphSegment = {
-    glyph: string;
-    key: string;
-};
-type MorphStage = "idle" | "prepare" | "animate";
-type GlyphMove = {
-    kind: "move";
-    from: MorphCharacterLayout;
-    to: MorphCharacterLayout;
-};
-type GlyphEnter = {
-    kind: "enter";
-    to: MorphCharacterLayout;
-};
-type GlyphExit = {
-    kind: "exit";
-    from: MorphCharacterLayout;
-};
-type GlyphPairing = GlyphMove | GlyphEnter | GlyphExit;
-export declare function needsMeasurementLayer(measurementBackend: PretextMorphMeasurementBackend, renderText: string): boolean;
-export declare function measureMorphSnapshotFromLayer(text: string, renderText: string, segments: readonly MorphSegment[], layer: HTMLElement | null): MorphSnapshot;
-export declare function resolveContentWidthLockInlineSize(layoutHint: MorphMeasurement): number;
-export declare function shouldHealIdleMeasurementFromFlow(measurement: MorphMeasurement, flowLineCount: number | null): boolean;
-export declare function refineMeasurementWithLiveGeometry(measurement: MorphMeasurement, liveGeometry: {
-    flowInlineSize: number | null;
-    rootOrigin: {
-        left: number;
-        top: number;
-    };
-}): MorphMeasurement;
-export declare function pairMorphCharacters(previous: MorphCharacterLayout[], next: MorphCharacterLayout[]): GlyphPairing[];
-export declare function resolveMorphFrameBounds(previous: MorphSnapshot, next: MorphSnapshot): {
-    width: number;
-    height: number;
-};
-export declare function buildMorphVisualBridge(previous: MorphMeasurement, next: MorphMeasurement): MorphVisualBridge;
-export declare function buildMorphPlan(previous: MorphMeasurement, next: MorphMeasurement, visualBridge?: MorphVisualBridge): MorphRenderPlan;
-export declare function getLiveTransform(item: MorphLiveItem, stage: MorphStage, visualBridge: MorphVisualBridge): string;
-export declare function getLiveTransition(item: MorphLiveItem, stage: MorphStage): string | undefined;
-export declare function getExitTransform(visualBridge: MorphVisualBridge): string;
-export declare function getExitTransition(stage: MorphStage): string | undefined;
-export declare function supportsIntrinsicWidthLock(display: string, parentDisplay: string): boolean;
-export declare function getRootDisplay(layoutContext: LayoutContext | null): "grid" | "inline-grid";
-export declare function getRootStyle(stage: MorphStage, plan: MorphRenderPlan | null, measurement: MorphMeasurement | null, layoutContext: LayoutContext | null): CSSProperties;
-export declare function getMeasurementLayerStyle(layoutContext: LayoutContext | null, useContentInlineSize?: boolean): CSSProperties;
-export declare function resolveFlowText(committedMeasurement: MorphMeasurement | null, stateMeasurement: MorphMeasurement | null, text: string): string;
-export declare function Torph({ text, className, }: {
+export type TorphProps = {
     text: string;
     className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export {};
+};
+export declare function Torph({ text, className, }: TorphProps): import("react/jsx-runtime").JSX.Element;

package/dist/torph/src/core/dom-measurement.d.ts

@@ -0,0 +1,42 @@
+import { type PretextMorphMeasurementBackend } from "../utils/text-layout/pretextMorph";
+import { type LayoutContext, type MorphMeasurement, type MorphSegment, type MorphSnapshot } from "./types";
+export type SnapshotDrift = {
+    comparedGlyphs: number;
+    expectedGlyphs: number;
+    actualGlyphs: number;
+    maxAbsLeftDelta: number;
+    maxAbsTopDelta: number;
+    maxAbsWidthDelta: number;
+    maxAbsHeightDelta: number;
+    snapshotWidthDelta: number;
+    snapshotHeightDelta: number;
+    mismatches: Array<{
+        index: number;
+        glyph: string;
+        leftDelta: number;
+        topDelta: number;
+        widthDelta: number;
+        heightDelta: number;
+    }>;
+};
+export declare function readCachedMorphSnapshot(cache: Map<string, MorphSnapshot>, cacheKey: string): MorphSnapshot | null;
+export declare function rememberCachedMorphSnapshot(cache: Map<string, MorphSnapshot>, cacheKey: string, snapshot: MorphSnapshot): void;
+export declare function measureMorphSnapshotFromLayer(text: string, renderText: string, segments: readonly MorphSegment[], layer: HTMLElement | null): MorphSnapshot;
+export declare function readRootOrigin(node: HTMLElement): {
+    left: number;
+    top: number;
+};
+export declare function measureLiveFlowSnapshot(root: HTMLElement, flowTextNode: HTMLSpanElement): MorphSnapshot | null;
+export declare function measureSnapshotDrift(expected: MorphSnapshot, actual: MorphSnapshot): SnapshotDrift;
+export declare function measureOverlayBoxSnapshot(root: HTMLElement, overlayRoot: HTMLElement, role: "live" | "exit"): MorphSnapshot | null;
+export declare function measureFromNodes({ root, layoutContext, layoutHint, layer, measurementBackend, snapshotOverride, text, renderText, segments, }: {
+    root: HTMLElement;
+    layoutContext: LayoutContext;
+    layoutHint: MorphMeasurement | null;
+    layer: HTMLElement | null;
+    measurementBackend: PretextMorphMeasurementBackend;
+    snapshotOverride: MorphSnapshot | null;
+    text: string;
+    renderText: string;
+    segments: readonly MorphSegment[];
+}): MorphMeasurement;

package/dist/torph/src/core/finalize-barrier.d.ts

@@ -0,0 +1,13 @@
+export type MorphFinalizeSignal = "live-transform";
+export type MorphFinalizeBarrier = {
+    waitForLiveTransform: boolean;
+    sawLiveTransform: boolean;
+};
+export declare function createMorphFinalizeBarrier(hasMoveTransitions: boolean): MorphFinalizeBarrier;
+export declare function recordMorphFinalizeSignal(barrier: MorphFinalizeBarrier, signal: MorphFinalizeSignal): MorphFinalizeBarrier;
+export declare function isMorphFinalizeBarrierSatisfied(barrier: MorphFinalizeBarrier): boolean;
+export declare function summarizeMorphFinalizeBarrier(barrier: MorphFinalizeBarrier): {
+    waitForLiveTransform: boolean;
+    sawLiveTransform: boolean;
+    satisfied: boolean;
+};

package/dist/torph/src/core/layout-observer.d.ts

@@ -0,0 +1,8 @@
+import { type LayoutContext } from "./types";
+export declare function readFont(styles: CSSStyleDeclaration): string;
+export declare function notifyMorphMeasurementInvalidationSubscribers(): void;
+export declare function subscribeMorphMeasurementInvalidation(subscriber: () => void): () => void;
+export declare function useObservedLayoutContext<T extends HTMLElement>(deps: readonly unknown[]): {
+    ref: import("react").RefObject<T | null>;
+    layoutContext: LayoutContext | null;
+};

package/dist/torph/src/core/math.d.ts

@@ -0,0 +1 @@
+export declare function nearlyEqual(a: number, b: number, epsilon?: number): boolean;

package/dist/torph/src/core/measurement-policy.d.ts

@@ -0,0 +1,23 @@
+import { type PretextMorphMeasurementBackend } from "../utils/text-layout/pretextMorph";
+import { type LayoutContext, type MorphMeasurement, type MorphMeasurementRequest, type MorphSegment, type MorphSnapshot } from "./types";
+export declare function clearPretextMorphTrustCache(): void;
+export declare function clearMorphMeasurementCaches(): void;
+export declare function bumpMorphMeasurementEpoch(): void;
+export declare function getMorphMeasurementEpoch(): number;
+export declare function readCachedMorphSegments(text: string): readonly MorphSegment[];
+export declare function shouldMeasureUsingContentInlineSize(layoutContext: LayoutContext, layoutHint: MorphMeasurement | null): boolean;
+export declare function getTrustedPretextMeasurementBackend(text: string, renderText: string, layoutContext: LayoutContext, useContentInlineSize: boolean): PretextMorphMeasurementBackend;
+export declare function needsMeasurementLayer(measurementBackend: PretextMorphMeasurementBackend, renderText: string): boolean;
+export declare function canCacheMeasurementLayerSnapshot(measurementBackend: PretextMorphMeasurementBackend | null): measurementBackend is "dom";
+export declare function createMorphMeasurementRequest({ text, layoutContext, layoutHint, }: {
+    text: string;
+    layoutContext: LayoutContext | null;
+    layoutHint: MorphMeasurement | null;
+}): MorphMeasurementRequest | null;
+export declare function rememberPretextMeasurementTrust({ renderText, layoutContext, useContentInlineSize, trusted, }: {
+    renderText: string;
+    layoutContext: LayoutContext;
+    useContentInlineSize: boolean;
+    trusted: boolean;
+}): void;
+export declare function areSnapshotsEquivalentForPretextTrust(left: MorphSnapshot, right: MorphSnapshot): boolean;

package/dist/torph/src/core/render.d.ts

@@ -0,0 +1,16 @@
+import type { CSSProperties } from "react";
+import { type LayoutContext, type MorphLiveItem, type MorphMeasurement, type MorphRenderPlan, type MorphSnapshot, type MorphStage, type MorphVisualBridge } from "./types";
+export declare function getFadeDuration(fraction: number): number;
+export declare function getOverlayStyle(stage: MorphStage, plan: MorphRenderPlan): CSSProperties;
+export declare function getLiveTransform(item: MorphLiveItem, stage: MorphStage, visualBridge: MorphVisualBridge): string;
+export declare function getLiveTransition(item: MorphLiveItem, stage: MorphStage): string | undefined;
+export declare function getExitTransform(visualBridge: MorphVisualBridge): string;
+export declare function getExitTransition(stage: MorphStage): string | undefined;
+export declare function supportsIntrinsicWidthLock(display: string, parentDisplay: string): boolean;
+export declare function getRootDisplay(layoutContext: LayoutContext | null): "grid" | "inline-grid";
+export declare function getRootStyle(stage: MorphStage, plan: MorphRenderPlan | null, measurement: MorphMeasurement | null, layoutContext: LayoutContext | null): CSSProperties;
+export declare function getMeasurementLayerStyle(layoutContext: LayoutContext | null, useContentInlineSize?: boolean): CSSProperties;
+export declare function resolveFlowText(committedMeasurement: MorphMeasurement | null, stateMeasurement: MorphMeasurement | null, text: string): string;
+export declare function shouldRenderGlyphLayer(stage: MorphStage, plan: MorphRenderPlan | null, measurement: MorphMeasurement | null): boolean;
+export declare function resolveGlyphSliceWhiteSpace(snapshot: MorphSnapshot | null): "inherit" | "nowrap";
+export declare function createSteadyGlyphPlan(measurement: MorphMeasurement): MorphRenderPlan;

package/dist/torph/src/core/root-motion-bridge.d.ts

@@ -0,0 +1,6 @@
+export type RootMotionBridge = {
+    sourceLeft: number;
+    settledLeft: number;
+};
+export declare function resolveRootMotionBridgeBaseOffsetX(bridge: RootMotionBridge): number;
+export declare function resolveRootMotionBridgeOverlayOffsetX(bridge: RootMotionBridge, currentLeft: number): number;

package/dist/torph/src/core/session.d.ts

@@ -0,0 +1,81 @@
+import type { Dispatch, SetStateAction } from "react";
+import { type MorphCharacterLayout, type MorphMeasurement, type MorphRenderPlan, type MorphSession, type MorphState, type MorphTimeline, type MorphVisualBridge } from "./types";
+type GlyphMove = {
+    kind: "move";
+    from: MorphCharacterLayout;
+    to: MorphCharacterLayout;
+};
+type GlyphEnter = {
+    kind: "enter";
+    to: MorphCharacterLayout;
+};
+type GlyphExit = {
+    kind: "exit";
+    from: MorphCharacterLayout;
+};
+type GlyphPairing = GlyphMove | GlyphEnter | GlyphExit;
+export type MorphSessionDecision = {
+    kind: "freeze-animating-target";
+    target: MorphMeasurement;
+} | {
+    kind: "commit-static";
+    measurement: MorphMeasurement;
+} | {
+    kind: "start-morph";
+    source: MorphMeasurement;
+    target: MorphMeasurement;
+};
+export declare function pairMorphCharacters(previous: MorphCharacterLayout[], next: MorphCharacterLayout[]): GlyphPairing[];
+export declare function resolveMorphFrameBounds(previous: MorphMeasurement["snapshot"], next: MorphMeasurement["snapshot"]): {
+    width: number;
+    height: number;
+};
+export declare function buildMorphPlan(previous: MorphMeasurement, next: MorphMeasurement, visualBridge?: MorphVisualBridge): MorphRenderPlan;
+export declare function sameMeasurement(a: MorphMeasurement, b: MorphMeasurement): boolean;
+export declare function selectMorphLayoutHint(session: MorphSession): MorphMeasurement | null;
+export declare function decideMorphSessionUpdate({ committed, target, animating, nextMeasurement, fontsReady, }: {
+    committed: MorphMeasurement | null;
+    target: MorphMeasurement | null;
+    animating: boolean;
+    nextMeasurement: MorphMeasurement;
+    fontsReady: boolean;
+}): MorphSessionDecision;
+export declare function areFontsReady(): boolean;
+export declare function cancelTimeline(timeline: MorphTimeline): void;
+export declare function resetMorph(session: MorphSession, timeline: MorphTimeline, setState: (state: MorphState) => void): void;
+export declare function commitStaticMeasurement(session: MorphSession, measurement: MorphMeasurement, setState: Dispatch<SetStateAction<MorphState>>): void;
+export declare function applyMorphSessionDecision({ decision, session, timeline, setState, }: {
+    decision: MorphSessionDecision;
+    session: MorphSession;
+    timeline: MorphTimeline;
+    setState: Dispatch<SetStateAction<MorphState>>;
+}): MorphMeasurement;
+export declare function reconcileMorphSessionUpdate({ session, timeline, nextMeasurement, fontsReady, setState, }: {
+    session: MorphSession;
+    timeline: MorphTimeline;
+    nextMeasurement: MorphMeasurement;
+    fontsReady: boolean;
+    setState: Dispatch<SetStateAction<MorphState>>;
+}): MorphMeasurement;
+export declare function finalizeMorphTransition({ session, timeline, measurement, setState, }: {
+    session: MorphSession;
+    timeline: MorphTimeline;
+    measurement: MorphMeasurement;
+    setState: Dispatch<SetStateAction<MorphState>>;
+}): void;
+export declare function resolvePreparedMeasurementOrigin(measurement: MorphMeasurement, origin: {
+    left: number;
+    top: number;
+}): MorphMeasurement;
+export declare function resolvePreparedPlanVisualBridge(plan: MorphRenderPlan, origin: {
+    left: number;
+    top: number;
+}): MorphRenderPlan;
+export declare function startMorph({ source, target, session, timeline, setState, }: {
+    source: MorphMeasurement;
+    target: MorphMeasurement;
+    session: MorphSession;
+    timeline: MorphTimeline;
+    setState: Dispatch<SetStateAction<MorphState>>;
+}): void;
+export {};

package/dist/torph/src/core/snapshot.d.ts

@@ -0,0 +1,3 @@
+import { type MorphSnapshot } from "./types";
+export declare function isSingleLineSnapshot(snapshot: MorphSnapshot): boolean;
+export declare function assertSingleLineSnapshot(snapshot: MorphSnapshot): MorphSnapshot;

package/dist/torph/src/core/types.d.ts

@@ -0,0 +1,108 @@
+import type { PretextMorphMeasurementBackend } from "../utils/text-layout/pretextMorph";
+export declare const MORPH: {
+    readonly durationMs: 280;
+    readonly maxFadeMs: 150;
+    readonly ease: "cubic-bezier(0.22, 1, 0.36, 1)";
+    readonly geometryEpsilon: 0.5;
+    readonly contentWidthLockEpsilon: 2;
+    readonly lineGroupingEpsilon: 1;
+};
+export type SupportedWhiteSpace = "normal" | "nowrap" | "pre-wrap";
+export type MorphCharacterLayout = {
+    glyph: string;
+    key: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+export type MorphSnapshot = {
+    text: string;
+    renderText: string;
+    width: number;
+    height: number;
+    graphemes: MorphCharacterLayout[];
+};
+export type MorphMeasurement = {
+    snapshot: MorphSnapshot;
+    layoutInlineSize: number;
+    reservedInlineSize: number | null;
+    flowInlineSize: number | null;
+    rootOrigin: {
+        left: number;
+        top: number;
+    };
+};
+export type MorphVisualBridge = {
+    offsetX: number;
+    offsetY: number;
+};
+export type MorphLiveItem = MorphCharacterLayout & {
+    kind: "move" | "enter";
+    fromLeft: number | null;
+    fromTop: number | null;
+};
+export type MorphRenderPlan = {
+    frameWidth: number;
+    frameHeight: number;
+    layoutInlineSizeFrom: number;
+    layoutInlineSizeTo: number;
+    sourceRenderText: string;
+    targetRenderText: string;
+    sourceRootOrigin: {
+        left: number;
+        top: number;
+    };
+    visualBridge: MorphVisualBridge;
+    liveItems: MorphLiveItem[];
+    exitItems: MorphCharacterLayout[];
+};
+export type LayoutContext = {
+    display: string;
+    direction: string;
+    font: string;
+    fontFeatureSettings: string;
+    fontVariationSettings: string;
+    letterSpacingPx: number;
+    lineHeightPx: number;
+    parentDisplay: string;
+    textTransform: string;
+    whiteSpace: SupportedWhiteSpace;
+    width: number;
+    wordSpacingPx: number;
+    measurementVersion: number;
+};
+export type MorphSegment = {
+    glyph: string;
+    key: string;
+};
+export type MorphStage = "idle" | "prepare" | "animate";
+export type MorphState = {
+    stage: MorphStage;
+    measurement: MorphMeasurement | null;
+    plan: MorphRenderPlan | null;
+};
+export type MorphSession = {
+    committed: MorphMeasurement | null;
+    target: MorphMeasurement | null;
+    animating: boolean;
+};
+export type MorphTimeline = {
+    prepareFrame: number | null;
+    animateFrame: number | null;
+    finalizeTimer: number | null;
+};
+export type MorphMeasurementRequest = {
+    text: string;
+    renderText: string;
+    segments: readonly MorphSegment[];
+    measurementBackend: PretextMorphMeasurementBackend;
+    useContentInlineSize: boolean;
+    domMeasurementKey: string | null;
+};
+export declare const EMPTY_STATE: MorphState;
+export declare const EMPTY_SESSION: MorphSession;
+export declare const EMPTY_TIMELINE: MorphTimeline;
+export declare const ZERO_BRIDGE: MorphVisualBridge;
+export declare const EMPTY_SEGMENTS: readonly MorphSegment[];
+export declare function resolveContentWidthLockInlineSize(layoutHint: MorphMeasurement): number;

package/dist/torph/src/debug/trace.d.ts

@@ -0,0 +1,121 @@
+import type { LayoutContext, MorphMeasurement, MorphSnapshot } from "../core/types";
+export type TorphDebugConfig = boolean | {
+    enabled?: boolean;
+    capture?: boolean;
+    console?: boolean;
+};
+type TorphTraceApi = {
+    clear: () => void;
+    count: () => number;
+    download: (filename?: string) => string | null;
+    text: () => string;
+};
+export type SnapshotDrift = {
+    comparedGlyphs: number;
+    expectedGlyphs: number;
+    actualGlyphs: number;
+    maxAbsLeftDelta: number;
+    maxAbsTopDelta: number;
+    maxAbsWidthDelta: number;
+    maxAbsHeightDelta: number;
+    snapshotWidthDelta: number;
+    snapshotHeightDelta: number;
+    mismatches: Array<{
+        index: number;
+        glyph: string;
+        leftDelta: number;
+        topDelta: number;
+        widthDelta: number;
+        heightDelta: number;
+    }>;
+};
+export declare const TORPH_TRACE_SCHEMA_VERSION = 7;
+export declare function nextTorphDebugInstanceId(): number;
+export declare function readTorphDebugConfig(): TorphDebugConfig | null;
+export declare function shouldCaptureTorphTrace(config: TorphDebugConfig | null): boolean;
+export declare function isTorphDebugEnabled(config: TorphDebugConfig | null): boolean;
+export declare function shouldRunTorphInstrumentation(config: TorphDebugConfig | null): boolean;
+export declare function ensureTorphTraceApi(): TorphTraceApi;
+export declare function roundDebugValue(value: number | null | undefined): number | null | undefined;
+export declare function summarizeDebugSnapshot(snapshot: MorphSnapshot | null): {
+    text: string;
+    renderText: string;
+    width: number | null | undefined;
+    height: number | null | undefined;
+    graphemes: number;
+} | null;
+export declare function summarizeDebugGlyphs(snapshot: MorphSnapshot | null): {
+    index: number;
+    glyph: string;
+    key: string;
+    left: number | null | undefined;
+    top: number | null | undefined;
+    width: number | null | undefined;
+    height: number | null | undefined;
+}[] | null;
+export declare function summarizeDebugMeasurement(measurement: MorphMeasurement | null): {
+    layoutInlineSize: number | null | undefined;
+    reservedInlineSize: number | null | undefined;
+    flowInlineSize: number | null | undefined;
+    rootOrigin: {
+        left: number | null | undefined;
+        top: number | null | undefined;
+    };
+    snapshot: {
+        text: string;
+        renderText: string;
+        width: number | null | undefined;
+        height: number | null | undefined;
+        graphemes: number;
+    } | null;
+} | null;
+export declare function summarizeDebugLayoutContext(layoutContext: LayoutContext | null): {
+    display: string;
+    parentDisplay: string;
+    whiteSpace: import("../core/types").SupportedWhiteSpace;
+    width: number | null | undefined;
+    measurementVersion: number;
+} | null;
+export declare function summarizeDebugRect(rect: DOMRect | null): {
+    left: number | null | undefined;
+    top: number | null | undefined;
+    width: number | null | undefined;
+    height: number | null | undefined;
+} | null;
+export declare function summarizeDebugViewportAnchors(snapshot: MorphSnapshot | null, rootRect: DOMRect | null): {
+    index: number;
+    glyph: string;
+    left: number | null | undefined;
+    top: number | null | undefined;
+    width: number | null | undefined;
+    height: number | null | undefined;
+}[] | null;
+export declare function summarizeDebugRootOriginDrift(measurement: MorphMeasurement | null, rootRect: DOMRect | null): {
+    expectedLeft: number | null | undefined;
+    expectedTop: number | null | undefined;
+    actualLeft: number | null | undefined;
+    actualTop: number | null | undefined;
+    deltaLeft: number | null | undefined;
+    deltaTop: number | null | undefined;
+} | null;
+export declare function summarizeSnapshotDrift(drift: SnapshotDrift): {
+    comparedGlyphs: number;
+    expectedGlyphs: number;
+    actualGlyphs: number;
+    snapshotWidthDelta: number | null | undefined;
+    snapshotHeightDelta: number | null | undefined;
+    maxAbsLeftDelta: number | null | undefined;
+    maxAbsTopDelta: number | null | undefined;
+    maxAbsWidthDelta: number | null | undefined;
+    maxAbsHeightDelta: number | null | undefined;
+    mismatches: {
+        index: number;
+        glyph: string;
+        leftDelta: number | null | undefined;
+        topDelta: number | null | undefined;
+        widthDelta: number | null | undefined;
+        heightDelta: number | null | undefined;
+    }[];
+};
+export declare function logTorphDebug(instanceId: number, event: string, payload: Record<string, unknown>): void;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grahlnn/comps",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "React components from grahlnn/comps.",
   "main": "./dist/index.js",
   "module": "./dist/index.js",