@lapismd/mira 0.0.1

package/dist/preview/file-embed.svelte

@@ -0,0 +1,56 @@
+<script lang="ts">
+  import type {
+    MiraAssetResolver,
+    MiraExtension,
+    MiraFileAdapter,
+    MiraLinkResolver,
+    MiraListCallout,
+    MiraMarkdownPostProcessor,
+    MiraRendererComponents,
+  } from "@lapismd/mira/extensions";
+  import type { FrontmatterConfig } from "./components/frontmatter-utils";
+  import MarkdownEmbed from "./markdown-embed.svelte";
+
+  type Props = {
+    id?: string;
+    href?: string;
+    target?: string;
+    text?: string;
+    label?: string;
+    width?: number;
+    height?: number;
+    sourcePath?: string;
+    extensions?: MiraExtension[];
+    components?: MiraRendererComponents;
+    class?: string;
+    highlight?: boolean;
+    linkResolver?: MiraLinkResolver;
+    assetResolver?: MiraAssetResolver;
+    fileAdapter?: MiraFileAdapter;
+    frontmatterOpen?: boolean;
+    frontmatterConfig?: FrontmatterConfig;
+    headingIds?: boolean;
+    headingIdPrefix?: string;
+    htmlPolicy?: "trusted" | "safe";
+    emoji?: boolean;
+    dialog?: boolean;
+    listCallouts?: MiraListCallout[];
+    postProcess?: MiraMarkdownPostProcessor;
+  };
+
+  let { id, href, target, text, label, width, height, ...previewProps }: Props =
+    $props();
+
+  const activeTarget = $derived(target || id || href || "");
+  const details = $derived([
+    text || label,
+    width && width > 0
+      ? `${Math.round(width)}${height && height > 0 ? `x${Math.round(height)}` : ""}`
+      : undefined,
+  ]);
+  const value = $derived(
+    `![[${[activeTarget, ...details].filter(Boolean).join("|")}]]`,
+  );
+</script>
+
+<MarkdownEmbed {value} {...previewProps} />

package/dist/preview/file-embed.svelte.d.ts

@@ -0,0 +1,32 @@
+import type { MiraAssetResolver, MiraExtension, MiraFileAdapter, MiraLinkResolver, MiraListCallout, MiraMarkdownPostProcessor, MiraRendererComponents } from "@lapismd/mira/extensions";
+import type { FrontmatterConfig } from "./components/frontmatter-utils";
+type Props = {
+    id?: string;
+    href?: string;
+    target?: string;
+    text?: string;
+    label?: string;
+    width?: number;
+    height?: number;
+    sourcePath?: string;
+    extensions?: MiraExtension[];
+    components?: MiraRendererComponents;
+    class?: string;
+    highlight?: boolean;
+    linkResolver?: MiraLinkResolver;
+    assetResolver?: MiraAssetResolver;
+    fileAdapter?: MiraFileAdapter;
+    frontmatterOpen?: boolean;
+    frontmatterConfig?: FrontmatterConfig;
+    headingIds?: boolean;
+    headingIdPrefix?: string;
+    htmlPolicy?: "trusted" | "safe";
+    emoji?: boolean;
+    dialog?: boolean;
+    listCallouts?: MiraListCallout[];
+    postProcess?: MiraMarkdownPostProcessor;
+};
+declare const FileEmbed: import("svelte").Component<Props, {}, "">;
+type FileEmbed = ReturnType<typeof FileEmbed>;
+export default FileEmbed;
+//# sourceMappingURL=file-embed.svelte.d.ts.map

package/dist/preview/file-embed.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-embed.svelte.d.ts","sourceRoot":"","sources":["../../src/preview/file-embed.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACR,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAItE,KAAK,KAAK,GAAG;IACX,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,eAAe,EAAE,CAAC;IACjC,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC,CAAC;AA0BJ,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/preview/frontmatter/controller.svelte.d.ts

