@almadar/ui 6.8.0 → 6.9.0

package/dist/{cn-sgpqpN0U.d.ts → cn-C7fvp9gH.d.ts}

@@ -9,23 +9,50 @@ import { ClassValue } from 'clsx';
  * E2); this module only computes offsets and text.
  *
  * Caret convention: an integer offset in `[0, text.length]`, a gap position
- * (matches `textarea.selectionStart`) — except `word-end` and `line-end`,
- * which land ON the index of their target character (vim's `e`/`$` block-
- * cursor convention), so `motionRange` widens those by one to make an
- * operator's range inclusive of that char.
+ * (matches `textarea.selectionStart`) — except `word-end`, `line-end` and
+ * `match-bracket`, which land ON the index of their target character (vim's
+ * `e`/`$`/`%` block-cursor convention), so `motionRange` widens those by one
+ * to make an operator's range inclusive of that char.
+ *
+ * `EDITOR_MOTIONS` / `EDITOR_OPERATORS` are the single source of truth for
+ * the closed vocabularies — `CodeBlock.tsx`'s `motions`/`operators` prop
+ * defaults must list the same members (kept as JSON literals there for the
+ * pattern-registry parser; `test/CodeBlock.editable.test.tsx` asserts they
+ * stay in sync).
  */
-type EditorMotion = 'left' | 'right' | 'up' | 'down' | 'word-forward' | 'word-back' | 'word-end' | 'line-start' | 'line-end' | 'first-nonblank' | 'doc-start' | 'doc-end' | 'paragraph-forward' | 'paragraph-back' | 'line' | 'selection';
-type EditorOperator = 'delete' | 'yank' | 'change';
+declare const EDITOR_MOTIONS: readonly ["left", "right", "up", "down", "word-forward", "word-back", "word-end", "line-start", "line-end", "first-nonblank", "doc-start", "doc-end", "paragraph-forward", "paragraph-back", "line", "selection", "match-bracket"];
+type EditorMotion = (typeof EDITOR_MOTIONS)[number];
+declare const EDITOR_OPERATORS: readonly ["delete", "yank", "change", "put", "put-before", "undo", "redo", "join", "toggle-case", "indent", "dedent", "replace"];
+type EditorOperator = (typeof EDITOR_OPERATORS)[number];
+declare function isEditorMotion(value: string): value is EditorMotion;
+declare function isEditorOperator(value: string): value is EditorOperator;
+/** Fixed indent unit for the `indent`/`dedent` operators (two spaces). */
+declare const INDENT_UNIT = "  ";
 /** New caret offset after applying `motion` `count` times. `line`/`selection` are range-only — caret is unchanged. */
 declare function applyMotion(text: string, caret: number, motion: EditorMotion, count: number): number;
 /** The `[start, end)` range an operator acts on for `motion`. */
 declare function motionRange(text: string, caret: number, motion: EditorMotion, count: number, selection?: [number, number]): [number, number];
