quilt-vanilla 0.2.4 → 0.4.0

package/dist/workspace-api.d.ts

@@ -0,0 +1,186 @@
+import type { Pane, Group, WindowPlacement, AutoCollapse, Axis, CommandOptions, JoinOptions, Capability, Layout } from 'quilt-core';
+import { PaneRegistry } from './registry.js';
+import type { PaneRegistration } from './registry.js';
+import type { LayoutTheme } from './theme.js';
+import type { PaneRenderer, TabBarOptions, WorkspaceSettings, WorkspaceAction, ActionContext, RegisteredShortcut } from './types.js';
+export type PaneType<T> = Omit<PaneRegistration<T>, 'type' | 'view'> & {
+    render: T;
+};
+export type PaneTypes<T> = Record<string, PaneType<T>>;
+export type WorkspaceOptions<State = unknown> = WorkspaceSettings<State> & import('./types.js').InitialConfiguration & {
+    container: HTMLElement;
+    store?: never;
+} & (unknown extends State ? {} : {
+    getPaneState: (paneId: string) => State;
+}) & ({
+    paneTypes: PaneTypes<PaneRenderer<State>>;
+    registry?: never;
+    renderers?: never;
+    tabs?: never;
+} | {
+    paneTypes?: undefined;
+    registry: PaneRegistry<PaneRenderer<State>>;
+    renderers?: never;
+    tabs?: never;
+} | {
+    paneTypes?: undefined;
+    registry?: undefined;
+    renderers?: Record<string, PaneRenderer<State>>;
+    tabs?: import('./registry.js').TabRegistry;
+});
+export type WorkspaceOptionUpdates<State = unknown> = {
+    [Key in keyof WorkspaceSettings<State>]?: WorkspaceSettings<State>[Key] | undefined;
+} & ({
+    paneTypes?: PaneTypes<PaneRenderer<State>> | undefined;
+    registry?: undefined;
+    renderers?: undefined;
+    tabs?: undefined;
+} | {
+    paneTypes?: undefined;
+    registry?: PaneRegistry<PaneRenderer<State>> | undefined;
+    renderers?: undefined;
+    tabs?: undefined;
+} | {
+    paneTypes?: undefined;
+    registry?: undefined;
+    renderers?: Record<string, PaneRenderer<State>> | undefined;
+    tabs?: import('./registry.js').TabRegistry | undefined;
+});
+export interface WorkspaceChange {
+    action: string;
+    changes: readonly ('layout' | 'theme' | 'tabBar' | 'autoCollapse' | 'shortcuts')[];
+}
+export interface WorkspaceEvents {
+    change: WorkspaceChange;
+    error: unknown;
+}
+export type AddPaneOptions = Partial<Omit<Pane, 'type'>> & {
+    groupId?: string;
+};
+export interface CloseOptions {
+    force?: boolean;
+}
+export interface PaneHandle {
+    readonly id: string;
+    readonly isDisposed: boolean;
+    getSnapshot(): Pane;
+    update(patch: Partial<Omit<Pane, 'id'>>): void;
+    setTitle(title: string): void;
+    activate(): void;
+    move(groupId: string, position?: 'tab' | 'left' | 'right' | 'top' | 'bottom', index?: number): void;
+    popout(placement?: WindowPlacement): Promise<boolean>;
+    return(): void;
+    retry(): void;
+    close(options?: CloseOptions): Promise<boolean>;
+}
+/** The mounted API. The model and its lifetime remain private to Quilt. */
+export interface WorkspaceHandle<State = unknown> {
+    readonly isDisposed: boolean;
+    canExecuteAction(action: WorkspaceAction, context?: ActionContext): boolean;
+    executeAction(action: WorkspaceAction, context?: ActionContext): Promise<boolean>;
+    getShortcuts(): readonly RegisteredShortcut[];
+    /** Subscribe to configuration changes or errors. The returned function unsubscribes. */
+    on<K extends keyof WorkspaceEvents>(event: K, listener: (event: WorkspaceEvents[K]) => void): () => void;
+    /** Stable immutable arrangement snapshot, including live detached records. */
+    getLayout(): Layout;
+    /** Mutable arrangement copy. Use exportWorkspace for persistence with appearance. */
+    exportLayout(): Layout;
+    /** Validate and replace the arrangement; detached records restore docked. Invalidates old pane handles on success. */
+    loadLayout(input: unknown): void;
+    /** Restore the initial arrangement and appearance. */
+    reset(): void;
+    exportWorkspace(): import('./workspace.js').WorkspacePreset;
+    /** Apply a complete preset atomically; emit one consolidated change event. */
+    loadWorkspace(input: unknown): void;
+    updateOptions(options: WorkspaceOptionUpdates<State>): void;
+    setTheme(theme: LayoutTheme): void;
+    setTabBar(tabBar: TabBarOptions): void;
+    refreshTheme(): void;
+    getAutoCollapse(): AutoCollapse;
+    setAutoCollapse(mode: AutoCollapse): void;
+    getPane(id: string): PaneHandle | undefined;
+    getPanes(): PaneHandle[];
+    /** Create from a registered type; undefined means its factory cancelled. */
+    addPane(type: string, options?: AddPaneOptions): PaneHandle | undefined;
+    insertPane(pane: Pane, groupId: string, options?: CommandOptions): void;
+    updatePane(pane: Pane): void;
+    activatePane(id: string): void;
+    movePane(paneId: string, groupId: string, position?: 'tab' | 'left' | 'right' | 'top' | 'bottom', index?: number, options?: CommandOptions): void;
+    splitGroup(groupId: string, axis: Axis, pane?: Pane | null, options?: CommandOptions & {
+        before?: boolean;
+        ratio?: number;
+    }): string;
+    removeEmptyGroup(groupId: string): void;
+    joinGroup(groupId: string, options?: CommandOptions): void;
+    joinGroups(receiverId: string, otherId: string, options?: JoinOptions): void;
+    resize(splitId: string, ratio: number, options?: CommandOptions): void;
+    resizeMany(ratios: Record<string, number>, options?: CommandOptions): void;
+    maximize(groupId: string | null): void;
+    setTabDisplay(groupId: string, display: Group['tabDisplay']): void;
+    setTabPlacement(groupId: string, placement: Group['tabPlacement']): void;
+    can(paneId: string, capability: Capability): boolean;
+    canRestoreClosedPane(): boolean;
+    restoreClosedPane(): void;
+    /** Confirm and check permissions unless force is explicitly supplied. */
+    closePane(id: string, options?: CloseOptions): Promise<boolean>;
+    closeGroup(id: string, options?: CloseOptions): Promise<boolean>;
+    /** Call during a user gesture. Resolves after destination readiness or rollback. */
+    popout(id: string, placement?: WindowPlacement): Promise<boolean>;
+    returnPane(id: string): void;
+    retryPane(id: string): void;
+    /** Idempotently cancel pending work and release views, companions, and the private model. */
+    dispose(): void;
+}
+/** A mounted workspace. Call dispose once when its application container is removed. */
+export declare class Workspace<State = unknown> implements WorkspaceHandle<State> {
+    #private;
+    constructor(options: WorkspaceOptions<State>);
+    get isDisposed(): boolean;
+    on<K extends keyof WorkspaceEvents>(event: K, listener: (event: WorkspaceEvents[K]) => void): () => void;
+    /** Stable immutable layout snapshot. */
+    getLayout: () => Layout;
+    exportLayout(): Layout;
+    loadLayout(input: unknown): void;
+    reset(): void;
+    exportWorkspace(): import("./workspace.js").WorkspacePreset;
+    loadWorkspace(input: unknown): void;
+    canExecuteAction(action: WorkspaceAction, context?: ActionContext): boolean;
+    executeAction(action: WorkspaceAction, context?: ActionContext): Promise<boolean>;
+    getShortcuts(): readonly RegisteredShortcut[];
+    updateOptions(next: WorkspaceOptionUpdates<State>): void;
+    setTheme(theme: LayoutTheme): void;
+    setTabBar(tabBar: TabBarOptions): void;
+    refreshTheme(): void;
+    getAutoCollapse(): AutoCollapse;
+    setAutoCollapse(mode: AutoCollapse): void;
+    getPane(id: string): PaneHandle | undefined;
+    getPanes(): PaneHandle[];
+    addPane(type: string, options?: AddPaneOptions): PaneHandle | undefined;
+    /** Insert a fully specified serializable record (advanced model integration). */
+    insertPane(pane: Pane, groupId: string, options?: CommandOptions): void;
+    updatePane(pane: Pane): void;
+    activatePane(id: string): void;
+    movePane(paneId: string, groupId: string, position?: 'tab' | 'left' | 'right' | 'top' | 'bottom', index?: number, options?: CommandOptions): void;
+    splitGroup(groupId: string, axis: Axis, pane?: Pane | null, options?: CommandOptions & {
+        before?: boolean;
+        ratio?: number;
+    }): string;
+    removeEmptyGroup(groupId: string): void;
+    joinGroup(groupId: string, options?: CommandOptions): void;
+    joinGroups(receiverId: string, otherId: string, options?: JoinOptions): void;
+    resize(splitId: string, ratio: number, options?: CommandOptions): void;
+    resizeMany(ratios: Record<string, number>, options?: CommandOptions): void;
+    maximize(groupId: string | null): void;
+    setTabDisplay(groupId: string, display: Group['tabDisplay']): void;
+    setTabPlacement(groupId: string, placement: Group['tabPlacement']): void;
+    can(paneId: string, capability: Capability): boolean;
+    canRestoreClosedPane(): boolean;
+    restoreClosedPane(): void;
+    closePane(id: string, options?: CloseOptions): Promise<boolean>;
+    closeGroup(id: string, options?: CloseOptions): Promise<boolean>;
+    popout(id: string, placement?: WindowPlacement): Promise<boolean>;
+    returnPane(id: string): void;
+    retryPane(id: string): void;
+    dispose(): void;
+}
+//# sourceMappingURL=workspace-api.d.ts.map

