@quillmark/svelte 0.1.1 → 0.3.0

package/dist/visual/props.d.ts

@@ -5,6 +5,13 @@ import type { ActiveLeaf, EditorChange } from './signals.js';
 import type { FormatDiagnostic, VisualStringsInput } from './strings.js';
 export interface VisualEditorProps {
     doc: Document;
+    /**
+     * The schema this document is edited against. Borrowed for the surface's lifetime,
+     * whoever handed it over: a quill from `@quillmark/quiver`'s `getQuill` is the
+     * quiver's, shared with every other caller for that ref, and freeing it hands the
+     * next caller a freed handle. A host wanting one of its own mints it from
+     * `.toTree()`. The editor frees nothing it is passed.
+     */
     quill: Quill;
     /**
      * The active leaf: its canonical `DocPath` and the session key of the card holding
@@ -19,23 +26,28 @@ export interface VisualEditorProps {
      * keystroke path (the editor mints the path off its derived card tree, which
      * already holds every kind).
      *
-     * A SELECTION signal, not a change signal: an arrow key fires it and commits
+     * A selection signal, not a change signal: an arrow key fires it and commits
      * nothing. One keystroke fires `onChange` first and this second, so the edit
      * has landed by the time the caret names where it is.
      *
-     * A PLACE, so consecutive duplicates do not arrive: landing the caret where it
+     * A place, so consecutive duplicates do not arrive: landing the caret where it
      * already sits reports nothing, and a place left and returned to reports twice.
      */
     onCaretMove?: (at: Place) => void;
     /**
-     * EVERY edit that lands on the document: a prose commit, a scalar/array/object
+     * Every edit that lands on the document: a prose commit, a scalar/array/object
      * write, a card operation. The signal a host recompiles off; `source` is what
-     * moved, for a host that wants a structure op to recompile at once and a
-     * keystroke to wait for the burst to settle.
+     * moved.
+     *
+     * **The lane split is the default, not a tuning exercise.** `'structure'` arrives
+     * once per gesture and recompiles at once; `'prose'` and `'field'` arrive per
+     * keystroke and wait for the burst to settle. Recompiling structure on the debounce
+     * makes a card insert look dropped, and recompiling prose at once compiles the
+     * document on every character.
      */
     onChange?: (change: EditorChange) => void;
     /**
-     * Failures the editor RECOVERED from: a commit the boundary refused (also
+     * Failures the editor recovered from: a commit the boundary refused (also
      * pinned as a diagnostic on its field), a card operation that threw, a
      * `validate`/`resolve` that threw, a prose commit that fell back. None of them
      * stop editing; without this hook each is a `console.error` an app cannot
@@ -49,16 +61,25 @@ export interface VisualEditorProps {
     diagnostics?: Diagnostic[];
     /**
      * Consumer policy hook: given a field `addr` and an enum option,
-     * return `false` to mark that option unavailable. A disallowed option renders
-     * DISABLED (never stripped), so an already-authored value stays visible and its
-     * stored payload is untouched: the schema is unchanged, this is runtime policy.
-     * Absent → every schema option is offered (the default, zero behavior change).
+     * return `false` to mark that option unavailable; `enumDisallowed` decides how
+     * the control then draws it. The stored payload is untouched either way: the
+     * schema is unchanged, this is runtime policy. Absent → every schema option is
+     * offered. It reaches a field's own enum control; an enum inside an object
+     * subform has no `Addr` to pass and is offered whole.
      */
     enumOptionAllowed?: (addr: Addr, value: string) => boolean;
+    /**
+     * How an `enumOptionAllowed: false` option draws: `'disable'` (the default) greys
+     * it in place, `'hide'` leaves it out of the list. One policy for the surface, not
+     * a per-option verdict, and the selected value is drawn under either (disabled
+     * when refused), so the control always shows what the document says
+     * (VISUAL_EDITOR §"Enum policy").
+     */
+    enumDisallowed?: 'hide' | 'disable';
     /**
      * Every word the surface says, keyed and partial: unset keys take the package's
-     * English. Several are ACCESSIBLE NAMES rather than decoration, so this is what
-     * a product shipping in another language replaces. The empty body's per-kind
+     * English. Several are accessible names rather than decoration, so this is what
+     * a product shipping in another language replaces. The empty body's per-card
      * wording is the `bodyPlaceholder` key here rather than a prop of its own.
      */
     strings?: VisualStringsInput;

package/dist/visual/signals.d.ts

@@ -1,6 +1,6 @@
 import type { DocPath } from '../core/address.js';
 /**
- * Which lane an edit came down. The three differ in COST, not in meaning: prose
+ * Which lane an edit came down. The three differ in cost, not in meaning: prose
  * arrives per keystroke and wants a debounce, a structure op arrives once per
  * gesture and does not. A host that recompiles the same way for all three never
  * reads it.
@@ -13,30 +13,30 @@ export type ChangeSource =
 /** A card operation: add, move, remove, retype, rename, tips dismissal. */
  | 'structure';
 /**
- * A card's SESSION key: the editor's own identity for a card instance, `'main'` for
+ * A card's session key: the editor's own identity for a card instance, `'main'` for
  * the main card and an opaque `IdSeq` id (`structure.ts`) for a composable one. It
  * rides beside every address the surface emits, because no address survives a
  * reorder: `Addr` and `DocPath` are both positional, so a host holding
  * `cards.indorsement[2].from` names a different card after one `moveCard`, and
  * silently. The key does not move.
  *
- * SESSION-SCOPED BY CONSTRUCTION. Nothing document-side backs it (the document model
+ * Session-scoped by construction. Nothing document-side backs it (the document model
  * carries no card handle): it is minted at mount and dies with the surface, so it
  * does not survive a reload and a host persisting one is persisting a session key.
  *
- * THE EDITOR OWNS STRUCTURAL MUTATION for the session. The keys track the inserts,
+ * The editor owns structural mutation for the session. The keys track the inserts,
  * moves and removals the editor performs; a host that mutates the card array behind
  * it (its own `doc.insertCard`) desyncs them, and the answer is to re-seed the
  * surface rather than expect the keys to follow. There is nothing document-side to
  * reconcile against, so this is a contract rather than a mechanism.
  */
 export type CardId = string;
-/** An edit that LANDED on the document, and which lane it came down. */
+/** An edit that landed on the document, and which lane it came down. */
 export interface EditorChange {
     source: ChangeSource;
     /**
      * Where it landed, in the canonical `DocPath` the preview and every diagnostic
-     * already speak: a FIELD for the prose and field lanes, the CARD itself
+     * already speak: a field for the prose and field lanes, the card itself
      * (`cards.<kind>[i]`) for a structure op, where the change is the card rather than
      * anything inside it. Absent for a card removal and a tips dismissal, which are
      * the stack's change rather than a leaf's.

package/dist/visual/strings.d.ts

@@ -2,7 +2,7 @@ import type { Diagnostic } from '@quillmark/wasm';
 import { type SlashStrings, type TableChromeStrings } from '../core/codec/index.js';
 import type { BodyPlaceholder } from './structure.js';
 /**
- * The island and the insert menu's keys come from the CODEC, which owns both models
+ * The island and the insert menu's keys come from the codec, which owns both models
  * (a NodeView inside the leaf, and the trigger the leaf's keymap drives). Extending
  * rather than restating them is what keeps one English list: a consumer overrides an
  * island handle's name beside the card controls' and the codec still has a default
@@ -14,16 +14,11 @@ export interface VisualStrings extends TableChromeStrings, SlashStrings {
     cardDelete: string;
     /** The card-title input's accessible name. */
     cardTitle: string;
-    /** The multi-kind trigger, which names no kind because it opens a menu of them. */
+    /** The trailing strip's visible words, which are also every strip's accessible
+     * name; the glyph rides the wording, as the array foot's does. One string over
+     * one kind and many: the trigger seeds A card, and which kind is the menu's word
+     * to say or the schema's to have already settled. */
     addCard: string;
-    /** The single-kind trigger, whose accessible name IS the kind it seeds. */
-    addCardOfKind: (kind: string) => string;
-    /** The trailing strip's VISIBLE words, which are also its accessible name; the
-     * glyph rides the wording, as the array foot's does. A pair of their own rather
-     * than a prefix over the two above, because a language reading the mark as one
-     * phrase has nothing to prefix. */
-    addCardMark: (kind: string) => string;
-    addCardMarkAny: string;
     arrayAdd: string;
     arrayRemove: string;
     /** The required marker's accessible name; the glyph itself is a `*`. */
@@ -37,10 +32,12 @@ export interface VisualStrings extends TableChromeStrings, SlashStrings {
     formatLink: string;
     /** The anchor button's accessible name. */
     formatAnchor: string;
-    /** Its hover title, which says what an anchor IS; the name above only says what. */
+    /** Its hover title, which says what an anchor is; the name above only says what. */
     formatAnchorTitle: string;
     linkPlaceholder: string;
     linkApply: string;
+    /** Drawn only where the selection carries a link. */
+    linkRemove: string;
     linkCancel: string;
     tipsLabel: string;
     tipsDismiss: string;
@@ -57,10 +54,8 @@ export interface VisualStrings extends TableChromeStrings, SlashStrings {
      */
     bodyGhost: string;
     /**
-     * Per-KIND wording, in place of {@link VisualStrings.bodyGhost}; `undefined`
-     * takes it. Consulted once per kind per session and cached by the editor, so a
-     * hook that samples a set at random still reads as one deliberate string.
-     * Impurity is expected, and the cache is what contains it.
+     * Per-CARD wording, in place of {@link VisualStrings.bodyGhost}; `undefined`
+     * takes it. Pure and uncached ({@link BodyPlaceholder}).
      */
     bodyPlaceholder: BodyPlaceholder;
 }
@@ -72,22 +67,22 @@ export interface VisualStrings extends TableChromeStrings, SlashStrings {
  * lane (VISUAL_EDITOR §Diagnostics for why each lands where it does):
  *
  * - **`validation::enum_violation`, `type_mismatch`, `format_violation`,
- *   `must_fill`**: the CONSTRAINT re-words from the quill's schema at `path`, the
- *   offending VALUE from `args` (`value` / `sourceToken` / `actual`, the engine
+ *   `must_fill`**: the constraint re-words from the quill's schema at `path`, the
+ *   offending value from `args` (`value` / `sourceToken` / `actual`, the engine
  *   testifying to what it saw) and never from the document at `path`: validation
  *   runs post-coercion, so the validator read a value the document does not hold and
  *   a sentence built from `path` names a spelling the user never typed.
  * - **`edit::field_coercion_failed`**: re-words from the app's own control state, the
  *   refused value being in neither document (unchanged on throw) nor schema.
  * - **`parse::yaml_error_with_location`, `invalid_structure`**: does not re-word. No
- *   `path`, and `args` carries the LOCATION (`blockIndex`, `line`) and nothing else,
+ *   `path`, and `args` carries the location (`blockIndex`, `line`) and nothing else,
  *   engine prose riding under no key: the parser's own text, its column and its caret
  *   snippet exist only inside `message`.
  * - **`LiveSession.warnings`**: does not re-word. Backend text, an external feed.
  *
  * The last two are the boundary's shape, not a gap in it, so the fallback arm is
  * permanent: returning `undefined` renders `d.message` unchanged. `code` is optional
- * at this pin, so that arm is reachable by TYPE and not only in principle.
+ * at this pin, so that arm is reachable by type and not only in principle.
  *
  * Displayed text is that message or this replacement and nothing beside it: `hint` is
  * the tail of the message it accompanies, so rendering it too ships a two-language

package/dist/visual/strings.js

@@ -1,9 +1,9 @@
 // Every word the visual surface says, in one place, so a product shipping in
-// another language can replace them. Keyed and PARTIAL: a consumer sets the keys
+// another language can replace them. Keyed and partial: a consumer sets the keys
 // it has translations for and the rest take the package's English, which is what
 // makes wording an override rather than a fork.
 //
-// Several of these are ACCESSIBLE NAMES rather than decoration — the card
+// Several of these are accessible names rather than decoration — the card
 // controls, the add trigger, the required marker — so an untranslated surface is
 // not merely inconsistent, it reads the wrong language to a screen reader. That is
 // why this exists as a seam and not as a list of literals to grep for.
@@ -12,7 +12,7 @@
 // a parametric string cannot be assembled from fragments and stay translatable,
 // since the word order is the translator's to choose.
 //
-// The strings reach the tree through CONTEXT, not props. They are ambient,
+// The strings reach the tree through context, not props. They are ambient,
 // read-only, and wanted eight components deep (a card's controls, a field's
 // required marker, the formatting popover, the tips card); threading them by hand
 // would put a `strings` prop on every component between the root and each leaf,
@@ -27,10 +27,7 @@ export const DEFAULT_VISUAL_STRINGS = {
     cardMoveDown: 'Move down',
     cardDelete: 'Delete card',
     cardTitle: 'Card title',
-    addCard: 'Add card',
-    addCardOfKind: (kind) => `Add ${kind}`,
-    addCardMark: (kind) => `+ Add ${kind}`,
-    addCardMarkAny: '+ Add Card',
+    addCard: '+ Add Card',
     arrayAdd: '+ Add',
     arrayRemove: 'Remove',
     fieldRequired: 'required',
@@ -45,6 +42,7 @@ export const DEFAULT_VISUAL_STRINGS = {
     formatAnchorTitle: 'Anchor — an identity handle over the selection',
     linkPlaceholder: 'https://…',
     linkApply: 'Apply',
+    linkRemove: 'Remove',
     linkCancel: 'Cancel',
     tipsLabel: 'Editor tips',
     tipsDismiss: 'Dismiss',

package/dist/visual/structure.d.ts

@@ -17,7 +17,7 @@ export interface FieldModel {
      * undefined when the field declares none. Chrome-only; never gates. */
     description: string | undefined;
     /**
-     * Required-ness: a field with NO `default:` is "Unendorsed": its
+     * Required-ness: a field with no `default:` is "Unendorsed": its
      * seed carries a `!must_fill` marker (DOCUMENT_MODEL: there is no separate
      * `required` axis). Drives a persistent label `*`, complementary to the ghosted
      * `default:` (a required field has no default to ghost). Persistent (schema-
@@ -38,7 +38,7 @@ export interface GroupSection {
 /**
  * One card instance projected for rendering: the schema × payload join result
  * the VisualEditor's `$derived` produces and hands to `<Card>`. Positional
- * identity is carried by `id` (a session key), NOT by array index.
+ * identity is carried by `id` (a session key), not by array index.
  */
 export interface CardModel {
     /** Stable session id (`'main'` for the main card). */
@@ -48,7 +48,7 @@ export interface CardModel {
     /**
      * The card's `kind` has no projectable schema: a foreign kind under
      * a schema that declares others, or a card under a schema with no `card_kinds` at
-     * all. Such a card renders a RECOVERY SHELL (humanized title + retype + delete)
+     * all. Such a card renders a recovery shell (humanized title + retype + delete)
      * instead of a field list, so its content is never dropped or trapped: retyping
      * to a declared kind re-projects it, delete removes it. Always `false` for `main`.
      */
@@ -62,7 +62,7 @@ export interface CardModel {
     /**
      * Field name → its resolved provenance row (`{ value, source }`), parallel to
      * `values` (FIELD_PROVENANCE). The channel that feeds chrome (the ghosted
-     * `default:` and any authored/default/zero affordance), NEVER the control
+     * `default:` and any authored/default/zero affordance), never the control
      * value. Empty when `quill.resolve` is unavailable.
      */
     provenance: Record<string, ResolvedField>;
@@ -73,7 +73,7 @@ export interface CardModel {
      * empty for a card that does: the resolved body `default:` when there is one,
      * else the consumer's wording, else the built-in invitation
      * ({@link resolveBodyGhost}). A body leaf therefore always has something in it
-     * to write into, which the inline fields deliberately do not: their ghost IS
+     * to write into, which the inline fields deliberately do not: their ghost is
      * the resolved default, and an invented one would read as a value.
      */
     bodyGhost?: string;
@@ -114,25 +114,32 @@ export declare function ghostDefault(row: ResolvedField | undefined): unknown;
  * thing to display as a placeholder (FIELD_PROVENANCE). */
 export declare function stringifyGhost(ghost: unknown): string | undefined;
 /** What a {@link BodyPlaceholder} is told about the body it words. The card's
- *  IDENTITY, not its chrome: `kind` keys the consumer's own `quill.schema` for
- *  anything richer, and a renamed card must not shift its ghost. */
+ *  identity, not its chrome: `cardId` is what per-card wording keys off, `kind` keys
+ *  the consumer's own `quill.schema` for anything richer, and a renamed card must not
+ *  shift its ghost. */
 export interface BodyPlaceholderContext {
+    /**
+     * The card's session key (`CardId`), `'main'` for the main card. Follows its card
+     * across a reorder and a retype, and is re-minted when the surface re-keys on a new
+     * document handle. Opaque: wording keyed off it hashes it rather than reads it.
+     */
+    cardId: string;
     /** The card's kind; `'main'` for the main card. */
     kind: string;
     /** The main card: whose `kind` is not a `card_kinds` key. */
     isMain: boolean;
 }
 /**
- * Consumer wording for an empty body, per KIND, in place of the flat `bodyGhost`
- * string; returning `undefined` takes it. Consulted ONCE PER KIND per session and
- * cached by the editor, so a hook that samples a set at random still reads as one
- * deliberate string: two empty cards of a kind ghost the same, and a remount does
- * not re-roll. Impurity is expected, and the cache is what contains it.
+ * Consumer wording for an empty body, in place of the flat `bodyGhost` string;
+ * returning `undefined` takes it. Consulted per card on every derive and never
+ * cached, so it must be pure: a hook sampling a set at random re-rolls on every
+ * keystroke. Per-card wording is a function of `cardId`, per-kind wording a function
+ * of `kind`, and either is stable because the function is.
  */
 export type BodyPlaceholder = (ctx: BodyPlaceholderContext) => string | undefined;
 /**
- * The empty body's ghost: the resolved body `default:`, else per-kind consumer
- * wording, else the flat built-in. The `default:` WINS because it is the only one
+ * The empty body's ghost: the resolved body `default:`, else the consumer's
+ * wording, else the flat built-in. The `default:` wins because it is the only one
  * of the three that describes the render: it promises what prints if nothing is
  * written, and wording placed over it would make that promise unreadable. The
  * other two are invitations, and an invitation belongs only where there is no
@@ -140,7 +147,7 @@ export type BodyPlaceholder = (ctx: BodyPlaceholderContext) => string | undefine
  */
 export declare function resolveBodyGhost(resolvedDefault: string | undefined, custom: string | undefined, builtIn: string): string;
 /** Map a field schema to its control (precedence: prose › enum › text › …).
- * An array's ELEMENT control is this over `items`: a missing `items` is a text
+ * An array's element control is this over `items`: a missing `items` is a text
  * element. */
 export declare function controlKind(f: QuillFieldSchema): ControlKind;
 /** The closed value domain of an enum/enum-string field, or undefined. */
@@ -151,7 +158,7 @@ export declare function humanize(name: string): string;
 export declare function fieldModels(cardSchema: QuillCardSchema): FieldModel[];
 /**
  * Group-section order (VISUAL_EDITOR §"Structure mirrors the schema"): the schema's `ui.groups` registry
- * KEY ORDER when present: `QuillCardUi.groups` is a typed `Record` at the
+ * key order when present: `QuillCardUi.groups` is a typed `Record` at the
  * boundary, so this reads it uncast: else the first-appearance order of each
  * field's `ui.group`.
  */
@@ -195,7 +202,7 @@ export interface PlacedField {
  * Assign each field its span in the section grid. Consecutive packable fields are
  * `cell`s the grid auto-places: capacity and wrapping are the container query's
  * business, so a trailing orphan keeps its column width rather than growing to fill.
- * A packable run of ONE is `lone`: with no row above to align to, one column reads as
+ * A packable run of one is `lone`: with no row above to align to, one column reads as
  * truncated, so it takes half the capacity from column 1. Everything else is `full`.
  *
  * Pure, and stays pure: no width, no measurement, nothing to re-derive on resize.

package/dist/visual/structure.js

@@ -36,8 +36,8 @@ export function stringifyGhost(ghost) {
     return ghost != null && typeof ghost !== 'object' ? String(ghost) : undefined;
 }
 /**
- * The empty body's ghost: the resolved body `default:`, else per-kind consumer
- * wording, else the flat built-in. The `default:` WINS because it is the only one
+ * The empty body's ghost: the resolved body `default:`, else the consumer's
+ * wording, else the flat built-in. The `default:` wins because it is the only one
  * of the three that describes the render: it promises what prints if nothing is
  * written, and wording placed over it would make that promise unreadable. The
  * other two are invitations, and an invitation belongs only where there is no
@@ -47,7 +47,7 @@ export function resolveBodyGhost(resolvedDefault, custom, builtIn) {
     return resolvedDefault || custom || builtIn;
 }
 /** Map a field schema to its control (precedence: prose › enum › text › …).
- * An array's ELEMENT control is this over `items`: a missing `items` is a text
+ * An array's element control is this over `items`: a missing `items` is a text
  * element. */
 export function controlKind(f) {
     switch (f.type) {
@@ -102,7 +102,7 @@ export function fieldModels(cardSchema) {
 }
 /**
  * Group-section order (VISUAL_EDITOR §"Structure mirrors the schema"): the schema's `ui.groups` registry
- * KEY ORDER when present: `QuillCardUi.groups` is a typed `Record` at the
+ * key order when present: `QuillCardUi.groups` is a typed `Record` at the
  * boundary, so this reads it uncast: else the first-appearance order of each
  * field's `ui.group`.
  */
@@ -174,13 +174,13 @@ export function initialExpandedGroup(sections) {
 }
 /**
  * Whether a field can share a row. `ui.compact` asks; a shape declines when the
- * DOCUMENT sets its height, because a row is as tall as its tallest cell and the cell
+ * document sets its height, because a row is as tall as its tallest cell and the cell
  * beside it does not grow in step: an object nests a whole field set, block richtext
  * (`inline` absent) holds paragraphs, and an array holds however many elements the
  * document carries. Any of them stands its neighbour in a column of whitespace. An
  * inline prose leaf is one line tall and packs like any scalar.
  *
- * An array declines WHATEVER ITS ITEMS ARE: one-line elements make a one-line step,
+ * An array declines whatever its items are: one-line elements make a one-line step,
  * but nothing holds two arrays to the same number of them, so the shorter of a packed
  * pair pays a cell of whitespace for every element the taller one has past it, and
  * pays more of it as the document is filled.
@@ -196,7 +196,7 @@ function packable(f) {
  * Assign each field its span in the section grid. Consecutive packable fields are
  * `cell`s the grid auto-places: capacity and wrapping are the container query's
  * business, so a trailing orphan keeps its column width rather than growing to fill.
- * A packable run of ONE is `lone`: with no row above to align to, one column reads as
+ * A packable run of one is `lone`: with no row above to align to, one column reads as
  * truncated, so it takes half the capacity from column 1. Everything else is `full`.
  *
  * Pure, and stays pure: no width, no measurement, nothing to re-derive on resize.
@@ -250,7 +250,7 @@ export function bodyEnabled(cardSchema) {
     return cardSchema?.body?.enabled !== false;
 }
 // ── Session identity (VISUAL_EDITOR §"The address is the spine") ─────────────
-// Cards are POSITIONAL in the content and `doc.cards` re-allocates on each read,
+// Cards are positional in the content and `doc.cards` re-allocates on each read,
 // so a stable card-instance key cannot be the card object (a fresh object every
 // derive): it is a session id held in a parallel array, reordered in lockstep
 // with the structure ops and resolved to an index only at the mutation boundary.

package/dist/visual/synced.svelte.d.ts

@@ -4,7 +4,7 @@ export interface SyncedLocal<T> {
     value: T;
 }
 /**
- * Seed a local from `project` and reconcile only an EXTERNAL change into it.
+ * Seed a local from `project` and reconcile only an external change into it.
  * `project` reads the reactive source (a prop) and maps it to the local's type:
  * ` => value ?? ''`, ` => (value != null ? String(value) : '')`, etc. The
  * seed is `untrack`ed (the ongoing sync is the `$effect`, not the initializer),

package/dist/visual/synced.svelte.js

@@ -1,12 +1,12 @@
 // The controlled-local reconcile shared by the scalar controls (TextField /
 // NumberField / DateField / BooleanField / EnumField). Each seeds a local from a
-// projection of its `value` prop and reconciles ONLY an external change back into
+// projection of its `value` prop and reconciles only an external change back into
 // the local: own edits stay `untrack`ed, so typing never re-runs the sync and
-// resets the caret. The five controls carried a character-identical block; this
-// is the one copy (VISUAL_EDITOR §Surface).
+// resets the caret. One copy for all five, rather than a character-identical block
+// in each (VISUAL_EDITOR §Surface).
 import { untrack } from 'svelte';
 /**
- * Seed a local from `project` and reconcile only an EXTERNAL change into it.
+ * Seed a local from `project` and reconcile only an external change into it.
  * `project` reads the reactive source (a prop) and maps it to the local's type:
  * ` => value ?? ''`, ` => (value != null ? String(value) : '')`, etc. The
  * seed is `untrack`ed (the ongoing sync is the `$effect`, not the initializer),

package/dist/visual/tips.d.ts

@@ -12,13 +12,15 @@ export declare function tipsChannel(raw: unknown): string[];
  * (`strong`/`emph`/`code`/`link`) rather than by a second markdown renderer that
  * would drift from it.
  *
- * The INLINE schema, not the block one: a tip is a one-line hint, and
+ * The inline schema, not the block one: a tip is a one-line hint, and
  * `decodeInline` folds stray lines to a space and drops island slots, so any string
  * produces one paragraph: no tip can change the card's block structure as the
  * cursor advances.
  *
  * Raw HTML does not survive the round-trip, so this is not the injection seam an
  * `{@html}` of the same string would be. A throw degrades to the literal text:
- * chrome never breaks the editor.
+ * chrome never breaks the editor. The gate is read outside that catch — an
+ * uninitialized core is not a tip that failed to render, and would otherwise be
+ * reported as one.
  */
 export declare function renderTip(markdown: string, onError?: EditorErrorHandler): Node;

package/dist/visual/tips.js

@@ -1,11 +1,11 @@
 // The tips channel: `$ext.editor.tips`, a list of authoring hints a
-// quill or consumer seeds, which the editor only ever RENDERS and CLEARS.
+// quill or consumer seeds, which the editor only ever renders and clears.
 // Editor-only chrome; never reaches the render backend, never gates, absent when
 // the channel is empty (VISUAL_EDITOR §"Card operations").
 //
 // The channel narrowing the derive reads and the render the card paints. The write
 // is `patchEditorExt` (ext.ts), the one door into the namespace.
-import { importMarkdown } from '@quillmark/wasm';
+import { core } from '../core/lifecycle.js';
 import { reportError, errorMessage } from '../core/errors.js';
 import { renderContent, inlineSchema } from '../core/codec/index.js';
 /**
@@ -25,16 +25,19 @@ export function tipsChannel(raw) {
  * (`strong`/`emph`/`code`/`link`) rather than by a second markdown renderer that
  * would drift from it.
  *
- * The INLINE schema, not the block one: a tip is a one-line hint, and
+ * The inline schema, not the block one: a tip is a one-line hint, and
  * `decodeInline` folds stray lines to a space and drops island slots, so any string
  * produces one paragraph: no tip can change the card's block structure as the
  * cursor advances.
  *
  * Raw HTML does not survive the round-trip, so this is not the injection seam an
  * `{@html}` of the same string would be. A throw degrades to the literal text:
- * chrome never breaks the editor.
+ * chrome never breaks the editor. The gate is read outside that catch — an
+ * uninitialized core is not a tip that failed to render, and would otherwise be
+ * reported as one.
  */
 export function renderTip(markdown, onError) {
+    const { importMarkdown } = core();
     try {
         return renderContent(importMarkdown(markdown), inlineSchema);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@quillmark/svelte",
-	"version": "0.1.1",
+	"version": "0.3.0",
 	"description": "Editor, live-preview and source surfaces over a Quillmark WASM session.",
 	"repository": {
 		"type": "git",
@@ -66,7 +66,7 @@
 		"check": "svelte-check --tsconfig ./tsconfig.json"
 	},
 	"peerDependencies": {
-		"@quillmark/wasm": ">=0.102.0-0",
+		"@quillmark/wasm": ">=0.103.0-0",
 		"svelte": "^5.0.0"
 	},
 	"dependencies": {