-/** Apply `operator` over `range`. `delete`/`change` remove and store; `yank` only stores. */
-declare function applyOperator(text: string, range: [number, number], operator: EditorOperator, register: string): {
+interface ApplyOperatorInput {
     text: string;
+    /** `textarea.selectionStart` at the time the operator fired — the anchor for caret-based operators (put/put-before/join) that don't act over `range`. */
     caret: number;
+    /** The `[start, end)` range from `motionRange` — the anchor for range-based operators (delete/yank/change/toggle-case/indent/dedent/replace). */
+    range: [number, number];
+    operator: EditorOperator;
+    /** The motion paired with this operator. `change` special-cases `line`; delete/yank/change use it to set the returned `registerLinewise`. */
+    motion: EditorMotion;
+    count: number;
     register: string;
-};
+    registerLinewise: boolean;
+}
+interface ApplyOperatorResult {
+    text: string;
+    caret: number;
+    register: string;
+    registerLinewise: boolean;
+}
+/** Apply `operator`. `undo`/`redo` never reach here — they're history-stack operations handled by `useEditorCapabilities`. */
+declare function applyOperator(input: ApplyOperatorInput): ApplyOperatorResult;
 
 /**
  * Content Segment Parsing Utilities
@@ -400,4 +427,4 @@ declare function clearVerification(): void;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type BloomLevel as $, getTraitSnapshots as A, getTransitions as B, type ContentSegment as C, DEFAULT_CONFIG as D, type EditorMotion as E, getTransitionsForTrait as F, motionRange as G, parseContentSegments as H, parseLessonSegments as I, parseMarkdownWithCodeBlocks$1 as J, recordServerResponse as K, type LessonSegment as L, recordTransition as M, registerCheck as N, registerTraitSnapshot as O, renderStateMachineToDomData as P, renderStateMachineToSvg as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, subscribeToVerification as U, type VisualizerConfig as V, updateAssetStatus as W, updateBridgeHealth as X, updateCheck as Y, waitForTransition as Z, type InteractiveOrbitalType as _, type DomEntityBox as a, BloomQuizBlock as a0, type BloomQuizBlockProps as a1, type MixedSegment as a2, parseMarkdownWithCodeBlocks as a3, type DomLayoutData as b, type DomOutputsBox as c, type DomStateNode as d, type DomTransitionLabel as e, type DomTransitionPath as f, type EditorOperator as g, type EntityDefinition as h, type StateMachineDefinition as i, type TransitionDefinition as j, applyMotion as k, applyOperator as l, bindCanvasCapture as m, bindEventBus as n, bindLastDrawables as o, bindTraitStateGetter as p, clearVerification as q, cn as r, extractOutputsFromTransitions as s, extractStateMachine as t, formatGuard as u, getAllChecks as v, getBridgeHealth as w, getEffectSummary as x, getSnapshot as y, getSummary as z };
+export { renderStateMachineToSvg as $, type ApplyOperatorInput as A, getEffectSummary as B, type ContentSegment as C, DEFAULT_CONFIG as D, EDITOR_MOTIONS as E, getSnapshot as F, getSummary as G, getTraitSnapshots as H, INDENT_UNIT as I, getTransitions as J, getTransitionsForTrait as K, type LessonSegment as L, isEditorMotion as M, isEditorOperator as N, motionRange as O, parseContentSegments as P, parseLessonSegments as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, parseMarkdownWithCodeBlocks$1 as U, type VisualizerConfig as V, recordServerResponse as W, recordTransition as X, registerCheck as Y, registerTraitSnapshot as Z, renderStateMachineToDomData as _, type ApplyOperatorResult as a, subscribeToVerification as a0, updateAssetStatus as a1, updateBridgeHealth as a2, updateCheck as a3, waitForTransition as a4, type InteractiveOrbitalType as a5, type BloomLevel as a6, BloomQuizBlock as a7, type BloomQuizBlockProps as a8, type MixedSegment as a9, parseMarkdownWithCodeBlocks as aa, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, EDITOR_OPERATORS as h, type EditorMotion as i, type EditorOperator as j, type EntityDefinition as k, type StateMachineDefinition as l, type TransitionDefinition as m, applyMotion as n, applyOperator as o, bindCanvasCapture as p, bindEventBus as q, bindLastDrawables as r, bindTraitStateGetter as s, clearVerification as t, cn as u, extractOutputsFromTransitions as v, extractStateMachine as w, formatGuard as x, getAllChecks as y, getBridgeHealth as z };

package/dist/{cn-CCjFspAo.d.cts → cn-DnLYahyL.d.cts}

@@ -9,23 +9,50 @@ import { ClassValue } from 'clsx';
  * E2); this module only computes offsets and text.
  *
  * Caret convention: an integer offset in `[0, text.length]`, a gap position
- * (matches `textarea.selectionStart`) — except `word-end` and `line-end`,
- * which land ON the index of their target character (vim's `e`/`$` block-
- * cursor convention), so `motionRange` widens those by one to make an
- * operator's range inclusive of that char.
+ * (matches `textarea.selectionStart`) — except `word-end`, `line-end` and
+ * `match-bracket`, which land ON the index of their target character (vim's
+ * `e`/`$`/`%` block-cursor convention), so `motionRange` widens those by one
+ * to make an operator's range inclusive of that char.
+ *
+ * `EDITOR_MOTIONS` / `EDITOR_OPERATORS` are the single source of truth for
+ * the closed vocabularies — `CodeBlock.tsx`'s `motions`/`operators` prop
+ * defaults must list the same members (kept as JSON literals there for the
+ * pattern-registry parser; `test/CodeBlock.editable.test.tsx` asserts they
+ * stay in sync).
  */
-type EditorMotion = 'left' | 'right' | 'up' | 'down' | 'word-forward' | 'word-back' | 'word-end' | 'line-start' | 'line-end' | 'first-nonblank' | 'doc-start' | 'doc-end' | 'paragraph-forward' | 'paragraph-back' | 'line' | 'selection';
-type EditorOperator = 'delete' | 'yank' | 'change';
+declare const EDITOR_MOTIONS: readonly ["left", "right", "up", "down", "word-forward", "word-back", "word-end", "line-start", "line-end", "first-nonblank", "doc-start", "doc-end", "paragraph-forward", "paragraph-back", "line", "selection", "match-bracket"];
+type EditorMotion = (typeof EDITOR_MOTIONS)[number];
+declare const EDITOR_OPERATORS: readonly ["delete", "yank", "change", "put", "put-before", "undo", "redo", "join", "toggle-case", "indent", "dedent", "replace"];
+type EditorOperator = (typeof EDITOR_OPERATORS)[number];
+declare function isEditorMotion(value: string): value is EditorMotion;
+declare function isEditorOperator(value: string): value is EditorOperator;
+/** Fixed indent unit for the `indent`/`dedent` operators (two spaces). */
+declare const INDENT_UNIT = "  ";
 /** New caret offset after applying `motion` `count` times. `line`/`selection` are range-only — caret is unchanged. */
 declare function applyMotion(text: string, caret: number, motion: EditorMotion, count: number): number;
 /** The `[start, end)` range an operator acts on for `motion`. */
 declare function motionRange(text: string, caret: number, motion: EditorMotion, count: number, selection?: [number, number]): [number, number];