@@ -0,0 +1,58 @@
+import type { FrontmatterPathSegment, FrontmatterProperty, FrontmatterPropertyKind } from "./types";
+import { type FrontmatterPropertyManager } from "./manager";
+export type FrontmatterControllerCommit = {
+    record: Record<string, unknown>;
+    yaml: string;
+    replacement: string;
+    from: number | null;
+    to: number | null;
+    nextMarkdown?: string;
+};
+export type FrontmatterControllerOptions = {
+    yaml?: string;
+    record?: Record<string, unknown>;
+    propertyManager?: FrontmatterPropertyManager;
+    sourcePath?: string;
+    getMarkdown?: () => string;
+    dataOffset?: number | null;
+    dataOffsetEnd?: number | null;
+    onChange?: (replacement: string, from: number, to: number) => void;
+    onFrontmatterChange?: (nextYaml: string, nextValue: string) => void;
+    onRecordChange?: (commit: FrontmatterControllerCommit) => void | Promise<void>;
+};
+export declare class FrontmatterController {
+    revision: number;
+    parseError: string | null;
+    yaml: string;
+    record: Record<string, unknown>;
+    propertyManager: FrontmatterPropertyManager;
+    sourcePath?: string;
+    private getMarkdown?;
+    private dataOffset;
+    private dataOffsetEnd;
+    private onChange?;
+    private onFrontmatterChange?;
+    private onRecordChange?;
+    private suppressCommit;
+    constructor(options?: FrontmatterControllerOptions);
+    update(options: FrontmatterControllerOptions): void;
+    getRecord(): Record<string, unknown>;
+    getYaml(): string;
+    getParseError(): string | null;
+    syncYaml(nextYaml: string, options?: {
+        commit?: boolean;
+    }): void;
+    syncRecord(nextRecord: Record<string, unknown>, options?: {
+        commit?: boolean;
+    }): void;
+    commitYaml(nextYaml: string): void;
+    commitRecord(nextRecord: Record<string, unknown>): void;
+    updateProperty(path: FrontmatterPathSegment[], nextValue: unknown): void;
+    addProperty(kind?: FrontmatterPropertyKind): string | null;
+    renameProperty(path: FrontmatterPathSegment[], nextKey: string): void;
+    removeProperty(path: FrontmatterPathSegment[]): void;
+    mergeProperties(parentPath: FrontmatterPathSegment[], pasted: Record<string, unknown>): void;
+    changePropertyKind(property: FrontmatterProperty, kind: FrontmatterPropertyKind): void;
+    private commitCurrent;
+}
+//# sourceMappingURL=controller.svelte.d.ts.map

package/dist/preview/frontmatter/controller.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller.svelte.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/controller.svelte.ts"],"names":[],"mappings":"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"}

package/dist/preview/frontmatter/controller.svelte.js

