@quillmark/svelte 0.21.0 → 0.23.0

package/dist/visual/structure.js

@@ -84,6 +84,21 @@ export function optionalCell(f) {
 export function baseType(f) {
     return (optionalCell(f) ? f.type.slice(0, -1) : f.type);
 }
+/** Whether a content field is one line: one paragraph, no container, no island. A `text`
+ *  or `richtext` field is one line unless it declares `multiline: true`. */
+export function oneLine(f) {
+    return f.multiline !== true;
+}
+/** Whether a content field's codec is the literal one, its value text with no marks: `text`. */
+export function literalText(f) {
+    return baseType(f) === 'text';
+}
+/** The character cap a content field's `max:` declares, `undefined` on any other. */
+export function textCap(f) {
+    if (f?.max == null || controlKind(f) !== 'prose')
+        return undefined;
+    return { max: f.max, trimEnd: literalText(f) && oneLine(f) };
+}
 /**
  * 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
@@ -95,7 +110,7 @@ export function printedText(v) {
 }
 /**
  * A declared content literal as the `Content` it holds: a `richtext` one's markdown
- * imported, a `plaintext` one's text taken literally, one paragraph whose later lines
+ * imported, a `text` one's text taken literally, one paragraph whose later lines
  * continue it, as the literal codec reads a stored one. What a cell's static
  * `default:` stands in its leaf as, where no resolved row reaches it. `undefined` for
  * a blank or a non-scalar.
@@ -117,26 +132,33 @@ export function declaredContent(v, markdown) {
         islands: []
     };
 }
-/** 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. */
+/** A field's `{#each}` key: its name and what a mounted leaf reads once, its type,
+ *  {@link oneLine} and `max:`, 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. */
 export function mountKey(name, f) {
-    return `${name}\u0000${f.type}\u0000${f.inline === true}\u0000${f.items?.type ?? ''}\u0000${f.items?.inline === true}`;
-}
-/** 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
- * element. */
+    const items = f.items;
+    return [
+        name,
+        f.type,
+        oneLine(f),
+        f.max ?? '',
+        items?.type ?? '',
+        items ? oneLine(items) : '',
+        items?.max ?? ''
+    ].join('\u0000');
+}
+/** Map a field schema to its control. An array's element control is this over `items`;
+ *  a type this build does not know takes the text input. */
 export function controlKind(f) {
     switch (baseType(f)) {
         case 'richtext':
-        case 'plaintext':
+        case 'text':
             return 'prose';
         case 'enum':
             // `variants:` is the one key that changes a field's resting shape (canon
             // `SCHEMAS.md`): with it the field rests as a container, without it a bare string.
             return f.variants ? 'variant' : 'enum';
-        case 'string':
-            return 'text';
         case 'number':
         case 'integer':
             return 'number';
@@ -300,13 +322,13 @@ export function addedId(title, taken) {
     return `${base}_${n}`;
 }
 /** The `object` a matrix member is, for the schema walk: the declared columns, and an
- *  added item's `title` beside them. Composed here because the boundary serializes the
- *  roster and the columns alone. */
+ *  added item's `title`, a one-line `text` cell, beside them. Composed here because the
+ *  boundary serializes the roster and the columns alone. */
 export function matrixMemberSchema(matrix, id) {
     const columns = matrix.properties ?? {};
     return {
         type: 'object',
-        properties: onRoster(matrix, id) ? columns : { [MATRIX_TITLE]: { type: 'string' }, ...columns }
+        properties: onRoster(matrix, id) ? columns : { [MATRIX_TITLE]: { type: 'text' }, ...columns }
     };
 }
 // ── The schema walk ──────────────────────────────────────────────────────────
@@ -330,7 +352,7 @@ export function schemaAt(field, steps) {
 /** What an array declaring no `items` holds, the walk's copy of the element control
  *  {@link controlKind} names for one: a text element, so an index into such an array is
  *  a place and not a refusal. */
-const UNDECLARED_ELEMENT = { type: 'string' };
+const UNDECLARED_ELEMENT = { type: 'text' };
 function stepInto(schema, step) {
     switch (controlKind(schema)) {
         case 'array':
@@ -361,17 +383,16 @@ function stepInto(schema, step) {
 }
 // ── Row summaries and layouts ────────────────────────────────────────────────
 /** Whether a cell is one line tall by declaration: the shape a table column and a row
- *  summary can hold. A prose cell is one where it declares `inline`, `richtext` or
- *  `plaintext` alike. */
+ *  summary can hold. A prose cell is one where it is {@link oneLine}. */
 export function shortCell(sub) {
     const kind = controlKind(sub);
     if (kind === 'prose')
-        return !!sub.inline;
+        return oneLine(sub);
     return (kind === 'text' || kind === 'enum' || kind === 'number' || kind === 'boolean' || kind === 'date');
 }
 /**
- * The first short text cell's words — the first `string`, or inline `richtext` /
- * `plaintext`, in declaration order — read through {@link titleText}; `undefined` where
+ * The first short text cell's words — the first one-line `text` or `richtext`, in
+ * declaration order — read through {@link titleText}; `undefined` where
  * there is no such cell or it is empty. The cell is picked by the schema alone, so an
  * instance is named by one cell whatever the others hold. What names an instance from
  * its own values: a collapsed row, and a card whose kind declares no `title`.
@@ -435,39 +456,36 @@ export function commitDiscriminant(value, member) {
     delete next[VARIANT_DISCRIMINANT];
     return Object.keys(next).length ? next : undefined;
 }
-/**
- * Whether the schema obliges a cell: `default:`'s absence, which is the whole of the
- * obligation (DOCUMENT_MODEL). Exempt are the cells whose absence of one says nothing:
- * a typed dictionary, since a namespace declares no `default:` at all and `validate`
- * anchors obligation on the leaves under it; a matrix, whose blank is nothing held, a
- * whole answer; and an optional cell, which can declare none, its unanswered render
- * being `none`.
- */
-export function obliged(schema) {
-    return (schema.type !== 'object' &&
-        schema.type !== 'matrix' &&
-        !optionalCell(schema) &&
-        schema.default === undefined);
-}
 /** `foo_bar` → `Foo bar`: the label fallback when a field declares no `title`. */
 export function humanize(name) {
     const spaced = name.replace(/_/g, ' ').trim();
     return spaced ? spaced[0].toUpperCase() + spaced.slice(1) : spaced;
 }
-/** Project a card schema's `fields` map (declaration = key order) into models. */
+/**
+ * Whether a field asks to share a row when its `ui.compact` is undeclared: a control
+ * whose type bounds its width. Text never does, its type saying nothing of whether a
+ * value is a rank or a subject line, so a short text field asks with `compact: true`.
+ */
+function packsByDefault(control) {
+    return control === 'date' || control === 'enum' || control === 'number' || control === 'boolean';
+}
+/** Project a card schema's `fields` map (declaration = key order) into models. A
+ *  card-level object's `properties` project the same way. */
 export function fieldModels(cardSchema) {
-    return Object.entries(cardSchema.fields).map(([name, schema]) => ({
-        name,
-        schema,
-        control: controlKind(schema),
-        group: schema.ui?.group,
-        compact: !!schema.ui?.compact,
-        label: schema.title ?? humanize(name),
-        description: schema.description,
-        required: obliged(schema),
-        inline: !!schema.inline,
-        plaintext: baseType(schema) === 'plaintext'
-    }));
+    return Object.entries(cardSchema.fields).map(([name, schema]) => {
+        const control = controlKind(schema);
+        return {
+            name,
+            schema,
+            control,
+            group: schema.ui?.group,
+            compact: schema.ui?.compact ?? packsByDefault(control),
+            label: schema.title ?? humanize(name),
+            description: schema.description,
+            inline: oneLine(schema),
+            plaintext: literalText(schema)
+        };
+    });
 }
 /**
  * Group-section order (VISUAL_EDITOR §"Structure mirrors the schema"): the schema's `ui.groups` registry
@@ -543,12 +561,12 @@ export function initialExpandedGroup(sections) {
     return sections.find((s) => s.group != null)?.group ?? null;
 }
 /**
- * Whether a field can share a row. `ui.compact` asks; a shape declines when the
+ * Whether a field can share a row. `compact` asks; a shape declines when the
  * 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.
+ * beside it does not grow in step: an object nests a whole field set, a multiline prose
+ * leaf holds paragraphs or lines, and an array holds however many elements the
+ * document carries. Any of them stands its neighbour in a column of whitespace. A
+ * one-line prose leaf packs like any scalar.
  *
  * A variant declines for the same reason one step further in: its height is the live
  * world's cell count, so it is set by a pick rather than only by the document, and a

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@quillmark/svelte",
-	"version": "0.21.0",
+	"version": "0.23.0",
 	"description": "Editor, live-preview and source surfaces over a Quillmark WASM session.",
 	"repository": {
 		"type": "git",
@@ -23,7 +23,7 @@
 	"author": "Quillmark Contributors",
 	"type": "module",
 	"engines": {
-		"node": ">=24"
+		"node": ">=22"
 	},
 	"svelte": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -69,7 +69,7 @@
 		"check": "svelte-check --tsconfig ./tsconfig.json --fail-on-warnings"
 	},
 	"peerDependencies": {
-		"@quillmark/wasm": ">=0.125.0-0",
+		"@quillmark/wasm": ">=0.126.0-0",
 		"svelte": "^5.33.0"
 	},
 	"dependencies": {