@liberation-data/desk 0.1.0

package/dist/react/tasks.d.ts

@@ -0,0 +1,41 @@
+import type { ReactNode } from 'react';
+export type TaskState = 'waiting' | 'working' | 'done' | 'failed';
+export interface Task {
+    readonly id: string;
+    readonly name: ReactNode;
+    /** The line under the name, until the task reports its own. */
+    readonly detail?: ReactNode;
+    /** The work. `report` replaces the line under the name while it runs: "12 of 24". Throw to fail. */
+    readonly run: (report: (detail: ReactNode) => void) => unknown;
+}
+export interface TaskProgress {
+    readonly id: string;
+    readonly name: ReactNode;
+    readonly state: TaskState;
+    readonly detail?: ReactNode;
+    /** Why it failed, for a person. */
+    readonly error?: string;
+}
+export interface Tasks {
+    readonly items: readonly TaskProgress[];
+    readonly running: boolean;
+    readonly done: boolean;
+    readonly failed: boolean;
+    /** Runs every task not yet done, in order. After a failure, this is the retry. */
+    readonly start: () => void;
+    /** Forgets what ran and runs everything again: for a setup step entered a second time. */
+    readonly restart: () => void;
+}
+export declare function useTasks(tasks: readonly Task[]): Tasks;
+export interface ChecklistProps {
+    readonly items: readonly TaskProgress[];
+    /** Offered beside a failed task. */
+    readonly onRetry?: () => void;
+    /** A bar above the list, filling as tasks finish. Default true. */
+    readonly progress?: boolean;
+    readonly label?: string;
+    readonly className?: string;
+}
+/** Tasks as a person watches them: waiting, working, done, or failed with the reason. */
+export declare function Checklist({ items, onRetry, progress, label, className }: ChecklistProps): import("react").JSX.Element;
+//# sourceMappingURL=tasks.d.ts.map

package/dist/react/tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/react/tasks.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAUtC,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAA;AAEjE,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,oGAAoG;IACpG,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,KAAK,OAAO,CAAA;CAC/D;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAA;IAC3B,mCAAmC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,kFAAkF;IAClF,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,0FAA0F;IAC1F,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAC7B;AAQD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,GAAG,KAAK,CAwEtD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;IACvC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAe,EAAE,KAAkB,EAAE,SAAS,EAAE,EAAE,cAAc,+BA0C3G"}

package/dist/react/tasks.js

