@quillmark/svelte 0.1.1 → 0.3.0

package/dist/visual/TextField.svelte

@@ -1,11 +1,11 @@
 <!--
- A `string` field → text input. Commits a non-empty edit LIVE (on input) via the
+ A `string` field → text input. Commits a non-empty edit live (on input) via the
  parent's typed `writer.set`, so the preview tracks typing. A cleared field is the
- UNSET rung of the commitment ladder (VISUAL_EDITOR §"Structure mirrors the schema"): it
+ unset rung of the commitment ladder (VISUAL_EDITOR §"Structure mirrors the schema"): it
  commits `undefined` (the parent removes the field, ghosted `default:` renders):
- but at `change` (blur), NOT per keystroke, so select-all-and-retype doesn't flash
+ but at `change` (blur), not per keystroke, so select-all-and-retype doesn't flash
  the field through its default between the delete and the first typed char.
- Trade-off (recorded in VISUAL_EDITOR): an explicit empty string OVER a non-empty
+ Trade-off (recorded in VISUAL_EDITOR): an explicit empty string over a non-empty
  default is inexpressible from the UI: clear and unset collapse to one gesture.
 -->
 <script lang="ts">
@@ -15,7 +15,7 @@
 	interface Props {
 		value: string | undefined;
 		placeholder?: string;
-		/** Accessible name for an input NOTHING else names: an array element, whose
+		/** 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. */
 		label?: string;

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

@@ -2,7 +2,7 @@ import './controls.css';
 interface Props {
     value: string | undefined;
     placeholder?: string;
-    /** Accessible name for an input NOTHING else names: an array element, whose
+    /** 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. */
     label?: string;

package/dist/visual/TipsCard.svelte

@@ -2,9 +2,9 @@
  The ephemeral tips card. Renders the
  `$ext.editor.tips` channel one tip at a time: dots reach any tip in the set, and the
  foot's one button advances until the last, where it becomes the dismiss. Dismissal
- CLEARS the channel in the Document, so the card is gone and does not reappear.
+ clears the channel in the Document, so the card is gone and does not reappear.
 
- The cursor is LOCAL state, not the channel. Advancing writes nothing: a per-tip
+ The cursor is local state, not the channel. Advancing writes nothing: a per-tip
  write would round-trip the boundary, re-derive the card tree, and dirty the
  document (firing a consumer's autosave) on what is a read gesture. Exactly one
  write happens, at dismissal, and this component unmounts with it, so the cursor
@@ -40,7 +40,7 @@
 	const index = $derived(Math.min(cursor, tips.length - 1));
 	const isLast = $derived(index >= tips.length - 1);
 
-	// The tip STRING is derived before the effect reads it, and that is load-bearing.
+	// The tip string is derived before the effect reads it, and that is load-bearing.
 	// Reading `tips[index]` inside the effect makes the parent's `model` derive the
 	// dependency (a fresh object every `revision` bump) so the effect would re-run
 	// on every unrelated commit, re-crossing the WASM boundary and rebuilding this
@@ -81,7 +81,7 @@
 				{/each}
 			</div>
 		{/if}
-		<!-- ONE button, and its action is where the cursor stands: the set is walked,
+		<!-- One button, and its action is where the cursor stands: the set is walked,
 		     and its end is the exit. -->
 		<button type="button" class="qm-icon-btn qm-tips-action" onclick={advance}>
 			{#if isLast}
@@ -94,44 +94,57 @@
 </aside>
 
 <style>
-	/* ATTACHED to `main`, not a block beside it: a square top pulled up by the radius,
+	/* Attached to `main`, not a block beside it: a square top pulled up by the radius,
 	 so its background fills the notches `main`'s rounded bottom corners cut and `main`
-	 paints over the rest. The seam is `main`'s own bottom hairline, and the two read as
-	 one block, which is what document-level guidance is: the main card's, not a card of
-	 its own. Still in-flow, one hairline, no lift, no fill beyond the card recipe. It
-	 reads as guidance rather than as a field by TONE and TYPE: the label rung in the
-	 muted label colour; not by a badge or an accent. It mints no token of its own;
-	 every value here is an existing dial.
+	 paints over the rest. The two read as one block, which is what document-level
+	 guidance is: the main card's, not a card of its own. Still in-flow, no edge, no
+	 lift.
+
+	 A typewritten slip, and that is the whole of the treatment: the monospace face and
+	 a warmth over the card's own surface, which together say draft rather than
+	 document. Both come off the tips rungs (`core/theme.css`), which are mixes over
+	 the surface and the ink the consumer already tuned, so the card cannot end up less
+	 legible than the editor around it.
 
 	 The top inset takes the tuck back, so the space above the tip is the space below
 	 the foot.
 
-	 Leading is the reading rung, not the tight one the label SIZE would suggest: a
-	 tip is a passage that wraps, and the two axes are independent. */
+	 The reading rungs, size and leading both: a tip is a passage that wraps, so it
+	 takes the size a field's value is read at rather than the label rung a line of
+	 chrome would take. */
 	.qm-tips {
 		margin-top: calc(var(--_qm-radius) * -1);
-		border: var(--_qm-border-width) solid var(--_qm-border);
 		border-radius: 0 0 var(--_qm-radius) var(--_qm-radius);
 		padding: calc(var(--_qm-space-3) + var(--_qm-radius)) var(--_qm-space-3) var(--_qm-space-3);
-		background: var(--_qm-surface-raised);
+		background: var(--_qm-tips-surface);
 		display: flex;
 		flex-direction: column;
 		gap: var(--_qm-space-2);
-		font-size: var(--_qm-text-label);
+		font-family: var(--_qm-font-mono);
+		font-size: var(--_qm-text-body);
 		line-height: var(--_qm-leading-body);
-		color: var(--_qm-ink-label);
+		color: var(--_qm-tips-ink);
 	}
 	/* The rendered tip is injected DOM (the codec's `toDOM` output), so its element
-	 styles are `:global`: the compiler never sees these tags in the markup. Three
-	 rules restated from `core/codec/prose.css`, which is where they are argued and
-	 which cannot reach here: its selectors are scoped to `.ProseMirror` and a tip is
-	 not a view. The one deliberate divergence is the link, which takes no underline:
-	 a tip is not editable, so a hidden `href` costs its reader nothing. */
+	 styles are `:global`: the compiler never sees these tags in the markup. Restated
+	 from `core/codec/prose.css`, which is where they are argued and which cannot reach
+	 here: its selectors are scoped to `.ProseMirror` and a tip is not a view. Two
+	 deliberate divergences, and both follow from the card being read rather than
+	 edited: the link takes no underline, since a hidden `href` costs its reader
+	 nothing; and `code` takes a chip where a leaf gives it a face, since the face is
+	 already the card's own and a token like `- ` has nothing else to set it apart.
+	 `pre-wrap` is what keeps the significant space inside such a token: collapsed, the
+	 chip closes on the word after it. */
 	.qm-tips-body :global(p) {
 		margin: 0;
 	}
 	.qm-tips-body :global(code) {
-		font-family: var(--_qm-font-mono);
+		font-family: inherit;
+		font-size: inherit;
+		white-space: pre-wrap;
+		padding: 0 var(--_qm-space-half);
+		border-radius: var(--_qm-radius-inner);
+		background: var(--_qm-tips-chip);
 	}
 	.qm-tips-body :global(a) {
 		color: inherit;
@@ -147,7 +160,7 @@
 		align-items: center;
 		margin-right: auto;
 	}
-	/* Random access to the set, and the PITCH is the tap floor: 2.5.8's spacing
+	/* Random access to the set, and the pitch is the tap floor: 2.5.8's spacing
 	 exception measures centre distance, which is the number the floor already fixes,
 	 so a tighter row of dots buys nothing it does not immediately owe back. Target and
 	 mark are therefore not one rectangle (the floor is the button, the dot is drawn
@@ -164,7 +177,7 @@
 		background: transparent;
 		cursor: pointer;
 	}
-	/* Three steps of ONE ink on the recede ladder (rest, hover, current), never a
+	/* Three steps of one ink on the recede ladder (rest, hover, current), never a
 	 second hue and never a size: a dot that grew would move the row it sits in. */
 	.qm-tips-dot::before {
 		content: '';
@@ -182,10 +195,12 @@
 		opacity: 1;
 	}
 	/* Box and disabled state come from `.qm-icon-btn` (controls.css); the foot's
-	   button carries a label and so widens its inset and takes the meta type rung. */
+	   button carries a label, so it widens its inset and stays on the card's own type
+	   and ink rather than the family's body rung and the callers' own colours. */
 	.qm-tips-action {
 		padding: var(--_qm-space-half) var(--_qm-space-2);
-		font-size: var(--_qm-text-meta);
-		color: var(--_qm-ink-label);
+		font-family: inherit;
+		font-size: inherit;
+		color: inherit;
 	}
 </style>

package/dist/visual/VisualEditor.svelte

@@ -3,11 +3,11 @@
  `doc` prop remounts the editor under it, so a consumer holding one mount across
  two documents gets a surface that names the live handle.
 
- IT IS A `{#key}`, NOT A RESEED. The state a swap invalidates is not one field:
+ It is A `{#key}`, not A reseed. The state a swap invalidates is not one field:
  composable cards key on session id, the main card is keyed on nothing, and each
  prose leaf mounts once per stable leaf key with `createField` closing over the
  `doc` it mounted against — so after an in-place swap the main card's leaves
- commit to the PREVIOUS handle. Reseeding by hand means threading a generation
+ commit to the previous handle. Reseeding by hand means threading a generation
  token through every leaf key and resetting the id state, the commit-error map,
  the active address, the leaf registry, the card refs and any pending scroll,
  which is a remount spelled out one field at a time. This spells it as one.
@@ -16,17 +16,16 @@
  unregisters, cancels its pending ticks, and only then releases, so a continuation
  awaiting a flush across the swap runs against nothing.
 
- `quill` is NOT part of the key: the schema is re-read on every derive, so a quill
+ `quill` is not part of the key: the schema is re-read on every derive, so a quill
  swap re-projects correctly on its own, and keying on it would throw away a card
  tree that did not need rebuilding. What it cannot do is re-mount the leaves, so a
- quill swapped WITHOUT a doc swap reports `rebind-ignored` rather than passing
+ quill swapped without a doc swap reports `rebind-ignored` rather than passing
  silently.
 -->
 <script lang="ts">
 	import { untrack } from 'svelte';
-	import { reportError } from '../core/errors.js';
-	import type { ContentHit } from '@quillmark/wasm';
-	import type { DocPath } from '../core/address.js';
+	import { reportRebindIgnored } from '../core/rebind.svelte.js';
+	import type { DocPath, Landing } from '../core/address.js';
 	import type { CardId } from './signals.js';
 	import type { VisualEditorProps } from './props.js';
 	import VisualEditorInner from './VisualEditorInner.svelte';
@@ -35,7 +34,7 @@
 
 	let inner = $state<VisualEditorInner | undefined>();
 
-	// The pair the CURRENT mount bound to. Re-read on each re-key rather than held
+	// The pair the current mount bound to. Re-read on each re-key rather than held
 	// from the first mount: after a doc swap the incoming mount binds whatever quill
 	// came with it, and comparing against the original would report a pairing that
 	// is correct.
@@ -54,24 +53,24 @@
 			}
 			if (quill === boundQuill || reported) return;
 			reported = true;
-			reportError(props.onError, {
-				code: 'rebind-ignored',
-				severity: 'dev',
-				message:
-					'quill swapped in place; the mounted leaves still commit against the quill this doc mounted with. Swap the doc with it, or remount the editor, to rebind.'
-			});
+			reportRebindIgnored(
+				props.onError,
+				'quill swapped in place; the mounted leaves still commit against the quill this doc mounted with. Swap the doc with it, or remount the editor, to rebind.'
+			);
 		});
 	});
 
 	// The instance surface, every member a pass-through to the live mount: a call
 	// landing between a swap and the incoming mount is a no-op rather than a throw,
