@appinternalleads/ui 0.2.0

package/dist/esm/components/checklist/engine.js

@@ -0,0 +1,288 @@
+import { CAPABILITY_FOR_CHANGE, findSection, findTask, } from './contract';
+import { evaluateCondition, gateMessage, progressOf, unsatisfiedGates } from './derive';
+const fail = (reason, message) => ({ ok: false, reason, message });
+/**
+ * **One spelling per fact.** `skipped: false`, `description: ''` and `required: true` are each a
+ * second way of writing what the absent key already says, and a document with two spellings cannot
+ * have exact inverses: apply-then-undo would leave a key behind that was never there.
+ *
+ * So the optional fields are canonicalised on every write, and the round-trip test in
+ * `tests/checklistEngine.test.ts` is what holds the rule — it is the test that found this.
+ */
+export function normalizeTask(task) {
+    const out = { ...task };
+    if (out.skipped !== true)
+        delete out.skipped;
+    if (out.description === undefined || out.description === '')
+        delete out.description;
+    if (out.required !== false)
+        delete out.required;
+    return out;
+}
+/**
+ * The same canonicalisation, one level up. A section with `title: ''` is the *ungrouped* section,
+ * which the document spells by **omitting** the key; a checklist with `description: ''` has no
+ * description. Exported because generation must canonicalise a document that was seeded or
+ * hand-authored rather than built up through `applyChange`.
+ */
+export function normalizeSection(section) {
+    const out = { ...section, tasks: section.tasks.map(normalizeTask) };
+    if (out.title === undefined || out.title.trim() === '')
+        delete out.title;
+    return out;
+}
+export function normalizeChecklist(checklist) {
+    const out = { ...checklist, sections: checklist.sections.map(normalizeSection) };
+    if (out.description === undefined || out.description.trim() === '')
+        delete out.description;
+    return out;
+}
+/** The whole portable artefact, canonical. Rules lose an empty `label`/`if` for the same reason. */
+export function normalizeChecklistDocument(doc) {
+    return {
+        ...doc,
+        checklist: normalizeChecklist(doc.checklist),
+        rules: doc.rules.map(r => {
+            const out = { ...r };
+            if (out.label === undefined || out.label.trim() === '')
+                delete out.label;
+            if (out.kind === 'notify' && Array.isArray(out.if) && out.if.length === 0)
+                delete out.if;
+            return out;
+        }),
+    };
+}
+/** Structural clone of the containment tree. Small, and it keeps `next` free of shared references. */
+const cloneSections = (sections) => sections.map(s => ({ ...s, tasks: s.tasks.map(t => ({ ...t })) }));
+function withTask(doc, taskId, edit) {
+    return {
+        ...doc,
+        sections: doc.sections.map(s => ({
+            ...s,
+            tasks: s.tasks.map(t => (t.id === taskId ? normalizeTask(edit({ ...t })) : t)),
+        })),
+    };
+}
+/**
+ * Which notify rules the transition from `before` to `after` fired, as resolved effects.
+ *
+ * The event set is deliberately four (`CHECKLIST_EVENTS`): each is something the *document*
+ * observably became, never something the runtime did. `sharedWith` recipients are left empty here
+ * on purpose — the pure engine resolves what the **document** knows, and the runtime completes
+ * what the **session** knows before the host is called.
+ */
+function effectsFor(before, after, change, rules) {
+    const fired = [];
+    if (change.kind === 'task.complete') {
+        const was = findTask(before, change.taskId)?.task;
+        const now = findTask(after, change.taskId)?.task;
+        if (now && was && was.done !== now.done) {
+            fired.push({ event: now.done ? 'task.completed' : 'task.uncompleted', task: now });
+        }
+    }
+    if (change.kind === 'task.assign') {
+        const now = findTask(after, change.taskId)?.task;
+        const was = findTask(before, change.taskId)?.task;
+        if (now && now.assigneeId && now.assigneeId !== was?.assigneeId) {
+            fired.push({ event: 'task.assigned', task: now });
+        }
+    }
+    /* Checklist completion is a DERIVATION crossing a threshold, not a stored flag being written —
+       which is why it is computed from both documents rather than read off either. */
+    if (!progressOf(before).complete && progressOf(after).complete) {
+        fired.push({ event: 'checklist.completed' });
+    }
+    const effects = [];
+    for (const rule of rules) {
+        if (rule.kind !== 'notify')
+            continue;
+        for (const f of fired) {
+            if (rule.when !== f.event)
+                continue;
+            if ((rule.if ?? []).some(c => !evaluateCondition(c, after)))
+                continue;
+            const recipients = rule.to === 'assignee'
+                ? [f.task?.assigneeId].filter((x) => !!x)
+                : [];
+            effects.push({
+                id: `${change.id}:${rule.id}`,
+                kind: 'notify',
+                ruleId: rule.id,
+                channel: rule.channel,
+                audience: rule.to,
+                recipients,
+                event: f.event,
+                checklist: { id: after.id, title: after.title },
+                task: f.task ? { id: f.task.id, title: f.task.title } : undefined,
+            });
+        }
+    }
+    return effects;
+}
+/** The inverse's id: a distinct, derived, deterministic id so a rollback is visible as its own row. */
+const inverseId = (change) => `${change.id}~undo`;
+export function applyChange(doc, change, rules = [], opts = {}) {
+    const can = opts.config?.can;
+    if (can && can[CAPABILITY_FOR_CHANGE[change.kind]] === false) {
+        return fail('not-permitted', 'That is not something this checklist allows');
+    }
+    const ok = (next, inverseBody) => {
+        const inverse = { ...inverseBody, id: inverseId(change), author: change.author };
+        return { ok: true, next, inverse, effects: effectsFor(doc, next, change, rules) };
+    };
+    switch (change.kind) {
+        case 'checklist.edit': {
+            /* `checklist/1` requires a title (`minLength: 1`), so emptying it is refused rather than
+               written and caught later at generation — the document should never hold a value it is
+               not allowed to hold. */
+            if (change.title !== undefined && change.title.trim() === '') {
+                return fail('empty-value', 'A checklist needs a title');
+            }
+            const before = doc;
+            const next = normalizeChecklist({
+                ...doc,
+                title: change.title ?? doc.title,
+                description: change.description ?? doc.description,
+            });
+            /* Same rule as `task.edit`: the inverse names exactly the fields the change named. */
+            return ok(next, {
+                kind: 'checklist.edit',
+                ...(change.title !== undefined ? { title: before.title } : {}),
+                ...(change.description !== undefined ? { description: before.description ?? '' } : {}),
+            });
+        }
+        case 'task.complete': {
+            const found = findTask(doc, change.taskId);
+            if (!found)
+                return fail('unknown-task', 'That task is no longer on this checklist');
+            /* **Gates evaluate here, synchronously, before anything is attempted.** They are pure
+               functions of the document, so they need no round trip — and blocking a tick *after* an
+               operation had been sent would be a worse experience for no gain (§6). Only becoming done
+               is gated; un-ticking is always allowed, because a gate governs the transition INTO done. */
+            if (change.done) {
+                const blocked = unsatisfiedGates(change.taskId, doc, rules);
+                if (blocked.length)
+                    return fail('blocked', gateMessage(blocked[0], doc));
+            }
+            if (found.task.done === change.done) {
+                return ok(doc, { kind: 'task.complete', taskId: change.taskId, done: change.done });
+            }
+            /* Completing clears `skipped`: "done" and "not applicable" cannot both be true. The inverse
+               restores the prior skipped value, so a rollback is exact rather than approximately right. */
+            const next = withTask(doc, change.taskId, t => ({ ...t, done: change.done, skipped: change.done ? false : t.skipped }));
+            /* Disclosed rather than silently lost: un-ticking returns a task to OPEN, not to skipped.
+               One inverse restores one fact, and `done` is the fact this change asserted. */
+            return ok(next, { kind: 'task.complete', taskId: change.taskId, done: found.task.done });
+        }
+        case 'task.skip': {
+            const found = findTask(doc, change.taskId);
+            if (!found)
+                return fail('unknown-task', 'That task is no longer on this checklist');
+            const next = withTask(doc, change.taskId, t => ({ ...t, skipped: change.skipped, done: change.skipped ? false : t.done }));
+            return ok(next, { kind: 'task.skip', taskId: change.taskId, skipped: found.task.skipped === true });
+        }
+        case 'task.edit': {
+            const found = findTask(doc, change.taskId);
+            if (!found)
+                return fail('unknown-task', 'That task is no longer on this checklist');
+            const before = found.task;
+            const next = withTask(doc, change.taskId, t => ({
+                ...t,
+                title: change.title ?? t.title,
+                description: change.description ?? t.description,
+                required: change.required ?? t.required,
+            }));
+            /* The inverse names exactly the fields the change named — an inverse that rewrote every
+               field would clobber a concurrent edit to a field this change never touched. */
+            return ok(next, {
+                kind: 'task.edit',
+                taskId: change.taskId,
+                ...(change.title !== undefined ? { title: before.title } : {}),
+                ...(change.description !== undefined ? { description: before.description ?? '' } : {}),
+                ...(change.required !== undefined ? { required: before.required !== false } : {}),
+            });
+        }
+        case 'task.assign': {
+            const found = findTask(doc, change.taskId);
+            if (!found)
+                return fail('unknown-task', 'That task is no longer on this checklist');
+            const before = found.task.assigneeId ?? null;
+            const next = withTask(doc, change.taskId, t => {
+                const copy = { ...t };
+                if (change.assigneeId === null)
+                    delete copy.assigneeId;
+                else
+                    copy.assigneeId = change.assigneeId;
+                return copy;
+            });
+            return ok(next, { kind: 'task.assign', taskId: change.taskId, assigneeId: before });
+        }
+        case 'task.add': {
+            if (!findSection(doc, change.sectionId))
+                return fail('unknown-section', 'That section is no longer on this checklist');
+            const sections = cloneSections(doc.sections);
+            const section = sections.find(s => s.id === change.sectionId);
+            const index = Math.max(0, Math.min(change.index, section.tasks.length));
+            section.tasks.splice(index, 0, normalizeTask(change.task));
+            return ok({ ...doc, sections }, { kind: 'task.delete', taskId: change.task.id });
+        }
+        case 'task.delete': {
+            const found = findTask(doc, change.taskId);
+            if (!found)
+                return fail('unknown-task', 'That task is no longer on this checklist');
+            const sections = cloneSections(doc.sections);
+            const section = sections.find(s => s.id === found.section.id);
+            section.tasks.splice(found.taskIndex, 1);
+            /* The inverse carries the whole task back, at the same index — which is why `task.add`
+               takes a task and an index rather than a title. */
+            return ok({ ...doc, sections }, { kind: 'task.add', sectionId: found.section.id, index: found.taskIndex, task: { ...found.task } });
+        }
+        case 'task.move': {
+            const found = findTask(doc, change.taskId);
+            if (!found)
+                return fail('unknown-task', 'That task is no longer on this checklist');
+            if (!findSection(doc, change.toSectionId))
+                return fail('unknown-section', 'That section is no longer on this checklist');
+            const sections = cloneSections(doc.sections);
+            const from = sections.find(s => s.id === found.section.id);
+            const [moved] = from.tasks.splice(found.taskIndex, 1);
+            const to = sections.find(s => s.id === change.toSectionId);
+            const index = Math.max(0, Math.min(change.toIndex, to.tasks.length));
+            to.tasks.splice(index, 0, moved);
+            return ok({ ...doc, sections }, { kind: 'task.move', taskId: change.taskId, toSectionId: found.section.id, toIndex: found.taskIndex });
+        }
+        case 'section.add': {
+            const sections = cloneSections(doc.sections);
+            const index = Math.max(0, Math.min(change.index, sections.length));
+            sections.splice(index, 0, { ...change.section, tasks: change.section.tasks.map(normalizeTask) });
+            return ok({ ...doc, sections }, { kind: 'section.delete', sectionId: change.section.id });
+        }
+        case 'section.edit': {
+            const section = findSection(doc, change.sectionId);
+            if (!section)
+                return fail('unknown-section', 'That section is no longer on this checklist');
+            const next = { ...doc, sections: doc.sections.map(s => (s.id === change.sectionId ? { ...s, title: change.title } : s)) };
+            return ok(next, { kind: 'section.edit', sectionId: change.sectionId, title: section.title ?? '' });
+        }
+        case 'section.delete': {
+            const index = doc.sections.findIndex(s => s.id === change.sectionId);
+            if (index < 0)
+                return fail('unknown-section', 'That section is no longer on this checklist');
+            const removed = doc.sections[index];
+            const sections = cloneSections(doc.sections);
+            sections.splice(index, 1);
+            return ok({ ...doc, sections }, { kind: 'section.add', index, section: { ...removed, tasks: removed.tasks.map(normalizeTask) } });
+        }
+        case 'section.move': {
+            const index = doc.sections.findIndex(s => s.id === change.sectionId);
+            if (index < 0)
+                return fail('unknown-section', 'That section is no longer on this checklist');
+            const sections = cloneSections(doc.sections);
+            const [moved] = sections.splice(index, 1);
+            const to = Math.max(0, Math.min(change.toIndex, sections.length));
+            sections.splice(to, 0, moved);
+            return ok({ ...doc, sections }, { kind: 'section.move', sectionId: change.sectionId, toIndex: index });
+        }
+    }
+}
+//# sourceMappingURL=engine.js.map

