@lapismd/mira 0.0.1

package/dist/preview/frontmatter/manager.js

@@ -0,0 +1,46 @@
+import { coerceFrontmatterValue } from "./values";
+import { defaultFrontmatterValue } from "./defaults";
+import { frontmatterProperties, frontmatterPropertyKind } from "./properties";
+import { frontmatterTypeOptions, resolveFrontmatterWidget } from "./widgets";
+export function createFrontmatterPropertyManager(options = {}) {
+    const { sourcePath, setType: setTypeOverride, rename, types: seedTypes, ...configRest } = options;
+    const types = {
+        ...(seedTypes ?? {}),
+    };
+    const config = {
+        ...configRest,
+        types,
+    };
+    return {
+        get config() {
+            return config;
+        },
+        sourcePath,
+        resolveType(pathString, key, value) {
+            return frontmatterPropertyKind(value, key, config, pathString);
+        },
+        properties(record) {
+            return frontmatterProperties(record, config);
+        },
+        typeOptions() {
+            return frontmatterTypeOptions(config);
+        },
+        resolveWidget(kind) {
+            return resolveFrontmatterWidget(config, kind);
+        },
+        coerceValue(value, kind, property) {
+            return coerceFrontmatterValue(value, kind, config, property);
+        },
+        defaultValue(kind) {
+            return defaultFrontmatterValue(kind, config);
+        },
+        setType(key, type) {
+            if (setTypeOverride) {
+                setTypeOverride(key, type);
+                return;
+            }
+            types[key] = type;
+        },
+        rename,
+    };
+}

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

@@ -0,0 +1,4 @@
+import type { FrontmatterParseResult } from "./types";
+export declare function normalizeFrontmatterYaml(frontmatter: string): string;
+export declare function parseFrontmatterYaml(yaml: string): FrontmatterParseResult;
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/parse.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEtD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAqCzE"}

package/dist/preview/frontmatter/parse.js

@@ -0,0 +1,49 @@
+import { parseDocument } from "yaml";
+import { isRecord } from "./predicates";
+export function normalizeFrontmatterYaml(frontmatter) {
+    const trimmed = frontmatter.trim();
+    if (!trimmed.startsWith("---")) {
+        return frontmatter.trimEnd();
+    }
+    return trimmed
+        .replace(/^---\r?\n/, "")
+        .replace(/\r?\n---$/, "")
+        .trimEnd();
+}
+export function parseFrontmatterYaml(yaml) {
+    const normalizedYaml = normalizeFrontmatterYaml(yaml);
+    try {
+        const document = parseDocument(normalizedYaml, { prettyErrors: false });
+        const error = document.errors[0] ?? document.warnings[0];
+        if (error) {
+            return {
+                ok: false,
+                error: error.message,
+                yaml: normalizedYaml,
+            };
+        }
+        const value = document.toJS();
+        if (value === null || value === undefined) {
+            return { ok: true, value: {}, yaml: normalizedYaml };
+        }
+        if (!isRecord(value)) {
+            return {
+                ok: false,
+                error: "Frontmatter must be a YAML mapping.",
+                yaml: normalizedYaml,
+            };
+        }
+        return {
+            ok: true,
+            value,
+            yaml: normalizedYaml,
+        };
+    }
+    catch (cause) {
+        return {
+            ok: false,
+            error: cause instanceof Error ? cause.message : String(cause),
+            yaml: normalizedYaml,
+        };
+    }
+}

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

@@ -0,0 +1,3 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isTextNumberArray(value: unknown): value is Array<string | number>;
+//# sourceMappingURL=predicates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"predicates.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/predicates.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAKjC"}

package/dist/preview/frontmatter/predicates.js

@@ -0,0 +1,7 @@
+export function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+export function isTextNumberArray(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => typeof item === "string" || typeof item === "number"));
+}

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

