@parhelia/core 0.3.12832 → 0.3.12833

package/dist/editor/component-conversion/conversionTypes.d.ts

@@ -0,0 +1,214 @@
+import type { ConversionMappingMode, ItemDescriptor } from "../../types";
+/** Mirrors Parhelia.ComponentConversion.ConversionPlan (camelCase JSON). */
+export type ConversionPlan = {
+    mode: "each" | "merge";
+    canMerge: boolean;
+    cannotMergeReason?: string;
+    target: ConversionTargetInfo;
+    currentLanguage: string;
+    languages: string[];
+    groups: ConversionPlanGroup[];
+    items: ConversionPlanItem[];
+    notes: ConversionNote[];
+    aiAvailable: boolean;
+    aiSuggested: boolean;
+    aiApplied: boolean;
+    aiError?: string;
+    /** Models the user can pick for the AI conversion. */
+    models: ConversionModelOption[];
+    /** The model this plan's AI calls used (the picked one or the default). */
+    modelId?: string;
+    /** Model calls as sent and received; only when the request asked for them. */
+    aiCalls?: ConversionAiCall[];
+};
+export type ConversionModelOption = {
+    id: string;
+    name: string;
+};
+/** One model call, for the debug view. */
+export type ConversionAiCall = {
+    title: string;
+    model?: string;
+    maxTokens: number;
+    durationMs: number;
+    inputTokens: number;
+    outputTokens: number;
+    /** The provider request as sent. */
+    payload?: string;
+    /** The provider response as received. */
+    rawResponse?: string;
+    /** The model's reply text. */
+    content?: string;
+    error?: string;
+};
+export type ConversionTargetInfo = {
+    typeId: string;
+    name: string;
+    thumbnail?: string;
+    icon?: string;
+    fields: ConversionFieldInfo[];
+    placeholders: ConversionPlaceholderInfo[];
+};
+export type ConversionFieldInfo = {
+    id: string;
+    name: string;
+    displayName: string;
+    type: string;
+    category: string;
+    section?: string;
+    sortOrder: number;
+    /** Target fields: the AI can write this field (free text). */
+    writable?: boolean;
+};
+export type ConversionPlaceholderInfo = {
+    name: string;
+    allowedTypes: {
+        id: string;
+        name: string;
+    }[];
+};
+export type ConversionSourceOption = {
+    key: string;
+    componentId?: string;
+    componentName?: string;
+    fieldId: string;
+    name: string;
+    displayName: string;
+    type: string;
+    section?: string;
+};
+export type ConversionMappingRow = {
+    targetFieldId: string;
+    sourceKey?: string | null;
+    mode: ConversionMappingMode;
+    instruction?: string;
+    /** Generate rows: the source option keys the AI based the value on. */
+    uses?: string[];
+    origin: "name" | "ai" | "none" | "user";
+    reason?: string;
+};
+export type ConversionPlanGroup = {
+    key: string;
+    sourceTypeId?: string;
+    sourceTypeName?: string;
+    itemKeys: string[];
+    sourceFields: ConversionSourceOption[];
+    mappings: ConversionMappingRow[];
+    /** target field id -> source option key -> "copy" | "convert" | "none" */
+    compatibility: Record<string, Record<string, "copy" | "convert" | "none">>;
+    /** target field id -> source option keys the model may rewrite from */
+    rewriteSources: Record<string, string[]>;
+};
+export type ConversionValuePreview = {
+    hasValue: boolean;
+    text?: string;
+    imageUrl?: string;
+    raw?: string;
+    error?: string;
+};
+export type ConversionSourceRole = {
+    componentId: string;
+    name: string;
+    typeName: string;
+    role: "merge" | "child";
+    targetPlaceholder?: string;
+    childPlaceholders: string[];
+    targetTypeId?: string;
+    targetTypeName?: string;
+    nested?: ConversionNestedPlan;
+};
+export type ConversionNestedPlan = {
+    targetFields: ConversionFieldInfo[];
+    sourceFields: ConversionSourceOption[];
+    mappings: ConversionMappingRow[];
+    /** AI-written values of the converted child: language -> target field id -> raw value. */
+    values?: Record<string, Record<string, string>>;
+};
+export type ConversionChildPlan = {
+    componentId: string;
+    parentComponentId?: string;
+    name: string;
+    typeId: string;
+    typeName: string;
+    action: "move" | "convert" | "remove";
+    targetPlaceholder?: string;
+    targetTypeId?: string;
+    targetTypeName?: string;
+    reason?: string;
+    movePlaceholders: string[];
+    nested?: ConversionNestedPlan;
+};
+export type ConversionPlanItem = {
+    key: string;
+    groupKey: string;
+    sourceComponentIds: string[];
+    anchorComponentId: string;
+    name: string;
+    sourceTypeName: string;
+    placeholderKey: string;
+    placeholderIndex: number;
+    isShared: boolean;
+    externalReferrerCount: number;
+    externalReferrers: string[];
+    sourceValues: Record<string, ConversionValuePreview>;
+    targetValues: Record<string, ConversionValuePreview>;
+    /** AI-written values in the other languages: language -> target field id -> raw value. */
+    languageValues?: Record<string, Record<string, string>>;
+    languages: string[];
+    children: ConversionChildPlan[];
+    sourceRoles: ConversionSourceRole[];
+    carriedParameters: string[];
+    droppedParameters: string[];
+    personalizationRulesKept: number;
+    personalizationRulesDropped: number;
+    fieldComments: number;
+    componentComments: number;
+    suggestedEdits: number;
+};
+export type ConversionNote = {
+    kind: "info" | "warning";
+    code: string;
+    text: string;
+};
+export type ConversionPlanRequest = {
+    page: ItemDescriptor;
+    componentIds: string[];
+    targetTypeId: string;
+    mode?: "each" | "merge";
+    useAi?: boolean;
+    /** The user's instructions for the AI, oldest first; the last one is the new request. */
+    instructions?: string[];
+    /** The mapping as the dialog shows it; the plan starts from it and the AI refines it. */
+    currentMappings?: ConversionClientRow[];
+    /** Group key -> item key on screen; its children stand for the group's in the prompt. */
+    activeItems?: Record<string, string>;
+    /** AI values the dialog shows: item key -> language -> target field id -> raw value. */
+    currentValues?: Record<string, Record<string, Record<string, string>>>;
+    /** Model to use; unset for the default. */
+    modelId?: string;
+    /** Return each model call's raw payload and response. */
+    includeAiDebug?: boolean;
+};
+export type ConversionClientRow = {
+    groupKey: string;
+    targetFieldId: string;
+    sourceKey?: string | null;
+    mode: ConversionMappingMode;
+    instruction?: string;
+    uses?: string[];
+    origin?: ConversionMappingRow["origin"];
+};
+export type ConversionPreviewRequest = {
+    page: ItemDescriptor;
+    sourceComponentId: string;
+    sourceFieldId: string;
+    targetTypeId: string;
+    targetFieldId: string;
+    mode: ConversionMappingMode;
+    instruction?: string;
+    modelId?: string;
+};
+export type ConversionPreviewResponse = {
+    preview?: ConversionValuePreview;
+    error?: string;
+};