package/dist/esm/components/checklist/engine.js.map

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

package/dist/esm/components/checklist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * **Checklist — the second component family.** A piece of shared, durable work.
+ *
+ * ```
+ * ChecklistDocument  =  checklist  +  config  +  rules      the portable contract (§14)
+ *          ↓
+ * useChecklistRuntime                                        optimistic, concurrent, reversible (§7)
+ *          ↓
+ * ChecklistView                                              renders it and nothing else (§3)
+ *          ↓
+ * ChecklistChange  →  applyChange  →  next + inverse + effects    the one place a document mutates
+ *          ↓
+ * ChecklistOperations                                        the host's half: commit / share / notify
+ * ```
+ *
+ * The design is `docs/components/checklist/CHECKLIST-DESIGN.md`; every section reference in this
+ * package points into it. The write-side runtime it stands on is `src/runtime/operations`.
+ */
+export { ChecklistView, type ChecklistViewProps } from './ChecklistView';
+export { defaultChecklistConfig, validateChecklistConfig, validateChecklistRule, validateChecklistRules, hasGateCycle, findTask, findSection, allTasks, CHECKLIST_EVENTS, CHECKLIST_CHANGE_KINDS, CAPABILITY_FOR_CHANGE, OPERATORS_BY_FIELD, TASK_FIELDS, SECTION_FIELDS, type Checklist, type ChecklistSection, type ChecklistTask, type ChecklistDocument, type ChecklistConfig, type ChecklistProgressMode, type ChecklistSectionMode, type ChecklistAssigneeMode, type ChecklistRule, type ChecklistGateRule, type ChecklistNotifyRule, type ChecklistCondition, type ChecklistEvent, type ChecklistTaskField, type ChecklistSectionField, type ChecklistChange, type ChecklistChangeBody, type ChecklistChangeKind, type ChecklistEffect, type ChecklistOperations, type ChecklistCapabilities, type AssigneeId, type Person, type PeopleAdapter, type ShareRequest, type ShareResult, type NotificationRequest, type NotificationTrigger, type ChecklistRuleRejection, type ChecklistRuleCheck, } from './contract';
+export { progressOf, sectionProgressOf, taskViewOf, evaluateCondition, unsatisfiedGates, gateMessage, isRequired, isDone, type TaskView, type ChecklistProgress, } from './derive';
+export { applyChange, normalizeTask, normalizeSection, normalizeChecklist, normalizeChecklistDocument, type ChangeResult, type ChangeRejection, type ApplyChangeOptions, } from './engine';
+export { processChecklistDocument, blankChecklist, type ProcessResult, type ProcessIssue, type ProcessIssueStage, } from './process';
+export { useChecklistRuntime, SLOW_THRESHOLD_MS, type ChecklistRuntime, type ChecklistRuntimeState, type ChecklistRuntimeOptions, type PendingChange, type EffectRecord, type RejectedRule, type ShareState, } from './runtime';
+export { createMockChecklistOperations, createMockPeopleAdapter, CHECKLIST_LATENCY, MOCK_PEOPLE, type MockChecklistOperationsOptions, type ChecklistLatencyPreset, } from './mock';
+export { CHECKLIST_CASE_STUDIES, type ChecklistCaseStudy } from './cases';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/components/checklist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/checklist/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EACL,sBAAsB,EAAE,uBAAuB,EAC/C,qBAAqB,EAAE,sBAAsB,EAAE,YAAY,EAC3D,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAC/B,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,kBAAkB,EACnF,WAAW,EAAE,cAAc,EAC3B,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,iBAAiB,EACjF,KAAK,eAAe,EAAE,KAAK,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EACvG,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAC7F,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,KAAK,qBAAqB,EACxE,KAAK,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAC9F,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EACpD,KAAK,UAAU,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAChD,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EACvF,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,GACrD,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAC3F,UAAU,EAAE,MAAM,EAClB,KAAK,QAAQ,EAAE,KAAK,iBAAiB,GACtC,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,0BAA0B,EAC5F,KAAK,YAAY,EAAE,KAAK,eAAe,EAAE,KAAK,kBAAkB,GACjE,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,wBAAwB,EAAE,cAAc,EACxC,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,iBAAiB,GAC9D,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EAAE,iBAAiB,EACtC,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,KAAK,uBAAuB,EAC/E,KAAK,aAAa,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,GAC1E,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,6BAA6B,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,WAAW,EACtF,KAAK,8BAA8B,EAAE,KAAK,sBAAsB,GACjE,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC"}