@@ -0,0 +1,79 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Button } from './controls.js';
+export function useTasks(tasks) {
+    // The latest tasks, so a task's `run` sees the answers given since the step was drawn.
+    const latest = useRef(tasks);
+    latest.current = tasks;
+    const [status, setStatus] = useState({});
+    const statusNow = useRef(status);
+    statusNow.current = status;
+    // A run that has been superseded — by a restart, or by leaving — stops touching state.
+    const generation = useRef(0);
+    const [running, setRunning] = useState(false);
+    useEffect(() => () => {
+        generation.current += 1;
+    }, []);
+    const run = useCallback(async (from) => {
+        const mine = ++generation.current;
+        const set = (id, next) => {
+            if (generation.current !== mine)
+                return;
+            statusNow.current = { ...statusNow.current, [id]: next };
+            setStatus(statusNow.current);
+        };
+        setRunning(true);
+        for (const task of latest.current) {
+            if (from[task.id]?.state === 'done')
+                continue;
+            set(task.id, { state: 'working' });
+            try {
+                await task.run(detail => set(task.id, { state: 'working', reported: detail }));
+                set(task.id, { state: 'done', reported: statusNow.current[task.id]?.reported });
+            }
+            catch (failure) {
+                set(task.id, { state: 'failed', error: failure instanceof Error ? failure.message : String(failure) });
+                break;
+            }
+            if (generation.current !== mine)
+                return;
+        }
+        if (generation.current === mine)
+            setRunning(false);
+    }, []);
+    const start = useCallback(() => {
+        if (running)
+            return;
+        void run(statusNow.current);
+    }, [run, running]);
+    const restart = useCallback(() => {
+        statusNow.current = {};
+        setStatus({});
+        void run({});
+    }, [run]);
+    const items = tasks.map((task) => {
+        const s = status[task.id];
+        const detail = s?.reported ?? task.detail;
+        return {
+            id: task.id,
+            name: task.name,
+            state: s?.state ?? 'waiting',
+            ...(detail === undefined ? {} : { detail }),
+            ...(s?.error === undefined ? {} : { error: s.error }),
+        };
+    });
+    return {
+        items,
+        running,
+        done: items.length > 0 && items.every(item => item.state === 'done'),
+        failed: items.some(item => item.state === 'failed'),
+        start,
+        restart,
+    };
+}
+/** Tasks as a person watches them: waiting, working, done, or failed with the reason. */
+export function Checklist({ items, onRetry, progress = true, label = 'Progress', className }) {
+    const done = items.filter(item => item.state === 'done').length;
+    return (_jsxs("div", { className: ['desk-checklist', className].filter(Boolean).join(' '), children: [progress && (_jsx("div", { className: "desk-progress", role: "progressbar", "aria-label": label, "aria-valuemin": 0, "aria-valuemax": items.length, "aria-valuenow": done, children: _jsx("i", { style: { width: `${items.length ? (done / items.length) * 100 : 0}%` } }) })), _jsx("ul", { className: "desk-tasks", "aria-label": label, children: items.map(item => (_jsxs("li", { className: "desk-task", "data-state": item.state, children: [_jsx("span", { className: "desk-task-mark", "aria-hidden": "true", children: item.state === 'done' ? '✓' : item.state === 'failed' ? '!' : '' }), _jsxs("span", { className: "desk-task-text", children: [_jsx("span", { className: "desk-task-name", children: item.name }), item.state === 'failed' ? (_jsx("span", { className: "desk-task-error", role: "alert", children: item.error })) : (item.detail !== undefined && _jsx("span", { className: "desk-task-detail", children: item.detail }))] }), item.state === 'failed' && onRetry && (_jsx(Button, { size: "small", onClick: onRetry, children: "Try again" }))] }, item.id))) })] }));
+}
+//# sourceMappingURL=tasks.js.map

package/dist/react/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/react/tasks.tsx"],"names":[],"mappings":"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"}

package/dist/react/tour.d.ts

@@ -0,0 +1,42 @@
+import type { ReactNode } from 'react';
+import type { DeskEvent } from '../core/events.js';
+import type { WindowId } from '../core/types.js';
+export interface TourStep {
+    /** Opened and made key before the step is shown. */
+    readonly window?: WindowId;
+    /** What to point at: a `data-tour` name, or any CSS selector. */
+    readonly point?: string;
+    readonly caption: ReactNode;
+    /** Hands over: the bar offers Done and Skip instead of Next. */
+    readonly yourTurn?: boolean;
+    /**
+     * The event that means the person has done it — `ride.selected`, or a topic and a test.
+     * The tour moves on by itself when it arrives, so nobody has to say Done.
+     */
+    readonly until?: string | {
+        readonly topic: string;
+        readonly when: (event: DeskEvent) => boolean;
+    };
+}
+export interface Tour {
+    readonly id: string;
+    readonly name: string;
+    /** What the tour shows, in a sentence: said when it is offered. */
+    readonly description?: ReactNode;
+    readonly steps: readonly TourStep[];
+}
+export interface TourBarProps {
+    readonly tour: Tour;
+    /** Called when the last step is finished. */
+    readonly onFinish?: () => void;
+    /** Called when the person stops early. */
+    readonly onStop?: () => void;
+    /**
+     * Ask first: the bar invites the person to take the tour, and starts only if they say so.
+     * For the first time someone reaches the desktop, where nobody should be dropped without a word.
+     */
+    readonly offer?: boolean;
+    readonly className?: string;
+}
+export declare function TourBar({ tour, onFinish, onStop, offer, className }: TourBarProps): import("react").JSX.Element | null;
+//# sourceMappingURL=tour.d.ts.map