-/** Apply `operator` over `range`. `delete`/`change` remove and store; `yank` only stores. */
-declare function applyOperator(text: string, range: [number, number], operator: EditorOperator, register: string): {
+interface ApplyOperatorInput {
     text: string;
+    /** `textarea.selectionStart` at the time the operator fired — the anchor for caret-based operators (put/put-before/join) that don't act over `range`. */
     caret: number;
+    /** The `[start, end)` range from `motionRange` — the anchor for range-based operators (delete/yank/change/toggle-case/indent/dedent/replace). */
+    range: [number, number];
+    operator: EditorOperator;
+    /** The motion paired with this operator. `change` special-cases `line`; delete/yank/change use it to set the returned `registerLinewise`. */
+    motion: EditorMotion;
+    count: number;
     register: string;
-};
+    registerLinewise: boolean;
+}
+interface ApplyOperatorResult {
+    text: string;
+    caret: number;
+    register: string;
+    registerLinewise: boolean;
+}
+/** Apply `operator`. `undo`/`redo` never reach here — they're history-stack operations handled by `useEditorCapabilities`. */
+declare function applyOperator(input: ApplyOperatorInput): ApplyOperatorResult;
 
 /**
  * Content Segment Parsing Utilities
@@ -400,4 +427,4 @@ declare function clearVerification(): void;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { type BloomLevel as $, getTraitSnapshots as A, getTransitions as B, type ContentSegment as C, DEFAULT_CONFIG as D, type EditorMotion as E, getTransitionsForTrait as F, motionRange as G, parseContentSegments as H, parseLessonSegments as I, parseMarkdownWithCodeBlocks$1 as J, recordServerResponse as K, type LessonSegment as L, recordTransition as M, registerCheck as N, registerTraitSnapshot as O, renderStateMachineToDomData as P, renderStateMachineToSvg as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, subscribeToVerification as U, type VisualizerConfig as V, updateAssetStatus as W, updateBridgeHealth as X, updateCheck as Y, waitForTransition as Z, type InteractiveOrbitalType as _, type DomEntityBox as a, BloomQuizBlock as a0, type BloomQuizBlockProps as a1, type MixedSegment as a2, parseMarkdownWithCodeBlocks as a3, type DomLayoutData as b, type DomOutputsBox as c, type DomStateNode as d, type DomTransitionLabel as e, type DomTransitionPath as f, type EditorOperator as g, type EntityDefinition as h, type StateMachineDefinition as i, type TransitionDefinition as j, applyMotion as k, applyOperator as l, bindCanvasCapture as m, bindEventBus as n, bindLastDrawables as o, bindTraitStateGetter as p, clearVerification as q, cn as r, extractOutputsFromTransitions as s, extractStateMachine as t, formatGuard as u, getAllChecks as v, getBridgeHealth as w, getEffectSummary as x, getSnapshot as y, getSummary as z };
+export { renderStateMachineToSvg as $, type ApplyOperatorInput as A, getEffectSummary as B, type ContentSegment as C, DEFAULT_CONFIG as D, EDITOR_MOTIONS as E, getSnapshot as F, getSummary as G, getTraitSnapshots as H, INDENT_UNIT as I, getTransitions as J, getTransitionsForTrait as K, type LessonSegment as L, isEditorMotion as M, isEditorOperator as N, motionRange as O, parseContentSegments as P, parseLessonSegments as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, parseMarkdownWithCodeBlocks$1 as U, type VisualizerConfig as V, recordServerResponse as W, recordTransition as X, registerCheck as Y, registerTraitSnapshot as Z, renderStateMachineToDomData as _, type ApplyOperatorResult as a, subscribeToVerification as a0, updateAssetStatus as a1, updateBridgeHealth as a2, updateCheck as a3, waitForTransition as a4, type InteractiveOrbitalType as a5, type BloomLevel as a6, BloomQuizBlock as a7, type BloomQuizBlockProps as a8, type MixedSegment as a9, parseMarkdownWithCodeBlocks as aa, type DomEntityBox as b, type DomLayoutData as c, type DomOutputsBox as d, type DomStateNode as e, type DomTransitionLabel as f, type DomTransitionPath as g, EDITOR_OPERATORS as h, type EditorMotion as i, type EditorOperator as j, type EntityDefinition as k, type StateMachineDefinition as l, type TransitionDefinition as m, applyMotion as n, applyOperator as o, bindCanvasCapture as p, bindEventBus as q, bindLastDrawables as r, bindTraitStateGetter as s, clearVerification as t, cn as u, extractOutputsFromTransitions as v, extractStateMachine as w, formatGuard as x, getAllChecks as y, getBridgeHealth as z };