package/dist/esm/components/checklist/index.js

@@ -0,0 +1,27 @@
+/**
+ * **Checklist — the second component family.** A piece of shared, durable work.
+ *
+ * ```
+ * ChecklistDocument  =  checklist  +  config  +  rules      the portable contract (§14)
+ *          ↓
+ * useChecklistRuntime                                        optimistic, concurrent, reversible (§7)
+ *          ↓
+ * ChecklistView                                              renders it and nothing else (§3)
+ *          ↓
+ * ChecklistChange  →  applyChange  →  next + inverse + effects    the one place a document mutates
+ *          ↓
+ * ChecklistOperations                                        the host's half: commit / share / notify
+ * ```
+ *
+ * The design is `docs/components/checklist/CHECKLIST-DESIGN.md`; every section reference in this
+ * package points into it. The write-side runtime it stands on is `src/runtime/operations`.
+ */
+export { ChecklistView } from './ChecklistView';
+export { defaultChecklistConfig, validateChecklistConfig, validateChecklistRule, validateChecklistRules, hasGateCycle, findTask, findSection, allTasks, CHECKLIST_EVENTS, CHECKLIST_CHANGE_KINDS, CAPABILITY_FOR_CHANGE, OPERATORS_BY_FIELD, TASK_FIELDS, SECTION_FIELDS, } from './contract';
+export { progressOf, sectionProgressOf, taskViewOf, evaluateCondition, unsatisfiedGates, gateMessage, isRequired, isDone, } from './derive';
+export { applyChange, normalizeTask, normalizeSection, normalizeChecklist, normalizeChecklistDocument, } from './engine';
+export { processChecklistDocument, blankChecklist, } from './process';
+export { useChecklistRuntime, SLOW_THRESHOLD_MS, } from './runtime';
+export { createMockChecklistOperations, createMockPeopleAdapter, CHECKLIST_LATENCY, MOCK_PEOPLE, } from './mock';
+export { CHECKLIST_CASE_STUDIES } from './cases';
+//# sourceMappingURL=index.js.map

