wizards 0.5.12 → 0.6.0

package/node_modules/@engenty-wizards/shared/dist/surface.js

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: FSL-1.1-MIT OR MIT
 import { z } from "zod";
+import { shapeAt } from "./shape.js";
 /**
  * Surfaces: views composed from a small catalog of native components, bound to a run's data and
  * rendered by the runner itself — themed, on phones, no iframe and nothing to pay per run. A
@@ -9,8 +10,10 @@ import { z } from "zod";
  *
  * A surface is a flat list of components with ids; the one with id "root" is drawn, containers
  * name their children by id. A prop may be a literal or `{ "path": "/json/pointer" }` into the
- * surface's data. A `List` or `Table` repeats over an array: inside a repeated row, a path
- * without a leading slash reads the row ("name"), one with a slash the whole data.
+ * surface's data. A `List`, `Table` or `Group` repeats over an array: inside a repeated row, a
+ * path without a leading slash reads the row ("name"), one with a slash the whole data. A path
+ * may turn what it reads into words: `map` looks the value up (`{ "true": "im Kühlschrank" }`),
+ * `format` sets it into a text ("{} Min").
  */
 export const SURFACE_COMPONENTS = [
     "Column",
@@ -28,9 +31,26 @@ export const SURFACE_COMPONENTS = [
     "DonutChart",
     "Actions",
     "Button",
+    "Tabs",
+    "Card",
+    "Fold",
+    "Group",
+    "Chips",
+    "Checklist",
+    "Steps",
+    "Link",
+    "Callout",
 ];
 /** Components that hold others by id. */
-const CONTAINERS = new Set(["Column", "List", "Grid", "Actions"]);
+const CONTAINERS = new Set([
+    "Column",
+    "List",
+    "Grid",
+    "Actions",
+    "Card",
+    "Fold",
+    "Group",
+]);
 /** The props each component needs. */
 const REQUIRED = {
     Text: ["text"],
@@ -44,6 +64,15 @@ const REQUIRED = {
     LineChart: ["points"],
     DonutChart: ["slices"],
     Button: ["label", "action"],
+    Tabs: ["tabs"],
+    Card: ["title"],
+    Fold: ["title", "children"],
+    Group: ["children", "by"],
+    Chips: ["items"],
+    Checklist: ["items"],
+    Steps: ["items"],
+    Link: ["title", "items", "value", "view"],
+    Callout: ["text"],
 };
 export const SURFACE_ACTIONS = ["regenerate", "open"];
 const id = z.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,40}$/, "ids are letters, digits, _ and -");
@@ -57,6 +86,24 @@ export const surfaceComponentSchema = z.looseObject({
 });
 export const surfaceComponentsSchema = z.array(surfaceComponentSchema).min(1).max(200);
 const isPath = (v) => Boolean(v && typeof v === "object" && !Array.isArray(v) && typeof v.path === "string");
+/**
+ * The ids a component draws: its children, the views of its tabs. A Link's view is drawn only
+ * when it is opened, so it is no part of the tree.
+ */
+function childIds(c) {
+    const kids = c.children;
+    const ids = Array.isArray(kids) ? [...kids] : kids ? [kids.componentId] : [];
+    const tabs = c.tabs;
+    if (Array.isArray(tabs)) {
+        for (const tab of tabs) {
+            const child = tab?.child;
+            if (typeof child === "string") {
+                ids.push(child);
+            }
+        }
+    }
+    return ids;
+}
 /** Every `{ path }` in a component's props, with whether it reads a repeated row. */
 function pathsOf(c) {
     const out = [];
@@ -78,12 +125,173 @@ function pathsOf(c) {
     }
     return out;
 }
