@syntrologie/adapt-faq 2.8.0-canary.211 → 2.8.0-canary.213

package/dist/FAQWidgetLit.editable.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Adaptive FAQ - FAQWidgetLit.editable
+ *
+ * Editable variant of the FAQ accordion for the canvas editor surface.
+ * Renders the same Q&A rows as <syntro-faq-accordion> but adds:
+ *   - Pencil button per row (shows on hover, calls controller.editItem on click)
+ *   - Double-click on row calls controller.editItem
+ *   - Drag handle per row when items.length >= 2
+ *   - Drag-and-drop reorder via the sortable utility (injected via mount config)
+ *   - Read-only fallback when controller is null
+ *
+ * Tag name: <syntro-faq-accordion-editable>
+ *
+ * Decorator-free: uses `static override properties` (matches codebase convention).
+ * Light DOM: inherits host-page CSS variables (same as <syntro-faq-accordion>).
+ *
+ * Cross-package import safety:
+ *   The controller is typed as a structural `ControllerLike` interface defined
+ *   locally — NOT imported from @syntrologie/editor-sdk. This prevents a
+ *   dependency cycle (editor-sdk imports adapt-faq's editable; adapt-faq cannot
+ *   import editor-sdk). The real EditModeController satisfies ControllerLike
+ *   structurally.
+ *
+ *   Similarly, `makeSortable` is passed in as a `SortableFn` option rather than
+ *   imported directly. The editor-sdk bootstrap (setupEditModeBootstrap.ts) threads
+ *   the real makeSortable through the FAQWidgetLitEditableMountable.mount() call.
+ *   This is Alternative C from the architecture decision log, and matches the
+ *   structural-interface pattern already used for the controller.
+ */
+import { LitElement } from 'lit';
+import type { FAQConfig } from './types';
+/**
+ * Structural interface — describes only the methods the editable widget needs.
+ * The real EditModeController satisfies this by structural subtyping.
+ */
+export interface ControllerLike {
+    editItem(adaptive: string, itemId: string): void;
+    isModalOpen(): boolean;
+    reorderItems(adaptive: string, newOrder: string[]): void;
+}
+/** Return value from makeSortable. */
+export interface SortableHandle {
+    destroy(): void;
+}
+/** Options subset that FAQAccordionEditableElement passes into the sortable. */
+export interface SortableOptions {
+    itemSelector: string;
+    handleSelector: string;
+    getItems: () => string[];
+    onReorder: (newOrder: string[]) => void;
+    liveRegion: HTMLElement;
+}
+/**
+ * Structural type matching `makeSortable` from editor-sdk's sortable.ts.
+ * Injected at mount time by FAQWidgetLitEditableMountable.
+ */
+export type SortableFn = (host: HTMLElement, opts: SortableOptions) => SortableHandle;
+/**
+ * <syntro-faq-accordion-editable> — light-DOM Lit element.
+ *
+ * Set properties imperatively (no attribute serialisation for objects):
+ *   el.faqConfig = { ... };
+ *   el.controller = editModeControllerInstance;  // null → read-only
+ */
+export declare class FAQAccordionEditableElement extends LitElement {
+    static properties: {
+        faqConfig: {
+            attribute: boolean;
+        };
+        controller: {
+            attribute: boolean;
+        };
+        _hoveredId: {
+            state: boolean;
+        };
+    };
+    faqConfig: FAQConfig;
+    /** Null when loaded without an editor context — renders read-only accordion. */
+    controller: ControllerLike | null;
+    /**
+     * The `makeSortable` factory to use. Injected by FAQWidgetLitEditableMountable
+     * from the editor-sdk bootstrap so there is no direct import from editor-sdk
+     * into this package (which would create a circular dependency).
+     *
+     * Null when running without the editor context (read-only mode).
+     */
+    sortable: SortableFn | null;
+    /**
+     * Shared aria-live region from the modal host, threaded in via mount config.
+     * Falls back to a detached element when running outside the editor context.
+     *
+     * TODO(phase-2-a11y): wire shared live region from modal host for real a11y.
+     */
+    liveRegion: HTMLElement | null;
+    _hoveredId: string | null;
+    private _sortableHandle;
+    createRenderRoot(): this;
+    /**
+     * Wire (or re-wire) the sortable whenever the properties it depends on change.
+     * `updated()` fires after every render, including the first, so we don't need
+     * a separate `firstUpdated()` call — using `updated()` alone avoids a double
+     * attach on mount (firstUpdated + updated both fire on first render).
+     */
+    protected updated(changed: Map<string, unknown>): void;
+    disconnectedCallback(): void;
+    private _attachSortable;
+    private _handleEdit;
+    private _handleRowDblClick;
+    private _handlePencilClick;
+    private _renderRow;
+    render(): import("lit-html").TemplateResult<1>;
+}
+/**
+ * Mountable for <syntro-faq-accordion-editable>.
+ *
+ * Follows the same mount pattern as FAQWidgetLitMountable in runtime.ts.
+ * Accepts a `controller` in addition to `faqConfig` so the editor can
+ * wire up the EditModeController at mount time.
+ */
+export declare const FAQWidgetLitEditableMountable: {
+    mount(container: HTMLElement, config?: FAQConfig & {
+        instanceId?: string;
+        controller?: ControllerLike | null;
+        /** makeSortable factory injected by editor-sdk bootstrap. Null → drag disabled. */
+        sortable?: SortableFn | null;
+        /** Shared aria-live region from the modal host for sortable announcements. */
+        liveRegion?: HTMLElement | null;
+    }): () => void;
+};
+//# sourceMappingURL=FAQWidgetLit.editable.d.ts.map

