@quillmark/svelte 0.14.0 → 0.16.0

package/dist/core/codec/field.d.ts

@@ -75,11 +75,6 @@ export interface CreateFieldOpts {
      * emptied it holds an empty answer, which prints empty. Absent, the placeholder
      * returns whenever the leaf is empty. */
     placeholderUntilEdit?: boolean;
-    /** Ghost text shown on the empty leaf until its first edit: an unset field's
-     * `example:`, at rest where there is no placeholder and in the placeholder's stead
-     * while the leaf holds the focus. The initial value; {@link FieldController.setExample}
-     * moves it after mount. */
-    example?: string;
     onFocus?(addr: Addr): void;
     /** Fired with the new USV caret after an edit or a selection move. */
     onCaretMove?(addr: Addr, pos: number): void;
@@ -117,9 +112,6 @@ export interface FieldController {
      * a transaction would fire `onCaretMove` at a moment the caret did not move.
      */
     setPlaceholder(text: string | undefined): void;
-    /** Move the example ghost after mount, the way {@link setPlaceholder} moves the
-     *  other one. */
-    setExample(text: string | undefined): void;
     /** Move the default an unset leaf holds after mount: a retype or a quill swap
      *  re-seats an unset leaf on the new kind's default, and leaves a written one be. */
     setFallback(content: Content | undefined): void;
@@ -219,7 +211,5 @@ export declare function proseLeafPlugins(schema: Schema, opts: {
     placeholder?: () => string | undefined;
     /** {@link CreateFieldOpts.placeholderUntilEdit}. */
     placeholderUntilEdit?: boolean;
-    /** The focused leaf's ghost, read live for the same reason. */
-    example?: () => string | undefined;
     afterHistory?: Plugin[];
 }): Plugin[];

package/dist/core/codec/field.js

@@ -146,10 +146,9 @@ export function createField(opts) {
     const reconciler = createReconciler(shown());
     let index; // rebuilt on every structural change
     let view;
-    // The ghosts' live cells: the ghost plugin reads them per pass, so moving one is
-    // an assignment plus a re-render rather than a rebuilt plugin stack.
+    // The ghost's live cell: the ghost plugin reads it per pass, so moving it is an
+    // assignment plus a re-render rather than a rebuilt plugin stack.
     let placeholderText = opts.placeholder;
-    let exampleText = opts.example;
     // The views nested inside this leaf: one per table cell (`table-view.ts`). The
     // leaf holds the set because chrome asks the leaf, not the island, which view
     // holds the caret: the format popover raises over a cell exactly as over the
@@ -269,7 +268,6 @@ export function createField(opts) {
                 // given one later; the plugin draws nothing while the text is empty.
                 placeholder: () => placeholderText,
                 placeholderUntilEdit: opts.placeholderUntilEdit,
-                example: () => exampleText,
                 afterHistory: [anchorPlugin(seededAnchors)]
             })
         });
@@ -418,12 +416,6 @@ export function createField(opts) {
             // transaction, so nothing commits and no caret is reported.
             view.setProps({});
         },
