@grahlnn/comps 0.1.0

package/dist/torph/index.d.ts

@@ -0,0 +1 @@
+export * from "./src/components/Torph";

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

@@ -0,0 +1,102 @@
+import { type CSSProperties } from "react";
+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;
+    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;
+    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 measureMorphSnapshotFromLayer(text: string, renderText: string, segments: readonly MorphSegment[], layer: HTMLElement | null): MorphSnapshot;
+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 resolveVisibleFlowText(pendingBootstrapText: string | null, committedMeasurement: MorphMeasurement | null, stateMeasurement: MorphMeasurement | null, text: string): string;
+export declare function resolveActivationBootstrapText(isActivated: boolean, previousText: string, nextText: string): string | null;
+export declare function Torph({ text, className, }: {
+    text: string;
+    className?: string;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/torph/src/utils/text-layout/pretext.d.ts

@@ -0,0 +1,2 @@
+export { clearCache, layout, layoutNextLine, layoutWithLines, prepare, prepareWithSegments, profilePrepare, setLocale, walkLineRanges, type LayoutCursor, type LayoutLine, type LayoutLineRange, type LayoutLinesResult, type LayoutResult, type PrepareOptions, type PrepareProfile, type PreparedText, type PreparedTextWithSegments, } from "../../vendor/pretext/layout.js";
+export type { AnalysisChunk, SegmentBreakKind, TextAnalysis, WhiteSpaceMode, } from "../../vendor/pretext/analysis.js";

package/dist/torph/src/utils/text-layout/pretextMorph.d.ts

@@ -0,0 +1,37 @@
+export type PretextMorphWhiteSpace = "normal" | "nowrap" | "pre-wrap";
+export type PretextMorphMeasurementBackend = "pretext" | "probe" | "dom";
+export type PretextMorphLayoutContext = {
+    display: string;
+    font: string;
+    lineHeightPx: number;
+    parentDisplay: string;
+    whiteSpace: PretextMorphWhiteSpace;
+    width: number;
+    direction: string;
+    textTransform: string;
+    letterSpacingPx: number;
+    wordSpacingPx: number;
+    fontFeatureSettings: string;
+    fontVariationSettings: string;
+};
+export type PretextMorphCharacterLayout = {
+    glyph: string;
+    key: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+export type PretextMorphSnapshot = {
+    text: string;
+    renderText: string;
+    width: number;
+    height: number;
+    graphemes: PretextMorphCharacterLayout[];
+};
+export declare function clearPretextMorphCaches(): void;
+export declare function getPretextMorphRenderedText(text: string, layoutContext: Pick<PretextMorphLayoutContext, "whiteSpace"> | null): string;
+export declare function getPretextMorphStyleSignature(layoutContext: PretextMorphLayoutContext | null): string | null;
+export declare function getPretextMorphMeasurementBackend(text: string, layoutContext: PretextMorphLayoutContext | null): PretextMorphMeasurementBackend;
+export declare function canUsePretextMorphFastPath(text: string, layoutContext: PretextMorphLayoutContext | null): boolean;
+export declare function measureMorphSnapshotWithPretext(text: string, layoutContext: PretextMorphLayoutContext): PretextMorphSnapshot;

package/dist/torph/src/vendor/pretext/analysis.d.ts

@@ -0,0 +1,31 @@
+export type WhiteSpaceMode = "normal" | "pre-wrap";
+export type SegmentBreakKind = "text" | "space" | "preserved-space" | "tab" | "glue" | "zero-width-break" | "soft-hyphen" | "hard-break";
+export type MergedSegmentation = {
+    len: number;
+    texts: string[];
+    isWordLike: boolean[];
+    kinds: SegmentBreakKind[];
+    starts: number[];
+};
+export type AnalysisChunk = {
+    startSegmentIndex: number;
+    endSegmentIndex: number;
+    consumedEndSegmentIndex: number;
+};
+export type TextAnalysis = {
+    normalized: string;
+    chunks: AnalysisChunk[];
+} & MergedSegmentation;
+export type AnalysisProfile = {
+    carryCJKAfterClosingQuote: boolean;
+};
+export declare function normalizeWhitespaceNormal(text: string): string;
+export declare function normalizeWhitespacePreWrap(text: string): string;
+export declare function clearAnalysisCaches(): void;
+export declare function setAnalysisLocale(locale?: string): void;
+export declare function isCJK(s: string): boolean;
+export declare const kinsokuStart: Set<string>;
+export declare const kinsokuEnd: Set<string>;
+export declare const leftStickyPunctuation: Set<string>;
+export declare function endsWithClosingQuote(text: string): boolean;
+export declare function analyzeText(text: string, profile: AnalysisProfile, whiteSpace?: WhiteSpaceMode): TextAnalysis;

package/dist/torph/src/vendor/pretext/bidi.d.ts

@@ -0,0 +1 @@
+export declare function computeSegmentLevels(normalized: string, segStarts: number[]): Int8Array | null;

package/dist/torph/src/vendor/pretext/layout.d.ts

@@ -0,0 +1,70 @@
+import { type SegmentBreakKind, type WhiteSpaceMode } from './analysis.js';
+declare const preparedTextBrand: unique symbol;
+type PreparedCore = {
+    widths: number[];
+    lineEndFitAdvances: number[];
+    lineEndPaintAdvances: number[];
+    kinds: SegmentBreakKind[];
+    simpleLineWalkFastPath: boolean;
+    segLevels: Int8Array | null;
+    breakableWidths: (number[] | null)[];
+    breakablePrefixWidths: (number[] | null)[];
+    discretionaryHyphenWidth: number;
+    tabStopAdvance: number;
+    chunks: PreparedLineChunk[];
+};
+export type PreparedText = {
+    readonly [preparedTextBrand]: true;
+};
+type InternalPreparedText = PreparedText & PreparedCore;
+export type PreparedTextWithSegments = InternalPreparedText & {
+    segments: string[];
+};
+export type LayoutCursor = {
+    segmentIndex: number;
+    graphemeIndex: number;
+};
+export type LayoutResult = {
+    lineCount: number;
+    height: number;
+};
+export type LayoutLine = {
+    text: string;
+    width: number;
+    start: LayoutCursor;
+    end: LayoutCursor;
+};
+export type LayoutLineRange = {
+    width: number;
+    start: LayoutCursor;
+    end: LayoutCursor;
+};
+export type LayoutLinesResult = LayoutResult & {
+    lines: LayoutLine[];
+};
+export type PrepareProfile = {
+    analysisMs: number;
+    measureMs: number;
+    totalMs: number;
+    analysisSegments: number;
+    preparedSegments: number;
+    breakableSegments: number;
+};
+export type PrepareOptions = {
+    whiteSpace?: WhiteSpaceMode;
+};
+export type PreparedLineChunk = {
+    startSegmentIndex: number;
+    endSegmentIndex: number;
+    consumedEndSegmentIndex: number;
+};
+export declare function profilePrepare(text: string, font: string, options?: PrepareOptions): PrepareProfile;
+export declare function prepare(text: string, font: string, options?: PrepareOptions): PreparedText;
+export declare function prepareWithSegments(text: string, font: string, options?: PrepareOptions): PreparedTextWithSegments;
+export declare function layout(prepared: PreparedText, maxWidth: number, lineHeight: number): LayoutResult;
+export declare function walkLineRanges(prepared: PreparedTextWithSegments, maxWidth: number, onLine: (line: LayoutLineRange) => void): number;
+export declare function layoutNextLine(prepared: PreparedTextWithSegments, start: LayoutCursor, maxWidth: number): LayoutLine | null;
+export declare function layoutWithLines(prepared: PreparedTextWithSegments, maxWidth: number, lineHeight: number): LayoutLinesResult;
+export declare function clearCache(): void;
+export declare function setLocale(locale?: string): void;
+export {};

package/dist/torph/src/vendor/pretext/line-break.d.ts

@@ -0,0 +1,32 @@
+import type { SegmentBreakKind } from './analysis.js';
+export type LineBreakCursor = {
+    segmentIndex: number;
+    graphemeIndex: number;
+};
+export type PreparedLineBreakData = {
+    widths: number[];
+    lineEndFitAdvances: number[];
+    lineEndPaintAdvances: number[];
+    kinds: SegmentBreakKind[];
+    simpleLineWalkFastPath: boolean;
+    breakableWidths: (number[] | null)[];
+    breakablePrefixWidths: (number[] | null)[];
+    discretionaryHyphenWidth: number;
+    tabStopAdvance: number;
+    chunks: {
+        startSegmentIndex: number;
+        endSegmentIndex: number;
+        consumedEndSegmentIndex: number;
+    }[];
+};
+export type InternalLayoutLine = {
+    startSegmentIndex: number;
+    startGraphemeIndex: number;
+    endSegmentIndex: number;
+    endGraphemeIndex: number;
+    width: number;
+};
+export declare function normalizeLineStart(prepared: PreparedLineBreakData, start: LineBreakCursor): LineBreakCursor | null;
+export declare function countPreparedLines(prepared: PreparedLineBreakData, maxWidth: number): number;
+export declare function walkPreparedLines(prepared: PreparedLineBreakData, maxWidth: number, onLine?: (line: InternalLayoutLine) => void): number;
+export declare function layoutNextLineRange(prepared: PreparedLineBreakData, start: LineBreakCursor, maxWidth: number): InternalLayoutLine | null;

package/dist/torph/src/vendor/pretext/measurement.d.ts

@@ -0,0 +1,28 @@
+export type SegmentMetrics = {
+    width: number;
+    containsCJK: boolean;
+    emojiCount?: number;
+    graphemeWidths?: number[] | null;
+    graphemePrefixWidths?: number[] | null;
+};
+export type EngineProfile = {
+    lineFitEpsilon: number;
+    carryCJKAfterClosingQuote: boolean;
+    preferPrefixWidthsForBreakableRuns: boolean;
+    preferEarlySoftHyphenBreak: boolean;
+};
+export declare function getMeasureContext(): CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D;
+export declare function getSegmentMetricCache(font: string): Map<string, SegmentMetrics>;
+export declare function getSegmentMetrics(seg: string, cache: Map<string, SegmentMetrics>): SegmentMetrics;
+export declare function getEngineProfile(): EngineProfile;
+export declare function parseFontSize(font: string): number;
+export declare function textMayContainEmoji(text: string): boolean;
+export declare function getCorrectedSegmentWidth(seg: string, metrics: SegmentMetrics, emojiCorrection: number): number;
+export declare function getSegmentGraphemeWidths(seg: string, metrics: SegmentMetrics, cache: Map<string, SegmentMetrics>, emojiCorrection: number): number[] | null;
+export declare function getSegmentGraphemePrefixWidths(seg: string, metrics: SegmentMetrics, cache: Map<string, SegmentMetrics>, emojiCorrection: number): number[] | null;
+export declare function getFontMeasurementState(font: string, needsEmojiCorrection: boolean): {
+    cache: Map<string, SegmentMetrics>;
+    fontSize: number;
+    emojiCorrection: number;
+};
+export declare function clearMeasurementCaches(): void;

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@grahlnn/comps",
+  "version": "0.1.0",
+  "description": "React components from grahlnn/comps.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "torph/src/vendor/pretext/LICENSE",
+    "torph/src/vendor/pretext/NOTICE.md"
+  ],
+  "scripts": {
+    "build": "bun run build:js && bun run build:types",
+    "build:js": "bun build ./index.ts --outdir ./dist --format esm --target browser --external react --external react/jsx-runtime",
+    "build:types": "tsc -p tsconfig.build.json",
+    "prepublishOnly": "bun run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/react": "^19.2.14"
+  },
+  "peerDependencies": {
+    "react": "^19.2.4",
+    "typescript": "^5"
+  }
+}

package/torph/src/vendor/pretext/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pretext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/torph/src/vendor/pretext/NOTICE.md

@@ -0,0 +1,11 @@
+Vendored from `C:\Users\admin\pretext` under the MIT license.
+
+Upstream files copied here:
+- `src/analysis.ts`
+- `src/bidi.ts`
+- `src/layout.ts`
+- `src/line-break.ts`
+- `src/measurement.ts`
+
+Local project code should import through `src/utils/text-layout/pretext.ts`
+instead of importing these vendor files directly.