pagepilot-visual-editor 1.0.33 → 1.0.34

package/dist/host-stubs/view/template/form/fields/renameFieldTokens.d.ts

@@ -0,0 +1,26 @@
+import { TemplateFieldDef } from './types';
+/**
+ * Maps of old → new ids for template fields renamed in the dialog.
+ * `fields` are top-level variables (`{{id}}`, `{{id.date}}`), `items` are
+ * array row sub-fields (`{{this.id}}`).
+ */
+export type FieldRenames = {
+    fields: Record<string, string>;
+    items: Record<string, string>;
+};
+export declare const EMPTY_RENAMES: FieldRenames;
+export declare const hasRenames: (r: FieldRenames) => boolean;
+/** `stableId → original id` snapshot taken when the dialog opens. */
+export type OriginalIds = {
+    fields: Map<string, string>;
+    items: Map<string, string>;
+};
+export declare function snapshotOriginalIds(fields: TemplateFieldDef[]): OriginalIds;
+/** Diffs the edited fields against the opening snapshot (matched by stableId). */
+export declare function computeRenames(fields: TemplateFieldDef[], original: OriginalIds): FieldRenames;
+/**
+ * Deep-rewrites `{{oldId}}` tokens inside every string of a JSON-like value.
+ * Returns the SAME reference when nothing changed so callers can cheaply
+ * detect which blocks were touched.
+ */
+export declare function renameTokensDeep<T>(value: T, renames: FieldRenames): T;

package/dist/host-stubs/view/template/form/fields/types.d.ts

@@ -1,3 +1,90 @@
+/** Single-value field kinds (everything except the repeatable `array`). */
+export type TemplateScalarType = 'text' | 'textarea' | 'number' | 'image' | 'video' | 'date' | 'time' | 'datetime';
+export type TemplateFieldType = TemplateScalarType | 'array';
+/** A row sub-field declared on an `array` template field. */
+export type TemplateItemFieldDef = {
+    /**
+     * Authoring-only React list key, distinct from the user-editable `id`.
+     * Generated client-side (see `addItem` / load-time backfill) and stripped
+     * before save — never sent to the backend.
+     */
+    stableId?: string;
+    id: string;
+    name: string;
+    /** Sub-field input kind. Defaults to `text`. */
+    type?: TemplateScalarType;
+    /** Author-set default value used to prefill the row on apply. */
+    defaultValue?: string;
+    /** `date` / `datetime` sub-fields — date display format (+ absolute-only tz). */
+    dateFormat?: import('../../../../utils/dateFormats').DateFormatPreset;
+    /** `time` / `datetime` sub-fields — 24h / AM/PM display. Timezone reuses `dateTz`. */
+    timeFormat?: import('../../../../utils/dateFormats').TimeFormatPreset;
+    dateTz?: string;
+};
+export type TemplateFieldDef = {
+    /**
+     * Authoring-only React list key, distinct from the user-editable `id`.
+     * Generated client-side (see `addField` / load-time backfill) and stripped
+     * before save — never sent to the backend.
+     */
+    stableId?: string;
+    id: string;
+    name: string;
+    type: TemplateFieldType;
+    /**
+     * Author flag: whether this field's block/content is meant to be repeated
+     * (e.g. across grid cells / carousel slides) once the template is applied.
+     * Purely descriptive metadata on the saved field — doesn't change how this
+     * dialog behaves, just carries the author's intent through to `formFields`.
+     */
+    repeatable?: boolean;
+    /** Author-set default — prefills the Variables tab when the template is applied. */
+    defaultValue?: string;
+    /** Declared row sub-fields — only present for `array` fields. */
+    itemFields?: TemplateItemFieldDef[];
+    /**
+     * `array` only — when set, this field repeats the CONTAINER block with this id
+     * instead of looping text. Auto-linked to the container being saved.
+     */
+    sourceBlockId?: string;
+    /**
+     * `array` + `sourceBlockId` only — ids of OTHER existing container blocks on the
+     * canvas (e.g. Carousel slides 2 & 3) that should be treated as pre-existing rows
+     * when the template is applied. These become the initial `rowIds` so all existing
+     * copies are wired up from the start.
+     */
+    additionalSourceBlockIds?: string[];
+    /**
+     * `array` + `sourceBlockId` only — per-row default data, one entry per row
+     * (row 0 = sourceBlock, row 1+ = additionalSourceBlockIds). Each entry is a
+     * map of subFieldId → defaultValue. Prefilled into the Variables tab on apply.
+     */
+    defaultRows?: Record<string, string>[];
+    /**
+     * Authoring-only convenience: blockId → that block's default-row data, so
+     * re-ordering the block selection keeps each block's typed values intact.
+     * Not persisted to the runtime field — `defaultRows` (positional) is the
+     * source of truth that gets saved.
+     */
+    defaultRowsByBlock?: Record<string, Record<string, string>>;
+    /**
+     * Tour/Demo templates only — which step this field belongs to. Zero-based.
+     * `undefined` means the field applies to all steps (legacy / global). On
+     * save, fields are grouped by `stepIndex` and embedded in that step's
+     * `contentMetadata.document.root.data.formFields`, so tokens declared for a
+     * given step travel with its document.
+     */
+    stepIndex?: number;
+};
+export declare const FIELD_TYPE_OPTIONS: {
+    value: TemplateFieldType;
+    label: string;
+}[];
+export declare const SUBFIELD_TYPE_OPTIONS: {
+    value: TemplateScalarType;
+    label: string;
+}[];
+/** Inline `{{token}}` chip styling used in hint text across the fields editor. */
 export declare const codeSx: {
     readonly px: 0.5;
     readonly py: 0.1;
@@ -5,3 +92,17 @@ export declare const codeSx: {
     readonly bgcolor: "action.hover";
     readonly fontSize: "0.85em";
 };
+/** Returns per-type TextField props (placeholder, multiline, input type). */
+export declare function defaultValueInputProps(type: TemplateScalarType | undefined): {
+    placeholder: string;
+    multiline: boolean;
+    minRows: number;
+    maxRows: number;
+    type: string;
+} | {
+    placeholder: string;
+    multiline: boolean;
+    type: string;
+    minRows?: undefined;
+    maxRows?: undefined;
+};