package/dist/editor/component-conversion/conversionTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=conversionTypes.js.map

package/dist/editor/component-conversion/conversionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversionTypes.js","sourceRoot":"","sources":["../../../src/editor/component-conversion/conversionTypes.ts"],"names":[],"mappings":""}

package/dist/editor/component-conversion/convertComponentsCommand.d.ts

@@ -0,0 +1,25 @@
+import type { EditContextType } from "../client/editContext";
+import type { Component } from "../pageModel";
+import type { InsertOption } from "../../types";
+import type { ComponentCommand } from "../commands/componentCommands";
+/** The components a conversion just created, for the canvas "Converted from" badge. */
+export type RecentConversion = {
+    operationId: string;
+    componentIds: string[];
+    fromName: string;
+};
+/**
+ * Types every selected component may become: the insert options their
+ * placeholders share. When all selected components have the same type, that
+ * type is left out.
+ */
+export declare function getConversionTargets(components: Component[]): InsertOption[];
+/** Selected components sorted by their position in the page tree. */
+export declare function sortByDocumentOrder(components: Component[], root: Component | undefined): Component[];
+/**
+ * "Convert to…": replaces the selected components with components of another
+ * type. Hidden when a component cannot be converted; disabled while the
+ * placeholders' insert options are still loading (they are an empty list until
+ * then, which must not read as "nothing allowed").
+ */
+export declare function getConvertToCommand(components: Component[], editContext: EditContextType): ComponentCommand | null;

