@quillmark/svelte 0.2.0 → 0.3.0

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,14 +12,14 @@ 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. The gate is read OUTSIDE that catch — an
+ * 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.
  */

package/dist/visual/tips.js

@@ -1,5 +1,5 @@
 // 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").
 //
@@ -25,14 +25,14 @@ 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. The gate is read OUTSIDE that catch — an
+ * 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.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@quillmark/svelte",
-	"version": "0.2.0",
+	"version": "0.3.0",
 	"description": "Editor, live-preview and source surfaces over a Quillmark WASM session.",
 	"repository": {
 		"type": "git",