package/dist/esm/components/checklist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/components/checklist/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,aAAa,EAA2B,MAAM,iBAAiB,CAAC;AAEzE,OAAO,EACL,sBAAsB,EAAE,uBAAuB,EAC/C,qBAAqB,EAAE,sBAAsB,EAAE,YAAY,EAC3D,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAC/B,gBAAgB,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,kBAAkB,EACnF,WAAW,EAAE,cAAc,GAU5B,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,WAAW,EAC3F,UAAU,EAAE,MAAM,GAEnB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,0BAA0B,GAE7F,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,wBAAwB,EAAE,cAAc,GAEzC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,mBAAmB,EAAE,iBAAiB,GAGvC,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,6BAA6B,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,WAAW,GAEvF,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,sBAAsB,EAA2B,MAAM,SAAS,CAAC"}

package/dist/esm/components/checklist/mock.d.ts

@@ -0,0 +1,59 @@
+import type { ChecklistChange, ChecklistOperations, NotificationRequest, Person, PeopleAdapter, ShareRequest } from './contract';
+/**
+ * **The deterministic mock runtime — §12.**
+ *
+ * The constraint is inherited, not invented: `createMockAdapter` (`src/runtime/query`) and
+ * `createMockUploadOperations` (`src/widgets/fileUploadEngine.ts`) both take latency as a
+ * value-or-function-of-call-index and failure as a predicate, and both explicitly avoid
+ * `Math.random` and `Date.now`. A test that can make call 1 slower than call 2 can *prove* race
+ * safety; a random one can only prove it usually.
+ *
+ * **Every timer in the Checklist family lives in this file.** There is no `setTimeout` in
+ * `ChecklistView`, no `await` in an event handler and no failure branch in a row component. A UI
+ * component's only relationship with latency is reading a status off the runtime.
+ *
+ * Nothing here sends anything. `notify` records what *would* have been sent and resolves.
+ */
+/**
+ * The three presets, chosen for what each one lets a reviewer *see* rather than for realism:
+ *
+ * - `fast` lands inside the no-spinner window (§16's 500 ms), so a quick tick shows no machinery.
+ * - `normal` crosses it, so the quiet activity indicator appears.
+ * - `slow` is long enough to tick a second task while the first is still in flight — the
+ *   concurrency property that distinguishes this runtime from a query machine.
+ */
+export declare const CHECKLIST_LATENCY: {
+    readonly fast: 120;
+    readonly normal: 450;
+    readonly slow: 1600;
+};
+export type ChecklistLatencyPreset = keyof typeof CHECKLIST_LATENCY;
+export type MockChecklistOperationsOptions = {
+    /** Fixed, or a function of the change and the 0-based call index. Default 0. */
+    latencyMs?: number | ((change: ChecklistChange, callIndex: number) => number);
+    /** Deterministic failure injection — by change kind, by call index, by any predicate. */
+    failWhen?: (change: ChecklistChange, callIndex: number) => boolean;
+    failShare?: (req: ShareRequest, callIndex: number) => boolean;
+    failNotify?: (req: NotificationRequest, callIndex: number) => boolean;
+    /** Latency for the two boundary operations, when they should differ from `latencyMs`. */
+    shareLatencyMs?: number | ((req: ShareRequest, callIndex: number) => number);
+    notifyLatencyMs?: number | ((req: NotificationRequest, callIndex: number) => number);
+    /** Everything the mock "sent", for the Playground inspector and for assertions. */
+    onCall?: (op: 'commit' | 'share' | 'notify', payload: unknown, callIndex: number) => void;
+};
+export declare function createMockChecklistOperations(opts?: MockChecklistOperationsOptions): ChecklistOperations;
+/**
+ * Deterministic mock people. Generic names on purpose — there is not one real team member here,
+ * for the same reason there is not one column name in `src/components/directory/`.
+ */
+export declare const MOCK_PEOPLE: Person[];
+export type MockPeopleAdapterOptions = {
+    latencyMs?: number | ((q: string, callIndex: number) => number);
+};
+/**
+ * The host's half of assignment, mocked. `resolve` returns only the ids it actually has — an id it
+ * does not know is **absent from the result**, not invented, which is what lets the component draw
+ * the difference between "nobody is on this" and "somebody is, and we do not know who" (§9).
+ */
+export declare function createMockPeopleAdapter(people?: Person[], opts?: MockPeopleAdapterOptions): PeopleAdapter;
+//# sourceMappingURL=mock.d.ts.map

