@quillmark/wasm 0.69.1 → 0.71.0

package/bundler/wasm.d.ts

@@ -102,10 +102,9 @@ export interface QuillCardUi {
 /** Schema entry for a single field declared in a quill's `Quill.yaml`. */
 export interface QuillFieldSchema {
     type: "string" | "number" | "integer" | "boolean" | "array" | "object" | "date" | "datetime" | "markdown";
-    title?: string;
     description?: string;
     default?: unknown;
-    examples?: unknown;
+    example?: unknown;
     required?: boolean;
     enum?: string[];
     ui?: QuillFieldUi;
@@ -115,37 +114,33 @@ export interface QuillFieldSchema {
 
 /** Schema entry for the main card or a named card type. */
 export interface QuillCardSchema {
-    title?: string;
     description?: string;
     fields: Record<string, QuillFieldSchema>;
     ui?: QuillCardUi;
 }
 
 /**
- * Public schema contract returned as `QuillMetadata.schema`.
+ * Document schema. Returned by both `Quill.schema` (no ui hints) and
+ * `Quill.formSchema` (with ui hints) — same shape, optional `ui` keys.
  *
- * Identical to `QuillConfig::public_schema()` on the Rust side.
+ * `main.fields.QUILL` and `card_types[name].fields.CARD` are required
+ * sentinels with `const` values telling consumers what to write.
  */
 export interface QuillSchema {
-    name: string;
     main: QuillCardSchema;
     /** Present only when the quill declares at least one named card type. */
     card_types?: Record<string, QuillCardSchema>;
-    /** The quill's bundled example document, if declared. */
-    example?: string;
 }
 
 /**
- * Read-only snapshot of the loaded quill's engine info and declared schema.
- * Returned by `Quill.metadata`.
- *
- * Well-known keys are strongly typed; any additional keys declared under
- * `quill:` in `Quill.yaml` appear as `unknown`.
+ * Identity snapshot mirroring the `quill:` section of `Quill.yaml`.
+ * Schemas live on `Quill.schema` / `Quill.formSchema`; the example on
+ * `Quill.example`. Extra `quill:` keys appear as `unknown`.
  */
 export interface QuillMetadata {
-    schema: QuillSchema;
-    backend: string;
+    name: string;
     version: string;
+    backend: string;
     author: string;
     description: string;
     supportedFormats: OutputFormat[];
@@ -233,7 +228,7 @@ export interface RenderResult {
     renderTimeMs: number;
 }
 
-export type FrontmatterItem = { kind: "field"; key: string; value: unknown; fill?: boolean } | { kind: "comment"; text: string };
+export type FrontmatterItem = { kind: "field"; key: string; value: unknown; fill?: boolean } | { kind: "comment"; text: string; inline?: boolean };
 
 export type OutputFormat = "pdf" | "svg" | "txt" | "png";
 
@@ -508,23 +503,20 @@ export class Quill {
      */
     readonly backendId: string;
     /**
-     * Read-only snapshot of the loaded quill's engine info and declared schema.
-     *
-     * Returns a plain JS object with:
-     * - `schema` — the quill's public schema contract, identical to
-     *   `QuillConfig::public_schema()`. Top-level keys: `name`, `main`,
-     *   optional `card_types` (map keyed by card name, omitted when empty),
-     *   optional `example`. `main` and each card under `card_types` share
-     *   the same shape: `fields` (map keyed by field name), optional
-     *   `title`, `description`, `ui`.
-     * - `backend`, `version`, `author`, `description` — quill identity
-     *   declared in `Quill.yaml`'s `quill:` section. `description` describes
-     *   the quill itself; if the author also declared `main.description` (the
-     *   schema description of the entry-point card), it lives at
-     *   `schema.main.description` and is independent.
-     * - `supportedFormats` — output formats the backend produces, as
-     *   lowercase strings.
-     * - Any additional unstructured keys declared under `quill:`.
+     * Auto-generated annotated Markdown blueprint for LLM consumers.
+     */
+    readonly blueprint: string;
+    /**
+     * Bundled example document, or `undefined` if none was declared.
+     */
+    readonly example: string | undefined;
+    /**
+     * Document schema with `ui` hints — for form builders.
+     */
+    readonly formSchema: QuillSchema;
+    /**
+     * Identity snapshot of the `quill:` section of `Quill.yaml`, plus
+     * `supportedFormats` and any custom `quill:` keys.
      *
      * Consumers that need validation run their own validator against
      * `metadata.schema`.
@@ -533,6 +525,10 @@ export class Quill {
      * immutable once constructed.
      */
     readonly metadata: QuillMetadata;
+    /**
+     * Document schema with `ui` hints stripped — for LLM/MCP consumers.
+     */
+    readonly schema: QuillSchema;
     /**
      * Whether this quill's backend supports canvas preview.
      *

package/bundler/wasm_bg.js

@@ -575,6 +575,46 @@ export class Quill {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Auto-generated annotated Markdown blueprint for LLM consumers.
+     * @returns {string}
+     */
+    get blueprint() {
+        let deferred1_0;
+        let deferred1_1;
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.quill_blueprint(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            deferred1_0 = r0;
+            deferred1_1 = r1;
+            return getStringFromWasm0(r0, r1);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+            wasm.__wbindgen_export4(deferred1_0, deferred1_1, 1);
+        }
+    }
+    /**
+     * Bundled example document, or `undefined` if none was declared.
+     * @returns {string | undefined}
+     */
+    get example() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.quill_example(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            let v1;
+            if (r0 !== 0) {
+                v1 = getStringFromWasm0(r0, r1).slice();
+                wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            }
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * The schema-aware form view of `doc`.
      *
@@ -613,23 +653,16 @@ export class Quill {
         }
     }
     /**
-     * Read-only snapshot of the loaded quill's engine info and declared schema.
-     *
-     * Returns a plain JS object with:
-     * - `schema` — the quill's public schema contract, identical to
-     *   `QuillConfig::public_schema()`. Top-level keys: `name`, `main`,
-     *   optional `card_types` (map keyed by card name, omitted when empty),
-     *   optional `example`. `main` and each card under `card_types` share
-     *   the same shape: `fields` (map keyed by field name), optional
-     *   `title`, `description`, `ui`.
-     * - `backend`, `version`, `author`, `description` — quill identity
-     *   declared in `Quill.yaml`'s `quill:` section. `description` describes
-     *   the quill itself; if the author also declared `main.description` (the
-     *   schema description of the entry-point card), it lives at
-     *   `schema.main.description` and is independent.
-     * - `supportedFormats` — output formats the backend produces, as
-     *   lowercase strings.
-     * - Any additional unstructured keys declared under `quill:`.
+     * Document schema with `ui` hints — for form builders.
+     * @returns {QuillSchema}
+     */
+    get formSchema() {
+        const ret = wasm.quill_formSchema(this.__wbg_ptr);
+        return takeObject(ret);
+    }
+    /**
+     * Identity snapshot of the `quill:` section of `Quill.yaml`, plus
+     * `supportedFormats` and any custom `quill:` keys.
      *
      * Consumers that need validation run their own validator against
      * `metadata.schema`.
@@ -685,6 +718,14 @@ export class Quill {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Document schema with `ui` hints stripped — for LLM/MCP consumers.
+     * @returns {QuillSchema}
+     */
+    get schema() {
+        const ret = wasm.quill_schema(this.__wbg_ptr);
+        return takeObject(ret);
+    }
     /**
      * Whether this quill's backend supports canvas preview.
      *

package/bundler/wasm_bg.wasm.d.ts

@@ -31,10 +31,14 @@ export const init: () => void;
 export const quill_backendId: (a: number, b: number) => void;
 export const quill_blankCard: (a: number, b: number, c: number, d: number) => void;
 export const quill_blankMain: (a: number, b: number) => void;
+export const quill_blueprint: (a: number, b: number) => void;
+export const quill_example: (a: number, b: number) => void;
 export const quill_form: (a: number, b: number, c: number) => void;
+export const quill_formSchema: (a: number) => number;
 export const quill_metadata: (a: number) => number;
 export const quill_open: (a: number, b: number, c: number) => void;
 export const quill_render: (a: number, b: number, c: number, d: number) => void;
+export const quill_schema: (a: number) => number;
 export const quill_supportsCanvas: (a: number) => number;
 export const quillmark_new: () => number;
 export const quillmark_quill: (a: number, b: number, c: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quillmark/wasm",
-  "version": "0.69.1",
+  "version": "0.71.0",
   "description": "WebAssembly bindings for quillmark",
   "type": "module",
   "license": "MIT OR Apache-2.0",