@fieldia/designer 0.0.0-stage → 0.11.0

package/src/lib/app-kinds-ui.d.ts

@@ -0,0 +1,25 @@
+import type { FieldNode, Page } from '@fieldia/core';
+import type { AppKind } from './app-kinds';
+import type { ElementFactory } from './chrome';
+import type { Designer } from './designer';
+/**
+ * Where an app's kind shows in the editors beyond its tile: its own settings
+ * on the picked field and on the panel's Content tab, and how its closed
+ * card reads. The app draws them; these put them in place and keep them up
+ * to date.
+ */
+/** The app's kind a field was made as, or null for one of Fieldia's or none. */
+export declare function appKindOf(kind: string | null): AppKind | null;
+/** The app's settings among the picked field's own, for `kind-settings`: none for one of Fieldia's kinds, or one with no settings. */
+export declare function appKindSettings(el: ElementFactory, designer: Designer, id: string, kind: string | null): {
+    element: HTMLElement;
+    standsIn: false;
+    refresh(page: Page, node: FieldNode): void;
+} | null;
+/** A row of the panel's Content tab with the app's settings, named after its kind; hidden for a field of another kind, or of the model. */
+export declare function appKindPanel(el: ElementFactory, designer: Designer, id: string): {
+    element: HTMLElement;
+    update(page: Page, node: FieldNode): void;
+};
+/** How a closed card of an app's kind reads: its words on a dotted line, or its own drawing; null for its real widget. */
+export declare function appKindPreview(el: ElementFactory, page: Page, node: FieldNode, kind: string | null): HTMLElement | null;