@@ -0,0 +1,13 @@
+import type { FrontmatterConfig, FrontmatterPathSegment, FrontmatterProperty, FrontmatterPropertyKind } from "./types";
+export declare function frontmatterProperties(value: Record<string, unknown>, config?: FrontmatterConfig, parentPath?: FrontmatterPathSegment[], depth?: number): FrontmatterProperty[];
+export declare function frontmatterPropertyKind(value: unknown, key?: string, config?: FrontmatterConfig, pathString?: string): FrontmatterPropertyKind;
+export declare function deriveFrontmatterPropertyType(key: string, value: unknown): FrontmatterPropertyKind;
+export declare function updateFrontmatterRecord(value: Record<string, unknown>, path: FrontmatterPathSegment[], nextValue: unknown): Record<string, unknown>;
+export declare function renameFrontmatterRecordProperty(value: Record<string, unknown>, path: FrontmatterPathSegment[], nextKey: string): Record<string, unknown>;
+export declare function removeFrontmatterRecordProperty(value: Record<string, unknown>, path: FrontmatterPathSegment[]): Record<string, unknown>;
+export declare function mergeFrontmatterRecordProperties(value: Record<string, unknown>, parentPath: FrontmatterPathSegment[], properties: Record<string, unknown>): Record<string, unknown>;
+export declare function addFrontmatterRecordProperty(value: Record<string, unknown>, kind?: FrontmatterPropertyKind, config?: FrontmatterConfig): {
+    name: string;
+    value: Record<string, unknown>;
+};
+//# sourceMappingURL=properties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/properties.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAUjB,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,CAAC,EAAE,iBAAiB,EAC1B,UAAU,GAAE,sBAAsB,EAAO,EACzC,KAAK,SAAI,GACR,mBAAmB,EAAE,CAUvB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,GAAG,SAAK,EACR,MAAM,CAAC,EAAE,iBAAiB,EAC1B,UAAU,SAAM,GACf,uBAAuB,CAKzB;AAED,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,uBAAuB,CAiCzB;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,sBAAsB,EAAE,EAC9B,SAAS,EAAE,OAAO,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,sBAAsB,EAAE,EAC9B,OAAO,EAAE,MAAM,GACd,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAwBzB;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,sBAAsB,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOzB;AAED,wBAAgB,gCAAgC,CAC9C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,UAAU,EAAE,sBAAsB,EAAE,EACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAgBzB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,GAAE,uBAAgC,EACtC,MAAM,CAAC,EAAE,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CASlD"}

package/dist/preview/frontmatter/properties.js