package/dist/FAQWidgetLit.editable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FAQWidgetLit.editable.d.ts","sourceRoot":"","sources":["../src/FAQWidgetLit.editable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAqB,MAAM,SAAS,CAAC;AAM5D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,WAAW,IAAI,OAAO,CAAC;IACvB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1D;AAMD,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACxC,UAAU,EAAE,WAAW,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,KAAK,cAAc,CAAC;AAyFtF;;;;;;GAMG;AACH,qBAAa,2BAA4B,SAAQ,UAAU;IAKzD,OAAgB,UAAU;;;;;;;;;;MAMxB;IAMF,SAAS,EAAE,SAAS,CAKlB;IAEF,gFAAgF;IAChF,UAAU,EAAE,cAAc,GAAG,IAAI,CAAQ;IAEzC;;;;;;OAMG;IACH,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAQ;IAEnC;;;;;OAKG;IACH,UAAU,EAAE,WAAW,GAAG,IAAI,CAAQ;IAEtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IAMjC,OAAO,CAAC,eAAe,CAA+B;IAM7C,gBAAgB;IAQzB;;;;;OAKG;cACgB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQtD,oBAAoB,IAAI,IAAI;IAMrC,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IAU1B,OAAO,CAAC,UAAU;IAkDT,MAAM;CAqDhB;AAcD;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;qBAE3B,WAAW,WACb,SAAS,GAAG;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;QACnC,mFAAmF;QACnF,QAAQ,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC7B,8EAA8E;QAC9E,UAAU,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;KACjC;CAgCJ,CAAC"}

package/dist/editor.d.ts

@@ -10,6 +10,7 @@
  */
 import { LitElement } from 'lit';
 import '@syntrologie/shared-editor-ui/lit-elements';
