@syntrologie/adapt-nav 2.20.0 → 2.21.0

package/dist/NavWidgetLit.editable.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Adaptive Nav - NavWidgetLit.editable
+ *
+ * Editable variant of the Nav tips accordion for the canvas editor surface.
+ * Renders the same tip rows as <syntro-nav-tips> but adds:
+ *   - Pencil button per row (shows on hover, calls controller.editItem on click)
+ *   - Pencil click calls controller.editItem to open the modal editor
+ *   - Read-only fallback when controller is null
+ *   - Normal clicks pass through — only pencil and drag handle trigger edit actions
+ *
+ * Tag name: <syntro-nav-tips-editable>
+ *
+ * Decorator-free: uses `static override properties` (matches codebase pattern).
+ * Light DOM: inherits host-page CSS variables (same as <syntro-nav-tips>).
+ *
+ * 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. The real EditModeController satisfies ControllerLike
+ *   structurally.
+ *
+ *   Similarly, `makeSortable` is passed in as a `SortableFn` option rather than
+ *   imported directly — matching the FAQ editable widget pattern (Alternative C
+ *   from the architecture decision log). The sortable is wired via _attachSortable()
+ *   in the updated() lifecycle hook, exactly mirroring FAQAccordionEditableElement.
+ *
+ * Click strategy:
+ *   Row clicks pass through normally — the editable variant does NOT intercept
+ *   them. Only the pencil button (opens modal editor) and drag handle (reorder)
+ *   trigger edit-mode actions. This lets the underlying widget behavior (e.g.
+ *   navigation, scrolling) work as expected in the editor preview.
+ */
+import { LitElement } from 'lit';
+import type { NavConfig } from './types';
+/**
+ * Structural interface — describes only the methods the editable widget needs.
+ * The real EditModeController satisfies this by structural subtyping.
+ *
+ * `tileId` (the host tile's id, threaded in via `instanceId` at mount) scopes
+ * controller calls to the active tile when a canvas has multiple Nav tiles.
+ * It is optional so single-tile and v2 actions-shape canvases continue to work.
+ */
+export interface ControllerLike {
+    editItem(adaptive: string, itemId: string, tileId?: string): void;
+    editContainer(adaptive: string, tileId?: string): void;
+    isModalOpen(): boolean;
+    reorderItems(adaptive: string, newOrder: string[], tileId?: string): void;
+}
+/** Return value from makeSortable. */
+export interface SortableHandle {
+    destroy(): void;
+}
+/** Options subset that NavTipsEditableElement 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 NavWidgetLitEditableMountable.
+ * Phase 3.3 will actually wire this; it is accepted here for forward compat.
+ */
+export type SortableFn = (host: HTMLElement, opts: SortableOptions) => SortableHandle;
+/**
+ * <syntro-nav-tips-editable> — light-DOM Lit element.
+ *
+ * Set properties imperatively (no attribute serialisation for objects):
+ *   el.navConfig = { ... };
+ *   el.controller = editModeControllerInstance;  // null → read-only
+ */
+export declare class NavTipsEditableElement extends LitElement {
+    static properties: {
+        navConfig: {
+            attribute: boolean;
+        };
+        controller: {
+            attribute: boolean;
+        };
+        tileId: {
+            attribute: boolean;
+        };
+        _hoveredId: {
+            state: boolean;
+        };
+        _containerHovered: {
+            state: boolean;
+        };
+    };
+    navConfig: NavConfig;
+    /** Null when loaded without an editor context — renders read-only list. */
+    controller: ControllerLike | null;
+    /**
+     * Host tile id, threaded in via the mountable's `instanceId`. Scopes every
+     * controller call so the right tile is targeted when the canvas has more
+     * than one Nav tile (per-route navs). Empty string when unknown.
+     */
+    tileId: string;
+    /**
+     * The `makeSortable` factory to use. Injected by NavWidgetLitEditableMountable
+     * 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.
+     */
+    liveRegion: HTMLElement | null;
+    _hoveredId: string | null;
+    _containerHovered: boolean;
+    private _sortableHandle;
+    createRenderRoot(): this;
+    connectedCallback(): void;
+    /**
+     * 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 _handlePencilClick;
+    private _handleContainerEdit;
+    private _renderRow;
+    render(): import("lit-html").TemplateResult<1>;
+}
+/**
+ * Mountable for <syntro-nav-tips-editable>.
+ *
+ * Follows the same mount pattern as NavWidgetLitMountable in runtime.ts.
+ * Accepts a `controller` in addition to `navConfig` so the editor can
+ * wire up the EditModeController at mount time.
+ */
+export declare const NavWidgetLitEditableMountable: {
+    mount(container: HTMLElement, config?: NavConfig & {
+        instanceId?: string;
+        controller?: ControllerLike | null;
+        /** makeSortable factory injected by editor-sdk bootstrap. Phase 3.3 wires this. */
+        sortable?: SortableFn | null;
+        /** Shared aria-live region from the modal host for sortable announcements. */
+        liveRegion?: HTMLElement | null;
+    }): () => void;
+};
+//# sourceMappingURL=NavWidgetLit.editable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NavWidgetLit.editable.d.ts","sourceRoot":"","sources":["../src/NavWidgetLit.editable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAMvD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvD,WAAW,IAAI,OAAO,CAAC;IACvB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3E;AAMD,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,2EAA2E;AAC3E,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;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,eAAe,KAAK,cAAc,CAAC;AA6JtF;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IAKpD,OAAgB,UAAU;;;;;;;;;;;;;;;;MAQxB;IAMF,SAAS,EAAE,SAAS,CAIlB;IAEF,2EAA2E;IAC3E,UAAU,EAAE,cAAc,GAAG,IAAI,CAAQ;IAEzC;;;;OAIG;IACH,MAAM,SAAM;IAEZ;;;;;;OAMG;IACH,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAQ;IAEnC;;;OAGG;IACH,UAAU,EAAE,WAAW,GAAG,IAAI,CAAQ;IAEtC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjC,iBAAiB,UAAS;IAM1B,OAAO,CAAC,eAAe,CAA+B;IAM7C,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IASlC;;;;;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;IAM1B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,UAAU;IAqDT,MAAM;CA8EhB;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;CAiCJ,CAAC"}

package/dist/editor.d.ts

@@ -13,6 +13,8 @@
 import { LitElement } from 'lit';
 import { type NavConfig } from './types';
 import '@syntrologie/shared-editor-ui/lit-elements';
+import './nav-item-editor';
+import './NavWidgetLit.editable';
 export declare class NavEditorLit extends LitElement {
     static properties: {
         config: {
@@ -41,7 +43,6 @@ export declare class NavEditorLit extends LitElement {
     private _runDetection;
     private _handleItemClick;
     private _emitConfig;
-    private _handleFieldChange;
     private _handleDelete;
     private _handleLocate;
     private _handleNavigateToRoute;
@@ -51,4 +52,21 @@ export declare class NavEditorLit extends LitElement {
     private _renderListMode;
     render(): import("lit-html").TemplateResult<1>;
 }
+export { NavTipsEditableElement, NavWidgetLitEditableMountable, } from './NavWidgetLit.editable';
+export { NavItemEditorLit } from './nav-item-editor';
+interface ModalHostLike {
+    registerEditorFactory: (adaptive: 'adaptive-nav:tips', 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 Nav adaptive's editor factories into the modal host. Called by editor-sdk bootstrap. */
+export declare function registerNavEditorFactories(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;;;;;;;;;;;GAWG;AAIH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAGhD,OAAO,EAAe,KAAK,SAAS,EAAqB,MAAM,SAAS,CAAC;AAEzE,OAAO,4CAA4C,CAAC;AAsHpD,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,UAAU;;;;;;;;;;;;;MAKxB;IAEF,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAChC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAErE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,WAAW,CAA8B;IAExC,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,YAAY,IAAI,IAAI;IAIpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC;IAKhE,OAAO,CAAC,aAAa,CAGnB;IAIF,OAAO,CAAC,gBAAgB,CAEtB;IAEF,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,kBAAkB,CAQxB;IAEF,OAAO,CAAC,aAAa,CASnB;IAEF,OAAO,CAAC,aAAa,CAUnB;IAEF,OAAO,CAAC,sBAAsB,CAY5B;IAIF,OAAO,CAAC,mBAAmB,CAWzB;IAEF,OAAO,CAAC,eAAe,CA0DrB;IAEF,OAAO,CAAC,eAAe,CAsDrB;IAEF,OAAO,CAAC,eAAe,CAarB;IAEO,MAAM;CAoChB"}
+{"version":3,"file":"editor.d.ts","sourceRoot":"","sources":["../src/editor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAQ,UAAU,EAAW,MAAM,KAAK,CAAC;AAGhD,OAAO,EAAe,KAAK,SAAS,EAAqB,MAAM,SAAS,CAAC;AAEzE,OAAO,4CAA4C,CAAC;AACpD,OAAO,mBAAmB,CAAC;AAE3B,OAAO,yBAAyB,CAAC;AAsHjC,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAgB,UAAU;;;;;;;;;;;;;MAKxB;IAEF,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAChC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC,GAAG,IAAI,CAAQ;IAErE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,aAAa,CAA0C;IAC/D,OAAO,CAAC,WAAW,CAA8B;IAExC,gBAAgB;IAIhB,iBAAiB,IAAI,IAAI;IAKzB,oBAAoB,IAAI,IAAI;IAK5B,YAAY,IAAI,IAAI;IAIpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC;IAKhE,OAAO,CAAC,aAAa,CAGnB;IAIF,OAAO,CAAC,gBAAgB,CAEtB;IAEF,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,aAAa,CASnB;IAEF,OAAO,CAAC,aAAa,CAUnB;IAEF,OAAO,CAAC,sBAAsB,CAY5B;IAIF,OAAO,CAAC,mBAAmB,CAWzB;IAEF,OAAO,CAAC,eAAe,CAiBrB;IAEF,OAAO,CAAC,eAAe,CAsDrB;IAEF,OAAO,CAAC,eAAe,CAarB;IAEO,MAAM;CAoChB;AAQD,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAGrD,UAAU,aAAa;IACrB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,mBAAmB,EAC7B,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,CAsCzE"}