package/dist/esm/components/checklist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../../src/components/checklist/mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAChF,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB;;;;CAAkD,CAAC;AACjF,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEpE,MAAM,MAAM,8BAA8B,GAAG;IAC3C,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC9E,yFAAyF;IACzF,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACnE,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IAC9D,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACtE,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC7E,eAAe,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACrF,mFAAmF;IACnF,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3F,CAAC;AAMF,wBAAgB,6BAA6B,CAAC,IAAI,GAAE,8BAAmC,GAAG,mBAAmB,CA4B5G;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,EAS/B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;CACjE,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,GAAE,MAAM,EAAgB,EAC9B,IAAI,GAAE,wBAA6B,GAClC,aAAa,CAiBf"}

package/dist/esm/components/checklist/mock.js

@@ -0,0 +1,96 @@
+import { abortableDelay, resolveLatency } from '../../runtime/operations';
+/**
+ * **The deterministic mock runtime — §12.**
+ *
+ * The constraint is inherited, not invented: `createMockAdapter` (`src/runtime/query`) and
+ * `createMockUploadOperations` (`src/widgets/fileUploadEngine.ts`) both take latency as a
+ * value-or-function-of-call-index and failure as a predicate, and both explicitly avoid
+ * `Math.random` and `Date.now`. A test that can make call 1 slower than call 2 can *prove* race
+ * safety; a random one can only prove it usually.
+ *
+ * **Every timer in the Checklist family lives in this file.** There is no `setTimeout` in
+ * `ChecklistView`, no `await` in an event handler and no failure branch in a row component. A UI
+ * component's only relationship with latency is reading a status off the runtime.
+ *
+ * Nothing here sends anything. `notify` records what *would* have been sent and resolves.
+ */
+/**
+ * The three presets, chosen for what each one lets a reviewer *see* rather than for realism:
+ *
+ * - `fast` lands inside the no-spinner window (§16's 500 ms), so a quick tick shows no machinery.
+ * - `normal` crosses it, so the quiet activity indicator appears.
+ * - `slow` is long enough to tick a second task while the first is still in flight — the
+ *   concurrency property that distinguishes this runtime from a query machine.
+ */
+export const CHECKLIST_LATENCY = { fast: 120, normal: 450, slow: 1600 };
+const COMMIT_FAILED = 'The change was not saved';
+const SHARE_FAILED = 'The checklist was not shared';
+const NOTIFY_FAILED = 'The notification was not sent';
+export function createMockChecklistOperations(opts = {}) {
+    let commits = 0;
+    let shares = 0;
+    let notifies = 0;
+    return {
+        commit: async (change, { signal }) => {
+            const callIndex = commits++;
+            opts.onCall?.('commit', change, callIndex);
+            await abortableDelay(resolveLatency(opts.latencyMs, change, callIndex), signal);
+            if (opts.failWhen?.(change, callIndex))
+                throw new Error(COMMIT_FAILED);
+        },
+        share: async (req, { signal }) => {
+            const callIndex = shares++;
+            opts.onCall?.('share', req, callIndex);
+            await abortableDelay(resolveLatency(opts.shareLatencyMs ?? 0, req, callIndex), signal);
+            if (opts.failShare?.(req, callIndex))
+                throw new Error(SHARE_FAILED);
+            /* No `url`: this mock writes no link, and inventing one would suggest the component had
+               decided what a share *is*. A host that mints links returns one; this one does not. */
+            return { sharedWith: req.recipients };
+        },
+        notify: async (req, { signal }) => {
+            const callIndex = notifies++;
+            opts.onCall?.('notify', req, callIndex);
+            await abortableDelay(resolveLatency(opts.notifyLatencyMs ?? 0, req, callIndex), signal);
+            if (opts.failNotify?.(req, callIndex))
+                throw new Error(NOTIFY_FAILED);
+        },
+    };
+}
+/**
+ * Deterministic mock people. Generic names on purpose — there is not one real team member here,
+ * for the same reason there is not one column name in `src/components/directory/`.
+ */
+export const MOCK_PEOPLE = [
+    { id: 'p-ana', name: 'Ana', initials: 'A', email: 'ana@example.test' },
+    { id: 'p-ben', name: 'Ben', initials: 'B', email: 'ben@example.test' },
+    { id: 'p-chi', name: 'Chi', initials: 'C', email: 'chi@example.test' },
+    { id: 'p-dev', name: 'Dev', initials: 'D', email: 'dev@example.test' },
+    { id: 'p-eli', name: 'Eli', initials: 'E', email: 'eli@example.test' },
+    { id: 'p-fay', name: 'Fay', initials: 'F', email: 'fay@example.test' },
+    { id: 'p-gus', name: 'Gus', initials: 'G', email: 'gus@example.test' },
+    { id: 'p-hana', name: 'Hana', initials: 'H', email: 'hana@example.test' },
+];
+/**
+ * The host's half of assignment, mocked. `resolve` returns only the ids it actually has — an id it
+ * does not know is **absent from the result**, not invented, which is what lets the component draw
+ * the difference between "nobody is on this" and "somebody is, and we do not know who" (§9).
+ */
+export function createMockPeopleAdapter(people = MOCK_PEOPLE, opts = {}) {
+    let calls = 0;
+    const wait = (q, signal) => abortableDelay(resolveLatency(opts.latencyMs, q, calls++), signal);
+    return {
+        resolve: async (ids, { signal }) => {
+            await wait(ids.join(','), signal);
+            return people.filter(p => ids.includes(p.id));
+        },
+        search: async (q, { signal }) => {
+            await wait(q, signal);
+            const needle = q.trim().toLowerCase();
+            if (!needle)
+                return people;
+            return people.filter(p => p.name.toLowerCase().includes(needle) || p.id.toLowerCase().includes(needle));
+        },
+    };
+}
+//# sourceMappingURL=mock.js.map