package/dist/react/tour.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour.d.ts","sourceRoot":"","sources":["../../src/react/tour.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAahD,MAAM,WAAW,QAAQ;IACvB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;IAC1B,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAA;KAAE,CAAA;CACnG;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,mEAAmE;IACnE,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;IAC9B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAcD,wBAAgB,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,YAAY,sCAqHjF"}

package/dist/react/tour.js

@@ -0,0 +1,68 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Button } from './controls.js';
+import { useDesk } from './context.js';
+import { useBus } from './events.js';
+const POINTED = 'data-desk-tour-pointed';
+function point(step) {
+    if (!step?.point)
+        return () => { };
+    const selector = step.point.startsWith('[') || step.point.includes('.') || step.point.includes('#') ? step.point : `[data-tour="${step.point}"]`;
+    const element = document.querySelector(selector);
+    if (!element)
+        return () => { };
+    element.setAttribute(POINTED, '');
+    element.scrollIntoView({ block: 'nearest', behavior: 'smooth' });
+    return () => element.removeAttribute(POINTED);
+}
+export function TourBar({ tour, onFinish, onStop, offer, className }) {
+    const desk = useDesk();
+    const bus = useBus();
+    const [offered, setOffered] = useState(offer ?? false);
+    const [index, setIndex] = useState(0);
+    const step = offered ? undefined : tour.steps[index];
+    const total = tour.steps.length;
+    const stop = useRef(() => { });
+    // Enter the step: open the window it is about, then point at its control.
+    useEffect(() => {
+        if (!step)
+            return;
+        if (step.window)
+            desk.open(step.window);
+        stop.current();
+        // A frame later: the window it just opened has to exist before it can be pointed at.
+        const frame = requestAnimationFrame(() => {
+            stop.current = point(step);
+        });
+        return () => {
+            cancelAnimationFrame(frame);
+            stop.current();
+            stop.current = () => { };
+        };
+    }, [desk, step, index]);
+    const go = useCallback((to) => {
+        if (to >= total) {
+            onFinish?.();
+            return;
+        }
+        setIndex(Math.max(0, to));
+    }, [total, onFinish]);
+    // A step that waits for the person moves on when what it asked for happens.
+    const until = step?.until;
+    useEffect(() => {
+        if (!until)
+            return undefined;
+        const topic = typeof until === 'string' ? until : until.topic;
+        return bus.subscribe(topic, event => {
+            if (typeof until === 'string' || until.when(event))
+                go(index + 1);
+        });
+    }, [bus, until, go, index]);
+    if (offered) {
+        return (_jsxs("div", { className: ['desk-tour', className].filter(Boolean).join(' '), role: "region", "aria-label": `Tour: ${tour.name}`, children: [_jsxs("div", { className: "desk-tour-head", children: [_jsx("b", { children: tour.name }), _jsxs("span", { className: "desk-tour-count", children: [total, " steps"] })] }), tour.description && _jsx("p", { className: "desk-tour-caption", children: tour.description }), _jsxs("div", { className: "desk-tour-actions", children: [_jsx("span", { className: "desk-tour-spacer" }), _jsx(Button, { size: "small", onClick: () => onStop?.(), children: "Not now" }), _jsx(Button, { size: "small", intent: "default", onClick: () => setOffered(false), children: "Show me" })] })] }));
+    }
+    if (!step)
+        return null;
+    return (_jsxs("div", { className: ['desk-tour', className].filter(Boolean).join(' '), role: "region", "aria-label": `Tour: ${tour.name}`, children: [_jsxs("div", { className: "desk-tour-head", children: [_jsx("b", { children: tour.name }), _jsxs("span", { className: "desk-tour-count", children: ["Step ", index + 1, " of ", total] }), _jsx(Button, { size: "small", intent: "quiet", "aria-label": "Stop the tour", onClick: () => onStop?.(), children: "\u2715" })] }), _jsx("div", { className: "desk-tour-progress", role: "presentation", children: _jsx("i", { style: { width: `${((index + 1) / total) * 100}%` } }) }), _jsxs("p", { className: "desk-tour-caption", "data-your-turn": step.yourTurn || undefined, children: [step.yourTurn && _jsx("span", { className: "desk-tour-turn", children: "Your turn" }), step.caption] }), _jsxs("div", { className: "desk-tour-actions", children: [_jsx(Button, { size: "small", intent: "quiet", onClick: () => setIndex(0), children: "Restart" }), _jsx(Button, { size: "small", intent: "quiet", onClick: () => setIndex(index), children: "Show me again" }), _jsx("span", { className: "desk-tour-spacer" }), step.yourTurn ? (_jsxs(_Fragment, { children: [_jsx(Button, { size: "small", onClick: () => go(index + 1), children: "Skip" }), !step.until && (_jsx(Button, { size: "small", intent: "default", onClick: () => go(index + 1), children: "Done" }))] })) : (_jsxs(_Fragment, { children: [_jsx(Button, { size: "small", disabled: index === 0, onClick: () => go(index - 1), children: "\u2039 Back" }), _jsx(Button, { size: "small", intent: "default", onClick: () => go(index + 1), children: index === total - 1 ? 'Finish' : 'Next ›' })] }))] })] }));
+}
+//# sourceMappingURL=tour.js.map