@@ -0,0 +1,250 @@
+import { isRecord, isTextNumberArray } from "./predicates";
+import { defaultFrontmatterValue } from "./defaults";
+import { frontmatterPropertyIcon, resolveConfiguredFrontmatterType, resolveFrontmatterWidget, toBuiltinFrontmatterKind, } from "./widgets";
+export function frontmatterProperties(value, config, parentPath = [], depth = 0) {
+    return Object.entries(value).map(([key, propertyValue]) => createFrontmatterProperty(key, propertyValue, [...parentPath, key], depth, config));
+}
+export function frontmatterPropertyKind(value, key = "", config, pathString = key) {
+    return (resolveConfiguredFrontmatterType(config, pathString, key)?.type ??
+        deriveFrontmatterPropertyType(key, value));
+}
+export function deriveFrontmatterPropertyType(key, value) {
+    const normalizedKey = key.toLowerCase();
+    if (normalizedKey === "tags" || normalizedKey === "tag") {
+        return "tags";
+    }
+    if (normalizedKey === "aliases" || normalizedKey === "alias") {
+        return "aliases";
+    }
+    if (value === null) {
+        return "null";
+    }
+    if (Array.isArray(value)) {
+        return isTextNumberArray(value) ? "multitext" : "array";
+    }
+    if (typeof value === "string") {
+        if (/^\d{4}-\d{2}-\d{2}$/.test(value)) {
+            return "date";
+        }
+        if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(?::\d{2})?$/.test(value)) {
+            return "datetime";
+        }
+        return "text";
+    }
+    if (typeof value === "number") {
+        return "number";
+    }
+    if (typeof value === "boolean") {
+        return "checkbox";
+    }
+    if (isRecord(value)) {
+        return "object";
+    }
+    return "unknown";
+}
+export function updateFrontmatterRecord(value, path, nextValue) {
+    const next = setValueAtPath(value, path, nextValue);
+    return isRecord(next) ? next : value;
+}
+export function renameFrontmatterRecordProperty(value, path, nextKey) {
+    const currentKey = path.at(-1);
+    if (typeof currentKey !== "string" || !nextKey || currentKey === nextKey) {
+        return value;
+    }
+    const parentPath = path.slice(0, -1);
+    const parent = getValueAtPath(value, parentPath);
+    if (!isRecord(parent) || Object.hasOwn(parent, nextKey)) {
+        return value;
+    }
+    const renamedParent = Object.fromEntries(Object.entries(parent).map(([key, propertyValue]) => key === currentKey ? [nextKey, propertyValue] : [key, propertyValue]));
+    if (!parentPath.length) {
+        return renamedParent;
+    }
+    const next = setValueAtPath(value, parentPath, renamedParent);
+    return isRecord(next) ? next : value;
+}
+export function removeFrontmatterRecordProperty(value, path) {
+    if (!path.length) {
+        return value;
+    }
+    const next = removeValueAtPath(value, path);
+    return isRecord(next) ? next : value;
+}
+export function mergeFrontmatterRecordProperties(value, parentPath, properties) {
+    const parent = getValueAtPath(value, parentPath);
+    if (!isRecord(parent)) {
+        return value;
+    }
+    const merged = {
+        ...parent,
+        ...properties,
+    };
+    if (!parentPath.length) {
+        return merged;
+    }
+    const next = setValueAtPath(value, parentPath, merged);
+    return isRecord(next) ? next : value;
+}
+export function addFrontmatterRecordProperty(value, kind = "text", config) {
+    const name = createUniquePropertyName(value, "property");
+    return {
+        name,
+        value: {
+            ...value,
+            [name]: defaultFrontmatterValue(kind, config),
+        },
+    };
+}
+function createFrontmatterProperty(key, value, path, depth, config) {
+    const pathString = formatPath(path);
+    const kind = frontmatterPropertyKind(value, key, config, pathString);
+    const children = shouldDeriveChildren(kind, value)
+        ? deriveChildren(value, path, depth + 1, config)
+        : [];
+    const property = {
+        children,
+        depth,
+        icon: frontmatterPropertyIcon(children.length ? "object" : kind, config),
+        id: pathString,
+        key,
+        kind,
+        parent: formatPath(path.slice(0, -1)),
+        path,
+        pathString,
+        type: kind,
+        valid: true,
+        value,
+    };
+    property.valid = validateFrontmatterPropertyValue(kind, value, property, config);
+    return property;
+}
+function deriveChildren(value, parentPath, depth, config) {
+    if (Array.isArray(value)) {
+        return value.map((item, index) => createFrontmatterProperty(String(index), item, [...parentPath, index], depth, config));
+    }
+    if (!isRecord(value)) {
+        return [];
+    }
+    return Object.entries(value).map(([key, childValue]) => createFrontmatterProperty(key, childValue, [...parentPath, key], depth, config));
+}
+function shouldDeriveChildren(kind, value) {
+    const builtinKind = toBuiltinFrontmatterKind(kind);
+    if (builtinKind === "object") {
+        return Object.keys(value).length > 0;
+    }
+    return builtinKind === "array" && Array.isArray(value) && value.length > 0;
+}
+function validateFrontmatterPropertyValue(kind, value, property, config) {
+    const widget = resolveFrontmatterWidget(config, kind);
+    if (widget?.validate && property) {
+        return widget.validate(value, property);
+    }
+    const builtinKind = toBuiltinFrontmatterKind(widget?.fallbackKind ?? kind);
+    if (builtinKind === "tags" ||
+        builtinKind === "aliases" ||
+        builtinKind === "multitext") {
+        return isTextNumberArray(value) || typeof value === "string";
+    }
+    if (builtinKind === "array") {
+        return Array.isArray(value) && !isTextNumberArray(value);
+    }
+    if (builtinKind === "object") {
+        return isRecord(value);
+    }
+    if (builtinKind === "text" ||
+        builtinKind === "date" ||
+        builtinKind === "datetime") {
+        return typeof value === "string";
+    }
+    if (builtinKind === "number") {
+        return typeof value === "number";
+    }
+    if (builtinKind === "checkbox") {
+        return typeof value === "boolean";
+    }
+    if (builtinKind === "null") {
+        return value === null;
+    }
+    return true;
+}
+function setValueAtPath(current, path, nextValue) {
+    if (!path.length) {
+        return nextValue;
+    }
+    const [segment, ...rest] = path;
+    if (Array.isArray(current)) {
+        const next = [...current];
+        if (typeof segment === "number") {
+            next[segment] = setValueAtPath(next[segment], rest, nextValue);
+        }
+        return next;
+    }
+    if (isRecord(current) && typeof segment === "string") {
+        return {
+            ...current,
+            [segment]: setValueAtPath(current[segment], rest, nextValue),
+        };
+    }
+    return current;
+}
+function removeValueAtPath(current, path) {
+    const [segment, ...rest] = path;
+    if (segment === undefined) {
+        return current;
+    }
+    if (Array.isArray(current) && typeof segment === "number") {
+        const next = [...current];
+        if (rest.length) {
+            next[segment] = removeValueAtPath(next[segment], rest);
+        }
+        else {
+            next.splice(segment, 1);
+        }
+        return next;
+    }
+    if (isRecord(current) && typeof segment === "string") {
+        const next = { ...current };
+        if (rest.length) {
+            next[segment] = removeValueAtPath(next[segment], rest);
+        }
+        else {
+            delete next[segment];
+        }
+        return next;
+    }
+    return current;
+}
+function getValueAtPath(current, path) {
+    let value = current;
+    for (const segment of path) {
+        if (Array.isArray(value) && typeof segment === "number") {
+            value = value[segment];
+            continue;
+        }
+        if (isRecord(value) && typeof segment === "string") {
+            value = value[segment];
+            continue;
+        }
+        return undefined;
+    }
+    return value;
+}
+function createUniquePropertyName(value, base) {
+    if (!Object.hasOwn(value, base)) {
+        return base;
+    }
+    let index = 2;
+    while (Object.hasOwn(value, `${base}${index}`)) {
+        index += 1;
+    }
+    return `${base}${index}`;
+}
+function formatPath(path) {
+    return path
+        .map((segment, index) => typeof segment === "number"
+        ? `[${segment}]`
+        : index === 0
+            ? segment
+            : `.${segment}`)
+        .join("");
+}

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

