@quillmark/svelte 0.11.0 → 0.13.0

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

@@ -0,0 +1,36 @@
+import type { Content, PathStep, QuillFieldSchema } from '@quillmark/wasm';
+import { type DeepDiagnostic } from './diagnostics.js';
+import type { LandingBox } from './leaves.js';
+import './controls.css';
+interface Props {
+    /** The stored sparse map, or undefined while the field is unset. */
+    value: Record<string, unknown> | undefined;
+    /** The field's own schema: `members` is the roster, `properties` the columns. */
+    schema: QuillFieldSchema;
+    /** Field label, the naming prefix a member's columns compose with. */
+    label?: string;
+    /** Schema `description`: the label's help affordance. */
+    description?: string;
+    /** The label's own DOM id: the group's name, each tick keeping its own `<label>`. */
+    labelId?: string;
+    /** Where the description parks, for the group's `aria-describedby`. */
+    descriptionId?: string;
+    /** The field's control id: the base a member's tick and columns derive their own
+     * names from, one `-m-<member id>` segment down. */
+    idBase?: string;
+    /** The boundary's nested content read, rooted at this field: a member's content
+     * column reads at `[id, column]` (`reader.getContentAt`). */
+    contentAt: (path: PathStep[]) => Content | undefined;
+    onCommit: (v: Record<string, unknown> | undefined) => void;
+    /** The diagnostics routed into this field, each with its steps still to walk: one
+     * naming a member draws under that member, one naming nothing on the roster at the
+     * field's foot. */
+    diagnostics?: readonly DeepDiagnostic[];
+}
+declare const MatrixField: import("svelte").Component<Props, {
+    focus: () => void;
+    washBox: () => HTMLElement | undefined;
+    focusPath: (steps: readonly PathStep[], pos?: number) => LandingBox;
+}, "">;
+type MatrixField = ReturnType<typeof MatrixField>;
+export default MatrixField;

package/dist/visual/NumberField.svelte

@@ -4,10 +4,13 @@
  (`-`, `1.`, `1e`) is never a document state worth a boundary round-trip, and
  committing it live flashes a coercion diagnostic + `console.error` on every
  intermediate prefix, announced by `DiagnosticList`'s `role="status"` live
- region. A blank entry commits `undefined`: the unset rung of the
- commitment ladder: the parent removes the field and the engine renders the
- ghosted `default:`. Settling at `change` also keeps
- select-all-and-retype from flashing the preview through the default mid-keystroke.
+ region.
+
+ An unset field holds its resolved `default:` as its text, at the default rung
+ (theme.css), and an edit that settles writes it as authored, as `TextField` takes
+ its default. A number has no empty answer (canon `SCHEMAS.md` §"Native validation"),
+ so a blank entry commits `undefined`, the unset rung: the parent removes the field,
+ the engine renders the default, and the input holds it again.
 
  `type="text"`, not `type="number"`: a native number input sanitizes an
  invalid string to `""` before the DOM `value` setter even runs (verified:
@@ -26,7 +29,11 @@
 	interface Props {
 		value: number | undefined;
 		integer?: boolean;
-		fallback?: number;
+		/** The resolved `default:` as text: what an unset field holds. */
+		fallback?: string;
+		/** Words at rest about an unset field that holds no text: the `None` an optional
+		 * cell prints. */
+		placeholder?: string;
 		/** Accessible name for an input nothing else names: an object property, whose
 		 * name is the field label plus the property's. A field's own input takes `id`
 		 * instead and is named by the `<label for>` beside it. */
@@ -38,16 +45,25 @@
 		describedBy?: string;
 		onCommit: (v: number | string | undefined) => void;
 	}
-	let { value, integer, fallback, label, id, describedBy, onCommit }: Props = $props();
+	let { value, integer, fallback, placeholder, label, id, describedBy, onCommit }: Props = $props();
 
-	// Local input state synced to `value` (as a string projection); own-typing
-	// stays local, only an external change reconciles back in (see `syncedLocal`).
-	const local = syncedLocal(() => (value != null ? String(value) : ''));
+	// Local input state synced to `value` (as a string projection), or to the default
+	// an unset field holds; own-typing stays local, only an external change reconciles
+	// back in (see `syncedLocal`).
+	const local = syncedLocal(() => (value != null ? String(value) : (fallback ?? '')));
+	const defaulted = $derived(value == null && !!fallback && local.value === fallback);
 
 	// Parse a settled entry and emit it; `local` is owned by `oninput`. Blank →
-	// `undefined` (the unset rung: parent removes the field, default renders).
-	function commit(raw: string): void {
-		if (raw.trim() === '') return void onCommit(undefined);
+	// `undefined`, and the input takes the default back: nothing else reconciles it, the
+	// projection having read the default throughout. Onto the element as well, since the
+	// attribute Svelte last wrote may already be the default, and it writes no repeat.
+	function commit(el: HTMLInputElement): void {
+		const raw = el.value;
+		if (raw.trim() === '') {
+			onCommit(undefined);
+			local.value = el.value = fallback ?? '';
+			return;
+		}
 		// Number(), not parseFloat/parseInt: a prefix parse would silently commit
 		// `14.5` for `14.5x` (and truncate `11.9` → 11 on integer fields) instead
 		// of letting the boundary judge the full entry.
@@ -62,11 +78,12 @@
 	inputmode={integer ? 'numeric' : 'decimal'}
 	value={local.value}
 	{id}
-	placeholder={fallback != null ? String(fallback) : ''}
+	{placeholder}
+	data-default={defaulted ? '' : undefined}
 	aria-label={id ? undefined : label}
 	aria-describedby={describedBy}
 	oninput={(e) => {
 		local.value = (e.currentTarget as HTMLInputElement).value;
 	}}
-	onchange={(e) => commit((e.currentTarget as HTMLInputElement).value)}
+	onchange={(e) => commit(e.currentTarget as HTMLInputElement)}
 />

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

@@ -2,7 +2,11 @@ import './controls.css';
 interface Props {
     value: number | undefined;
     integer?: boolean;
-    fallback?: number;
+    /** The resolved `default:` as text: what an unset field holds. */
+    fallback?: string;
+    /** Words at rest about an unset field that holds no text: the `None` an optional
+     * cell prints. */
+    placeholder?: string;
     /** Accessible name for an input nothing else names: an object property, whose
      * name is the field label plus the property's. A field's own input takes `id`
      * instead and is named by the `<label for>` beside it. */