package/dist/react/tour.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tour.js","sourceRoot":"","sources":["../../src/react/tour.tsx"],"names":[],"mappings":"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"}

package/dist/react/windowBoundary.d.ts

@@ -0,0 +1,22 @@
+import type { ComponentType, ReactNode } from 'react';
+import type { WindowId } from '../core/types.js';
+export type WindowLoading = (id: WindowId) => ReactNode;
+export type WindowFailed = (id: WindowId, error: Error, reload: () => void) => ReactNode;
+export declare function WindowBoundary({ id, loading, failed, children, }: {
+    readonly id: WindowId;
+    readonly loading: WindowLoading | undefined;
+    readonly failed: WindowFailed | undefined;
+    readonly children: ReactNode;
+}): import("react").JSX.Element;
+/**
+ * A window whose code loads when it is first opened.
+ *
+ *   const RoutePlanner = lazyWindow(() => import('./apps/RoutePlanner'))
+ *
+ * Unlike `React.lazy`, a load that fails is not remembered: Reload in the window
+ * tries the import again, so a dropped connection is not permanent.
+ */
+export declare function lazyWindow<P extends object>(load: () => Promise<{
+    default: ComponentType<P>;
+}>): ComponentType<P>;
+//# sourceMappingURL=windowBoundary.d.ts.map

package/dist/react/windowBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowBoundary.d.ts","sourceRoot":"","sources":["../../src/react/windowBoundary.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkC,SAAS,EAAE,MAAM,OAAO,CAAA;AACrF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAUhD,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,QAAQ,KAAK,SAAS,CAAA;AACvD,MAAM,MAAM,YAAY,GAAG,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,KAAK,SAAS,CAAA;AA0DxF,wBAAgB,cAAc,CAAC,EAC7B,EAAE,EACF,OAAO,EACP,MAAM,EACN,QAAQ,GACT,EAAE;IACD,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,SAAS,CAAA;IAC3C,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAC7B,+BAMA;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,CAAA;CAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAYjH"}

package/dist/react/windowBoundary.js