@@ -0,0 +1,3 @@
+export declare function serializeFrontmatterRecord(value: Record<string, unknown>): string;
+export declare function createFrontmatterReplacement(yaml: string): string;
+//# sourceMappingURL=serialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/serialize.ts"],"names":[],"mappings":"AAEA,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,MAAM,CAKR;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}

package/dist/preview/frontmatter/serialize.js

@@ -0,0 +1,10 @@
+import { stringify } from "yaml";
+export function serializeFrontmatterRecord(value) {
+    return stringify(value, {
+        lineWidth: 0,
+        singleQuote: false,
+    }).trimEnd();
+}
+export function createFrontmatterReplacement(yaml) {
+    return `---\n${yaml.trimEnd()}\n---`;
+}

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

@@ -0,0 +1,11 @@
+import type { FrontmatterConfig, FrontmatterPropertySuggestion } from "./types";
+export declare function readFrontmatterPropertySuggestions(config?: FrontmatterConfig): Promise<FrontmatterPropertySuggestion[]>;
+export declare function filterFrontmatterPropertySuggestions(suggestions: readonly FrontmatterPropertySuggestion[], query: string, excludedNames?: readonly string[]): FrontmatterPropertySuggestion[];
+export type FrontmatterPillWikilink = {
+    target: string;
+    text: string;
+};
+export declare function readFrontmatterValueSuggestions(config: FrontmatterConfig | undefined, key: string, query: string): Promise<string[]>;
+export declare function filterFrontmatterValueSuggestions(suggestions: readonly string[], query: string, excludedValues?: readonly string[]): string[];
+export declare function parseFrontmatterPillWikilink(value: string): FrontmatterPillWikilink | null;
+//# sourceMappingURL=suggestions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../../../src/preview/frontmatter/suggestions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,6BAA6B,EAE9B,MAAM,SAAS,CAAC;AAGjB,wBAAsB,kCAAkC,CACtD,MAAM,CAAC,EAAE,iBAAiB,GACzB,OAAO,CAAC,6BAA6B,EAAE,CAAC,CAQ1C;AAED,wBAAgB,oCAAoC,CAClD,WAAW,EAAE,SAAS,6BAA6B,EAAE,EACrD,KAAK,EAAE,MAAM,EACb,aAAa,GAAE,SAAS,MAAM,EAAO,GACpC,6BAA6B,EAAE,CAyBjC;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,wBAAsB,+BAA+B,CACnD,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,SAAS,MAAM,EAAO,GACrC,MAAM,EAAE,CA4BV;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,MAAM,GACZ,uBAAuB,GAAG,IAAI,CAUhC"}

package/dist/preview/frontmatter/suggestions.js