package/src/lib/app-kinds-ui.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.appKindOf = appKindOf;
+exports.appKindSettings = appKindSettings;
+exports.appKindPanel = appKindPanel;
+exports.appKindPreview = appKindPreview;
+const kinds_1 = require("./kinds");
+/**
+ * Where an app's kind shows in the editors beyond its tile: its own settings
+ * on the picked field and on the panel's Content tab, and how its closed
+ * card reads. The app draws them; these put them in place and keep them up
+ * to date.
+ */
+/** The app's kind a field was made as, or null for one of Fieldia's or none. */
+function appKindOf(kind) {
+    if (!kind)
+        return null;
+    try {
+        return (0, kinds_1.kindById)(kind).app ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The app's settings for the field `id`, drawn by the app, saving through the designer. */
+function drawSettings(el, designer, id, app) {
+    if (!app.settings)
+        return null;
+    const document = el('span').ownerDocument;
+    return app.settings({ document, id, designer, set: (patch) => designer.setWidgetOptions(id, patch) });
+}
+/** The app's settings among the picked field's own, for `kind-settings`: none for one of Fieldia's kinds, or one with no settings. */
+function appKindSettings(el, designer, id, kind) {
+    const app = appKindOf(kind);
+    const own = app ? drawSettings(el, designer, id, app) : null;
+    if (!app || !own)
+        return null;
+    return { element: el('div', { class: 'fd-app-settings', 'data-kind': app.id }, own.element), standsIn: false, refresh: (page, node) => own.refresh(page, node) };
+}
+/** A row of the panel's Content tab with the app's settings, named after its kind; hidden for a field of another kind, or of the model. */
+function appKindPanel(el, designer, id) {
+    const name = el('span', { class: 'fd-prop-name' });
+    const box = el('div', { class: 'fd-app-settings' });
+    const element = el('div', { class: 'fd-prop fd-set', 'data-tab': 'content', 'data-setting': 'Settings', hidden: '' }, name, box);
+    let drawn = null;
+    let own = null;
+    return {
+        element,
+        update(page, node) {
+            const app = designer.isFromModel(id) ? null : appKindOf((0, kinds_1.kindOfField)(page.fields[node.field], node));
+            const key = app?.settings ? app.id : '';
+            if (key !== drawn) {
+                drawn = key;
+                own = app ? drawSettings(el, designer, id, app) : null;
+                box.replaceChildren(...(own ? [own.element] : []));
+                name.textContent = app?.label ?? '';
+                element.dataset['setting'] = app && own ? `${app.label} settings` : 'Settings';
+            }
+            element.hidden = !own;
+            own?.refresh(page, node);
+        },
+    };
+}
+/** How a closed card of an app's kind reads: its words on a dotted line, or its own drawing; null for its real widget. */
+function appKindPreview(el, page, node, kind) {
+    const preview = appKindOf(kind)?.preview;
+    if (typeof preview === 'string')
+        return el('div', { class: 'fd-q-preview fd-q-preview-short' }, preview);
+    if (typeof preview === 'function')
+        return preview({ document: el('span').ownerDocument, page, node });
+    return null;
+}
+//# sourceMappingURL=app-kinds-ui.js.map

package/src/lib/app-kinds-ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-kinds-ui.js","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/app-kinds-ui.ts"],"names":[],"mappings":"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"}

package/src/lib/app-kinds-ui.mjs

@@ -0,0 +1,67 @@
+import { kindById, kindOfField } from './kinds.mjs';
+/**
+ * Where an app's kind shows in the editors beyond its tile: its own settings
+ * on the picked field and on the panel's Content tab, and how its closed
+ * card reads. The app draws them; these put them in place and keep them up
+ * to date.
+ */
+/** The app's kind a field was made as, or null for one of Fieldia's or none. */
+export function appKindOf(kind) {
+    if (!kind)
+        return null;
+    try {
+        return kindById(kind).app ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The app's settings for the field `id`, drawn by the app, saving through the designer. */
+function drawSettings(el, designer, id, app) {
+    if (!app.settings)
+        return null;
+    const document = el('span').ownerDocument;
+    return app.settings({ document, id, designer, set: (patch) => designer.setWidgetOptions(id, patch) });
+}
+/** The app's settings among the picked field's own, for `kind-settings`: none for one of Fieldia's kinds, or one with no settings. */
+export function appKindSettings(el, designer, id, kind) {
+    const app = appKindOf(kind);
+    const own = app ? drawSettings(el, designer, id, app) : null;
+    if (!app || !own)
+        return null;
+    return { element: el('div', { class: 'fd-app-settings', 'data-kind': app.id }, own.element), standsIn: false, refresh: (page, node) => own.refresh(page, node) };
+}
+/** A row of the panel's Content tab with the app's settings, named after its kind; hidden for a field of another kind, or of the model. */
+export function appKindPanel(el, designer, id) {
+    const name = el('span', { class: 'fd-prop-name' });
+    const box = el('div', { class: 'fd-app-settings' });
+    const element = el('div', { class: 'fd-prop fd-set', 'data-tab': 'content', 'data-setting': 'Settings', hidden: '' }, name, box);
+    let drawn = null;
+    let own = null;
+    return {
+        element,
+        update(page, node) {
+            const app = designer.isFromModel(id) ? null : appKindOf(kindOfField(page.fields[node.field], node));
+            const key = app?.settings ? app.id : '';
+            if (key !== drawn) {
+                drawn = key;
+                own = app ? drawSettings(el, designer, id, app) : null;
+                box.replaceChildren(...(own ? [own.element] : []));
+                name.textContent = app?.label ?? '';
+                element.dataset['setting'] = app && own ? `${app.label} settings` : 'Settings';
+            }
+            element.hidden = !own;
+            own?.refresh(page, node);
+        },
+    };
+}
+/** How a closed card of an app's kind reads: its words on a dotted line, or its own drawing; null for its real widget. */
+export function appKindPreview(el, page, node, kind) {
+    const preview = appKindOf(kind)?.preview;
+    if (typeof preview === 'string')
+        return el('div', { class: 'fd-q-preview fd-q-preview-short' }, preview);
+    if (typeof preview === 'function')
+        return preview({ document: el('span').ownerDocument, page, node });
+    return null;
+}
+//# sourceMappingURL=app-kinds-ui.mjs.map

package/src/lib/app-kinds-ui.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-kinds-ui.mjs","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/app-kinds-ui.ts"],"names":[],"mappings":"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"}

package/src/lib/app-kinds.d.mts

@@ -0,0 +1,67 @@
+import type { Field, FieldNode, Page } from '@fieldia/core';
+import type { Designer } from './designer.mjs';
+/**
+ * Kinds of field an app adds to the designer's own — an IBAN, a product
+ * code, a member number. Each is what a built-in kind is: the field a new
+ * one starts as and the widget that draws it, with an icon for the toolbox,
+ * settings of its own on the picked field, and how a closed card reads. A
+ * field made as one is known again by its widget, so an app's kind must be
+ * told apart from Fieldia's and from the app's others: these checks refuse
+ * one that could not be, saying why.
+ */
+export interface AppKind {
+    /** Its own id: never one of Fieldia's kinds. */
+    id: string;
+    label: string;
+    /** The field a new one starts as. */
+    field(label: string): Field;
+    /** Its picture in the toolbox and the menus: SVG markup on a 24-unit grid, drawn in the text's colour, such as `<path d="…"/>`. */
+    icon?: string;
+    /** The toolbox group it is listed under: "Your kinds" unless it says. A group the toolbox has already takes it at its end. */
+    group?: string;
+    /** The widget that draws it, given to the editors and the viewer in `widgets` under `type.widget`. Its id when it says none. */
+    widget?: string;
+    /** Whether it can show a field that already holds data, such as one of the model's. Unless it says, a field of the type its own field has. */
+    fits?(field: Field): boolean;
+    /** Settings of its own: on the picked field, and on the Content tab of the screen editor's panel. */
+    settings?(context: AppKindContext): AppKindSettings;
+    /** How a closed survey card reads before anyone answers: words on a dotted line, or a drawing. Its real widget when it says none. */
+    preview?: string | ((context: AppKindPreviewContext) => HTMLElement | null);
+}
+/** What an app's kind's settings are given. */
+export interface AppKindContext {
+    document: Document;
+    /** The picked field's id on the page. */
+    id: string;
+    designer: Designer;
+    /** Keep settings on the field's place on the page, where its widget reads them (`node.options`); `null` or empty takes one away. A run of typing in one is one undo step. */
+    set(patch: Record<string, string | number | boolean | null>): boolean;
+}
+/** An app's kind's settings, drawn once and kept up to date. */
+export interface AppKindSettings {
+    element: HTMLElement;
+    /** Show the field as it is now: called after every edit. */
+    refresh(page: Page, node: FieldNode): void;
+}
+/** What draws a closed card of an app's kind. */
+export interface AppKindPreviewContext {
+    document: Document;
+    page: Page;
+    node: FieldNode;
+}
+/** The group an app's kind is listed under when it names none. */
+export declare const APP_GROUP = "Your kinds";
+/** The widget an app's kind is drawn by: the one it names, or its id. */
+export declare const widgetOf: (kind: AppKind) => string;
+/** A kind already known, as these checks need it: its id, its label and the widget that draws it. */
+export interface KnownKind {
+    id: string;
+    label: string;
+    widget?: string;
+}
+/**
+ * Check an app's kinds against Fieldia's (`builtIn`) and the app's kinds
+ * registered before (`others`, which these replace when they share an id).
+ * Throws, saying why, for one that cannot be told apart.
+ */
+export declare function checkAppKinds(kinds: readonly AppKind[], builtIn: readonly KnownKind[], others?: readonly KnownKind[]): void;

package/src/lib/app-kinds.d.ts

@@ -0,0 +1,67 @@
+import type { Field, FieldNode, Page } from '@fieldia/core';
+import type { Designer } from './designer';
+/**
+ * Kinds of field an app adds to the designer's own — an IBAN, a product
+ * code, a member number. Each is what a built-in kind is: the field a new
+ * one starts as and the widget that draws it, with an icon for the toolbox,
+ * settings of its own on the picked field, and how a closed card reads. A
+ * field made as one is known again by its widget, so an app's kind must be
+ * told apart from Fieldia's and from the app's others: these checks refuse
+ * one that could not be, saying why.
+ */
+export interface AppKind {
+    /** Its own id: never one of Fieldia's kinds. */
+    id: string;
+    label: string;
+    /** The field a new one starts as. */
+    field(label: string): Field;
+    /** Its picture in the toolbox and the menus: SVG markup on a 24-unit grid, drawn in the text's colour, such as `<path d="…"/>`. */
+    icon?: string;
+    /** The toolbox group it is listed under: "Your kinds" unless it says. A group the toolbox has already takes it at its end. */
+    group?: string;
+    /** The widget that draws it, given to the editors and the viewer in `widgets` under `type.widget`. Its id when it says none. */
+    widget?: string;
+    /** Whether it can show a field that already holds data, such as one of the model's. Unless it says, a field of the type its own field has. */
+    fits?(field: Field): boolean;
+    /** Settings of its own: on the picked field, and on the Content tab of the screen editor's panel. */
+    settings?(context: AppKindContext): AppKindSettings;
+    /** How a closed survey card reads before anyone answers: words on a dotted line, or a drawing. Its real widget when it says none. */
+    preview?: string | ((context: AppKindPreviewContext) => HTMLElement | null);
+}
+/** What an app's kind's settings are given. */
+export interface AppKindContext {
+    document: Document;
+    /** The picked field's id on the page. */
+    id: string;
+    designer: Designer;
+    /** Keep settings on the field's place on the page, where its widget reads them (`node.options`); `null` or empty takes one away. A run of typing in one is one undo step. */
+    set(patch: Record<string, string | number | boolean | null>): boolean;
+}
+/** An app's kind's settings, drawn once and kept up to date. */
+export interface AppKindSettings {
+    element: HTMLElement;
+    /** Show the field as it is now: called after every edit. */
+    refresh(page: Page, node: FieldNode): void;
+}
+/** What draws a closed card of an app's kind. */
+export interface AppKindPreviewContext {
+    document: Document;
+    page: Page;
+    node: FieldNode;
+}
+/** The group an app's kind is listed under when it names none. */
+export declare const APP_GROUP = "Your kinds";
+/** The widget an app's kind is drawn by: the one it names, or its id. */
+export declare const widgetOf: (kind: AppKind) => string;
+/** A kind already known, as these checks need it: its id, its label and the widget that draws it. */
+export interface KnownKind {
+    id: string;
+    label: string;
+    widget?: string;
+}
+/**
+ * Check an app's kinds against Fieldia's (`builtIn`) and the app's kinds
+ * registered before (`others`, which these replace when they share an id).
+ * Throws, saying why, for one that cannot be told apart.
+ */
+export declare function checkAppKinds(kinds: readonly AppKind[], builtIn: readonly KnownKind[], others?: readonly KnownKind[]): void;

package/src/lib/app-kinds.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.widgetOf = exports.APP_GROUP = void 0;
+exports.checkAppKinds = checkAppKinds;
+/** The group an app's kind is listed under when it names none. */
+exports.APP_GROUP = 'Your kinds';
+/** The widget an app's kind is drawn by: the one it names, or its id. */
+const widgetOf = (kind) => kind.widget?.trim() || kind.id;
+exports.widgetOf = widgetOf;
+/**
+ * Check an app's kinds against Fieldia's (`builtIn`) and the app's kinds
+ * registered before (`others`, which these replace when they share an id).
+ * Throws, saying why, for one that cannot be told apart.
+ */
+function checkAppKinds(kinds, builtIn, others = []) {
+    const ids = new Set();
+    for (const kind of kinds) {
+        if (!kind || typeof kind.id !== 'string' || !kind.id.trim() || typeof kind.label !== 'string' || !kind.label.trim() || typeof kind.field !== 'function') {
+            throw new Error('An app’s kind needs an id, a label and a field');
+        }
+        if (builtIn.some((k) => k.id === kind.id))
+            throw new Error(`The kind “${kind.id}” is one of Fieldia’s own: give the app’s kind an id of its own`);
+        if (ids.has(kind.id))
+            throw new Error(`Two of the app’s kinds have the id “${kind.id}”`);
+        ids.add(kind.id);
+        const widget = (0, exports.widgetOf)(kind);
+        const fieldia = builtIn.find((k) => k.widget === widget);
+        if (fieldia)
+            throw new Error(`The kind “${kind.id}” is drawn by “${widget}”, as Fieldia’s ${fieldia.label} is: give it a widget of its own`);
+    }
+    // Two drawn by one widget would be read back as the same kind.
+    const drawn = [...others.filter((k) => !ids.has(k.id)), ...kinds.map((k) => ({ id: k.id, label: k.label, widget: (0, exports.widgetOf)(k) }))];
+    drawn.forEach((kind, i) => {
+        const twin = drawn.slice(0, i).find((k) => k.widget === kind.widget);
+        if (twin)
+            throw new Error(`“${twin.id}” and “${kind.id}” are both drawn by the widget “${kind.widget}”: give each a widget of its own`);
+    });
+}
+//# sourceMappingURL=app-kinds.js.map

package/src/lib/app-kinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-kinds.js","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/app-kinds.ts"],"names":[],"mappings":";;;AA2EA,sCAmBC;AArCD,kEAAkE;AACrD,QAAA,SAAS,GAAG,YAAY,CAAC;AAEtC,yEAAyE;AAClE,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;AAArE,QAAA,QAAQ,YAA6D;AASlF;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAyB,EAAE,OAA6B,EAAE,SAA+B,EAAE;IACvH,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACxJ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,EAAE,iEAAiE,CAAC,CAAC;QAClJ,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACzF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,MAAM,MAAM,GAAG,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,EAAE,kBAAkB,MAAM,mBAAmB,OAAO,CAAC,KAAK,kCAAkC,CAAC,CAAC;IAC/I,CAAC;IACD,+DAA+D;IAC/D,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,IAAA,gBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClI,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,EAAE,mCAAmC,IAAI,CAAC,MAAM,kCAAkC,CAAC,CAAC;IAC1I,CAAC,CAAC,CAAC;AACL,CAAC"}

package/src/lib/app-kinds.mjs

@@ -0,0 +1,34 @@
+/** The group an app's kind is listed under when it names none. */
+export const APP_GROUP = 'Your kinds';
+/** The widget an app's kind is drawn by: the one it names, or its id. */
+export const widgetOf = (kind) => kind.widget?.trim() || kind.id;
+/**
+ * Check an app's kinds against Fieldia's (`builtIn`) and the app's kinds
+ * registered before (`others`, which these replace when they share an id).
+ * Throws, saying why, for one that cannot be told apart.
+ */
+export function checkAppKinds(kinds, builtIn, others = []) {
+    const ids = new Set();
+    for (const kind of kinds) {
+        if (!kind || typeof kind.id !== 'string' || !kind.id.trim() || typeof kind.label !== 'string' || !kind.label.trim() || typeof kind.field !== 'function') {
+            throw new Error('An app’s kind needs an id, a label and a field');
+        }
+        if (builtIn.some((k) => k.id === kind.id))
+            throw new Error(`The kind “${kind.id}” is one of Fieldia’s own: give the app’s kind an id of its own`);
+        if (ids.has(kind.id))
+            throw new Error(`Two of the app’s kinds have the id “${kind.id}”`);
+        ids.add(kind.id);
+        const widget = widgetOf(kind);
+        const fieldia = builtIn.find((k) => k.widget === widget);
+        if (fieldia)
+            throw new Error(`The kind “${kind.id}” is drawn by “${widget}”, as Fieldia’s ${fieldia.label} is: give it a widget of its own`);
+    }
+    // Two drawn by one widget would be read back as the same kind.
+    const drawn = [...others.filter((k) => !ids.has(k.id)), ...kinds.map((k) => ({ id: k.id, label: k.label, widget: widgetOf(k) }))];
+    drawn.forEach((kind, i) => {
+        const twin = drawn.slice(0, i).find((k) => k.widget === kind.widget);
+        if (twin)
+            throw new Error(`“${twin.id}” and “${kind.id}” are both drawn by the widget “${kind.widget}”: give each a widget of its own`);
+    });
+}
+//# sourceMappingURL=app-kinds.mjs.map

package/src/lib/app-kinds.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-kinds.mjs","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/app-kinds.ts"],"names":[],"mappings":"AAyDA,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;AAEtC,yEAAyE;AACzE,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAa,EAAU,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;AASlF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB,EAAE,OAA6B,EAAE,SAA+B,EAAE;IACvH,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YACxJ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,EAAE,iEAAiE,CAAC,CAAC;QAClJ,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACzF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QACzD,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,EAAE,kBAAkB,MAAM,mBAAmB,OAAO,CAAC,KAAK,kCAAkC,CAAC,CAAC;IAC/I,CAAC;IACD,+DAA+D;IAC/D,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAClI,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,IAAI,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,UAAU,IAAI,CAAC,EAAE,mCAAmC,IAAI,CAAC,MAAM,kCAAkC,CAAC,CAAC;IAC1I,CAAC,CAAC,CAAC;AACL,CAAC"}

package/src/lib/assistant-box.d.mts

@@ -0,0 +1,34 @@
+import { type DesignerAssistant } from './assistant.mjs';
+import type { ElementFactory } from './chrome.mjs';
+import type { Designer } from './designer.mjs';
+/**
+ * The box a person describes a form in for the app's assistant: the words,
+ * the assistant's name and what it is, and Build it (or Ask). Asked, it is
+ * busy — the words held, Cancel in place of the button, the wait said aloud;
+ * answered, the form goes in place and `onApplied` says what changed. What
+ * went wrong is said under it, the words kept to try again. Ctrl or ⌘ with
+ * Enter asks too; Enter alone starts a new line.
+ */
+export interface AssistantBoxOptions {
+    el: ElementFactory;
+    designer: Designer;
+    assistant: DesignerAssistant;
+    /** What the box asks for: "Describe the form you need", or what should change. */
+    label: string;
+    placeholder: string;
+    /** The button's words, and what is said while it waits. */
+    ask: string;
+    busy: string;
+    /** Its form is in place: these are the changes, and whether the page was blank before. */
+    onApplied(changes: string[], wasBlank: boolean): void;
+    /** It stopped waiting, whatever the answer. */
+    onSettled?(): void;
+}
+export interface AssistantBox {
+    element: HTMLElement;
+    readonly busy: boolean;
+    focus(): void;
+    /** Stop waiting: the assistant is told, and its answer let go. */
+    cancel(): void;
+}
+export declare function assistantBox(options: AssistantBoxOptions): AssistantBox;

package/src/lib/assistant-box.d.ts

@@ -0,0 +1,34 @@
+import { type DesignerAssistant } from './assistant';
+import type { ElementFactory } from './chrome';
+import type { Designer } from './designer';
+/**
+ * The box a person describes a form in for the app's assistant: the words,
+ * the assistant's name and what it is, and Build it (or Ask). Asked, it is
+ * busy — the words held, Cancel in place of the button, the wait said aloud;
+ * answered, the form goes in place and `onApplied` says what changed. What
+ * went wrong is said under it, the words kept to try again. Ctrl or ⌘ with
+ * Enter asks too; Enter alone starts a new line.
+ */
+export interface AssistantBoxOptions {
+    el: ElementFactory;
+    designer: Designer;
+    assistant: DesignerAssistant;
+    /** What the box asks for: "Describe the form you need", or what should change. */
+    label: string;
+    placeholder: string;
+    /** The button's words, and what is said while it waits. */
+    ask: string;
+    busy: string;
+    /** Its form is in place: these are the changes, and whether the page was blank before. */
+    onApplied(changes: string[], wasBlank: boolean): void;
+    /** It stopped waiting, whatever the answer. */
+    onSettled?(): void;
+}
+export interface AssistantBox {
+    element: HTMLElement;
+    readonly busy: boolean;
+    focus(): void;
+    /** Stop waiting: the assistant is told, and its answer let go. */
+    cancel(): void;
+}
+export declare function assistantBox(options: AssistantBoxOptions): AssistantBox;

package/src/lib/assistant-box.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assistantBox = assistantBox;
+const assistant_1 = require("./assistant");
+const templates_1 = require("./templates");
+let made = 0;
+function assistantBox(options) {
+    const { el, designer, assistant } = options;
+    const w = designer.words.assistant;
+    const id = `fd-assist-${++made}`;
+    const area = el('textarea', { id, class: 'fd-input fd-assist-prompt', rows: '3', placeholder: options.placeholder, spellcheck: 'true' });
+    const label = el('label', { class: 'fd-assist-label', for: id }, options.label);
+    const name = assistant.name ? el('span', { class: 'fd-assist-name' }, assistant.name) : null;
+    const note = assistant.note ? el('p', { class: 'fd-assist-note', id: `${id}-note` }, el('bdi', {}, assistant.note)) : null;
+    if (note)
+        area.setAttribute('aria-describedby', note.id);
+    const submit = el('button', { type: 'submit', class: 'fd-button fd-button-primary fd-assist-ask' }, options.ask);
+    const cancelButton = el('button', { type: 'button', class: 'fd-button fd-assist-cancel', hidden: '' }, w.cancel);
+    const waiting = el('span', { class: 'fd-assist-busy', role: 'status', hidden: '' }, el('span', { class: 'fd-assist-spinner', 'aria-hidden': 'true' }), options.busy);
+    const said = el('p', { class: 'fd-assist-said', role: 'status' });
+    const problem = el('p', { class: 'fd-assist-problem', role: 'alert', hidden: '' });
+    const element = el('form', { class: 'fd-assist', 'aria-busy': 'false', novalidate: '' }, el('div', { class: 'fd-assist-head' }, label, ...(name ? [name] : [])), area, ...(note ? [note] : []), el('div', { class: 'fd-assist-actions' }, submit, waiting, cancelButton, said), problem);
+    let run = null;
+    function setBusy(busy) {
+        element.setAttribute('aria-busy', String(busy));
+        area.readOnly = busy;
+        submit.hidden = busy;
+        waiting.hidden = !busy;
+        cancelButton.hidden = !busy;
+    }
+    /** Said under the box, each in its own direction: the assistant's words may be English on a page right to left. */
+    function tell(words, wrong) {
+        problem.replaceChildren(...(wrong ? [el('bdi', {}, words)] : []));
+        problem.hidden = !wrong;
+        said.replaceChildren(...(!wrong && words ? [el('bdi', {}, words)] : []));
+    }
+    async function ask() {
+        if (run)
+            return;
+        tell('', false);
+        if (!area.value.trim()) {
+            tell(w.askForWords, true);
+            area.focus();
+            return;
+        }
+        const wasBlank = (0, templates_1.isBlank)(designer.getPage());
+        // Asked from in here: the button pressed is hidden while it waits, so the cursor waits on Cancel.
+        const here = element.contains(element.ownerDocument.activeElement);
+        const current = (0, assistant_1.askAssistant)(designer, assistant, area.value);
+        run = current;
+        setBusy(true);
+        if (here)
+            cancelButton.focus();
+        const result = await current.done;
+        if (run !== current)
+            return;
+        run = null;
+        setBusy(false);
+        options.onSettled?.();
+        if (result.status === 'applied') {
+            options.onApplied(result.changes, wasBlank);
+            return;
+        }
+        if (result.status === 'unchanged')
+            tell(w.leftAsItWas, false);
+        else if (result.status !== 'cancelled')
+            tell(result.problem, true);
+        area.focus();
+    }
+    element.addEventListener('submit', (event) => {
+        event.preventDefault();
+        void ask();
+    });
+    area.addEventListener('keydown', (event) => {
+        if (event.key === 'Enter' && (event.ctrlKey || event.metaKey)) {
+            event.preventDefault();
+            void ask();
+        }
+    });
+    /** Stopped at once: the assistant is told, and the box is back to the words. */
+    function cancel() {
+        const current = run;
+        if (!current)
+            return;
+        run = null;
+        current.cancel();
+        setBusy(false);
+        options.onSettled?.();
+        tell(w.cancelled, false);
+        area.focus();
+    }
+    cancelButton.addEventListener('click', cancel);
+    element.addEventListener('keydown', (event) => {
+        // Escape stops the wait; with nothing to wait for, it is the place's own, a dialog's to close.
+        if (event.key === 'Escape' && run) {
+            event.preventDefault();
+            cancel();
+        }
+    });
+    return {
+        element,
+        get busy() {
+            return run !== null;
+        },
+        focus: () => area.focus(),
+        cancel,
+    };
+}
+//# sourceMappingURL=assistant-box.js.map

package/src/lib/assistant-box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-box.js","sourceRoot":"","sources":["../../../../../libs/designer/src/lib/assistant-box.ts"],"names":[],"mappings":"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"}