-        setExample(text) {
-            if (text === exampleText)
-                return;
-            exampleText = text;
-            view.setProps({});
-        },
         setFallback(content) {
             if (content === fallback || (content && fallback && contentEqual(content, fallback)))
                 return;
@@ -533,7 +525,7 @@ export function proseLeafPlugins(schema, opts) {
         list.push(gapCursor(), pastAtomPlugin(), islandPastePlugin());
     if (schema === plainSchema)
         list.push(plainClipboardPlugin());
-    if (opts.placeholder || opts.example)
+    if (opts.placeholder)
         list.push(ghostPlugin(opts));
     return list;
 }
@@ -590,18 +582,16 @@ function pastAtomPlugin() {
     });
 }
 /**
- * The empty leaf's ghosts. A node decoration stamps the sole empty textblock with a
- * class and the ghost text, which `prose.css` draws from the attributes: so the text
+ * The empty leaf's ghost. A node decoration stamps the sole empty textblock with a
+ * class and the ghost text, which `prose.css` draws from the attribute: so the text
  * never enters the document, the caret path, or a `pmToContent` export, and it
  * vanishes the instant the leaf holds any content (the emptiness test fails).
  *
- * `data-placeholder` is drawn at rest, and `data-example` where there is none, and in
- * its stead while the view holds the focus. The example is stamped only until the
- * state's first edit, after which the leaf has been answered, and so is a placeholder
- * under `placeholderUntilEdit`. An inline leaf's
- * ghost keeps to the one line the leaf is (`qm-prose-placeholder-line`).
+ * Under `placeholderUntilEdit` it is stamped only until the state's first edit, after
+ * which the leaf has been answered. An inline leaf's ghost keeps to the one line the
+ * leaf is (`qm-prose-placeholder-line`).
  *
- * The texts are read per decoration pass rather than closed over, so moving a ghost is
+ * The text is read per decoration pass rather than closed over, so moving the ghost is
  * a re-render and never a document edit.
  */
 function ghostPlugin(opts) {
@@ -616,8 +606,7 @@ function ghostPlugin(opts) {
             decorations(state) {
                 const edited = key.getState(state);
                 const text = edited && opts.placeholderUntilEdit ? undefined : opts.placeholder?.();
-                const example = edited ? undefined : opts.example?.();
-                if (!text && !example)
+                if (!text)
                     return null;
                 const { doc } = state;
                 const first = doc.firstChild;
@@ -629,10 +618,7 @@ function ghostPlugin(opts) {
                         ? 'qm-prose-placeholder qm-prose-placeholder-line'
                         : 'qm-prose-placeholder'
                 };
-                if (text)
-                    attrs['data-placeholder'] = text;
-                if (example)
-                    attrs['data-example'] = example;
+                attrs['data-placeholder'] = text;
                 return DecorationSet.create(doc, [Decoration.node(0, first.nodeSize, attrs)]);
             }
         }

package/dist/core/codec/prose.css

@@ -196,21 +196,19 @@ li.ProseMirror-selectednode::after {
 }
 
 /* The empty leaf's ghost (`field.ts`, `ghostPlugin`): a node decoration's data
-   attributes, so the text stays out of the document. At the rung every control's
+   attribute, so the text stays out of the document. At the rung every control's
    placeholder takes; the italic is what a leaf with no written neighbour has instead
    of the step to `ink`.
 
    After the empty line rather than before it, and pulled up one line box onto it: the
    caret keeps the start of that line, and a ghost's lines past the first grow the
    leaf rather than hang over what follows it. A block leaf's ghost wraps and keeps the
-   breaks it was written with, a `body.example` being a document's worth; an inline
-   leaf's keeps to the one line the leaf is. The example is drawn at rest where there
-   is no placeholder, and stands in for the placeholder while the leaf holds the focus.
+   breaks it was written with, a body `default:` being a document's worth; an inline
+   leaf's keeps to the one line the leaf is.
 
    Drawn only where there is text to draw: an empty box pulled up a line would take
    the empty line with it. */
-.ProseMirror .qm-prose-placeholder[data-placeholder]::after,
-.ProseMirror .qm-prose-placeholder[data-example]::after {
+.ProseMirror .qm-prose-placeholder[data-placeholder]::after {
 	content: attr(data-placeholder);
 	display: block;
 	margin-top: -1lh;
@@ -219,10 +217,6 @@ li.ProseMirror-selectednode::after {
 	font-style: italic;
 	pointer-events: none;
 }
-.ProseMirror .qm-prose-placeholder[data-example]:not([data-placeholder])::after,
-.ProseMirror-focused .qm-prose-placeholder[data-example]::after {
-	content: attr(data-example);
-}
 .ProseMirror .qm-prose-placeholder.qm-prose-placeholder-line::after {
 	white-space: nowrap;
 	overflow: hidden;

package/dist/core/index.d.ts

@@ -1,4 +1,3 @@
-import './theme.css';
 export { init } from './lifecycle.js';
 export type { DocPath, Landing, Place } from './address.js';
 export { fieldPathForAddr, addrForFieldPath } from './address.js';

package/dist/core/index.js

@@ -1,10 +1,3 @@
-// The theme derivation: the public dials → the private `--_qm-*` scale, applied
-// to every `data-qm-root` element (THEMING.md). Imported at every barrel a
-// consumer can enter through — here, `/visual`, `/preview` — because a subpath is
-// what a consumer gets, and a surface reaching a module inside `core/` reaches
-// nothing this file imports. One sheet however many barrels name it: the
-// derivation is minted once rather than re-declared per detached root.
-import './theme.css';
 // `@quillmark/svelte/core`: what this package owns at the substrate seam.
 //
 // The `@quillmark/wasm` API is not re-exported: import it straight from the peer
@@ -14,6 +7,10 @@ import './theme.css';
 // here. What earns a line is what more than one surface speaks and no other
 // package declares: the address vocabulary and the error channel, plus the WASM
 // init gate.
+//
+// No stylesheet: a host reaches this entry where there is no document (a worker,
+// a server), and a dev server serves a side-effect sheet as a module that writes a
+// `<style>` into one. The surface barrels carry the theme; `check:deps` holds it.
 export { init } from './lifecycle.js';
 // The hop between that vocabulary and the `Addr` the document verbs take, both
 // directions: a host handed a path by a hook and holding a mutator needs it.

package/dist/core/theme.css

@@ -4,8 +4,8 @@
    geometry, type and motion are all derived here, so each is minted in one place
    instead of once per detached root.
 
-   Transport: a stylesheet, side-effect imported by `core/index.ts` and applied to
-   every element marked `data-qm-root`. The package imports it itself, so there is
+   Transport: a stylesheet, side-effect imported by each surface barrel and applied
+   to every element marked `data-qm-root`. The package imports it itself, so there is
    no `import './theme.css'` for a consumer to forget. A stylesheet rather than an
    inline `style` attribute is what buys the three things an attribute cannot
    carry: a selector consumer CSS outranks without `!important`, real properties
@@ -164,12 +164,12 @@
 	   stacked on one. */
 	--_qm-border-faint: color-mix(in oklab, var(--_qm-bg), var(--_qm-border) 50%);
 	/* Three rungs, and nothing under the last: a step below `label` lands under 3:1 on
-	   the well a field draws it against, and what would take it — an example, an unset
-	   value's word — is content a reader has to read (WCAG 1.4.3), not decoration.
+	   the well a field draws it against, and what would take it — an unset value's word,
+	   an invitation — is content a reader has to read (WCAG 1.4.3), not decoration.
 	   `ink` is written. `default` is the resolved `default:` drawn as the value it
 	   prints: near enough to `ink` to read as an answer, a step off it so it never
-	   reads as a written one. `label` is words about a value rather than the value — an
-	   `example:`, `None`, a format hint — and the chrome that names fields; in italic
+	   reads as a written one. `label` is words about a value rather than the value —
+	   `None`, a format hint, an invitation — and the chrome that names fields; in italic
 	   where it is a leaf's ghost, which has no written neighbour to be read against. */
 	--_qm-ink: var(--_qm-fg);
 	--_qm-ink-default: color-mix(in oklab, var(--_qm-fg), var(--_qm-bg) 20%);

package/dist/preset/index.css

@@ -1,6 +1,6 @@
 /* `@quillmark/svelte/preset`, the package's one CSS entry point: the endorsed look for
    the page a surface is mounted on. Opt-in and side-effect free until imported:
-   `core/index.ts` pulls `core/theme.css` for the surfaces and never this, because this
+   the surface barrels pull `core/theme.css` and never this, because this
    styles the document and nothing may put that in a consumer's page uninvited.
 
    Two files because one of them is exempt: `scale.css` is where the literals are

package/dist/preview/index.js

@@ -8,10 +8,8 @@
 // module directly in `core/` is what pulls the codec, and all of ProseMirror with it.
 // The theme derivation, which the page slots read through `var()`.
 // Imported at the barrel because a subpath is what a consumer gets: this surface
-// reaches modules inside `core/` and never its entry, so a sheet hanging off that
-// entry arrives only for a consumer importing `/core` for some other reason. The
-// sheet rather than the entry, because the barrel needs the derivation and not
-// `init`. `check:deps` holds the reach.
+// reaches modules inside `core/` and never its entry, which carries no sheet.
+// `check:deps` holds the reach.
 import '../core/theme.css';
 export { createPreview } from './controller.js';
 export { default as Preview } from './Preview.svelte';

package/dist/visual/Field.svelte

@@ -33,7 +33,6 @@
 		VARIANT_DISCRIMINANT,
 		arrayLayout,
 		baseType,
-		exampleGhost,
 		ghostDefault,
 		isContainer,
 		optionalCell,
@@ -120,8 +119,7 @@
 	// which is what a take writes (`ArrayField`).
 	// A default that prints stands in the control as the value it is, at the default
 	// rung, and the first edit takes it (VISUAL_EDITOR §"The commitment ladder"). Where
-	// nothing prints, a control draws words: the `none` an optional cell prints, and
-	// a free-text field's `example:`.
+	// nothing prints, a control draws words: the `none` an optional cell prints.
 	const ghost = $derived(ghostDefault(provenance));
 	const defaultStr = $derived(
 		field.control === 'prose' ? titleText(ghost) || undefined : stringifyGhost(ghost)
@@ -134,7 +132,6 @@
 	const declared = $derived(printedText(field.schema.default));
 	const optional = $derived(optionalCell(field.schema));
 	const none = $derived(optional && value == null ? t.strings.optionalGhost : undefined);
-	const example = $derived(value == null ? exampleGhost(field.schema) : undefined);
 	// A variant resolves as one rung whose value is the whole container, so the
 	// discriminant's ghost is that container's own discriminant cell.
 	const ghostMember = $derived(
@@ -288,7 +285,6 @@
 					fallback={printed ? (ghost as Content) : undefined}
 					placeholder={none}
 					placeholderUntilEdit
-					{example}
 					labelledBy={domIds.label}
 					{describedBy}
 					{leafKey}
@@ -407,7 +403,6 @@
 					value={value as string | undefined}
 					fallback={declared}
 					placeholder={none}
-					{example}
 					id={domIds.control}
 					{describedBy}
 					onCommit={onCommitScalar}

package/dist/visual/ObjectField.svelte

@@ -39,7 +39,6 @@
 		baseType,
 		controlKind,
 		declaredContent,
-		exampleGhost,
 		humanize,
 		isContainer,
 		mountKey,
@@ -134,9 +133,6 @@
 	 *  cell ghosts nothing, an empty answer printing empty. */
 	const noneOf = (key: string, sub: QuillFieldSchema): string | undefined =>
 		obj[key] == null && optionalCell(sub) ? t.strings.optionalGhost : undefined;
-	/** What an unset free-text cell ghosts where nothing prints ({@link exampleGhost}). */
-	const exampleOf = (key: string, sub: QuillFieldSchema): string | undefined =>
-		obj[key] == null ? exampleGhost(sub) : undefined;
 	/** A scalar cell's `default:` as the text an unset cell holds, where it prints. */
 	const textDefault = (sub: QuillFieldSchema): string | undefined => printedText(sub.default);
 	/** A content cell's `default:` as the content an unset leaf holds, where it prints. */
@@ -349,7 +345,6 @@
 						value={obj[key] as string | undefined}
 						fallback={textDefault(sub)}
 						placeholder={noneOf(key, sub)}
-						example={exampleOf(key, sub)}
 						onCommit={(v) => commitProp(key, v)}
 						onKey={onCellKey ? (e) => onCellKey(e, key) : undefined}
 					/>
@@ -362,7 +357,6 @@
 						fallback={contentDefault(sub)}
 						plaintext={baseType(sub) === 'plaintext'}
 						placeholder={noneOf(key, sub)}
-						example={exampleOf(key, sub)}
 						{block}
 						label={named}
 						labelledBy={ids?.label}

package/dist/visual/ProseField.svelte

@@ -45,10 +45,6 @@
 		placeholder?: string;
 		/** The placeholder goes at the leaf's first edit (`createField`). */
 		placeholderUntilEdit?: boolean;
-		/** Ghost shown on the empty leaf until its first edit, and in the placeholder's
-		 * stead while the leaf holds the focus: an unset field's `example:`
-		 * (`exampleGhost`). */
-		example?: string;
 		/** Registry identity, stamped on the DOM node so a remount is visible as one. */
 		leafKey: string;
 		onFocus?: (addr: Addr) => void;
@@ -77,7 +73,6 @@
 		fallback,
 		placeholder,
 		placeholderUntilEdit,
-		example,
 		leafKey,
 		onFocus,
 		onCaretMove,
@@ -128,7 +123,6 @@
 			fallback,
 			placeholder,
 			placeholderUntilEdit,
-			example,
 			tableStrings: () => t.strings,
 			onSlash: (next) => {
 				slash = next;
@@ -156,9 +150,6 @@
 	$effect(() => {
 		controller?.setPlaceholder(placeholder);
 	});
-	$effect(() => {
-		controller?.setExample(example);
-	});
 	$effect(() => {
 		controller?.setFallback(fallback);
 	});

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

@@ -33,10 +33,6 @@ interface Props {
     placeholder?: string;
     /** The placeholder goes at the leaf's first edit (`createField`). */
     placeholderUntilEdit?: boolean;
-    /** Ghost shown on the empty leaf until its first edit, and in the placeholder's
-     * stead while the leaf holds the focus: an unset field's `example:`
-     * (`exampleGhost`). */
-    example?: string;
     /** Registry identity, stamped on the DOM node so a remount is visible as one. */
     leafKey: string;
     onFocus?: (addr: Addr) => void;

package/dist/visual/ProseValue.svelte

@@ -76,12 +76,9 @@
 		labelledBy?: string;
 		/** The parked `description` (FieldLabel) → `aria-describedby`. */
 		describedBy?: string;
-		/** The empty leaf's ghosts, a subform cell's, until the leaf's first edit: the
-		 *  `none` an optional cell prints unset, and the `example:` drawn where there is no
-		 *  placeholder and in its stead while the leaf holds the focus (`createField`'s
-		 *  pair). Read per decoration pass. */
+		/** The empty leaf's ghost, a subform cell's, until the leaf's first edit: the
+		 *  `none` an optional cell prints unset. Read per decoration pass. */
 		placeholder?: string;
-		example?: string;
 		onChange: (rt: Content) => void;
 		/** Raw keydown, for a container whose own keys run through this leaf: the
 		 * array repeater's Enter/Backspace (`ArrayField`). Fires before the view's own
@@ -97,7 +94,6 @@
 		labelledBy,
 		describedBy,
 		placeholder,
-		example,
 		onChange,
 		onKey
 	}: Props = $props();
@@ -160,8 +156,7 @@
 				: proseLeafPlugins(schema, {
 						inline,
 						placeholder: () => placeholder,
-						placeholderUntilEdit: true,
-						example: () => example
+						placeholderUntilEdit: true
 					})
 		});
 		const mounted = new EditorView(

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

@@ -25,12 +25,9 @@ interface Props {
     labelledBy?: string;
     /** The parked `description` (FieldLabel) → `aria-describedby`. */
     describedBy?: string;
-    /** The empty leaf's ghosts, a subform cell's, until the leaf's first edit: the
-     *  `none` an optional cell prints unset, and the `example:` drawn where there is no
-     *  placeholder and in its stead while the leaf holds the focus (`createField`'s
-     *  pair). Read per decoration pass. */
+    /** The empty leaf's ghost, a subform cell's, until the leaf's first edit: the
+     *  `none` an optional cell prints unset. Read per decoration pass. */
     placeholder?: string;
-    example?: string;
     onChange: (rt: Content) => void;
     /** Raw keydown, for a container whose own keys run through this leaf: the
      * array repeater's Enter/Backspace (`ArrayField`). Fires before the view's own

package/dist/visual/TextField.svelte

@@ -24,9 +24,6 @@
 		/** Words at rest about an unset field that holds no text: the `None` an optional
 		 * cell prints. */
 		placeholder?: string;
-		/** An unset field's `example:` (`exampleGhost`): drawn wherever the field holds no
-		 * text, and in `placeholder`'s stead while the input holds the focus. */
-		example?: string;
 		/** Accessible name for an input nothing else names: an array element, whose
 		 * name is the field label plus its 1-based index. A field's own input takes
 		 * `id` instead and is named by the `<label for>` beside it. */
@@ -41,8 +38,7 @@
 		 * array repeater's Enter/Backspace (`ArrayField`). */
 		onKey?: (e: KeyboardEvent) => void;
 	}
-	let { value, fallback, placeholder, example, label, id, describedBy, onCommit, onKey }: Props =
-		$props();
+	let { value, fallback, placeholder, label, id, describedBy, onCommit, onKey }: Props = $props();
 
 	// Local input state synced to `value`, or to the default an unset field holds:
 	// own-typing stays local, only an external change reconciles back in (see
@@ -50,9 +46,6 @@
 	const local = syncedLocal(() => value ?? fallback ?? '');
 	const defaulted = $derived(value == null && !!fallback && local.value === fallback);
 
-	let focused = $state(false);
-	const ghost = $derived(focused ? (example ?? placeholder) : (placeholder ?? example));
-
 	let inputEl: HTMLInputElement | undefined = $state();
 	/** Take the caret: what a parent placing focus on this control calls. */
 	export function focus(): void {
@@ -66,13 +59,11 @@
 	type="text"
 	value={local.value}
 	{id}
-	placeholder={ghost}
+	{placeholder}
 	data-default={defaulted ? '' : undefined}
 	aria-label={id ? undefined : label}
 	aria-describedby={describedBy}
 	onkeydown={onKey}
-	onfocus={() => (focused = true)}
-	onblur={() => (focused = false)}
 	oninput={(e) => {
 		local.value = (e.currentTarget as HTMLInputElement).value;
 		onCommit(local.value !== '' ? local.value : fallback ? '' : undefined);

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

@@ -6,9 +6,6 @@ interface Props {
     /** Words at rest about an unset field that holds no text: the `None` an optional
      * cell prints. */
     placeholder?: string;
-    /** An unset field's `example:` (`exampleGhost`): drawn wherever the field holds no
-     * text, and in `placeholder`'s stead while the input holds the focus. */
-    example?: string;
     /** Accessible name for an input nothing else names: an array element, whose
      * name is the field label plus its 1-based index. A field's own input takes
      * `id` instead and is named by the `<label for>` beside it. */

package/dist/visual/VisualEditorInner.svelte

@@ -63,7 +63,6 @@
 		provenanceMap,
 		resolvedByCardIndex,
 		ghostDefault,
-		declaredGhost,
 		titleText,
 		resolveBodyGhost,
 		NO_RESOLVED_ROWS,
@@ -612,7 +611,6 @@
 			bodyGhost: hasBody
 				? resolveBodyGhost(
 						titleText(ghostDefault(rows.body ?? undefined)) || undefined,
-						declaredGhost(cardSchema?.body?.example, true),
 						merged.bodyPlaceholder?.({ cardId: id, kind, isMain }),
 						merged.bodyGhost
 					)

package/dist/visual/controls.css

@@ -112,7 +112,7 @@
 	color: var(--_qm-ink-default);
 }
 /* The native placeholder is the label rung, not the UA's own grey: what an input
-   ghosts is words about a value it does not hold — an `example:`, `None` — which is
+   ghosts is words about a value it does not hold — `None` — which is
    content and reads at a content's contrast, the same step the prose leaf's ghost
    reads (`prose.css`). */
 :where(.qm-input)::placeholder {

package/dist/visual/index.js

@@ -10,10 +10,8 @@
 // that caller arrives, not before.
 // The theme derivation, which every control on this surface reads through `var()`.
 // Imported at the barrel because a subpath is what a consumer gets: this surface
-// reaches modules inside `core/` and never its entry, so a sheet hanging off that
-// entry arrives only for a consumer importing `/core` for some other reason. The
-// sheet rather than the entry, because the barrel needs the derivation and not
-// `init`. `check:deps` holds the reach.
+// reaches modules inside `core/` and never its entry, which carries no sheet.
+// `check:deps` holds the reach.
 import '../core/theme.css';
 export { default as VisualEditor } from './VisualEditor.svelte';
 // The prose leaf: the vanilla mount API a non-Svelte consumer (or a custom

package/dist/visual/structure.d.ts

@@ -138,32 +138,23 @@ export interface BodyPlaceholderContext {
  */
 export type BodyPlaceholder = (ctx: BodyPlaceholderContext) => string | undefined;
 /**
- * The empty body's ghost: the resolved body `default:`, else the kind's
- * `body.example`, else the consumer's wording, else the flat built-in. The
- * `default:` wins because it is the only one that describes the render: it promises
- * what prints if nothing is written, and wording placed over it would make that
- * promise unreadable. The rest are invitations, and an invitation belongs only where
- * there is no promise; the quill's own comes first, being the one an agent working
- * from the blueprint sees too.
+ * 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 that
+ * describes the render: it promises what prints if nothing is written, and wording
+ * placed over it would make that promise unreadable. The rest are invitations, and an
+ * invitation belongs only where there is no promise.
  */
-export declare function resolveBodyGhost(resolvedDefault: string | undefined, example: string | undefined, custom: string | undefined, builtIn: string): string;
+export declare function resolveBodyGhost(resolvedDefault: string | undefined, custom: string | undefined, builtIn: string): string;
 /** Whether a cell is optional: a `t?` type, which renders `none` unanswered and so
  *  never declares a `default:` (canon `SCHEMAS.md` §"Optional cells"). */
 export declare function optionalCell(f: QuillFieldSchema): boolean;
 /** The type a cell's control reads: the declared one, an optional cell's `?` stripped.
  *  The `?` moves the render floor and nothing else, so every read of a type is this. */
 export declare function baseType(f: QuillFieldSchema): QuillFieldType;
-/**
- * A value the schema declares, as ghost text: a `default:`, an `example:` or a
- * `body.example`. Markdown — a `richtext` value — ghosts as the text it renders, one
- * block to a line, as a resolved default does ({@link titleText}); anything else as
- * itself. `undefined` for a blank or a non-scalar.
- */
-export declare function declaredGhost(v: unknown, markdown: boolean): string | undefined;
 /**
  * A scalar `default:` as the text an unset control holds, where it prints: as
  * declared, `undefined` for none, a blank or a non-scalar. A default of spaces prints
- * nothing a reader sees, so a control holds none and draws its example instead.
+ * nothing a reader sees, so a control holds none.
  */
 export declare function printedText(v: unknown): string | undefined;
 /**
@@ -174,13 +165,6 @@ export declare function printedText(v: unknown): string | undefined;
  * a blank or a non-scalar.
  */
 export declare function declaredContent(v: unknown, markdown: boolean): Content | undefined;
-/**
- * The `example:` an unset free-text cell ghosts: a `string`, `plaintext` or `richtext`
- * whose `default:` prints nothing. Every other type takes none. A default that prints
- * dominates, standing in the control as the value it is; a type-empty one, the
- * skippable marker, prints nothing and leaves the example the only thing to draw.
- */
-export declare function exampleGhost(f: QuillFieldSchema): string | undefined;
 /** A field's `{#each}` key: its name and what a mounted leaf reads once, its type and
  *  `inline` and its elements'. A retype or a quill swap that changes any of them under a
  *  name remounts the field, where a kept leaf would commit on the old schema. */

package/dist/visual/structure.js

@@ -48,16 +48,14 @@ export function stringifyGhost(ghost) {
     return ghost != null && typeof ghost !== 'object' ? String(ghost) : undefined;
 }
 /**
- * The empty body's ghost: the resolved body `default:`, else the kind's
- * `body.example`, else the consumer's wording, else the flat built-in. The
- * `default:` wins because it is the only one that describes the render: it promises
- * what prints if nothing is written, and wording placed over it would make that
- * promise unreadable. The rest are invitations, and an invitation belongs only where
- * there is no promise; the quill's own comes first, being the one an agent working
- * from the blueprint sees too.
+ * 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 that
+ * describes the render: it promises what prints if nothing is written, and wording
+ * placed over it would make that promise unreadable. The rest are invitations, and an
+ * invitation belongs only where there is no promise.
  */
-export function resolveBodyGhost(resolvedDefault, example, custom, builtIn) {
-    return resolvedDefault || example || custom || builtIn;
+export function resolveBodyGhost(resolvedDefault, custom, builtIn) {
+    return resolvedDefault || custom || builtIn;
 }
 /** Whether a cell is optional: a `t?` type, which renders `none` unanswered and so
  *  never declares a `default:` (canon `SCHEMAS.md` §"Optional cells"). */
@@ -69,22 +67,10 @@ export function optionalCell(f) {
 export function baseType(f) {
     return (optionalCell(f) ? f.type.slice(0, -1) : f.type);
 }
-/**
- * A value the schema declares, as ghost text: a `default:`, an `example:` or a
- * `body.example`. Markdown — a `richtext` value — ghosts as the text it renders, one
- * block to a line, as a resolved default does ({@link titleText}); anything else as
- * itself. `undefined` for a blank or a non-scalar.
- */
-export function declaredGhost(v, markdown) {
-    const text = stringifyGhost(v)?.trim();
-    if (!text)
-        return undefined;
-    return (markdown ? core().importMarkdown(text).text.trim() : text) || undefined;
-}
 /**
  * A scalar `default:` as the text an unset control holds, where it prints: as
  * declared, `undefined` for none, a blank or a non-scalar. A default of spaces prints
- * nothing a reader sees, so a control holds none and draws its example instead.
+ * nothing a reader sees, so a control holds none.
  */
 export function printedText(v) {
     const text = stringifyGhost(v);
@@ -114,21 +100,6 @@ export function declaredContent(v, markdown) {
         islands: []
     };
 }
-/**
- * The `example:` an unset free-text cell ghosts: a `string`, `plaintext` or `richtext`
- * whose `default:` prints nothing. Every other type takes none. A default that prints
- * dominates, standing in the control as the value it is; a type-empty one, the
- * skippable marker, prints nothing and leaves the example the only thing to draw.
- */
-export function exampleGhost(f) {
-    const kind = controlKind(f);
-    if (kind !== 'text' && kind !== 'prose')
-        return undefined;
-    const markdown = baseType(f) === 'richtext';
-    if (declaredGhost(f.default, markdown) !== undefined)
-        return undefined;
-    return declaredGhost(f.example, markdown);
-}
 /** A field's `{#each}` key: its name and what a mounted leaf reads once, its type and
  *  `inline` and its elements'. A retype or a quill swap that changes any of them under a
  *  name remounts the field, where a kept leaf would commit on the old schema. */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@quillmark/svelte",
-	"version": "0.14.0",
+	"version": "0.16.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.116.0-0",
+		"@quillmark/wasm": ">=0.118.0-0",
 		"svelte": "^5.0.0"
 	},
 	"dependencies": {