+import './faq-item-editor';
 import { type FAQEditorConfig } from './types';
 export declare class FAQEditorLit extends LitElement {
     static properties: {
@@ -27,11 +28,18 @@ export declare class FAQEditorLit extends LitElement {
     onChange: ((updated: Record<string, unknown>) => void) | null;
     private _editingKey;
     createRenderRoot(): this;
-    private _handleBack;
     private _handleItemClick;
-    private _emitFieldChange;
-    private _handleFieldChange;
     private _handleDelete;
+    /**
+     * Build the FAQConfig slice and onChange handler to pass to <syntro-faq-item-editor>.
+     *
+     * For flat configs the full config is passed directly.
+     * For grouped configs a synthetic FAQConfig is built from the item's group actions so the
+     * inner element can find the item by ID. When onChange fires the patched flat actions are
+     * spliced back into the correct group of the grouped config before bubbling to the panel's
+     * own onChange.
+     */
+    private _buildInnerProps;
     private _renderEditMode;
     private _renderItemCard;
     private _handleNavigateFromPill;
@@ -39,4 +47,21 @@ export declare class FAQEditorLit extends LitElement {
     private _renderListMode;
     render(): import("lit-html").TemplateResult<1>;
 }
+export { FAQAccordionEditableElement, FAQWidgetLitEditableMountable, } from './FAQWidgetLit.editable';
+export { FAQItemEditorLit } from './faq-item-editor';
+interface ModalHostLike {
+    registerEditorFactory: (adaptive: 'adaptive-faq:accordion', factory: {
+        item: (args: {
+            itemId: string;
+            appConfig: Record<string, unknown>;
+            onChange: (next: Record<string, unknown>) => void;
+        }) => HTMLElement;
+        container: (args: {
+            appConfig: Record<string, unknown>;
+            onChange: (next: Record<string, unknown>) => void;
+        }) => HTMLElement;
+    }) => void;
+}
+/** Wires the FAQ adaptive's editor factories into the modal host. Called by editor-sdk bootstrap. */
+export declare function registerFaqEditorFactories(modalHost: ModalHostLike): void;
 //# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAGhD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,EAGL,KAAK,eAAe,EAMrB,MAAM,SAAS,CAAC;AA0HjB,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,UAAU;;;;;;;;;;MAIxB;IAEF,MAAM,EAAE,eAAe,GAAG,IAAI,CAAQ;IACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAErE,OAAO,CAAC,WAAW,CAAuB;IAEjC,gBAAgB;IAMzB,OAAO,CAAC,WAAW,CAMjB;IAEF,OAAO,CAAC,gBAAgB,CAEtB;IAEF,OAAO,CAAC,gBAAgB;IA+BxB,OAAO,CAAC,kBAAkB,CAExB;IAEF,OAAO,CAAC,aAAa,CA2BnB;IAIF,OAAO,CAAC,eAAe,CAsDrB;IAEF,OAAO,CAAC,eAAe,CAwDrB;IAEF,OAAO,CAAC,uBAAuB,CAY7B;IAEF,OAAO,CAAC,kBAAkB,CA8BxB;IAEF,OAAO,CAAC,eAAe,CAyBrB;IAEO,MAAM;CAoChB"}
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAGhD,OAAO,4CAA4C,CAAC;AAGpD,OAAO,mBAAmB,CAAC;AAG3B,OAAO,EAEL,KAAK,eAAe,EAMrB,MAAM,SAAS,CAAC;AAoHjB,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,UAAU;;;;;;;;;;MAIxB;IAEF,MAAM,EAAE,eAAe,GAAG,IAAI,CAAQ;IACtC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAErE,OAAO,CAAC,WAAW,CAAuB;IAEjC,gBAAgB;IAMzB,OAAO,CAAC,gBAAgB,CAEtB;IAEF,OAAO,CAAC,aAAa,CA2BnB;IAIF;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAmDxB,OAAO,CAAC,eAAe,CASrB;IAEF,OAAO,CAAC,eAAe,CAwDrB;IAEF,OAAO,CAAC,uBAAuB,CAY7B;IAEF,OAAO,CAAC,kBAAkB,CA8BxB;IAEF,OAAO,CAAC,eAAe,CAyBrB;IAEO,MAAM;CAoChB;AAQD,OAAO,EACL,2BAA2B,EAC3B,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMrD,UAAU,aAAa;IACrB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,wBAAwB,EAClC,OAAO,EAAE;QACP,IAAI,EAAE,CAAC,IAAI,EAAE;YACX,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;SACnD,KAAK,WAAW,CAAC;QAClB,SAAS,EAAE,CAAC,IAAI,EAAE;YAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;SACnD,KAAK,WAAW,CAAC;KACnB,KACE,IAAI,CAAC;CACX;AAED,qGAAqG;AACrG,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI,CAyBzE"}