@@ -0,0 +1,195 @@
+import { parseFrontmatterYaml } from "./parse";
+import { addFrontmatterRecordProperty, mergeFrontmatterRecordProperties, removeFrontmatterRecordProperty, renameFrontmatterRecordProperty, updateFrontmatterRecord, } from "./properties";
+import { createFrontmatterReplacement, serializeFrontmatterRecord, } from "./serialize";
+import { createFrontmatterPropertyManager, } from "./manager";
+export class FrontmatterController {
+    revision = $state(0);
+    parseError = $state(null);
+    yaml = $state("");
+    record = $state.raw({});
+    propertyManager;
+    sourcePath;
+    getMarkdown;
+    dataOffset = null;
+    dataOffsetEnd = null;
+    onChange;
+    onFrontmatterChange;
+    onRecordChange;
+    suppressCommit = false;
+    constructor(options = {}) {
+        this.propertyManager =
+            options.propertyManager ?? createFrontmatterPropertyManager();
+        this.sourcePath = options.sourcePath ?? this.propertyManager.sourcePath;
+        this.getMarkdown = options.getMarkdown;
+        this.dataOffset = options.dataOffset ?? null;
+        this.dataOffsetEnd = options.dataOffsetEnd ?? null;
+        this.onChange = options.onChange;
+        this.onFrontmatterChange = options.onFrontmatterChange;
+        this.onRecordChange = options.onRecordChange;
+        if (options.record) {
+            this.syncRecord(options.record, { commit: false });
+        }
+        else if (options.yaml !== undefined) {
+            this.syncYaml(options.yaml, { commit: false });
+        }
+    }
+    update(options) {
+        if (options.propertyManager) {
+            this.propertyManager = options.propertyManager;
+        }
+        if (options.sourcePath !== undefined) {
+            this.sourcePath = options.sourcePath;
+        }
+        if (options.getMarkdown !== undefined) {
+            this.getMarkdown = options.getMarkdown;
+        }
+        if (options.dataOffset !== undefined) {
+            this.dataOffset = options.dataOffset;
+        }
+        if (options.dataOffsetEnd !== undefined) {
+            this.dataOffsetEnd = options.dataOffsetEnd;
+        }
+        if (options.onChange !== undefined) {
+            this.onChange = options.onChange;
+        }
+        if (options.onFrontmatterChange !== undefined) {
+            this.onFrontmatterChange = options.onFrontmatterChange;
+        }
+        if (options.onRecordChange !== undefined) {
+            this.onRecordChange = options.onRecordChange;
+        }
+    }
+    getRecord() {
+        return this.record;
+    }
+    getYaml() {
+        return this.yaml;
+    }
+    getParseError() {
+        return this.parseError;
+    }
+    syncYaml(nextYaml, options = {}) {
+        if (!options.commit && nextYaml === this.yaml && this.revision > 0) {
+            return;
+        }
+        const parsed = parseFrontmatterYaml(nextYaml);
+        this.yaml = nextYaml;
+        if (parsed.ok) {
+            this.record = parsed.value;
+            this.parseError = null;
+        }
+        else {
+            this.record = {};
+            this.parseError = parsed.error;
+        }
+        this.revision += 1;
+        if (options.commit) {
+            void this.commitCurrent();
+        }
+    }
+    syncRecord(nextRecord, options = {}) {
+        const nextYaml = serializeFrontmatterRecord(nextRecord);
+        if (!options.commit && nextYaml === this.yaml && this.revision > 0) {
+            return;
+        }
+        this.record = cloneRecord(nextRecord);
+        this.yaml = nextYaml;
+        this.parseError = null;
+        this.revision += 1;
+        if (options.commit) {
+            void this.commitCurrent();
+        }
+    }
+    commitYaml(nextYaml) {
+        this.syncYaml(nextYaml, { commit: true });
+    }
+    commitRecord(nextRecord) {
+        this.syncRecord(nextRecord, { commit: true });
+    }
+    updateProperty(path, nextValue) {
+        if (this.parseError) {
+            return;
+        }
+        this.commitRecord(updateFrontmatterRecord(this.record, path, nextValue));
+    }
+    addProperty(kind = "text") {
+        if (this.parseError) {
+            return null;
+        }
+        const next = addFrontmatterRecordProperty(this.record, kind, this.propertyManager.config);
+        this.commitRecord(next.value);
+        return next.name;
+    }
+    renameProperty(path, nextKey) {
+        if (this.parseError) {
+            return;
+        }
+        const nextRecord = renameFrontmatterRecordProperty(this.record, path, nextKey);
+        if (nextRecord === this.record) {
+            return;
+        }
+        this.commitRecord(nextRecord);
+    }
+    removeProperty(path) {
+        if (this.parseError) {
+            return;
+        }
+        this.commitRecord(removeFrontmatterRecordProperty(this.record, path));
+    }
+    mergeProperties(parentPath, pasted) {
+        if (this.parseError) {
+            return;
+        }
+        this.commitRecord(mergeFrontmatterRecordProperties(this.record, parentPath, pasted));
+    }
+    changePropertyKind(property, kind) {
+        this.propertyManager.setType(property.pathString, kind);
+        if (property.path.length === 1 && typeof property.path[0] === "string") {
+            this.propertyManager.setType(property.path[0], kind);
+        }
+        this.updateProperty(property.path, this.propertyManager.coerceValue(property.value, kind, property));
+    }
+    async commitCurrent() {
+        if (this.suppressCommit) {
+            return;
+        }
+        const yaml = this.parseError
+            ? this.yaml
+            : serializeFrontmatterRecord(this.record);
+        if (!this.parseError) {
+            this.yaml = yaml;
+        }
+        const replacement = createFrontmatterReplacement(yaml);
+        const from = this.dataOffset;
+        const to = this.dataOffsetEnd;
+        const markdown = this.getMarkdown?.();
+        const nextMarkdown = markdown !== undefined && from !== null && to !== null
+            ? `${markdown.slice(0, from)}${replacement}${markdown.slice(to)}`
+            : undefined;
+        const commit = {
+            record: cloneRecord(this.record),
+            yaml,
+            replacement,
+            from,
+            to,
+            nextMarkdown,
+        };
+        if (from !== null && to !== null) {
+            this.onChange?.(replacement, from, to);
+            if (nextMarkdown !== undefined) {
+                this.onFrontmatterChange?.(yaml, nextMarkdown);
+            }
+        }
+        await this.onRecordChange?.(commit);
+    }
+}
+function cloneRecord(record) {
+    // Prefer JSON cloning so host-provided records (Svelte proxies, etc.) remain
+    // portable across panel/controller hosts.
+    try {
+        return JSON.parse(JSON.stringify(record));
+    }
+    catch {
+        return { ...record };
+    }
+}