package/dist/workspace-api.d.ts.map

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

package/dist/workspace-api.js

@@ -0,0 +1,409 @@
+import { groups, findNode } from 'quilt-core';
+import { mountLayout } from './renderer.js';
+import { PaneRegistry, createPaneId } from './registry.js';
+import { dockLayout } from './workspace.js';
+/** A mounted workspace. Call dispose once when its application container is removed. */
+export class Workspace {
+    #mounted;
+    #disposed = false;
+    #handles = new Map();
+    #listeners = {
+        change: new Set(),
+        error: new Set(),
+    };
+    #cleanups = [];
+    #options;
+    #activeGroup;
+    #batch = false;
+    #initial;
+    constructor(options) {
+        if (!options?.container?.ownerDocument?.defaultView)
+            throw new Error('Workspace requires a container in a live document');
+        const { container, ...input } = options;
+        const { initialLayout: _layout, initialWorkspace: _workspace, ...updates } = input;
+        this.#options = { ...updates };
+        const adapted = this.#adapt(this.#options);
+        this.#mounted = mountLayout(container, {
+            ...input,
+            ...adapted,
+            onError: this.#report,
+        });
+        this.#initial = this.#mounted.exportWorkspace();
+        this.#cleanups.push(this.#model.subscribe((event) => {
+            if (event.action === 'load') {
+                this.#handles.clear();
+                this.#activeGroup = undefined;
+            }
+            else
+                for (const id of this.#handles.keys())
+                    if (!Object.hasOwn(event.layout.panes, id))
+                        this.#handles.delete(id);
+            if (!this.#batch)
+                this.#emit({ action: event.action, changes: ['layout'] });
+        }), this.#model.onError(this.#report));
+        const activate = (event) => {
+            const target = event.target;
+            const id = target?.closest?.('[data-node-id]')?.getAttribute('data-node-id');
+            if (id && findNode(this.getLayout().root, id)?.kind === 'group')
+                this.#activeGroup = id;
+        };
+        container.addEventListener('pointerdown', activate);
+        container.addEventListener('focusin', activate);
+        this.#cleanups.push(() => container.removeEventListener('pointerdown', activate), () => container.removeEventListener('focusin', activate));
+    }
+    get #model() {
+        return this.#mounted.store;
+    }
+    #alive() {
+        if (this.#disposed)
+            throw new Error('Workspace has been disposed');
+    }
+    #report = (error) => {
+        try {
+            this.#options.onError?.(error);
+        }
+        catch {
+            /* Reporting must not interrupt cleanup. */
+        }
+        for (const listener of [...this.#listeners.error]) {
+            if (!this.#listeners.error.has(listener))
+                continue;
+            try {
+                listener(error);
+            }
+            catch {
+                /* Isolate reporters. */
+            }
+        }
+    };
+    #emit(event) {
+        for (const listener of [...this.#listeners.change]) {
+            if (!this.#listeners.change.has(listener))
+                continue;
+            try {
+                listener(event);
+            }
+            catch (error) {
+                this.#report(error);
+            }
+        }
+    }
+    #adapt(options) {
+        const { paneTypes, ...rest } = options;
+        if (paneTypes !== undefined) {
+            if (rest.registry || rest.renderers || rest.tabs)
+                throw new Error('paneTypes cannot be combined with registry, renderers, or tabs');
+            return {
+                ...rest,
+                registry: new PaneRegistry(Object.entries(paneTypes).map(([type, { render, ...entry }]) => ({
+                    ...entry,
+                    type,
+                    view: render,
+                }))),
+            };
+        }
+        return { ...rest, registry: rest.registry };
+    }
+    get isDisposed() {
+        return this.#disposed;
+    }
+    on(event, listener) {
+        this.#alive();
+        const listeners = this.#listeners[event];
+        listeners.add(listener);
+        return () => {
+            listeners.delete(listener);
+        };
+    }
+    /** Stable immutable layout snapshot. */
+    getLayout = () => {
+        this.#alive();
+        return this.#model.getSnapshot();
+    };
+    exportLayout() {
+        this.#alive();
+        return this.#model.export();
+    }
+    loadLayout(input) {
+        this.#alive();
+        this.#model.load(dockLayout(input));
+    }
+    reset() {
+        this.loadWorkspace(this.#initial);
+    }
+    exportWorkspace() {
+        this.#alive();
+        return this.#mounted.exportWorkspace();
+    }
+    loadWorkspace(input) {
+        this.#alive();
+        this.#batch = true;
+        try {
+            this.#mounted.loadWorkspace(input);
+        }
+        finally {
+            this.#batch = false;
+        }
+        this.#emit({ action: 'loadWorkspace', changes: ['layout', 'theme', 'tabBar', 'autoCollapse'] });
+    }
+    canExecuteAction(action, context) {
+        return !this.#disposed && this.#mounted.canExecuteAction(action, context);
+    }
+    executeAction(action, context) {
+        return this.#disposed ? Promise.resolve(false) : this.#mounted.executeAction(action, context);
+    }
+    getShortcuts() {
+        return this.#mounted.getShortcuts();
+    }
+    updateOptions(next) {
+        this.#alive();
+        if ('container' in next)
+            throw new Error('Workspace container cannot be updated');
+        const candidate = { ...this.#options, ...next };
+        const adapted = this.#adapt(candidate);
+        const changes = [];
+        const before = this.exportWorkspace();
+        const beforeShortcuts = JSON.stringify(this.getShortcuts());
+        const beforeFormatter = this.#options.formatShortcut;
+        // Initial appearance is mount-only: only explicitly updated appearance keys apply.
+        if (!('theme' in next))
+            delete adapted.theme;
+        if (!('tabBar' in next))
+            delete adapted.tabBar;
+        this.#mounted.updateOptions({ ...adapted, onError: this.#report });
+        this.#options = candidate;
+        const after = this.exportWorkspace();
+        if (JSON.stringify(before.theme) !== JSON.stringify(after.theme))
+            changes.push('theme');
+        if (JSON.stringify(before.tabBar) !== JSON.stringify(after.tabBar))
+            changes.push('tabBar');
+        if (beforeShortcuts !== JSON.stringify(this.getShortcuts()) ||
+            beforeFormatter !== candidate.formatShortcut)
+            changes.push('shortcuts');
+        if (changes.length)
+            this.#emit({ action: 'updateOptions', changes });
+    }
+    setTheme(theme) {
+        this.updateOptions({ theme });
+    }
+    setTabBar(tabBar) {
+        this.updateOptions({ tabBar });
+    }
+    refreshTheme() {
+        this.#alive();
+        this.#mounted.refreshTheme();
+    }
+    getAutoCollapse() {
+        this.#alive();
+        return this.#model.getAutoCollapse();
+    }
+    setAutoCollapse(mode) {
+        this.#alive();
+        const previous = this.#model.getAutoCollapse();
+        this.#model.setAutoCollapse(mode);
+        if (mode !== previous)
+            this.#emit({ action: 'setAutoCollapse', changes: ['autoCollapse'] });
+    }
+    getPane(id) {
+        this.#alive();
+        if (!Object.hasOwn(this.getLayout().panes, id))
+            return undefined;
+        let handle = this.#handles.get(id);
+        if (handle)
+            return handle;
+        const workspace = this;
+        const alive = () => {
+            workspace.#alive();
+            if (workspace.#handles.get(id) !== handle)
+                throw new Error(`Pane ${id} has been disposed`);
+        };
+        handle = {
+            id,
+            get isDisposed() {
+                return workspace.#disposed || workspace.#handles.get(id) !== handle;
+            },
+            getSnapshot() {
+                alive();
+                return workspace.getLayout().panes[id];
+            },
+            update(patch) {
+                alive();
+                workspace.updatePane({ ...workspace.getLayout().panes[id], ...patch, id });
+            },
+            setTitle(title) {
+                this.update({ title });
+            },
+            activate() {
+                alive();
+                workspace.activatePane(id);
+            },
+            move(groupId, position, index) {
+                alive();
+                workspace.movePane(id, groupId, position, index);
+            },
+            async popout(placement) {
+                alive();
+                return workspace.popout(id, placement);
+            },
+            return() {
+                alive();
+                workspace.returnPane(id);
+            },
+            retry() {
+                alive();
+                workspace.retryPane(id);
+            },
+            async close(options) {
+                alive();
+                return workspace.closePane(id, options);
+            },
+        };
+        Object.freeze(handle);
+        this.#handles.set(id, handle);
+        return handle;
+    }
+    getPanes() {
+        return Object.keys(this.getLayout().panes).map((id) => this.getPane(id));
+    }
+    addPane(type, options = {}) {
+        this.#alive();
+        const layout = this.getLayout();
+        const all = groups(layout.root);
+        const groupId = options.groupId ?? all.find((group) => group.id === this.#activeGroup)?.id ?? all[0].id;
+        const group = all.find((group) => group.id === groupId);
+        if (!group)
+            throw new Error(`Group not found: ${groupId}`);
+        const registry = this.#adapt(this.#options).registry;
+        const entry = registry?.list().find((entry) => entry.type === type);
+        if (!entry)
+            throw new Error(`Pane type is not registered: ${type}`);
+        const supplied = entry.create
+            ? entry.create({ groupId, source: group.active ? layout.panes[group.active] : undefined })
+            : {};
+        if (supplied === undefined)
+            return undefined;
+        const { groupId: _groupId, ...patch } = options;
+        const pane = {
+            title: entry.title,
+            ...(entry.icon === undefined ? {} : { icon: entry.icon }),
+            ...supplied,
+            ...patch,
+            type,
+            id: patch.id ?? supplied.id ?? createPaneId(),
+        };
+        this.insertPane(pane, groupId);
+        return this.getPane(pane.id);
+    }
+    /** Insert a fully specified serializable record (advanced model integration). */
+    insertPane(pane, groupId, options = {}) {
+        this.#alive();
+        this.#model.add(pane, groupId, options);
+    }
+    updatePane(pane) {
+        this.#alive();
+        this.#model.updatePane(pane);
+    }
+    activatePane(id) {
+        const group = groups(this.getLayout().root).find((group) => group.panes.includes(id));
+        if (!group)
+            throw new Error(`Pane is not docked: ${id}`);
+        this.#activeGroup = group.id;
+        this.#model.activate(group.id, id);
+    }
+    movePane(paneId, groupId, position = 'tab', index, options = {}) {
+        this.#alive();
+        this.#model.move(paneId, groupId, position, index, options);
+    }
+    splitGroup(groupId, axis, pane = null, options = {}) {
+        this.#alive();
+        return this.#model.split(groupId, axis, pane, options);
+    }
+    removeEmptyGroup(groupId) {
+        this.#alive();
+        this.#model.removeEmptyGroup(groupId);
+    }
+    joinGroup(groupId, options = {}) {
+        this.#alive();
+        this.#model.join(groupId, options);
+    }
+    joinGroups(receiverId, otherId, options = {}) {
+        this.#alive();
+        this.#model.joinRegions(receiverId, otherId, options);
+    }
+    resize(splitId, ratio, options = {}) {
+        this.#alive();
+        this.#model.resize(splitId, ratio, options);
+    }
+    resizeMany(ratios, options = {}) {
+        this.#alive();
+        this.#model.resizeMany(ratios, options);
+    }
+    maximize(groupId) {
+        this.#alive();
+        this.#model.maximize(groupId);
+    }
+    setTabDisplay(groupId, display) {
+        this.#alive();
+        this.#model.setTabDisplay(groupId, display);
+    }
+    setTabPlacement(groupId, placement) {
+        this.#alive();
+        this.#model.setTabPlacement(groupId, placement);
+    }
+    can(paneId, capability) {
+        this.#alive();
+        return this.#model.can(paneId, capability);
+    }
+    canRestoreClosedPane() {
+        this.#alive();
+        return this.#model.canRestoreClosedTab();
+    }
+    restoreClosedPane() {
+        this.#alive();
+        this.#model.restoreClosedTab();
+    }
+    async closePane(id, options = {}) {
+        this.#alive();
+        if (options.force) {
+            this.#model.close(id);
+            return true;
+        }
+        return this.#mounted.requestClose(id);
+    }
+    async closeGroup(id, options = {}) {
+        this.#alive();
+        if (options.force) {
+            this.#model.closeGroup(id);
+            return true;
+        }
+        return this.#mounted.requestClose(id, 'group');
+    }
+    async popout(id, placement) {
+        this.#alive();
+        return this.#mounted.popout(id, placement);
+    }
+    returnPane(id) {
+        this.#alive();
+        this.#mounted.returnPane(id);
+    }
+    retryPane(id) {
+        this.#alive();
+        this.#mounted.retryPane(id);
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#handles.clear();
+        for (const cleanup of this.#cleanups.splice(0))
+            cleanup();
+        try {
+            this.#mounted.dispose();
+        }
+        finally {
+            this.#listeners.change.clear();
+            this.#listeners.error.clear();
+        }
+    }
+}
+//# sourceMappingURL=workspace-api.js.map