@@ -0,0 +1,91 @@
+import { frontmatterPropertyIcon } from "./widgets";
+export async function readFrontmatterPropertySuggestions(config) {
+    const source = config?.propertySuggestions;
+    if (!source) {
+        return [];
+    }
+    const inputs = typeof source === "function" ? await source() : source;
+    return normalizeSuggestions(inputs, config);
+}
+export function filterFrontmatterPropertySuggestions(suggestions, query, excludedNames = []) {
+    const normalizedQuery = query.trim().toLocaleLowerCase();
+    const excluded = new Set(excludedNames.map((name) => name.trim().toLocaleLowerCase()));
+    return suggestions
+        .filter((suggestion) => {
+        const name = suggestion.name.trim().toLocaleLowerCase();
+        return (name &&
+            !excluded.has(name) &&
+            (!normalizedQuery || name.includes(normalizedQuery)));
+    })
+        .sort((left, right) => {
+        const leftName = left.name.toLocaleLowerCase();
+        const rightName = right.name.toLocaleLowerCase();
+        const leftStarts = normalizedQuery && leftName.startsWith(normalizedQuery) ? 0 : 1;
+        const rightStarts = normalizedQuery && rightName.startsWith(normalizedQuery) ? 0 : 1;
+        return leftStarts - rightStarts || leftName.localeCompare(rightName);
+    })
+        .slice(0, 20);
+}
+export async function readFrontmatterValueSuggestions(config, key, query) {
+    const source = config?.valueSuggestions;
+    if (!source) {
+        return [];
+    }
+    const values = await source(key, query);
+    return filterFrontmatterValueSuggestions(values, query);
+}
+export function filterFrontmatterValueSuggestions(suggestions, query, excludedValues = []) {
+    const normalizedQuery = query.trim().toLocaleLowerCase();
+    const excluded = new Set(excludedValues.map((value) => value.trim().toLocaleLowerCase()));
+    const unique = new Map();
+    for (const suggestion of suggestions) {
+        const value = suggestion.trim();
+        const key = value.toLocaleLowerCase();
+        if (!value || excluded.has(key) || unique.has(key)) {
+            continue;
+        }
+        if (normalizedQuery && !key.includes(normalizedQuery)) {
+            continue;
+        }
+        unique.set(key, value);
+    }
+    return [...unique.values()]
+        .sort((left, right) => {
+        const leftName = left.toLocaleLowerCase();
+        const rightName = right.toLocaleLowerCase();
+        const leftStarts = normalizedQuery && leftName.startsWith(normalizedQuery) ? 0 : 1;
+        const rightStarts = normalizedQuery && rightName.startsWith(normalizedQuery) ? 0 : 1;
+        return leftStarts - rightStarts || leftName.localeCompare(rightName);
+    })
+        .slice(0, 20);
+}
+export function parseFrontmatterPillWikilink(value) {
+    const match = /^\[\[([^\]|]+)(?:\|([^\]]+))?\]\]$/u.exec(value.trim());
+    const target = match?.[1]?.trim();
+    if (!target) {
+        return null;
+    }
+    return {
+        target,
+        text: match?.[2]?.trim() || target,
+    };
+}
+function normalizeSuggestions(inputs, config) {
+    const byName = new Map();
+    for (const input of inputs) {
+        const suggestion = typeof input === "string" ? { name: input } : { ...input };
+        const name = suggestion.name.trim();
+        if (!name) {
+            continue;
+        }
+        byName.set(name.toLocaleLowerCase(), {
+            ...suggestion,
+            name,
+            icon: suggestion.icon ??
+                (suggestion.kind
+                    ? frontmatterPropertyIcon(suggestion.kind, config)
+                    : undefined),
+        });
+    }
+    return [...byName.values()];
+}

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

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

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

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

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

@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import { filterFrontmatterPropertySuggestions, filterFrontmatterValueSuggestions, parseFrontmatterPillWikilink, readFrontmatterPropertySuggestions, readFrontmatterValueSuggestions, } from "./suggestions";
+describe("frontmatter property suggestions", () => {
+    it("loads lazy suggestions and derives configured icons", async () => {
+        const suggestions = await readFrontmatterPropertySuggestions({
+            propertySuggestions: async () => [
+                "status",
+                { name: "owner", kind: "aliases" },
+                "status",
+            ],
+        });
+        expect(suggestions).toEqual([
+            { name: "status", icon: undefined },
+            { name: "owner", kind: "aliases", icon: "lucide-at-sign" },
+        ]);
+    });
+    it("filters, ranks prefixes, and excludes existing names", () => {
+        expect(filterFrontmatterPropertySuggestions([{ name: "review-status" }, { name: "status" }, { name: "state" }], "sta", ["state"]).map((suggestion) => suggestion.name)).toEqual(["status", "review-status"]);
+    });
+});
+describe("frontmatter value suggestions", () => {
+    it("loads keyed values and ranks prefix matches", async () => {
+        const suggestions = await readFrontmatterValueSuggestions({
+            valueSuggestions: (key, query) => key === "tags" && query.startsWith("p")
+                ? ["project/alpha", "inbox", "project/beta"]
+                : [],
+        }, "tags", "pro");
+        expect(suggestions).toEqual(["project/alpha", "project/beta"]);
+    });
+    it("excludes current pills and empty values", () => {
+        expect(filterFrontmatterValueSuggestions(["demo", "ideas", "demo", ""], "dem", [
+            "demo",
+        ])).toEqual([]);
+        expect(filterFrontmatterValueSuggestions(["ideas", "demo"], "ide", ["demo"])).toEqual(["ideas"]);
+    });
+});
+describe("frontmatter wikilink pills", () => {
+    it("recognizes only whole-value wikilinks", () => {
+        expect(parseFrontmatterPillWikilink("[[Project|Roadmap]]")).toEqual({
+            target: "Project",
+            text: "Roadmap",
+        });
+        expect(parseFrontmatterPillWikilink("See [[Project]]")).toBeNull();
+    });
+});

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