package/dist/preview/frontmatter/defaults.d.ts

@@ -0,0 +1,3 @@
+import type { FrontmatterConfig, FrontmatterPropertyKind } from "./types";
+export declare function defaultFrontmatterValue(kind: FrontmatterPropertyKind, config?: FrontmatterConfig): unknown;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/preview/frontmatter/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAG1E,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,uBAAuB,EAC7B,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAgCT"}

package/dist/preview/frontmatter/defaults.js

@@ -0,0 +1,32 @@
+import { resolveFrontmatterWidget, toBuiltinFrontmatterKind } from "./widgets";
+export function defaultFrontmatterValue(kind, config) {
+    const widget = resolveFrontmatterWidget(config, kind);
+    if (typeof widget?.defaultValue === "function") {
+        return widget.defaultValue();
+    }
+    if (widget && "defaultValue" in widget) {
+        return widget.defaultValue;
+    }
+    const builtinKind = toBuiltinFrontmatterKind(widget?.fallbackKind ?? kind);
+    if (builtinKind === "number") {
+        return 0;
+    }
+    if (builtinKind === "checkbox") {
+        return false;
+    }
+    if (builtinKind === "tags" ||
+        builtinKind === "aliases" ||
+        builtinKind === "multitext") {
+        return [];
+    }
+    if (builtinKind === "array") {
+        return [];
+    }
+    if (builtinKind === "object") {
+        return {};
+    }
+    if (builtinKind === "null") {
+        return null;
+    }
+    return "";
+}

package/dist/preview/frontmatter/frontmatter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=frontmatter.test.d.ts.map

package/dist/preview/frontmatter/frontmatter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.test.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/frontmatter.test.ts"],"names":[],"mappings":""}

package/dist/preview/frontmatter/frontmatter.test.js

