@motionscript/code 0.1.0-alpha.0 → 0.1.0-alpha.10

package/dist/node.d.ts

@@ -1,37 +1,9 @@
-import { RenderContext2D, RenderPass2D, Clip, EasingFunction, NodeConfig, Size2D, SizeConstraints, Node2D, Node2DProps, MeasureContext2D, InsetsResolved, InsetsProps, type AssetScope, type Command, type CommandArgs, type Node, type TweenStepper, type Vector2 } from "@motionscript/core";
-import { CodeRange, type CodeDiffStrategy, type CodePhaseStrategy, CodeTheme } from "./engine.js";
+import { type NodeOf, type NormalizedColor, type Color as _Color, type Node2D as _Node2D, type Node2DProps as _Node2DProps } from "@motionscript/sdk";
+import { type CodeDiffStrategy, type CodePhaseStrategy, type CodeRange, type CodeTheme, type DimTransition, type IdLine, type RowBand, type RowsTransition, type StructuralTransition } from "./engine.js";
 /**
- * A listing and nothing else — no paint slots, and no box behind the tokens.
- *
- * It did carry a `fill`/`overlay`/`stroke`/`shadow` set and the corner radius
- * that shaped them, so a block could draw its own panel. That was one node doing
- * two jobs, and the second one is a `Rect`'s: a listing set on a card is a `Code`
- * inside a hugging `Rect`, which tracks the block's size for the same reason
- * every other hugging container tracks its child's. What is left here is the
- * listing — its source, how it is coloured, the face it is set in, and the space
- * it keeps around itself.
- */
-export interface CodeProps extends Node2DProps {
-    code: string;
-    language: string;
-    fontSize: number;
-    fontFamily: string;
-    /** A built-in/registered theme name (e.g. `'github-dark'`), or a {@link CodeHighlightStyle} object. */
-    theme: CodeTheme;
-    lineHeight: number;
-    letterSpacing: number;
-    showLineNumbers: boolean;
-    lineNumberGap: number;
-    padding: InsetsProps;
-}
-/**
- * Construction-time-only options: pluggable engine behavior, set once when
- * the node is created. Deliberately *not* part of {@link CodeProps} — every
- * `@property` field accepts either a value or a zero-arg reactive binding
- * (`value | (() => value)`, see `PropInputs`), and the node's own reactive
- * write path (`_writeProp`) treats any function value as the latter. A
- * strategy *is* a function, so it can't be told apart from a binding that
- * computes one — it has to stay outside the reactive prop system entirely.
+ * Which token became which across an edit, and when each part of it happens.
+ * Arguments of {@link defineCode}: a strategy is a function, which a prop would
+ * take for a binding, so it is part of the component's definition instead.
  */
 export interface CodeStrategies {
     /** Decides which token became which across an edit. Defaults to `defaultCodeDiff`. */
@@ -39,255 +11,277 @@ export interface CodeStrategies {
     /** Decides when (in normalized transition time) each part of an edit happens. Defaults to `defaultCodePhases`. */
     phaseStrategy?: CodePhaseStrategy;
 }
-export declare class Code extends Node2D<CodeProps> {
-    readonly code: string;
+/** `code` part-way through a `to({ code })`: the source it leaves, the one it lands on, and how far along it is, eased. */
+export interface CodeBlend {
+    readonly from: string;
+    readonly to: string;
+    readonly t: number;
+}
+/** What `code` holds: a source, or a {@link CodeBlend} while a `to({ code })` runs. */
+export type CodeSource = string | CodeBlend;
+/** A range argument: one range, several, or a chain that went through JSON as `{ list }`. */
+export type CodeTarget = CodeRange | Iterable<CodeRange> | {
+    readonly list: CodeRange[];
+};
+/** What a structure was tokenized with: the grammar, the theme and whether the grammar had landed. */
+export interface CodeTokenBasis {
     readonly language: string;
-    readonly fontFamily: string;
     readonly theme: CodeTheme;
-    readonly fontSize: number;
-    readonly lineHeight: number;
-    readonly letterSpacing: number;
-    readonly showLineNumbers: boolean;
-    readonly lineNumberGap: number;
-    readonly padding: InsetsResolved;
-    /** The settled structure. During an edit, the structure the edit lands on. */
-    private tokenLines;
-    private tokenized;
-    private transitions;
-    private advanceCache;
-    private structureVersion;
-    private layoutCacheKey;
-    private layoutCache;
-    private highlightDimOpacity;
-    private highlightedIds;
-    /**
-     * Which token became which across an edit, and when each part of that
-     * edit happens. Construction-time-only (see {@link CodeStrategies}) —
-     * resolved once here rather than left as `?? defaultX` at every call site.
-     */
-    private readonly diffStrategy;
-    private readonly phaseStrategy;
-    constructor(props: NodeConfig<Code, CodeProps> & CodeStrategies);
-    set(props: {
-        [K in keyof CodeProps]?: CodeProps[K] | (() => CodeProps[K]);
-    }): void;
-    private tokenize;
-    /**
-     * Swap in a new settled structure, invalidating the layout cache.
-     *
-     * The one place `tokenLines` is written, because the cache key is a version
-     * counter rather than a hash of the content — a write that skipped the bump
-     * would keep serving the previous frame's geometry for the new listing.
-     */
-    private setLines;
-    /**
-     * The monospaced face this block measures and draws with, and the syntax
-     * grammar it tokenizes with.
-     *
-     * Both belong to *layout*: token x positions are measured against the face,
-     * and how many tokens there are depends on the grammar. Declared here, the
-     * grammar goes on the timeline as an ordinary asset: `AssetManager.loadAt`
-     * waits for it before the frame is laid out, so the first measurement is the
-     * right one. Nothing is freed on eviction — parsers are cheap to keep
-     * resident. The loader touches no node: `renderContent` re-tokenizes once
-     * the grammar is there.
-     */
-    declareAssets(assets: AssetScope): void;
-    private metrics;
-    /** The structural edit currently in flight, if any. */
-    private activeEdit;
-    private settledLayout;
-    /**
-     * The one or two layouts this frame is drawn from.
-     *
-     * A settled frame has one. A frame inside an edit has two — where every
-     * token was, and where it is going — and the frame is a point between them.
-     * That is the whole reason an insert no longer piles its glyphs at the left
-     * margin: a token's destination is *computed*, not approximated by collapsing
-     * the advance of everything around it.
-     *
-     * Both endpoints are fixed for the edit's duration, so they are built once
-     * and cached on the transition rather than rebuilt per frame.
-     */
-    private frameLayout;
-    measure(constraints: SizeConstraints, scope: MeasureContext2D): Partial<Size2D>;
-    protected renderContent(ctx: RenderPass2D): void;
-    protected renderSelf(ctx: RenderContext2D): void;
-    /** A listing holds a listing — `append`/`insert`/`erase` are how it grows. */
-    protected acceptsChild(_child: Node): boolean;
-    /**
-     * The node's laid-out rect as a clip outline, so `clip` and any backdrop
-     * effect are confined to the block rather than to nothing — a listing set on
-     * a card is exactly where a backdrop blur is asked for.
-     */
-    protected clipSelf(): Clip;
-    /**
-     * A listing is grabbed by its **text**, line by ragged line, rather than by
-     * the rectangle the lines were laid out in.
-     *
-     * The default narrows a node's grab region to the outline it declares, and
-     * this node's outline is a box it no longer paints anything into. Code is
-     * mostly whitespace: a ten-line snippet with one long line is a rectangle
-     * that is largely empty, and in an editor every one of those empty pixels
-     * swallows a click meant for whatever sits behind or beneath it. Short of the
-     * text itself there is nothing there to have clicked.
-     *
-     * So the region is the union of the lines' own extents — each a line-height
-     * slot as wide as that line's ink — plus the gutter where line numbers are
-     * showing, since those are drawn glyphs too.
-     *
-     * Answered from the **cached** layout, which is what the last frame drew
-     * from, because a hit test arrives with no measurement scope and text cannot
-     * be measured without one. Where there is no usable cache — before the first
-     * frame, or mid-edit, when the geometry is an interpolation of two structures
-     * held on the transition — the box is the honest answer rather than a
-     * silhouette measured against stale metrics.
-     */
-    protected hitTestSelf(local: Vector2, tolerance: number): boolean;
-    /**
-     * The layout a hit test may be answered from: the settled cache, and only
-     * while it still matches the node's current metrics.
-     *
-     * The key is the one {@link settledLayout} writes minus its scope-dependent
-     * half — every input to it (`metricsSignature`, the advance cache's own
-     * signature) is readable without a measurer, which is precisely what makes
-     * the check possible here.
-     */
-    private hitLayout;
-    /**
-     * Append `code` to the end of the listing.
-     *
-     * Stated as *what the source becomes*; {@link editTo} works out the rest —
-     * which is why appending a line that closes a block re-highlights the lines
-     * above it, instead of colouring the new text as its own program.
-     */
-    append(args: CommandArgs<{
-        code: string;
-    }> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /** Insert `code` above the listing. */
-    prepend(args: CommandArgs<{
-        code: string;
-    }> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /**
-     * Insert `code` at the given (line, col). Both are 1-indexed; col is the
-     * column BEFORE which the new content is inserted (col=1 means start of
-     * line). If `code` contains newlines, new lines are created in the middle
-     * of the existing line.
-     */
-    insert(args: CommandArgs<{
-        position: [number, number];
-        code: string;
-    }> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /**
-     * Erase the code in `codeRange`.
-     *
-     * Named `erase` rather than `remove` because a `Code` is also a node, and
-     * `Node.remove(child)` takes a child out of the tree. Two methods spelled
-     * the same on one object, doing entirely different things, is worse than one
-     * of them having a slightly less obvious name.
-     *
-     * A range that covers whole lines takes their line breaks with it, so the
-     * rows below close up; a range inside a line takes only the characters, and
-     * the rest of the line reflows around the hole.
-     */
-    erase(args: CommandArgs<{
-        target: CodeRange;
-    }> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /** Replace the code in `codeRange` with `replacement`. */
-    replace(args: CommandArgs<{
-        target: CodeRange;
-        replacement: string;
-    }> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /**
-     * Highlight a range of code — or several at once (e.g.
-     * `CodeRanges.lines(2).word(5, 1, 3)`) — highlighted as one set: tokens
-     * within any of the ranges stay at opacity 1, tokens outside dim to
-     * `dim`. Persistent — call resetHighlight() to undo, or call highlight()
-     * again with a different range to cross-fade.
-     */
-    highlight(args: CommandArgs<{
-        target: CodeRange | Iterable<CodeRange>;
-        dim?: number;
-    }> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /**
-     * Fade all dimmed tokens back to opacity 1 and clear the persistent
-     * highlight state.
-     */
-    resetHighlight(args: CommandArgs<Record<string, never>> & {
-        duration: number;
-    }): Command<Record<string, never>>;
-    /**
-     * Animate the listing to a new source.
-     *
-     * The engine behind every editing command, and behind `to({ code })`. Every
-     * edit is expressed as the source it produces, tokenized, and then *diffed*
-     * against what is on screen — so a token that survived the edit keeps its
-     * identity and simply travels to its new column, and only what genuinely
-     * changed is faded.
-     *
-     * The result runs in three phases (see `phaseStrategy`): what is leaving
-     * fades out, what stays reflows, and only then does what is new arrive.
-     * Playing them together is what made a replacement read as a cross-dissolve
-     * of two unrelated listings rather than as an edit being made.
-     */
-    private editTo;
-    /**
-     * Put a dim transition on the stack, drive its progress, take it off and
-     * commit at the end.
-     *
-     * A {@link Command} rather than a generator, which is what makes a listing
-     * scrubbable: membership is a function of `t` (on the stack for `0 < t < 1`,
-     * off it outside), `settle(done)` replaces the `finally` and takes *which
-     * way*, and `progress` is assigned from `t` rather than accumulated.
-     */
-    private runDim;
-    /**
-     * Route a tweened `code` through the diff engine.
-     *
-     * `to({ code })` is the form an author reaches for first — it is how every
-     * other prop is animated — and a bare string prop would otherwise land in the
-     * generic tween's discrete-snap bucket and simply cut at the end. Intercepted
-     * here it becomes the same three-phase edit the named commands produce, while
-     * the rest of the step's props tween alongside it untouched.
-     */
-    _prepareStep(to: Partial<CodeProps>, duration: number, easing?: EasingFunction): TweenStepper;
-    /**
-     * Find every range matching the literal string `text` in the current
-     * source. Multi-line matches are supported.
-     */
-    findAllRanges(text: string): CodeRange[];
-    /** Find the `index`th range matching `text`. Returns null if not found. */
-    findRangeAt(text: string, index: number): CodeRange | null;
-    /** Find the first range matching `text`. Returns null if not found. */
-    findFirstRange(text: string): CodeRange | null;
-    private joinedSource;
-    private lineLengths;
-    /** Character offset of a 1-indexed (line, col), clamped into the document. */
-    private offsetAt;
-    /**
-     * Resolve one or more CodeRanges to the set of token ids whose content
-     * overlaps any of them. Tokens that partially overlap are included.
-     */
-    private tokenIdsInRanges;
-    /**
-     * Thin delegator: everything about *how* a frame is painted (settled or
-     * mid structural-edit, entry/exit motion, colour cross-fade) lives in
-     * `drawCode` (the engine's `render.ts`) as a pure function over plain
-     * state — this just gathers that state from the node's own instance
-     * fields and caches.
-     */
-    protected drawSelf(draw: RenderContext2D): void;
+    readonly highlighted: boolean;
+}
+/** A listing a command left behind: its source, its tokens, and the basis they were made on. */
+export interface CodeListing {
+    readonly source: string;
+    readonly lines: IdLine[];
+    readonly basis: CodeTokenBasis;
+}
+export interface CodeEditFrame {
+    readonly transition: StructuralTransition;
+    readonly progress: number;
 }
+/** The dim `highlight` leaves: what stays bright, what the rest dims to, and the cross-fade in flight. */
+export interface CodeFocus {
+    readonly dim: number | null;
+    readonly ids: Set<number>;
+    readonly fade: DimTransition | null;
+}
+export interface CodeBanding {
+    readonly bands: RowBand[];
+    readonly fade: RowsTransition | null;
+}
+/**
+ * A `Code` whose edits are paired and timed by `strategies`. {@link Code} is
+ * the one with the defaults; a project wanting another hands its own to the
+ * engine in its place (the key is the same).
+ *
+ * A listing and nothing else: no paint slots, and no box behind the tokens. A
+ * listing set on a card is a `Code` inside a hugging `Rect`.
+ */
+export declare function defineCode(strategies?: CodeStrategies): import("@motionscript/sdk").Component<"code", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly code: import("@motionscript/sdk").Type<string, CodeSource, false>;
+    readonly language: "typescript";
+    readonly fontFamily: "Fira Mono";
+    /** A built-in or registered theme name (e.g. `'github-dark'`), or a `CodeHighlightStyle` object. */
+    readonly theme: import("@motionscript/sdk").Type<CodeTheme, CodeTheme, false>;
+    readonly fontSize: 16;
+    readonly lineHeight: 1.6;
+    readonly letterSpacing: 1.1;
+    readonly showLineNumbers: false;
+    readonly lineNumberGap: 2;
+    readonly listing: import("@motionscript/sdk").Type<CodeListing | null, CodeListing | null, true>;
+    readonly edit: import("@motionscript/sdk").Type<CodeEditFrame | null, CodeEditFrame | null, true>;
+    readonly focus: import("@motionscript/sdk").Type<CodeFocus, CodeFocus, true>;
+    readonly banding: import("@motionscript/sdk").Type<CodeBanding, CodeBanding, true>;
+}>, {
+    readonly append: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly prepend: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly insert: {
+        readonly position: import("@motionscript/sdk").Type<[number, number] | undefined, [number, number] | undefined, false>;
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly remove: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+    };
+    readonly replace: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly replacement: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly highlight: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly dim: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetHighlight: unknown;
+    readonly highlightRows: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly color: import("@motionscript/sdk").Type<_Color, NormalizedColor, false>;
+        readonly radius: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetRowHighlight: unknown;
+}, readonly [], _Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly code: import("@motionscript/sdk").Type<string, CodeSource, false>;
+    readonly language: "typescript";
+    readonly fontFamily: "Fira Mono";
+    /** A built-in or registered theme name (e.g. `'github-dark'`), or a `CodeHighlightStyle` object. */
+    readonly theme: import("@motionscript/sdk").Type<CodeTheme, CodeTheme, false>;
+    readonly fontSize: 16;
+    readonly lineHeight: 1.6;
+    readonly letterSpacing: 1.1;
+    readonly showLineNumbers: false;
+    readonly lineNumberGap: 2;
+    readonly listing: import("@motionscript/sdk").Type<CodeListing | null, CodeListing | null, true>;
+    readonly edit: import("@motionscript/sdk").Type<CodeEditFrame | null, CodeEditFrame | null, true>;
+    readonly focus: import("@motionscript/sdk").Type<CodeFocus, CodeFocus, true>;
+    readonly banding: import("@motionscript/sdk").Type<CodeBanding, CodeBanding, true>;
+}>, readonly [], import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly code: import("@motionscript/sdk").Type<string, CodeSource, false>;
+    readonly language: "typescript";
+    readonly fontFamily: "Fira Mono";
+    /** A built-in or registered theme name (e.g. `'github-dark'`), or a `CodeHighlightStyle` object. */
+    readonly theme: import("@motionscript/sdk").Type<CodeTheme, CodeTheme, false>;
+    readonly fontSize: 16;
+    readonly lineHeight: 1.6;
+    readonly letterSpacing: 1.1;
+    readonly showLineNumbers: false;
+    readonly lineNumberGap: 2;
+    readonly listing: import("@motionscript/sdk").Type<CodeListing | null, CodeListing | null, true>;
+    readonly edit: import("@motionscript/sdk").Type<CodeEditFrame | null, CodeEditFrame | null, true>;
+    readonly focus: import("@motionscript/sdk").Type<CodeFocus, CodeFocus, true>;
+    readonly banding: import("@motionscript/sdk").Type<CodeBanding, CodeBanding, true>;
+}>, {
+    readonly append: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly prepend: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly insert: {
+        readonly position: import("@motionscript/sdk").Type<[number, number] | undefined, [number, number] | undefined, false>;
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly remove: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+    };
+    readonly replace: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly replacement: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly highlight: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly dim: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetHighlight: unknown;
+    readonly highlightRows: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly color: import("@motionscript/sdk").Type<_Color, NormalizedColor, false>;
+        readonly radius: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetRowHighlight: unknown;
+}, _Node2D<_Node2DProps>>>>;
+/**
+ * A syntax-highlighted listing whose edits animate token by token: each edit
+ * is diffed against what is on screen, so a token that survives travels to
+ * its new column and only what changed fades.
+ */
+export declare const Code: import("@motionscript/sdk").Component<"code", import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly code: import("@motionscript/sdk").Type<string, CodeSource, false>;
+    readonly language: "typescript";
+    readonly fontFamily: "Fira Mono";
+    /** A built-in or registered theme name (e.g. `'github-dark'`), or a `CodeHighlightStyle` object. */
+    readonly theme: import("@motionscript/sdk").Type<CodeTheme, CodeTheme, false>;
+    readonly fontSize: 16;
+    readonly lineHeight: 1.6;
+    readonly letterSpacing: 1.1;
+    readonly showLineNumbers: false;
+    readonly lineNumberGap: 2;
+    readonly listing: import("@motionscript/sdk").Type<CodeListing | null, CodeListing | null, true>;
+    readonly edit: import("@motionscript/sdk").Type<CodeEditFrame | null, CodeEditFrame | null, true>;
+    readonly focus: import("@motionscript/sdk").Type<CodeFocus, CodeFocus, true>;
+    readonly banding: import("@motionscript/sdk").Type<CodeBanding, CodeBanding, true>;
+}>, {
+    readonly append: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly prepend: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly insert: {
+        readonly position: import("@motionscript/sdk").Type<[number, number] | undefined, [number, number] | undefined, false>;
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly remove: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+    };
+    readonly replace: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly replacement: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly highlight: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly dim: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetHighlight: unknown;
+    readonly highlightRows: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly color: import("@motionscript/sdk").Type<_Color, NormalizedColor, false>;
+        readonly radius: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetRowHighlight: unknown;
+}, readonly [], _Node2D<_Node2DProps>, import("@motionscript/sdk").CallProps<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly code: import("@motionscript/sdk").Type<string, CodeSource, false>;
+    readonly language: "typescript";
+    readonly fontFamily: "Fira Mono";
+    /** A built-in or registered theme name (e.g. `'github-dark'`), or a `CodeHighlightStyle` object. */
+    readonly theme: import("@motionscript/sdk").Type<CodeTheme, CodeTheme, false>;
+    readonly fontSize: 16;
+    readonly lineHeight: 1.6;
+    readonly letterSpacing: 1.1;
+    readonly showLineNumbers: false;
+    readonly lineNumberGap: 2;
+    readonly listing: import("@motionscript/sdk").Type<CodeListing | null, CodeListing | null, true>;
+    readonly edit: import("@motionscript/sdk").Type<CodeEditFrame | null, CodeEditFrame | null, true>;
+    readonly focus: import("@motionscript/sdk").Type<CodeFocus, CodeFocus, true>;
+    readonly banding: import("@motionscript/sdk").Type<CodeBanding, CodeBanding, true>;
+}>, readonly [], import("@motionscript/sdk").BuiltNode<import("@motionscript/sdk").Merge<import("@motionscript/sdk").Box2DState, {
+    readonly code: import("@motionscript/sdk").Type<string, CodeSource, false>;
+    readonly language: "typescript";
+    readonly fontFamily: "Fira Mono";
+    /** A built-in or registered theme name (e.g. `'github-dark'`), or a `CodeHighlightStyle` object. */
+    readonly theme: import("@motionscript/sdk").Type<CodeTheme, CodeTheme, false>;
+    readonly fontSize: 16;
+    readonly lineHeight: 1.6;
+    readonly letterSpacing: 1.1;
+    readonly showLineNumbers: false;
+    readonly lineNumberGap: 2;
+    readonly listing: import("@motionscript/sdk").Type<CodeListing | null, CodeListing | null, true>;
+    readonly edit: import("@motionscript/sdk").Type<CodeEditFrame | null, CodeEditFrame | null, true>;
+    readonly focus: import("@motionscript/sdk").Type<CodeFocus, CodeFocus, true>;
+    readonly banding: import("@motionscript/sdk").Type<CodeBanding, CodeBanding, true>;
+}>, {
+    readonly append: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly prepend: {
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly insert: {
+        readonly position: import("@motionscript/sdk").Type<[number, number] | undefined, [number, number] | undefined, false>;
+        readonly code: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly remove: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+    };
+    readonly replace: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly replacement: import("@motionscript/sdk").Type<string, string, false>;
+    };
+    readonly highlight: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly dim: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetHighlight: unknown;
+    readonly highlightRows: {
+        readonly target: import("@motionscript/sdk").Type<CodeTarget | undefined, CodeTarget | undefined, false>;
+        readonly color: import("@motionscript/sdk").Type<_Color, NormalizedColor, false>;
+        readonly radius: import("@motionscript/sdk").Type<number, number, false>;
+    };
+    readonly resetRowHighlight: unknown;
+}, _Node2D<_Node2DProps>>>>;
+export type Code = NodeOf<typeof Code>;
+export type CodeProps = NonNullable<Parameters<typeof Code>[0]>;
+/** What a listing shows now: its source, its token rows, and the edit in flight, if any. */
+export declare function listingOf(code: Code): {
+    readonly source: string;
+    readonly lines: readonly IdLine[];
+    readonly edit: StructuralTransition | null;
+};
+/** Every range matching the literal `text` in `source`, in order and not overlapping. Multi-line matches are found too. */
+export declare function findAllRanges(source: CodeSource, text: string): CodeRange[];
+/** The `index`th range matching `text`, or `null`. */
+export declare function findRangeAt(source: CodeSource, text: string, index: number): CodeRange | null;
+/** The first range matching `text`, or `null`. */
+export declare function findFirstRange(source: CodeSource, text: string): CodeRange | null;
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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