@@ -0,0 +1,50 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Component, createContext, lazy, Suspense, useContext } from 'react';
+import { Button } from './controls.js';
+/** How many times this window has been reloaded: a lazy window loads afresh for each. */
+const AttemptContext = createContext(0);
+const defaultLoading = () => (_jsx("div", { className: "desk-window-status", role: "status", children: "Loading\u2026" }));
+const defaultFailed = (_id, error, reload) => (_jsxs("div", { className: "desk-window-status", role: "alert", children: [_jsx("b", { children: "This window could not open" }), _jsx("span", { className: "desk-window-status-detail", children: error.message }), _jsx(Button, { size: "small", onClick: reload, children: "Reload" })] }));
+class WindowErrorBoundary extends Component {
+    state = { error: null, attempt: 0 };
+    static getDerivedStateFromError(error) {
+        return { error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    componentDidCatch(error, info) {
+        // Still reported: a window that cannot open is a bug somebody should hear about.
+        console.error(`desk: window "${this.props.id}" could not open`, error, info.componentStack);
+    }
+    reload = () => this.setState(state => ({ error: null, attempt: state.attempt + 1 }));
+    render() {
+        const { error, attempt } = this.state;
+        if (error)
+            return (this.props.failed ?? defaultFailed)(this.props.id, error, this.reload);
+        // A fresh key remounts the content, so a reload really starts again.
+        return (_jsx(AttemptContext.Provider, { value: attempt, children: this.props.children }, attempt));
+    }
+}
+export function WindowBoundary({ id, loading, failed, children, }) {
+    return (_jsx(WindowErrorBoundary, { id: id, failed: failed, children: _jsx(Suspense, { fallback: (loading ?? defaultLoading)(id), children: children }) }));
+}
+/**
+ * A window whose code loads when it is first opened.
+ *
+ *   const RoutePlanner = lazyWindow(() => import('./apps/RoutePlanner'))
+ *
+ * Unlike `React.lazy`, a load that fails is not remembered: Reload in the window
+ * tries the import again, so a dropped connection is not permanent.
+ */
+export function lazyWindow(load) {
+    const byAttempt = new Map();
+    function LazyWindow(props) {
+        const attempt = useContext(AttemptContext);
+        let Loaded = byAttempt.get(attempt);
+        if (!Loaded) {
+            Loaded = lazy(load);
+            byAttempt.set(attempt, Loaded);
+        }
+        return _jsx(Loaded, { ...props });
+    }
+    return LazyWindow;
+}
+//# sourceMappingURL=windowBoundary.js.map

package/dist/react/windowBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windowBoundary.js","sourceRoot":"","sources":["../../src/react/windowBoundary.tsx"],"names":[],"mappings":"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"}

package/dist/react/wizard.d.ts

@@ -0,0 +1,41 @@
+import type { ReactNode } from 'react';
+export interface WizardStep {
+    readonly id: string;
+    /** Named in the progress row, and announced as the step changes. */
+    readonly name: string;
+    readonly title: ReactNode;
+    readonly description?: ReactNode;
+    readonly body?: ReactNode;
+    /** Above the title. */
+    readonly glyph?: ReactNode;
+    /** Continue is offered only when this is true. Default: always. */
+    readonly complete?: boolean;
+    /** Replaces Continue's label on this step. */
+    readonly continueLabel?: string;
+    /** A quiet way past this step: "Set up later". */
+    readonly skip?: {
+        readonly label: string;
+        readonly onSkip: () => void;
+    };
+    /** Nothing to do but wait: no Back, and Continue waits for `complete`. */
+    readonly working?: boolean;
+    readonly onEnter?: () => void;
+    /**
+     * Work Continue does before moving on: create the account, check the key, download the maps.
+     * While it runs, Continue says so and nothing can be pressed twice. Throw to stay on the step
+     * and show why, in the step; return `false` to stay without a message.
+     */
+    readonly onContinue?: () => unknown;
+    /** Continue's label while `onContinue` runs. Default: "Working…". */
+    readonly busyLabel?: string;
+}
+export interface WizardProps {
+    readonly steps: readonly WizardStep[];
+    readonly index: number;
+    readonly onIndexChange: (index: number) => void;
+    readonly onFinish: () => void;
+    readonly label?: string;
+    readonly className?: string;
+}
+export declare function Wizard({ steps, index, onIndexChange, onFinish, label, className }: WizardProps): import("react").JSX.Element | null;
+//# sourceMappingURL=wizard.d.ts.map

package/dist/react/wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.d.ts","sourceRoot":"","sources":["../../src/react/wizard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAYtC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,CAAA;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAA;IACzB,uBAAuB;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,CAAA;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;KAAE,CAAA;IACvE,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,OAAO,CAAA;IACnC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAA;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAA;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAgB,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAe,EAAE,SAAS,EAAE,EAAE,WAAW,sCAmGxG"}

package/dist/react/wizard.js

@@ -0,0 +1,60 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
+import { Button } from './controls.js';
+export function Wizard({ steps, index, onIndexChange, onFinish, label = 'Setup', className }) {
+    const step = steps[index];
+    const [direction, setDirection] = useState('forward');
+    const previous = useRef(index);
+    const heading = useRef(null);
+    const entered = useRef(undefined);
+    entered.current = step?.onEnter;
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState(null);
+    // The step a running `onContinue` belongs to: if the person has gone back meanwhile, its result is stale.
+    const running = useRef(null);
+    // Only when the step changes: a step whose body has a field re-renders on every
+    // keystroke, and moving focus to the heading then would eat what was being typed.
+    useEffect(() => {
+        setDirection(index >= previous.current ? 'forward' : 'back');
+        setBusy(false);
+        setError(null);
+        running.current = null;
+        previous.current = index;
+        entered.current?.();
+        // Focus the new step's heading, so a screen reader announces it and the
+        // keyboard starts at the top of the pane rather than back at the buttons.
+        heading.current?.focus();
+    }, [index]);
+    if (!step)
+        return null;
+    const last = index === steps.length - 1;
+    const canContinue = step.complete ?? true;
+    const go = (to) => (to >= steps.length ? onFinish() : onIndexChange(Math.max(0, to)));
+    const next = async () => {
+        if (!step.onContinue)
+            return go(index + 1);
+        if (running.current !== null)
+            return;
+        running.current = index;
+        setBusy(true);
+        setError(null);
+        try {
+            const result = await step.onContinue();
+            if (running.current !== index)
+                return;
+            running.current = null;
+            setBusy(false);
+            if (result !== false)
+                go(index + 1);
+        }
+        catch (failure) {
+            if (running.current !== index)
+                return;
+            running.current = null;
+            setBusy(false);
+            setError(failure instanceof Error ? failure.message : String(failure));
+        }
+    };
+    return (_jsxs("section", { className: ['desk-wizard', className].filter(Boolean).join(' '), "aria-label": label, children: [_jsxs("div", { className: "desk-wizard-content", "data-direction": direction, children: [step.glyph && _jsx("div", { className: "desk-wizard-glyph", "aria-hidden": "true", children: step.glyph }), _jsx("h1", { ref: heading, tabIndex: -1, className: "desk-wizard-title", children: step.title }), step.description && _jsx("p", { className: "desk-wizard-description", children: step.description }), step.body, error && (_jsx("p", { className: "desk-wizard-error", role: "alert", children: error }))] }, step.id), _jsxs("footer", { className: "desk-wizard-foot", children: [_jsx("ol", { className: "desk-wizard-steps", "aria-label": "Progress", children: steps.map((other, i) => (_jsx("li", { className: "desk-wizard-dot", "data-state": i === index ? 'now' : i < index ? 'done' : 'ahead', "aria-current": i === index ? 'step' : undefined, children: _jsx("span", { className: "desk-wizard-dot-name", children: other.name }) }, other.id))) }), _jsx("span", { className: "desk-wizard-step-name", "aria-live": "polite", children: step.name }), _jsxs("div", { className: "desk-wizard-actions", children: [step.skip && (_jsx(Button, { intent: "quiet", disabled: busy, onClick: step.skip.onSkip, children: step.skip.label })), index > 0 && !step.working && (_jsx(Button, { disabled: busy, onClick: () => go(index - 1), children: "Back" })), _jsx(Button, { intent: "default", disabled: !canContinue || busy, "aria-busy": busy || undefined, onClick: () => void next(), children: busy ? (step.busyLabel ?? 'Working…') : (step.continueLabel ?? (last ? 'Done' : 'Continue')) })] })] })] }));
+}
+//# sourceMappingURL=wizard.js.map

package/dist/react/wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wizard.js","sourceRoot":"","sources":["../../src/react/wizard.tsx"],"names":[],"mappings":"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"}