@@ -0,0 +1,190 @@
+import { describe, expect, it } from "vitest";
+import remarkFrontmatter from "remark-frontmatter";
+import { createParser } from "../renderer/utils";
+import { coerceFrontmatterValue, createFrontmatterPropertyManager, createFrontmatterReplacement, FrontmatterController, frontmatterProperties, mergeFrontmatterRecordProperties, parseFrontmatterYaml, removeFrontmatterRecordProperty, resolveFrontmatterWidget, serializeFrontmatterRecord, } from ".";
+import { remarkFrontmatterToHast, remarkPositionsToData } from "../remark";
+describe("frontmatter utilities", () => {
+    it("parses, mutates, and serializes portable YAML properties", () => {
+        const parsed = parseFrontmatterYaml("title: Demo\npublished: true\ncount: 2\ntags:\n  - mira\n");
+        expect(parsed.ok).toBe(true);
+        if (!parsed.ok) {
+            return;
+        }
+        const yaml = serializeFrontmatterRecord({
+            ...parsed.value,
+            title: "Updated",
+        });
+        expect(yaml).toContain("title: Updated");
+        expect(createFrontmatterReplacement(yaml)).toMatch(/^---\n/);
+    });
+    it("derives Lapis-style property types and icons", () => {
+        const properties = frontmatterProperties({
+            aliases: ["Mira"],
+            count: 2,
+            draft: false,
+            nested: { child: true },
+            published: "2026-06-27",
+            tags: ["mira", "editor"],
+            title: "Demo",
+        });
+        expect(properties.map((property) => [property.key, property.type])).toEqual([
+            ["aliases", "aliases"],
+            ["count", "number"],
+            ["draft", "checkbox"],
+            ["nested", "object"],
+            ["published", "date"],
+            ["tags", "tags"],
+            ["title", "text"],
+        ]);
+        expect(properties.find((property) => property.key === "tags")?.icon).toBe("lucide-hash");
+        expect(properties.find((property) => property.key === "nested")?.children[0]
+            ?.type).toBe("checkbox");
+    });
+    it("applies configured frontmatter property types and widgets", () => {
+        const properties = frontmatterProperties({
+            status: "draft",
+            title: "Demo",
+        }, {
+            types: {
+                status: {
+                    type: "workflow-state",
+                    label: "Workflow state",
+                    icon: "lucide-workflow",
+                    fallbackKind: "text",
+                    defaultValue: "draft",
+                    normalize: (value) => String(value).toUpperCase(),
+                },
+            },
+            widgets: [
+                {
+                    type: "workflow-state",
+                    label: "Workflow state",
+                    icon: "lucide-workflow",
+                    fallbackKind: "text",
+                    render: () => undefined,
+                },
+            ],
+        });
+        const status = properties.find((property) => property.key === "status");
+        expect(status?.type).toBe("workflow-state");
+        expect(status?.icon).toBe("lucide-workflow");
+        expect(resolveFrontmatterWidget({ widgets: [] }, "missing")).toBeNull();
+        expect(coerceFrontmatterValue("draft", "workflow-state", {
+            widgets: [
+                {
+                    type: "workflow-state",
+                    normalize: (value) => String(value).toUpperCase(),
+                },
+            ],
+        })).toBe("DRAFT");
+    });
+    it("removes nested object and array properties immutably", () => {
+        const source = {
+            nested: { keep: true, remove: "value" },
+            values: ["first", "second"],
+        };
+        expect(removeFrontmatterRecordProperty(source, ["nested", "remove"])).toEqual({
+            nested: { keep: true },
+            values: ["first", "second"],
+        });
+        expect(removeFrontmatterRecordProperty(source, ["values", 0])).toEqual({
+            nested: { keep: true, remove: "value" },
+            values: ["second"],
+        });
+        expect(source.nested.remove).toBe("value");
+    });
+    it("merges pasted properties into a portable parent record", () => {
+        const source = {
+            nested: { keep: true },
+            title: "Demo",
+        };
+        expect(mergeFrontmatterRecordProperties(source, ["nested"], {
+            owner: "[[Ada]]",
+            status: "ready",
+        })).toEqual({
+            nested: {
+                keep: true,
+                owner: "[[Ada]]",
+                status: "ready",
+            },
+            title: "Demo",
+        });
+    });
+    it("renders frontmatter as a component with source offsets", () => {
+        const parser = createParser([
+            remarkFrontmatter,
+            remarkFrontmatterToHast,
+            remarkPositionsToData,
+        ]);
+        const ast = parser("---\ntitle: Demo\n---\n\n# Heading");
+        const frontmatter = ast.children.find((node) => node.type === "element" && node.tagName === "frontmatter");
+        expect(frontmatter?.properties?.value).toBe("title: Demo");
+        expect(frontmatter?.properties?.["data-offset"]).toBe(0);
+        expect(frontmatter?.properties?.["data-offset-end"]).toBe(19);
+    });
+    it("creates a property manager that resolves widgets and setType", () => {
+        const manager = createFrontmatterPropertyManager({
+            types: {
+                status: {
+                    type: "workflow-state",
+                    label: "Workflow",
+                    icon: "lucide-workflow",
+                    fallbackKind: "text",
+                },
+            },
+            widgets: [
+                {
+                    type: "workflow-state",
+                    fallbackKind: "text",
+                    validate: (value) => typeof value === "string",
+                },
+            ],
+        });
+        expect(manager.resolveType("status", "status", "draft")).toBe("workflow-state");
+        expect(manager.resolveWidget("workflow-state")?.label).toBeUndefined();
+        expect(manager.typeOptions().some((option) => option.type === "text")).toBe(true);
+        manager.setType("priority", "number");
+        expect(manager.resolveType("priority", "priority", "1")).toBe("number");
+    });
+    it("commits controller record mutations through onRecordChange", async () => {
+        const commits = [];
+        const controller = new FrontmatterController({
+            record: { title: "Demo", count: 1 },
+            onRecordChange(commit) {
+                commits.push(commit.record);
+            },
+        });
+        controller.updateProperty(["title"], "Updated");
+        expect(controller.getRecord().title).toBe("Updated");
+        expect(commits.at(-1)).toEqual({ title: "Updated", count: 1 });
+        const added = controller.addProperty("text");
+        expect(added).toBeTruthy();
+        expect(Object.keys(controller.getRecord())).toContain(added);
+        controller.renameProperty([added], "subtitle");
+        expect(controller.getRecord()).toHaveProperty("subtitle");
+        expect(controller.getRecord()).not.toHaveProperty(added);
+        const title = controller.propertyManager
+            .properties(controller.getRecord())
+            .find((property) => property.key === "title");
+        expect(title).toBeTruthy();
+        controller.changePropertyKind(title, "checkbox");
+        expect(controller.getRecord().title).toBe(true);
+        expect(commits.length).toBeGreaterThan(3);
+    });
+    it("splices YAML into markdown through controller document adapters", () => {
+        const markdown = "---\ntitle: Demo\n---\n\nBody\n";
+        let nextValue = markdown;
+        const controller = new FrontmatterController({
+            yaml: "title: Demo",
+            getMarkdown: () => markdown,
+            dataOffset: 0,
+            dataOffsetEnd: 19,
+            onFrontmatterChange(_yaml, value) {
+                nextValue = value;
+            },
+        });
+        controller.updateProperty(["title"], "Updated");
+        expect(nextValue).toContain("title: Updated");
+        expect(nextValue).toContain("Body");
+    });
+});