package/dist/editor/component-conversion/convertComponentsCommand.js

@@ -0,0 +1,196 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import uuid from "react-uuid";
+import { Replace } from "lucide-react";
+import { getVisibleInsertOptions } from "../insertMenuItems";
+import { waitForEditOperationTerminal } from "../client/waitForEditOperationTerminal";
+import { ComponentTypePickerDialog, } from "./ComponentTypePickerDialog";
+import { ConvertComponentDialog, } from "./ConvertComponentDialog";
+const TERMINAL_TIMEOUT_MS = 10 * 60 * 1000;
+const normalizeId = (id) => (id ?? "").replace(/[{}]/g, "").toLowerCase();
+/**
+ * Types every selected component may become: the insert options their
+ * placeholders share. When all selected components have the same type, that
+ * type is left out.
+ */
+export function getConversionTargets(components) {
+    let shared;
+    for (const component of components) {
+        const options = getVisibleInsertOptions(component.parentPlaceholder?.insertOptions);
+        shared = shared
+            ? shared.filter((a) => options.some((b) => normalizeId(b.typeId) === normalizeId(a.typeId)))
+            : options;
+    }
+    const types = new Set(components.map((c) => normalizeId(c.typeId)));
+    const excluded = types.size === 1 ? [...types][0] : undefined;
+    return (shared ?? []).filter((option) => !option.isCommandTemplate && !option.action && normalizeId(option.typeId) !== excluded);
+}
+/** Selected components sorted by their position in the page tree. */
+export function sortByDocumentOrder(components, root) {
+    if (!root)
+        return components;
+    const order = new Map();
+    let index = 0;
+    const visit = (component) => {
+        order.set(normalizeId(component.id), index++);
+        for (const placeholder of component.placeholders ?? []) {
+            for (const child of placeholder.components)
+                visit(child);
+        }
+    };
+    visit(root);
+    return [...components].sort((a, b) => (order.get(normalizeId(a.id)) ?? Number.MAX_SAFE_INTEGER) -
+        (order.get(normalizeId(b.id)) ?? Number.MAX_SAFE_INTEGER));
+}
+function displayName(component) {
+    return component.datasourceItem?.displayName || component.datasourceItem?.name || component.name;
+}
+/** The component's type as the insert options name it, falling back to its rendering type. */
+function typeName(component) {
+    const option = component.parentPlaceholder?.insertOptions?.find((o) => normalizeId(o.typeId) === normalizeId(component.typeId));
+    return option?.name || component.type || undefined;
+}
+/** The type all components share, or undefined for mixed types. */
+function sharedTypeName(components) {
+    const types = new Set(components.map((c) => normalizeId(c.typeId)));
+    return types.size === 1 ? typeName(components[0]) : undefined;
+}
+/** "Convert from Hero to", "Convert 3 components from Hero to", or without "from" for mixed types. */
+function pickerTitle(components) {
+    const count = components.length === 1 ? "" : ` ${components.length} components`;
+    const from = sharedTypeName(components);
+    return from ? `Convert${count} from ${from} to` : `Convert${count} to`;
+}
+/**
+ * "Convert to…": replaces the selected components with components of another
+ * type. Hidden when a component cannot be converted; disabled while the
+ * placeholders' insert options are still loading (they are an empty list until
+ * then, which must not read as "nothing allowed").
+ */
+export function getConvertToCommand(components, editContext) {
+    if (components.length === 0)
+        return null;
+    if (editContext.mode === "suggestions" || editContext.mode === "preview")
+        return null;
+    if (editContext.readonly || editContext.isMobile)
+        return null;
+    for (const component of components) {
+        if (!component?.typeId || component.editable === false)
+            return null;
+        if (component.layoutId && !editContext.showLayoutComponents)
+            return null;
+        if (!component.parentPlaceholder)
+            return null;
+        if (editContext.page?.rootComponent?.id === component.id)
+            return null;
+    }
+    const unresolved = components.some((c) => c.parentPlaceholder?.insertOptionsResolved === false);
+    const targets = unresolved ? [] : getConversionTargets(components);
+    if (!unresolved && targets.length === 0)
+        return null;
+    return {
+        id: "convertTo",
+        label: components.length > 1
+            ? `Convert ${components.length} components to…`
+            : "Convert to…",
+        icon: _jsx(Replace, { strokeWidth: 1, size: 16 }),
+        visibilityScopes: ["contextMenu", "componentTree", "menu"],
+        disabled: (context) => unresolved || !context.editContext.page?.item.canWriteItem,
+        execute: async (context) => {
+            await runConversion(context.editContext, components, context.openDialog);
+        },
+    };
+}
+async function runConversion(editContext, selected, openDialog) {
+    const page = editContext.page;
+    const pageItem = page?.item.descriptor;
+    if (!page || !pageItem)
+        return;
+    const components = sortByDocumentOrder(selected, page.rootComponent);
+    const targets = getConversionTargets(components);
+    const selectionLabel = components.length === 1 ? displayName(components[0]) : `${components.length} components`;
+    const target = await openDialog(ComponentTypePickerDialog, {
+        title: pickerTitle(components),
+        subtitle: selectionLabel,
+        options: targets,
+    });
+    if (!target)
+        return;
+    const result = await openDialog(ConvertComponentDialog, {
+        pageItem,
+        componentIds: components.map((c) => c.id),
+        target,
+        selectionLabel,
+        sourceTypeName: sharedTypeName(components),
+    });
+    if (!result)
+        return;
+    const operation = {
+        type: "convert-component",
+        id: uuid(),
+        date: new Date().toISOString(),
+        title: result.title,
+        mainItem: pageItem,
+        mode: result.mode,
+        conversions: result.conversions,
+        instructions: result.instructions.length > 0 ? result.instructions : undefined,
+        modelId: result.modelId,
+    };
+    const executed = (await editContext.operations.executeEditOperation(operation));
+    if (!executed || executed.executionStatus === "failed")
+        return;
+    let createdIds = executed.createdItemIds ?? [];
+    let warnings = executed.warnings ?? [];
+    if (executed.executionStatus === "executing") {
+        let terminal;
+        try {
+            terminal = await waitForEditOperationTerminal(operation.id, TERMINAL_TIMEOUT_MS);
+        }
+        catch {
+            editContext.showErrorToast({
+                summary: "Conversion is still running",
+                details: "The page updates when it finishes.",
+            });
+            return;
+        }
+        if (terminal.errorMessage) {
+            editContext.showErrorToast({ summary: "Conversion failed", details: terminal.errorMessage });
+            return;
+        }
+        createdIds = terminal.createdItemIds ?? [];
+        warnings = await loadWarnings(operation.id);
+        // The request returned (and refreshed the canvas) before the background
+        // conversion wrote anything. A soft refresh patches the canvas in place and
+        // can keep the replaced component's markup; reload it fully instead.
+        editContext.requestRefresh("hard");
+    }
+    if (createdIds.length === 0)
+        return;
+    editContext.setRecentConversion?.({
+        operationId: operation.id,
+        componentIds: createdIds,
+        fromName: components.length === 1 ? selectionLabel : `${components.length} components`,
+    });
+    editContext.select(createdIds);
+    if (warnings.length > 0) {
+        editContext.showInfoToast({
+            summary: "Converted with notes",
+            details: warnings.slice(0, 4).join("\n"),
+        });
+    }
+}
+async function loadWarnings(operationId) {
+    try {
+        const response = await fetch(`/parhelia/editOperation?id=${encodeURIComponent(operationId)}`, {
+            credentials: "include",
+            headers: { "Cache-Control": "no-cache" },
+        });
+        if (!response.ok)
+            return [];
+        const op = (await response.json());
+        return op.warnings ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=convertComponentsCommand.js.map

package/dist/editor/component-conversion/convertComponentsCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertComponentsCommand.js","sourceRoot":"","sources":["../../../src/editor/component-conversion/convertComponentsCommand.tsx"],"names":[],"mappings":"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"}

package/dist/editor/field-types/FieldHistoryBoundary.js

@@ -1,19 +1,40 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useRef, useState } from "react";
+import { useLayoutEffect, useRef } from "react";
+const PRISTINE_ATTRIBUTE = "data-parhelia-pristine-field";
 /** Give page history the shortcut until this editor has local edits to undo. */
 export function FieldHistoryBoundary({ enabled, children, }) {
     const ref = useRef(null);
-    const [hasLocalEdits, setHasLocalEdits] = useState(false);
+    // Tracked in a ref and mirrored to the DOM by hand, never as React state.
+    // The capture handlers below run between the native edit and the editor's
+    // React change event. A state update there commits (React flushes it in a
+    // microtask) before onChange runs: the controlled input is re-rendered with
+    // its stale value, React writes that value back into the control and resyncs
+    // its value tracker, and the change event is then dropped as "unchanged".
+    // Deleting a selection with Backspace/Delete in an untouched field showed
+    // exactly that: the selection collapsed and the text came back. Typing was
+    // unaffected only because React's onBeforeInput (text insertion) fires
+    // before the DOM changes, while deletions have no such event.
+    const hasLocalEdits = useRef(false);
+    useLayoutEffect(() => {
+        const element = ref.current;
+        if (!element)
+            return;
+        if (enabled && !hasLocalEdits.current) {
+            element.setAttribute(PRISTINE_ATTRIBUTE, "true");
+        }
+        else {
+            element.removeAttribute(PRISTINE_ATTRIBUTE);
+        }
+    }, [enabled]);
     const markEdited = () => {
-        // Update synchronously too: another shortcut can arrive before React commits.
-        ref.current?.removeAttribute("data-parhelia-pristine-field");
-        setHasLocalEdits(true);
+        hasLocalEdits.current = true;
+        ref.current?.removeAttribute(PRISTINE_ATTRIBUTE);
     };
-    return (_jsx("div", { ref: ref, className: "contents", "data-parhelia-pristine-field": enabled && !hasLocalEdits ? "true" : undefined, onBeforeInputCapture: markEdited, onInputCapture: markEdited, onCompositionStartCapture: markEdited, children: children(markEdited) }));
+    return (_jsx("div", { ref: ref, className: "contents", onBeforeInputCapture: markEdited, onInputCapture: markEdited, onCompositionStartCapture: markEdited, children: children(markEdited) }));
 }
 export function hasPristineFieldHistory(target) {
     const node = target;
     const element = node?.nodeType === 3 ? node.parentElement : target;
-    return !!element?.closest?.('[data-parhelia-pristine-field="true"]');
+    return !!element?.closest?.(`[${PRISTINE_ATTRIBUTE}="true"]`);
 }
 //# sourceMappingURL=FieldHistoryBoundary.js.map

package/dist/editor/field-types/FieldHistoryBoundary.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldHistoryBoundary.js","sourceRoot":"","sources":["../../../src/editor/field-types/FieldHistoryBoundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAC;AAEzD,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,EACnC,OAAO,EACP,QAAQ,GAIT;IACC,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IACzC,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,8EAA8E;QAC9E,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,8BAA8B,CAAC,CAAC;QAC7D,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,OAAO,CACL,cACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAC,UAAU,kCAElB,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAEhD,oBAAoB,EAAE,UAAU,EAChC,cAAc,EAAE,UAAU,EAC1B,yBAAyB,EAAE,UAAU,YAEpC,QAAQ,CAAC,UAAU,CAAC,GACjB,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IAChE,MAAM,IAAI,GAAG,MAAqB,CAAC;IACnC,MAAM,OAAO,GACX,IAAI,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAE,MAAyB,CAAC;IACzE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,uCAAuC,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"FieldHistoryBoundary.js","sourceRoot":"","sources":["../../../src/editor/field-types/FieldHistoryBoundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAC;AAEhE,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAE1D,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,EACnC,OAAO,EACP,QAAQ,GAIT;IACC,MAAM,GAAG,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IACzC,0EAA0E;IAC1E,0EAA0E;IAC1E,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,0EAA0E;IAC1E,0EAA0E;IAC1E,2EAA2E;IAC3E,uEAAuE;IACvE,8DAA8D;IAC9D,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEpC,eAAe,CAAC,GAAG,EAAE;QACnB,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YACtC,OAAO,CAAC,YAAY,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;QAC7B,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,kBAAkB,CAAC,CAAC;IACnD,CAAC,CAAC;IAEF,OAAO,CACL,cACE,GAAG,EAAE,GAAG,EACR,SAAS,EAAC,UAAU,EACpB,oBAAoB,EAAE,UAAU,EAChC,cAAc,EAAE,UAAU,EAC1B,yBAAyB,EAAE,UAAU,YAEpC,QAAQ,CAAC,UAAU,CAAC,GACjB,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAA0B;IAChE,MAAM,IAAI,GAAG,MAAqB,CAAC;IACnC,MAAM,OAAO,GACX,IAAI,EAAE,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAE,MAAyB,CAAC;IACzE,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,IAAI,kBAAkB,UAAU,CAAC,CAAC;AAChE,CAAC"}

package/dist/editor/field-types/fieldStyles.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared look of the edit form's field boxes: a visible grey border, 6px
+ * corners, white fill, 12px text, and a dark border with a soft grey 3px halo on
+ * focus. Combine with `cn()` so these win over the base component classes.
+ * The radius is important: styles.css pins inputs and comboboxes to 4px
+ * with an unlayered rule that beats utilities.
+ */
+export declare const fieldBoxClassName = "border-neutral-grey-15 hover:not-focus-within:border-neutral-grey-50/50 text-neutral-grey-80 rounded-[6px]! border bg-white text-xs leading-5 md:text-xs";
+/**
+ * The field box's border, corners and white fill without its text styles, for
+ * fields that frame other UI: tree lists, image tiles, attachments.
+ */
+export declare const fieldFrameClassName = "border-neutral-grey-15 hover:not-focus-within:border-neutral-grey-50/50 rounded-[6px]! border bg-white";
+/** Text padding inside a field box. Backdrops that mirror the text repeat it. */
+export declare const fieldTextPaddingClassName = "px-3 py-2.5";
+/** Focus for native inputs and textareas (the shared Input draws focus as an outline). */
+export declare const fieldFocusClassName = "focus-visible:border-neutral-grey-100 focus-visible:outline-neutral-grey-15 focus-visible:outline-[3px] focus-visible:outline-offset-0 focus-visible:outline-solid";
+/** Focus for a box whose focusable element is a child (the rich text editor). */
+export declare const fieldFocusWithinClassName = "focus-within:border-neutral-grey-100 focus-within:outline-neutral-grey-15 focus-within:outline-[3px] focus-within:outline-offset-0 focus-within:outline-solid";
+/** Focus for button-based fields (selects, date and link pickers): Button draws focus as a ring. */
+export declare const fieldButtonFocusClassName = "focus-visible:border-neutral-grey-100 focus-visible:ring-neutral-grey-15 aria-expanded:border-neutral-grey-100 aria-expanded:ring-neutral-grey-15 aria-expanded:ring-[3px]";

package/dist/editor/field-types/fieldStyles.js

@@ -0,0 +1,22 @@
+/**
+ * Shared look of the edit form's field boxes: a visible grey border, 6px
+ * corners, white fill, 12px text, and a dark border with a soft grey 3px halo on
+ * focus. Combine with `cn()` so these win over the base component classes.
+ * The radius is important: styles.css pins inputs and comboboxes to 4px
+ * with an unlayered rule that beats utilities.
+ */
+export const fieldBoxClassName = "border-neutral-grey-15 hover:not-focus-within:border-neutral-grey-50/50 text-neutral-grey-80 rounded-[6px]! border bg-white text-xs leading-5 md:text-xs";
+/**
+ * The field box's border, corners and white fill without its text styles, for
+ * fields that frame other UI: tree lists, image tiles, attachments.
+ */
+export const fieldFrameClassName = "border-neutral-grey-15 hover:not-focus-within:border-neutral-grey-50/50 rounded-[6px]! border bg-white";
+/** Text padding inside a field box. Backdrops that mirror the text repeat it. */
+export const fieldTextPaddingClassName = "px-3 py-2.5";
+/** Focus for native inputs and textareas (the shared Input draws focus as an outline). */
+export const fieldFocusClassName = "focus-visible:border-neutral-grey-100 focus-visible:outline-neutral-grey-15 focus-visible:outline-[3px] focus-visible:outline-offset-0 focus-visible:outline-solid";
+/** Focus for a box whose focusable element is a child (the rich text editor). */
+export const fieldFocusWithinClassName = "focus-within:border-neutral-grey-100 focus-within:outline-neutral-grey-15 focus-within:outline-[3px] focus-within:outline-offset-0 focus-within:outline-solid";
+/** Focus for button-based fields (selects, date and link pickers): Button draws focus as a ring. */
+export const fieldButtonFocusClassName = "focus-visible:border-neutral-grey-100 focus-visible:ring-neutral-grey-15 aria-expanded:border-neutral-grey-100 aria-expanded:ring-neutral-grey-15 aria-expanded:ring-[3px]";
+//# sourceMappingURL=fieldStyles.js.map

package/dist/editor/field-types/fieldStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fieldStyles.js","sourceRoot":"","sources":["../../../src/editor/field-types/fieldStyles.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,0JAA0J,CAAC;AAE7J;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,wGAAwG,CAAC;AAE3G,iFAAiF;AACjF,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,mBAAmB,GAC9B,oKAAoK,CAAC;AAEvK,iFAAiF;AACjF,MAAM,CAAC,MAAM,yBAAyB,GACpC,+JAA+J,CAAC;AAElK,oGAAoG;AACpG,MAAM,CAAC,MAAM,yBAAyB,GACpC,4KAA4K,CAAC"}

package/dist/editor/field-types/richtext/utils/changeHighlight.d.ts

@@ -2,6 +2,13 @@ import { type DecoratedRange, type Descendant, type NodeEntry } from "slate";
 import type { DiffRange } from "../../../version-diff/versionDiffTargets";
 /** Leaf flag set by {@link decorateChangedText}; rendered as the added-text mark. */
 export declare const CHANGED_TEXT_LEAF = "changedText";
+/** Leaf flag for a misspelled word; rendered as the wavy spell-check underline. */
+export declare const MISSPELLED_LEAF = "misspelled";
+/** A [start, end) range in a text offset space, as used by the decorate helpers. */
+export type TextRange = {
+    start: number;
+    end: number;
+};
 /**
  * The document's plain text as one string: every text node concatenated in
  * document order, no separators between blocks. Diff offsets are computed
@@ -16,3 +23,10 @@ export declare function collectTextNodeStarts(nodes: Descendant[]): Map<string,
  * leaf flag. Non-text nodes and nodes outside every range yield nothing.
  */
 export declare function decorateChangedText(entry: NodeEntry, starts: Map<string, number>, ranges: DiffRange[]): DecoratedRange[];
+/**
+ * Generic Slate `decorate` body: the parts of `entry` (a text node) that fall
+ * inside one of the `ranges`, as decorated ranges carrying `leafKey`. The
+ * offsets of `ranges` and the `starts` map must share one text offset space
+ * (see {@link collectTextNodeStarts} and `buildSpellCheckText`).
+ */
+export declare function decorateRanges(entry: NodeEntry, starts: Map<string, number>, ranges: readonly TextRange[], leafKey: string): DecoratedRange[];

package/dist/editor/field-types/richtext/utils/changeHighlight.js

@@ -1,6 +1,8 @@
 import { Node, Text, } from "slate";
 /** Leaf flag set by {@link decorateChangedText}; rendered as the added-text mark. */
 export const CHANGED_TEXT_LEAF = "changedText";
+/** Leaf flag for a misspelled word; rendered as the wavy spell-check underline. */
+export const MISSPELLED_LEAF = "misspelled";
 /**
  * The document's plain text as one string: every text node concatenated in
  * document order, no separators between blocks. Diff offsets are computed
@@ -33,6 +35,15 @@ export function collectTextNodeStarts(nodes) {
  * leaf flag. Non-text nodes and nodes outside every range yield nothing.
  */
 export function decorateChangedText(entry, starts, ranges) {
+    return decorateRanges(entry, starts, ranges, CHANGED_TEXT_LEAF);
+}
+/**
+ * Generic Slate `decorate` body: the parts of `entry` (a text node) that fall
+ * inside one of the `ranges`, as decorated ranges carrying `leafKey`. The
+ * offsets of `ranges` and the `starts` map must share one text offset space
+ * (see {@link collectTextNodeStarts} and `buildSpellCheckText`).
+ */
+export function decorateRanges(entry, starts, ranges, leafKey) {
     const [node, path] = entry;
     if (!Text.isText(node) || ranges.length === 0)
         return [];
@@ -49,7 +60,7 @@ export function decorateChangedText(entry, starts, ranges) {
         decorations.push({
             anchor: { path, offset: start - nodeStart },
             focus: { path, offset: end - nodeStart },
-            [CHANGED_TEXT_LEAF]: true,
+            [leafKey]: true,
         });
     }
     return decorations;

package/dist/editor/field-types/richtext/utils/changeHighlight.js.map

@@ -1 +1 @@
-{"version":3,"file":"changeHighlight.js","sourceRoot":"","sources":["../../../../../src/editor/field-types/richtext/utils/changeHighlight.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,IAAI,GAIL,MAAM,OAAO,CAAC;AAGf,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACnC,KAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,MAA2B,EAC3B,MAAmB;IAEnB,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAE7C,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,GAAG,IAAI,KAAK;YAAE,SAAS;QAC3B,WAAW,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAG,SAAS,EAAE;YAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE;YACxC,CAAC,iBAAiB,CAAC,EAAE,IAAI;SACR,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
+{"version":3,"file":"changeHighlight.js","sourceRoot":"","sources":["../../../../../src/editor/field-types/richtext/utils/changeHighlight.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,IAAI,GAIL,MAAM,OAAO,CAAC;AAGf,qFAAqF;AACrF,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC;AAE/C,mFAAmF;AACnF,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAK5C;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1C,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACnC,KAAmB;IAEnB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC5B,KAAK,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;YAC/C,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QACjC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,MAA2B,EAC3B,MAAmB;IAEnB,OAAO,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,MAA2B,EAC3B,MAA4B,EAC5B,OAAe;IAEf,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAC3B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAE7C,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACzC,IAAI,GAAG,IAAI,KAAK;YAAE,SAAS;QAC3B,WAAW,CAAC,IAAI,CAAC;YACf,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAG,SAAS,EAAE;YAC3C,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,SAAS,EAAE;YACxC,CAAC,OAAO,CAAC,EAAE,IAAI;SACE,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}