+/** Props naming a key of the entries a component's `items` (or chart's points) holds. */
+const ENTRY_KEYS = [
+    "labelKey",
+    "valueKey",
+    "flagKey",
+    "detailKey",
+    "noteKey",
+    "groupKey",
+    "textKey",
+    "minutesKey",
+];
+/** A path as parts: "/days/0/label" from the data, "meals.slot" from the entry. */
+const partsOf = (path) => (path.startsWith("/") ? path.slice(1) : path)
+    .split(/[./]/)
+    .filter(Boolean)
+    .map((p) => p.replace(/~1/g, "/").replace(/~0/g, "~"));
+/**
+ * The paths a surface reads, followed through the step's schema from "root": a repeated child
+ * reads an entry of the list its path names, a Link's view the entry it opens. Every path has to
+ * be in the schema, every key a component names in its entries.
+ */
+function shapeIssues(byId, root) {
+    const issues = [];
+    const seen = new Map();
+    /** The shape a path reads where `entry` is drawn; "any": unchecked. */
+    const resolve = (path, entry) => {
+        if (path.startsWith("/")) {
+            return shapeAt(root, partsOf(path));
+        }
+        if (entry === "any") {
+            return "any";
+        }
+        return entry ? shapeAt(entry, partsOf(path)) : undefined;
+    };
+    const say = (c, path, entry) => issues.push({
+        message: !path.startsWith("/") && !entry
+            ? `"${c.id}" reads "${path}" outside a repeated entry; from the data it is "/${path.replace(/\./g, "/")}".`
+            : `"${c.id}" reads "${path}", which no data provides.`,
+    });
+    /** The entries of a list a prop binds, or undefined (and an issue) where it is no list. */
+    const entriesOf = (c, value, entry) => {
+        if (!isPath(value)) {
+            return "any";
+        }
+        const at = resolve(value.path, entry);
+        if (at === "any") {
+            return "any";
+        }
+        if (at?.kind === "list") {
+            return at.of;
+        }
+        if (at?.kind === "table") {
+            return at.columns?.length
+                ? {
+                    kind: "object",
+                    fields: Object.fromEntries(at.columns.map((k) => [k, { kind: "text" }])),
+                }
+                : "any";
+        }
+        if (at) {
+            issues.push({ message: `"${c.id}" reads "${value.path}" as a list; it is ${at.kind}.` });
+        }
+        else {
+            say(c, value.path, entry);
+        }
+        return undefined;
+    };
+    const hasKey = (shape, k) => shape === "any" || shape === undefined || shape.kind !== "object" || k in shape.fields;
+    const visit = (cid, entry) => {
+        const c = byId.get(cid);
+        const done = seen.get(cid) ?? new Set();
+        if (!c || done.has(entry)) {
+            return;
+        }
+        done.add(entry);
+        seen.set(cid, done);
+        const props = c;
+        // What the component's items, rows or points hold, for the keys it names in them.
+        const listProp = ["items", "rows", "points", "slices"].find((k) => isPath(props[k]));
+        const items = listProp ? entriesOf(c, props[listProp], entry) : undefined;
+        for (const k of ENTRY_KEYS) {
+            const named = props[k];
+            if (typeof named === "string" && items && !hasKey(items, named)) {
+                issues.push({
+                    message: `"${c.id}": "${k}" names "${named}", which its entries do not have.`,
+                });
+            }
+        }
+        if (c.component === "Table" && Array.isArray(props.columns) && items) {
+            for (const col of props.columns) {
+                if (typeof col?.key === "string" && !hasKey(items, col.key)) {
+                    issues.push({ message: `"${c.id}": no column "${col.key}" in its rows.` });
+                }
+            }
+        }
+        // A Link: title, subtitle and meta read the entry it opens, the rest the entry it sits in.
+        const opened = c.component === "Link" ? items : undefined;
+        if (c.component === "Link" && typeof props.key === "string" && !hasKey(opened, props.key)) {
+            issues.push({ message: `"${c.id}": its items have no "${props.key}".` });
+        }
+        for (const [k, value] of Object.entries(props)) {
+            if (k === "id" || k === "component" || k === "children" || k === listProp) {
+                continue;
+            }
+            const reads = c.component === "Link" && (k === "title" || k === "subtitle" || k === "meta");
+            const scope = reads ? opened : entry;
+            const paths = [];
+            const walk = (v) => {
+                if (isPath(v)) {
+                    paths.push(v.path);
+                }
+                else if (Array.isArray(v)) {
+                    v.forEach(walk);
+                }
+                else if (v && typeof v === "object") {
+                    Object.values(v).forEach(walk);
+                }
+            };
+            walk(value);
+            for (const path of paths) {
+                if (resolve(path, scope) === undefined) {
+                    say(c, path, scope);
+                }
+            }
+        }
+        const kids = c.children;
+        if (Array.isArray(kids)) {
+            for (const k of kids) {
+                visit(k, entry);
+            }
+        }
+        else if (kids) {
+            const of = entriesOf(c, { path: kids.path }, entry);
+            if (of !== undefined) {
+                if (c.component === "Group" && typeof props.by === "string" && !hasKey(of, props.by)) {
+                    issues.push({
+                        message: `"${c.id}": "by" names "${props.by}", which its entries do not have.`,
+                    });
+                }
+                visit(kids.componentId, of);
+            }
+        }
+        const tabs = props.tabs;
+        if (Array.isArray(tabs)) {
+            for (const tab of tabs) {
+                const child = tab?.child;
+                if (typeof child === "string") {
+                    visit(child, entry);
+                }
+            }
+        }
+        if (c.component === "Link" && typeof props.view === "string" && opened !== undefined) {
+            visit(props.view, opened);
+        }
+    };
+    if (byId.has("root")) {
+        visit("root", undefined);
+    }
+    return issues;
+}
 /**
  * What can be wrong with a surface: an unknown or missing component, no root, a child that is
- * not there, an id twice, a loop, a prop missing, and — given the data keys a run will provide —
- * an absolute path into data nothing provides.
+ * not there, an id twice, a loop, a prop missing, and — given the data keys a run will provide,
+ * or the step's schema — a path into data nothing provides.
  */