package/dist/preview/frontmatter/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./defaults";
+export * from "./parse";
+export * from "./predicates";
+export * from "./properties";
+export * from "./serialize";
+export * from "./suggestions";
+export * from "./types";
+export * from "./values";
+export * from "./widgets";
+export * from "./manager";
+export { FrontmatterController, type FrontmatterControllerCommit, type FrontmatterControllerOptions, } from "./controller.svelte";
+//# sourceMappingURL=index.d.ts.map

package/dist/preview/frontmatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,KAAK,2BAA2B,EAChC,KAAK,4BAA4B,GAClC,MAAM,qBAAqB,CAAC"}

package/dist/preview/frontmatter/index.js

@@ -0,0 +1,11 @@
+export * from "./defaults";
+export * from "./parse";
+export * from "./predicates";
+export * from "./properties";
+export * from "./serialize";
+export * from "./suggestions";
+export * from "./types";
+export * from "./values";
+export * from "./widgets";
+export * from "./manager";
+export { FrontmatterController, } from "./controller.svelte";

package/dist/preview/frontmatter/manager.d.ts

@@ -0,0 +1,28 @@
+import type { FrontmatterConfig, FrontmatterProperty, FrontmatterPropertyKind, FrontmatterTypeDefinition } from "./types";
+export type FrontmatterRenameFailure = {
+    path: string;
+    message: string;
+};
+export type FrontmatterRenameResult = {
+    updatedFiles: string[];
+    failedFiles: FrontmatterRenameFailure[];
+};
+export type FrontmatterPropertyManager = {
+    readonly config: FrontmatterConfig;
+    sourcePath?: string;
+    resolveType: (pathString: string, key: string, value: unknown) => FrontmatterPropertyKind;
+    properties: (record: Record<string, unknown>) => FrontmatterProperty[];
+    typeOptions: () => FrontmatterTypeDefinition[];
+    resolveWidget: (kind: FrontmatterPropertyKind) => FrontmatterTypeDefinition | null;
+    coerceValue: (value: unknown, kind: FrontmatterPropertyKind, property?: FrontmatterProperty) => unknown;
+    defaultValue: (kind: FrontmatterPropertyKind) => unknown;
+    setType: (key: string, type: FrontmatterPropertyKind) => void;
+    rename?: (prevId: string, newId: string) => Promise<FrontmatterRenameResult> | FrontmatterRenameResult;
+};
+export type CreateFrontmatterPropertyManagerOptions = FrontmatterConfig & {
+    sourcePath?: string;
+    setType?: (key: string, type: FrontmatterPropertyKind) => void;
+    rename?: FrontmatterPropertyManager["rename"];
+};
+export declare function createFrontmatterPropertyManager(options?: CreateFrontmatterPropertyManagerOptions): FrontmatterPropertyManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/preview/frontmatter/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/manager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,SAAS,CAAC;AAGjB,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,wBAAwB,EAAE,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CACX,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,KACX,uBAAuB,CAAC;IAC7B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,mBAAmB,EAAE,CAAC;IACvE,WAAW,EAAE,MAAM,yBAAyB,EAAE,CAAC;IAC/C,aAAa,EAAE,CACb,IAAI,EAAE,uBAAuB,KAC1B,yBAAyB,GAAG,IAAI,CAAC;IACtC,WAAW,EAAE,CACX,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,CAAC,EAAE,mBAAmB,KAC3B,OAAO,CAAC;IACb,YAAY,EAAE,CAAC,IAAI,EAAE,uBAAuB,KAAK,OAAO,CAAC;IACzD,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC9D,MAAM,CAAC,EAAE,CACP,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,KACV,OAAO,CAAC,uBAAuB,CAAC,GAAG,uBAAuB,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,uCAAuC,GAAG,iBAAiB,GAAG;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC/D,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;CAC/C,CAAC;AAEF,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,uCAA4C,GACpD,0BAA0B,CAqD5B"}