@@ -0,0 +1,66 @@
+export type BuiltinFrontmatterPropertyKind = "unknown" | "tags" | "aliases" | "multitext" | "array" | "object" | "text" | "number" | "checkbox" | "date" | "datetime" | "null";
+export type FrontmatterPropertyKind = BuiltinFrontmatterPropertyKind | (string & {});
+export type FrontmatterPathSegment = string | number;
+export type FrontmatterWidgetContext = {
+    property: FrontmatterProperty;
+    sourcePath?: string;
+    setValue: (value: unknown) => void;
+};
+export type FrontmatterWidgetRenderer = (element: HTMLElement, context: FrontmatterWidgetContext) => void | (() => void);
+export type FrontmatterTypeDefinition = {
+    type: FrontmatterPropertyKind;
+    label?: string;
+    icon?: string;
+    fallbackKind?: BuiltinFrontmatterPropertyKind;
+    defaultValue?: unknown | (() => unknown);
+    validate?: (value: unknown, property: FrontmatterProperty) => boolean;
+    normalize?: (value: unknown, property?: FrontmatterProperty) => unknown;
+    render?: FrontmatterWidgetRenderer;
+};
+export type FrontmatterPropertySuggestion = {
+    name: string;
+    icon?: string;
+    kind?: FrontmatterPropertyKind;
+};
+export type FrontmatterPropertySuggestionInput = string | FrontmatterPropertySuggestion;
+export type FrontmatterPropertySuggestionSource = readonly FrontmatterPropertySuggestionInput[] | (() => readonly FrontmatterPropertySuggestionInput[] | Promise<readonly FrontmatterPropertySuggestionInput[]>);
+export type FrontmatterValueSuggestionSource = (key: string, query: string) => readonly string[] | Promise<readonly string[]>;
+export type FrontmatterClipboard = {
+    readText: () => string | Promise<string>;
+    writeText: (value: string) => void | Promise<void>;
+};
+export type FrontmatterConfig = {
+    types?: Record<string, FrontmatterPropertyKind | FrontmatterTypeDefinition>;
+    properties?: Record<string, FrontmatterPropertyKind | FrontmatterTypeDefinition>;
+    widgets?: FrontmatterTypeDefinition[];
+    propertySuggestions?: FrontmatterPropertySuggestionSource;
+    valueSuggestions?: FrontmatterValueSuggestionSource;
+    clipboard?: FrontmatterClipboard;
+    onActionError?: (error: unknown, action: "copy" | "cut" | "paste" | "remove") => void;
+};
+export type FrontmatterParseResult = {
+    ok: true;
+    value: Record<string, unknown>;
+    yaml: string;
+} | {
+    ok: false;
+    error: string;
+    yaml: string;
+};
+export type FrontmatterProperty = {
+    children: FrontmatterProperty[];
+    depth: number;
+    icon: string;
+    id: string;
+    key: string;
+    parent: string;
+    path: FrontmatterPathSegment[];
+    pathString: string;
+    type: FrontmatterPropertyKind;
+    value: unknown;
+    kind: FrontmatterPropertyKind;
+    valid: boolean;
+};
+export declare const frontmatterPropertyKindOptions: readonly ["text", "number", "checkbox", "date", "datetime", "tags", "aliases", "multitext", "array", "object", "null"];
+export declare const frontmatterPropertyKindLabels: Record<BuiltinFrontmatterPropertyKind, string>;
+//# sourceMappingURL=types.d.ts.map

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

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