-export function validateSurface(raw, dataKeys) {
+export function validateSurface(raw, data) {
+    const dataKeys = Array.isArray(data) ? data : undefined;
     const parsed = surfaceComponentsSchema.safeParse(raw);
     if (!parsed.success) {
         return parsed.error.issues.map((i) => ({ message: `${i.path.join(".")}: ${i.message}` }));
@@ -116,7 +324,17 @@ export function validateSurface(raw, dataKeys) {
         if (children && !CONTAINERS.has(c.component) && c.component !== "Table") {
             issues.push({ message: `${c.component} "${c.id}" holds no children.` });
         }
-        const ids = Array.isArray(children) ? children : children ? [children.componentId] : [];
+        if (c.component === "Group" && (!children || Array.isArray(children))) {
+            issues.push({
+                message: `Group "${c.id}" repeats over a list: children { "path", "componentId" }.`,
+            });
+        }
+        const tabs = c.tabs;
+        if (c.component === "Tabs" && !(Array.isArray(tabs) && tabs.length >= 2)) {
+            issues.push({ message: `Tabs "${c.id}" needs at least two tabs: [{ label, child }].` });
+        }
+        const view = c.view;
+        const ids = [...childIds(c), ...(typeof view === "string" ? [view] : [])];
         for (const child of ids) {
             if (!byId.has(child)) {
                 issues.push({ message: `"${c.id}" names a child "${child}" that is not there.` });
@@ -142,18 +360,15 @@ export function validateSurface(raw, dataKeys) {
         }
         seen.add(cid);
         const c = byId.get(cid);
-        const kids = Array.isArray(c?.children)
-            ? c.children
-            : c?.children
-                ? [c.children.componentId]
-                : [];
+        const kids = c ? childIds(c) : [];
         const next = new Set(stack).add(cid);
         return kids.some((k) => loops(k, next));
     };
     if (byId.has("root") && loops("root", new Set())) {
         issues.push({ message: "Components hold each other in a loop." });
+        return issues;
     }
-    return issues;
+    return data && !Array.isArray(data) ? [...issues, ...shapeIssues(byId, data)] : issues;
 }
 /** A JSON pointer into data: "/suppliers/0/name". */
 export function pointer(data, path) {
@@ -174,21 +389,38 @@ export function bound(value, data, row) {
     if (!isPath(value)) {
         return value;
     }
-    if (value.path.startsWith("/")) {
-        return pointer(data, value.path);
+    const raw = value.path.startsWith("/")
+        ? pointer(data, value.path)
+        : row === undefined
+            ? undefined
+            : pointer(row, `/${value.path.replace(/\./g, "/")}`);
+    return worded(raw, value);
+}
+/** A value turned into words as its path says: looked up in `map`, set into `format`. */
+export function worded(raw, spec) {
+    let v = raw;
+    const map = spec.map;
+    if (map && typeof map === "object" && !Array.isArray(map)) {
+        const key = String(v);
+        if (Object.hasOwn(map, key)) {
+            v = map[key];
+        }
+    }
+    if (typeof spec.format === "string" && v !== undefined && v !== null && v !== "") {
+        v = spec.format.replace("{}", Array.isArray(v) ? v.join(", ") : String(v));
     }
-    return row === undefined ? undefined : pointer(row, `/${value.path.replace(/\./g, "/")}`);
+    return v;
 }
 /** What a model needs to compose a surface: the catalog, briefly. */
 export const SURFACE_GUIDE = `A surface is a flat JSON array of components; the one with id "root" is drawn. Containers list their children by id.
 Components and props (a prop may be a literal or {"path": "/key/..."} into the data):
-- Column { children: [ids] } — vertical stack (use for root)
-- Text { text, variant?: "h3"|"h4"|"body"|"muted" }
+- Column { children: [ids] } — vertical stack (use for root); Column and Grid may also repeat one component per entry: children {"path", "componentId"}
+- Text { text, variant?: "h3"|"h4"|"lead"|"body"|"muted" } — "lead": the one opening line in the wizard's voice
 - List { children: {"path": "/rows", "componentId": "<a Row id>"} } — one Row per array entry; inside, paths without "/" read the entry ("name")
 - Row { title, subtitle?, meta?, badge?, image? }
 - DetailGrid { rows: [{ label, value }] } — label/value facts
-- Badge { label, tone?: "default"|"success"|"warning" }
-- Grid { children: [ids], columns?: 2|3|4 } — tiles side by side
+- Badge { label, tone?: "default"|"success"|"warning"|"accent" }
+- Grid { children: [ids], columns?: 2|3|4, min?: rem } — tiles side by side; min: the narrowest a tile gets (14 for cards, so a phone shows one)
 - Metric { label, value, caption? } — a key figure
 - Table { rows: {"path": "/rows"}, columns?: [{ key, label }] }
 - Image { src: an asset id or {"path": ...}, alt? }
@@ -196,4 +428,15 @@ Components and props (a prop may be a literal or {"path": "/key/..."} into the d
 - DonutChart { title?, slices: [{ label, value }] or {"path": ...}, labelKey?, valueKey? }
   (labelKey / valueKey: the columns of bound rows that hold the label and the number, e.g. "name", "price")
 - Actions { children: [Button ids] } / Button { label, action: "regenerate"|"open" }
+- Tabs { tabs: [{ label, count?, child: id }] } — two to four views of one result; count may bind a list (shows its length)
+- Card { title, eyebrow?, subtitle?, meta?: [values], image?, children?: [ids] } — one thing: a day, a recipe, an offer
+- Fold { title, open?, children: [ids] } — details that open on a tap
+- Group { children: {"path", "componentId"}, by: "<key>", order?: [values] } — entries under a heading per value of a key
+- Chips { items, labelKey?, flagKey?, flag? } — short things at a glance; flagKey marks some ("bald")
+- Checklist { items, labelKey?, detailKey?, noteKey?, noteFormat?, noteMap?, groupKey?, groupOrder?, share? } — things to get or do; ticks are kept; a yes/no note needs noteMap: {"true": "da", "false": "einkaufen"}
+- Steps { items, textKey?, minutesKey? } — ordered work, numbered, with times
+- Link { title, subtitle?, eyebrow?, meta?, look?: "row"|"card", items: {"path": "/recipes"}, key?: "id", value: {"path": "recipe_id"}, view: id } — opens the entry of items whose key is value in a sheet, drawn by view; title, subtitle and meta read that entry, eyebrow the row the Link sits in
+- Callout { text, title?, tone?: "tip"|"note"|"warning" }
+A path may put its value into words: {"path": "in_fridge", "map": {"true": "da", "false": "einkaufen"}}, {"path": "minutes", "format": "{} Min"}.
+Design it like an app, not a report: lead with a headline, the key figure or the chips; one Card per thing, never a Table of things; ordered work is Steps, things to get are a Checklist, sets are grouped by their key. A Table only for figures people compare across columns.
 Keep it small: what the person needs to see first, then the details. Never invent numbers: bind them by path.`;

package/node_modules/@engenty-wizards/shared/dist/texts.d.ts

@@ -24,13 +24,22 @@ export type Texts<K extends string> = {
 };
 /** What fills a line's gaps: words, a number (written the language's way), or a list of them. */
 export type Gap = string | number | readonly Gap[];
+/** The plural rules of a language: any language, by its code. */
+export declare function pluralRules(lang: string): Intl.PluralRules;
 /** A gap's words in a language: numbers as the language writes them, lists joined. */
-export declare function gapText(value: Gap, lang: Lang): string;
+export declare function gapText(value: Gap, lang: string): string;
 /** Fills `{name}` gaps; a gap with nothing for it stays as it is. */
-export declare function fillGaps(text: string, lang: Lang, params?: Record<string, Gap | undefined>): string;
+export declare function fillGaps(text: string, lang: string, params?: Record<string, Gap | undefined>): string;
 /**
  * A line of a table in a language, its gaps filled and its plural form picked by `{count}`
  * (or `{n}`);
  * the English line where the language lacks one.
  */
 export declare function textOf<K extends string>(texts: Texts<K>, key: K, lang: Lang, params?: Record<string, Gap | undefined>): string;
+/**
+ * A string table of one language outside `LANGS`, translated on request: lines by key, a plural
+ * line with the forms of that language's plural categories.
+ */
+export type TextTable = Record<string, Line>;
+/** A line of a table, in a language: its gaps filled and its plural form picked. */
+export declare function lineText(line: Line, lang: string, params?: Record<string, Gap | undefined>): string;

package/node_modules/@engenty-wizards/shared/dist/texts.js

@@ -1,6 +1,15 @@
 // SPDX-License-Identifier: FSL-1.1-MIT OR MIT
-import { LOCALES } from "./definition.js";
+import { localeOf } from "./definition.js";
 const plurals = new Map();
+/** The plural rules of a language: any language, by its code. */
+export function pluralRules(lang) {
+    let rules = plurals.get(lang);
+    if (!rules) {
+        rules = new Intl.PluralRules(localeOf(lang));
+        plurals.set(lang, rules);
+    }
+    return rules;
+}
 function form(line, lang, count) {
     if (typeof line === "string") {
         return line;
@@ -8,17 +17,12 @@ function form(line, lang, count) {
     if (typeof count !== "number") {
         return line.other;
     }
-    let rules = plurals.get(lang);
-    if (!rules) {
-        rules = new Intl.PluralRules(LOCALES[lang]);
-        plurals.set(lang, rules);
-    }
-    return line[rules.select(count)] ?? line.other;
+    return line[pluralRules(lang).select(count)] ?? line.other;
 }
 /** A gap's words in a language: numbers as the language writes them, lists joined. */
 export function gapText(value, lang) {
     if (typeof value === "number") {
-        return value.toLocaleString(LOCALES[lang]);
+        return value.toLocaleString(localeOf(lang));
     }
     if (Array.isArray(value)) {
         return value.map((item) => gapText(item, lang)).join(", ");
@@ -44,3 +48,7 @@ export function textOf(texts, key, lang, params) {
     }
     return fillGaps(form(line, lang, params?.count ?? params?.n), lang, params);
 }
+/** A line of a table, in a language: its gaps filled and its plural form picked. */
+export function lineText(line, lang, params) {
+    return fillGaps(form(line, lang, params?.count ?? params?.n), lang, params);
+}

package/node_modules/@engenty-wizards/shared/dist/translation.d.ts

@@ -0,0 +1,23 @@
+import type { WizardDefinition } from "./definition.js";
+/** The texts of a definition the person reads, each once, in the order they appear. */
+export declare function wizardTexts(def: WizardDefinition): string[];
+/** Whether a translated text keeps every placeholder and gap of its original, no more, no fewer. */
+export declare function keepsPlaceholders(original: string, translated: string): boolean;
+/** A translation as it is kept: each original text with its translation and who wrote it. */
+export interface TranslationEntry {
+    text: string;
+    by: "machine" | "author";
+}
+export type TranslationMemory = Record<string, TranslationEntry>;
+/** The texts of a definition a translation does not have yet. */
+export declare function missingTexts(def: WizardDefinition, memory: TranslationMemory): string[];
+/**
+ * The definition in the viewer's language: a copy with every text the memory has written in,
+ * and the labels of the choices beside it (`labels[value]`), the values untouched.
+ */
+export declare function translateDefinition(def: WizardDefinition, memory: TranslationMemory): {
+    def: WizardDefinition;
+    labels: Record<string, string>;
+};
+/** Whether every text of the memory came from the author, or some from a model. */
+export declare function machineTranslated(memory: TranslationMemory, def: WizardDefinition): boolean;

package/node_modules/@engenty-wizards/shared/dist/translation.js

@@ -0,0 +1,154 @@
+/**
+ * A wizard translated for its viewer, on request: what the person reads is written in their
+ * language, what the wizard runs on stays as the author wrote it. Never translated: ids,
+ * branches and their statements, the instructions of AI steps, `{{…}}` placeholders, and the
+ * values of choices — a choice shows a translated label and keeps its value.
+ */
+/** Fields whose `options` are choices the person reads (a slot's are dates, written by the runner). */
+function choiceField(field) {
+    return field.kind === "select" || field.kind === "multiselect";
+}
+/** Every text of a definition the person reads, with the way to write it back. */
+function visitTexts(def, visit, choices) {
+    visit(def.title, (t) => {
+        def.title = t;
+    });
+    visit(def.description, (t) => {
+        def.description = t;
+    });
+    visit(def.intro, (t) => {
+        def.intro = t;
+    });
+    for (const list of def.lists ?? []) {
+        visit(list.title, (t) => {
+            list.title = t;
+        });
+        visit(list.description, (t) => {
+            list.description = t;
+        });
+        for (const column of list.columns ?? []) {
+            visit(column.name, (t) => {
+                column.name = t;
+            });
+            const options = ("format" in column
+                ? column.format
+                : undefined)?.options;
+            for (const option of options ?? []) {
+                visit(option.label, (t) => {
+                    option.label = t;
+                });
+            }
+        }
+    }
+    for (const connection of def.connections ?? []) {
+        visit(connection.title, (t) => {
+            connection.title = t;
+        });
+        visit(connection.description, (t) => {
+            connection.description = t;
+        });
+    }
+    for (const step of def.steps) {
+        visit(step.title, (t) => {
+            step.title = t;
+        });
+        visit(step.description, (t) => {
+            step.description = t;
+        });
+        if ("working" in step) {
+            visit(step.working, (t) => {
+                step.working = t;
+            });
+        }
+        // What an AI step's output fields hold: the headings a review and the result show them under.
+        if (step.type === "agent") {
+            for (const field of step.output?.fields ?? []) {
+                visit(field.description, (t) => {
+                    field.description = t;
+                });
+            }
+        }
+        if (step.type === "page") {
+            visit(step.cta, (t) => {
+                step.cta = t;
+            });
+            for (const field of step.fields) {
+                visit(field.label, (t) => {
+                    field.label = t;
+                });
+                visit(field.help, (t) => {
+                    field.help = t;
+                });
+                visit(field.placeholder, (t) => {
+                    field.placeholder = t;
+                });
+                for (const column of field.columns ?? []) {
+                    visit(column.label, (t) => {
+                        column.label = t;
+                    });
+                }
+                if (choiceField(field)) {
+                    for (const option of field.options ?? []) {
+                        choices(option, () => undefined);
+                    }
+                }
+            }
+        }
+        if (step.type === "result") {
+            visit(step.message, (t) => {
+                step.message = t;
+            });
+            for (const deliverable of step.deliverables) {
+                visit(deliverable.label, (t) => {
+                    deliverable.label = t;
+                });
+            }
+        }
+    }
+}
+/** The texts of a definition the person reads, each once, in the order they appear. */
+export function wizardTexts(def) {
+    const seen = new Set();
+    const add = (text) => {
+        if (text?.trim()) {
+            seen.add(text);
+        }
+    };
+    visitTexts(structuredClone(def), add, add);
+    return [...seen];
+}
+/** `{{…}}` placeholders and `{name}` gaps: what a translation keeps exactly. */
+const KEPT = /\{\{[^}]*\}\}|\{\w+\}/g;
+/** Whether a translated text keeps every placeholder and gap of its original, no more, no fewer. */
+export function keepsPlaceholders(original, translated) {
+    const of = (text) => (text.match(KEPT) ?? []).sort().join("\u0000");
+    return of(original) === of(translated);
+}
+/** The texts of a definition a translation does not have yet. */
+export function missingTexts(def, memory) {
+    return wizardTexts(def).filter((text) => !memory[text]);
+}
+/**
+ * The definition in the viewer's language: a copy with every text the memory has written in,
+ * and the labels of the choices beside it (`labels[value]`), the values untouched.
+ */
+export function translateDefinition(def, memory) {
+    const copy = structuredClone(def);
+    const labels = {};
+    visitTexts(copy, (text, write) => {
+        const entry = text ? memory[text] : undefined;
+        if (entry) {
+            write(entry.text);
+        }
+    }, (value) => {
+        const entry = value ? memory[value] : undefined;
+        if (value && entry) {
+            labels[value] = entry.text;
+        }
+    });
+    return { def: copy, labels };
+}
+/** Whether every text of the memory came from the author, or some from a model. */
+export function machineTranslated(memory, def) {
+    return wizardTexts(def).some((text) => memory[text]?.by !== "author");
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wizards",
-  "version": "0.5.12",
+  "version": "0.6.0",
   "description": "Make a wish. Get your wizard. It guides you step by step. Let AI do the work. Runs on your machine, on the AI subscription you already have.",
   "license": "FSL-1.1-MIT",
   "homepage": "https://engenty.ai",

package/apps/web/dist/assets/AboutDialog-DvkE9J4h.js

@@ -1 +0,0 @@
-import{r as e}from"./rolldown-runtime-hePW80VL.js";import{n as t,t as n}from"./jsx-runtime-BNakU3Ej.js";import{$n as r,At as i,Jn as a,Mt as o,Nt as s,Rt as c,Tn as l,Ut as u,Vt as d,Yt as f,jt as p}from"./ui-CeZNNuaK.js";import{t as m}from"./preload-helper-CNEI7N0N.js";import{H as h,U as g,W as _,yt as v}from"./index-93fPRTxr.js";import{c as y,f as b}from"./settings-menu-COgM8CgB.js";import{ReleaseNotes as x,loadReleases as S,releaseDate as C,releaseLabel as w}from"./ChangelogDialog-BZ8i3wt_.js";var T=e(t(),1),E=[{name:`engenty wizards`,description:`credit.engenty-wizards`,homepage:`https://github.com/engenty/wizards`,license:`FSL-1.1-MIT`},{name:`engenty`,description:`credit.engenty`,homepage:`https://github.com/engenty/engenty`,license:`FSL-1.1-MIT`}],D=[{name:`Mastra`,description:`credit.mastra`,homepage:`https://github.com/mastra-ai/mastra`,license:`Apache-2.0`},{name:`AI SDK`,description:`credit.ai-sdk`,homepage:`https://github.com/vercel/ai`,license:`Apache-2.0`},{name:`Model Context Protocol`,description:`credit.model-context-protocol`,homepage:`https://github.com/modelcontextprotocol/typescript-sdk`,license:`MIT`},{name:`Hono`,description:`credit.hono`,homepage:`https://github.com/honojs/hono`,license:`MIT`},{name:`Drizzle ORM`,description:`credit.drizzle-orm`,homepage:`https://github.com/drizzle-team/drizzle-orm`,license:`Apache-2.0`},{name:`libSQL`,description:`credit.libsql`,homepage:`https://github.com/tursodatabase/libsql`,license:`MIT`},{name:`Playwright`,description:`credit.playwright`,homepage:`https://github.com/microsoft/playwright`,license:`Apache-2.0`},{name:`agentOS`,description:`credit.agentos`,homepage:`https://github.com/rivet-dev/agentos`,license:`Apache-2.0`},{name:`React`,description:`credit.react`,homepage:`https://github.com/facebook/react`,license:`MIT`},{name:`Vite`,description:`credit.vite`,homepage:`https://github.com/vitejs/vite`,license:`MIT`},{name:`Tailwind CSS`,description:`credit.tailwind-css`,homepage:`https://github.com/tailwindlabs/tailwindcss`,license:`MIT`},{name:`React Flow`,description:`credit.react-flow`,homepage:`https://github.com/xyflow/xyflow`,license:`MIT`},{name:`TanStack Query`,description:`credit.tanstack-query`,homepage:`https://github.com/TanStack/query`,license:`MIT`},{name:`xterm.js`,description:`credit.xterm-js`,homepage:`https://github.com/xtermjs/xterm.js`,license:`MIT`},{name:`Lucide`,description:`credit.lucide`,homepage:`https://github.com/lucide-icons/lucide`,license:`ISC`},{name:`Geist & Geist Mono`,description:`credit.geist-geist-mono`,homepage:`https://github.com/vercel/geist-font`,license:`OFL-1.1`},{name:`Space Grotesk`,description:`credit.space-grotesk`,homepage:`https://github.com/floriankarsten/space-grotesk`,license:`OFL-1.1`},{name:`git-cliff`,description:`credit.git-cliff`,homepage:`https://github.com/orhun/git-cliff`,license:`MIT OR Apache-2.0`}],O=e(n(),1),k=(e,...t)=>t.some(t=>t?.toLowerCase().includes(e));function A({name:e,homepage:t,version:n,license:r,description:i}){return(0,O.jsxs)(`li`,{className:`py-2.5`,children:[(0,O.jsxs)(`div`,{className:`flex flex-wrap items-baseline gap-x-2.5 gap-y-0.5`,children:[t?(0,O.jsxs)(`a`,{href:t,target:`_blank`,rel:`noreferrer`,className:`inline-flex items-center gap-1 font-medium text-[0.875rem] text-ink underline-offset-4 hover:underline`,children:[e,(0,O.jsx)(a,{"aria-hidden":!0,className:`size-3 text-ink-4`})]}):(0,O.jsx)(`span`,{className:`font-medium text-[0.875rem] text-ink`,children:e}),n?(0,O.jsx)(`span`,{className:`text-[0.75rem] text-ink-3 tabular-nums`,children:n}):null,(0,O.jsx)(`span`,{className:`text-[0.75rem] text-ink-3`,children:r})]}),i?(0,O.jsx)(`p`,{className:`mt-0.5 text-[0.8125rem] text-ink-3`,children:i}):null]})}function j({title:e,hint:t,children:n}){return(0,O.jsxs)(`section`,{className:`mt-6`,children:[(0,O.jsx)(`h3`,{className:`border-border-soft border-b pb-2 font-display font-semibold text-[1rem]`,children:e}),t?(0,O.jsx)(`p`,{className:`mt-2 text-[0.8125rem] text-ink-3`,children:t}):null,n]})}function M({credits:e}){return(0,O.jsx)(`ul`,{className:`divide-y divide-border-soft`,children:e.map(e=>(0,O.jsx)(A,{name:e.name,homepage:e.homepage,license:e.license,description:f(e.description)},e.name))})}function N({label:e,packages:t}){return(0,O.jsxs)(`div`,{className:`mt-4`,children:[(0,O.jsx)(`h4`,{className:`font-medium text-[0.75rem] text-ink-3 tracking-wide`,children:e}),(0,O.jsx)(`ul`,{className:`divide-y divide-border-soft`,children:t.map(e=>(0,O.jsx)(A,{...e},e.name))})]})}function P({active:e}){let[t,n]=(0,T.useState)(null),[r,i]=(0,T.useState)(``);(0,T.useEffect)(()=>{if(!e||t)return;let r=!1;return m(()=>import(`./oss-credits-BJrR7BR1.js`).then(e=>{r||n(e.default)}),[]),()=>{r=!0}},[e,t]),(0,T.useEffect)(()=>{e||i(``)},[e]);let a=r.trim().toLowerCase(),o=e=>a?e.filter(e=>k(a,e.name,e.license,f(e.description))):e,l=e=>a?e.filter(e=>k(a,e.name,e.license,e.version)):e,u=o(E),d=o(D),h=t?[{id:`shared`,label:f(`about.creditsShared`),packages:l(t.shared)},...t.groups.map(e=>({id:e.id,label:e.label,packages:l(e.packages)}))].filter(e=>e.packages.length>0):[],g=u.length===0&&d.length===0&&h.length===0;return(0,O.jsxs)(O.Fragment,{children:[(0,O.jsx)(`p`,{className:`mb-4 text-[0.875rem] text-ink-3`,children:f(`about.creditsHint`)}),(0,O.jsx)(s,{type:`search`,value:r,placeholder:f(`about.search`),onChange:e=>i(e.target.value)}),u.length>0?(0,O.jsx)(j,{title:f(`about.creditsProduct`),children:(0,O.jsx)(M,{credits:u})}):null,d.length>0?(0,O.jsx)(j,{title:f(`about.creditsBuiltWith`),children:(0,O.jsx)(M,{credits:d})}):null,t===null?(0,O.jsx)(`div`,{className:`flex justify-center py-10 text-ink-3`,children:(0,O.jsx)(c,{})}):h.length>0?(0,O.jsx)(j,{title:f(`about.creditsDeps`),hint:a?void 0:f(`about.creditsDepsHint`),children:h.map(e=>(0,O.jsx)(N,{label:e.label,packages:e.packages},e.id))}):null,t!==null&&g?(0,O.jsx)(p,{children:f(`about.noMatches`)}):null]})}var F=[`new`,`earlier`,`credits`],I=e=>f(e===`new`?`about.tab.new`:e===`earlier`?`about.tab.earlier`:`about.credits`),L=e=>e===1?f(`about.change`):f(`about.changes`,{n:e});function R({open:e,onClose:t,me:n}){let a=n?.mode===`local`,{data:s,latest:p}=_(a&&e),[m,E]=(0,T.useState)(null),[D,k]=(0,T.useState)(`new`),A=b(F.indexOf(D)),j=s?.newer&&p?p:g;(0,T.useEffect)(()=>{if(!e)return;let t=!1;return E(null),S(j===`0.5.12`?void 0:j).then(e=>{t||E(e)}),()=>{t=!0}},[e,j]);let M=m?.find(e=>e.version===`v${j}`)??m?.[0]??null,N=m?.filter(e=>e!==M)??[],R=a?s?.kind??null:`cloud`;return(0,O.jsxs)(i,{open:e,onClose:t,wide:!0,height:`tall`,children:[(0,O.jsx)(`div`,{className:`-mt-2 -mr-2 sticky top-0 z-10 flex h-0 justify-end`,children:(0,O.jsx)(o,{label:f(`common.close`),onClick:t,children:(0,O.jsx)(l,{className:`size-4`})})}),(0,O.jsxs)(`div`,{className:`flex flex-col items-center pt-4 text-center`,children:[(0,O.jsx)(v,{size:96}),(0,O.jsxs)(`div`,{className:`mt-4 font-display font-semibold text-[1.5rem] tracking-tight`,children:[`engenty`,(0,O.jsx)(`span`,{className:`text-ember`,children:`.`}),(0,O.jsx)(`span`,{className:`ml-1.5 font-normal text-ink-3`,children:`wizards`})]}),(0,O.jsxs)(`div`,{className:`mt-1 text-[0.9375rem] text-ink-3 tabular-nums`,children:[f(`about.version`,{v:g}),R?` · ${f(`about.kind.${R}`)}`:``]})]}),a?(0,O.jsx)(`div`,{className:`mt-5`,children:(0,O.jsx)(h,{enabled:e})}):null,(0,O.jsx)(`div`,{className:`mt-6 flex justify-center`,children:(0,O.jsx)(d,{value:D,onChange:k,options:F.map(e=>({id:e,label:I(e)})),label:f(`about.title`)})}),(0,O.jsxs)(`div`,{className:u(`mt-5`,y(A)),children:[D===`new`?m===null?(0,O.jsx)(`div`,{className:`flex justify-center py-6 text-ink-3`,children:(0,O.jsx)(c,{})}):M?(0,O.jsxs)(O.Fragment,{children:[(0,O.jsxs)(`h3`,{className:`flex items-baseline gap-3 border-border-soft border-b pb-2 font-display font-semibold text-[1rem]`,children:[w(M),(0,O.jsx)(`span`,{className:`font-normal font-sans text-[0.8125rem] text-ink-3 tabular-nums`,children:C(M)})]}),(0,O.jsx)(`div`,{className:`mt-3`,children:(0,O.jsx)(x,{release:M})})]}):(0,O.jsx)(`p`,{className:`text-[0.875rem] text-ink-3`,children:f(`about.changelogEmpty`)}):null,D===`earlier`?(0,O.jsx)(`div`,{className:`flex flex-col divide-y divide-border-soft`,children:N.map(e=>(0,O.jsxs)(`details`,{className:`group/r py-2`,children:[(0,O.jsxs)(`summary`,{className:`flex cursor-pointer list-none items-baseline gap-3 text-[0.875rem] [&::-webkit-details-marker]:hidden`,children:[(0,O.jsx)(r,{className:`size-3.5 shrink-0 self-center text-ink-4 transition group-open/r:rotate-90`}),(0,O.jsx)(`span`,{className:`font-medium text-ink tabular-nums`,children:w(e)}),(0,O.jsx)(`span`,{className:`text-[0.8125rem] text-ink-3 tabular-nums`,children:C(e)}),(0,O.jsx)(`span`,{className:`ml-auto text-[0.8125rem] text-ink-4`,children:L(e.commits.length)})]}),(0,O.jsx)(`div`,{className:`mt-2 pl-6`,children:(0,O.jsx)(x,{release:e})})]},e.version??`unreleased`))}):null,D===`credits`?(0,O.jsx)(P,{active:!0}):null]},D)]})}export{R as AboutDialog};