package/dist/esm/components/checklist/mock.js.map

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

package/dist/esm/components/checklist/process.d.ts

@@ -0,0 +1,53 @@
+import { type Checklist, type ChecklistCapabilities, type ChecklistDocument } from './contract';
+/**
+ * **The processing pipeline — Phase 2's centre.**
+ *
+ * ```
+ * builder state  →  candidate  →  normalize  →  validate  →  canonical ChecklistDocument
+ *                                                   │
+ *                                                   └─ invalid ⇒ issues, and NO document
+ * ```
+ *
+ * Pure: no React, no state, no clock. It **orchestrates the existing validators rather than
+ * duplicating them** — `validateChecklistConfig` and `validateChecklistRules` are called as-is,
+ * and the only checks added here are the document-shape ones neither of them owns (a title, and
+ * unique ids).
+ *
+ * The one hard guarantee: **an invalid candidate never produces a document.** `ok: false` carries
+ * issues and nothing else, so a caller cannot accidentally treat a rejected candidate as
+ * generated.
+ */
+export type ProcessIssueStage = 'document' | 'config' | 'rules';
+export type ProcessIssue = {
+    stage: ProcessIssueStage;
+    /** Plain language, addressed to the person creating the checklist. Never a code or a stack. */
+    message: string;
+};
+export type ProcessResult = 
+/** `document` is normalised and valid. It is the artefact to export or hand to a host. */
+{
+    ok: true;
+    normalized: ChecklistDocument;
+    document: ChecklistDocument;
+    issues: never[];
+}
+/** Normalisation still happened — the inspector can show it — but nothing was generated. */
+ | {
+    ok: false;
+    normalized: ChecklistDocument;
+    document: null;
+    issues: ProcessIssue[];
+};
+/**
+ * Normalise, then validate, then generate. The stages are separable on purpose: the Playground's
+ * inspector shows candidate → normalized → validated → generated, and each of those is a real
+ * value rather than a label.
+ */
+export declare function processChecklistDocument(candidate: ChecklistDocument, opts?: {
+    capabilities?: ChecklistCapabilities;
+}): ProcessResult;
+/** A blank, valid-shaped starting point: one untitled section, which is how `checklist/1` spells
+    "ungrouped". Deliberately **without** a title — naming it is the creator's first act, and the
+    processing pipeline says so until they do. */
+export declare function blankChecklist(id: string): Checklist;
+//# sourceMappingURL=process.d.ts.map

package/dist/esm/components/checklist/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/components/checklist/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EACnE,MAAM,YAAY,CAAC;AAGpB;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEhE,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,iBAAiB,CAAC;IACzB,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa;AACvB,0FAA0F;AACxF;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,KAAK,EAAE,CAAA;CAAE;AAC3F,4FAA4F;GAC1F;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC;AAoCzF;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,iBAAiB,EAC5B,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,qBAAqB,CAAA;CAAO,GAClD,aAAa,CAiBf;AAED;;iDAEiD;AACjD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAEpD"}