-	// which is what lets a host hold ONE `bind:this` across two documents.
+	// which is what lets a host hold one `bind:this` across two documents.
 
-	/** Place the caret at a preview hit. */
-	export async function setCaret(hit: ContentHit): Promise<void> {
-		await inner?.setCaret(hit);
+	/** Land a preview pick: a caret where the payload carries one and the leaf can
+	 *  spend it, an array element where the address names one, a focus otherwise. */
+	export async function setCaret(at: Landing): Promise<void> {
+		await inner?.setCaret(at);
 	}
-	/** Reveal and focus the leaf at `field`, without placing a caret inside it. */
+	/** Reveal and focus the field at `field` — any mounted one — without placing a
+	 *  caret inside it. */
 	export async function focusField(field: DocPath): Promise<void> {
 		await inner?.focusField(field);
 	}

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

@@ -1,9 +1,8 @@
-import type { ContentHit } from '@quillmark/wasm';
-import type { DocPath } from '../core/address.js';
+import type { DocPath, Landing } from '../core/address.js';
 import type { CardId } from './signals.js';
 import type { VisualEditorProps } from './props.js';
 declare const VisualEditor: import("svelte").Component<VisualEditorProps, {
-    setCaret: (hit: ContentHit) => Promise<void>;
+    setCaret: (at: Landing) => Promise<void>;
     focusField: (field: DocPath) => Promise<void>;
     insertCard: (kind: string, at?: number) => CardId | undefined;
     removeCard: (cardId: CardId) => void;