@things-factory/worklist 10.1.147 → 10.1.149

package/dist-client/components/decision-slots.d.ts

@@ -2,12 +2,15 @@
  * Turns an activity's decisionKeys declaration plus an instance's input into the slots a decision
  * screen draws.
  *
- * ── Nothing is imported ───────────────────────────────────────────────────
- * No lit, no i18next. The rule is a mapping from a declaration and a payload to an ordered list,
+ * ── Nothing heavy is imported ─────────────────────────────────────────────
+ * No lit, no i18next — only the pure reading of the input in `shared/decision-sentences`, which the
+ * server freezes sentences with. The rule is a mapping from a declaration and a payload to an ordered list,
  * and keeping it free of imports is what lets the test runner hold it: that runner parses
  * TypeScript by stripping types and reads neither decorators nor enums, so one heavy import takes
  * a whole test file down with it. Labels and markup are the caller's half.
  */
+import { valueAtPath } from '../../shared/decision-sentences.js';
+export { valueAtPath };
 /** The roles that may appear more than once. Every other role names one value. */
 export declare const REPEATABLE_ROLES: readonly ["consequence", "evidence"];
 /** Listed in the order the screen reads them: what is asked, then past, present, future. */
@@ -62,22 +65,6 @@ export type DecisionSlot = {
      */
     found: boolean;
 };
-/**
- * Reads a dotted path out of the input.
- *
- * Dots only. An array index or a wildcard is not part of the path language — drawing a list is the
- * slot's job — so 'shift.passes[0]' looks for a key spelled "passes[0]", finds nothing, and reports
- * found: false. The declaration guard refuses such a path when it arrives, so this is the second
- * line rather than the first.
- *
- * A path that runs into a non-object partway reports found: false rather than throwing. The screen
- * has to draw something either way, and a thrown error here would take the whole approval down over
- * one slot.
- */
-export declare function valueAtPath(input: any, path: string): {
-    value: unknown;
-    found: boolean;
-};
 /**
  * The slots to draw, in the order they were declared.
  *

package/dist-client/components/decision-slots.js

@@ -2,12 +2,16 @@
  * Turns an activity's decisionKeys declaration plus an instance's input into the slots a decision
  * screen draws.
  *
- * ── Nothing is imported ───────────────────────────────────────────────────
- * No lit, no i18next. The rule is a mapping from a declaration and a payload to an ordered list,
+ * ── Nothing heavy is imported ─────────────────────────────────────────────
+ * No lit, no i18next — only the pure reading of the input in `shared/decision-sentences`, which the
+ * server freezes sentences with. The rule is a mapping from a declaration and a payload to an ordered list,
  * and keeping it free of imports is what lets the test runner hold it: that runner parses
  * TypeScript by stripping types and reads neither decorators nor enums, so one heavy import takes
  * a whole test file down with it. Labels and markup are the caller's half.
  */
+import { paramsFrom, valueAtPath } from '../../shared/decision-sentences.js';
+/* The blanks are read the same way the server freezes them — one reading, in `shared/decision-sentences`. */
+export { valueAtPath };
 /** The roles that may appear more than once. Every other role names one value. */
 export const REPEATABLE_ROLES = ['consequence', 'evidence'];
 /** Listed in the order the screen reads them: what is asked, then past, present, future. */
@@ -20,37 +24,6 @@ export const DECISION_ROLES = [
     'currentState',
     'consequence'
 ];
-/**
- * Reads a dotted path out of the input.
- *
- * Dots only. An array index or a wildcard is not part of the path language — drawing a list is the
- * slot's job — so 'shift.passes[0]' looks for a key spelled "passes[0]", finds nothing, and reports
- * found: false. The declaration guard refuses such a path when it arrives, so this is the second
- * line rather than the first.
- *
- * A path that runs into a non-object partway reports found: false rather than throwing. The screen
- * has to draw something either way, and a thrown error here would take the whole approval down over
- * one slot.
- */
-export function valueAtPath(input, path) {
-    const steps = String(path ?? '')
-        .split('.')
-        .filter(step => step.length > 0);
-    if (!steps.length) {
-        return { value: undefined, found: false };
-    }
-    let at = input;
-    for (const step of steps) {
-        if (at === null || at === undefined || typeof at !== 'object') {
-            return { value: undefined, found: false };
-        }
-        if (!Object.prototype.hasOwnProperty.call(at, step)) {
-            return { value: undefined, found: false };
-        }
-        at = at[step];
-    }
-    return { value: at, found: true };
-}
 /**
  * The slots to draw, in the order they were declared.
  *
@@ -82,27 +55,6 @@ export function decisionSlots(decisionKeys, input) {
         };
     });
 }
-/**
- * Read the sentence's blanks out of the input.
- *
- * A path that leads nowhere lands as `undefined`, the same as a slot's own value — i18next prints
- * an empty blank rather than the word `undefined`, and the sentence still says the rest. Folding it
- * into an empty string here would hide which of the two it was from anyone looking later.
- *
- * Returns undefined when nothing was declared, so a slot without a sentence carries no empty object
- * for a reader to puzzle over.
- */
-function paramsFrom(declared, input) {
-    const names = Object.keys(declared || {});
-    if (!names.length) {
-        return undefined;
-    }
-    const read = {};
-    for (const name of names) {
-        read[name] = valueAtPath(input, String(declared[name] ?? '')).value;
-    }
-    return read;
-}
 /** The slots for one role, in declared order. Empty when the activity declared none. */
 export function slotsOfRole(slots, role) {
     return slots.filter(slot => slot.role === role);

package/dist-client/components/decision-slots.js.map

@@ -1 +1 @@
-{"version":3,"file":"decision-slots.js","sourceRoot":"","sources":["../../client/components/decision-slots.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Turns an activity's decisionKeys declaration plus an instance's input into the slots a decision\n * screen draws.\n *\n * ── Nothing is imported ───────────────────────────────────────────────────\n * No lit, no i18next. The rule is a mapping from a declaration and a payload to an ordered list,\n * and keeping it free of imports is what lets the test runner hold it: that runner parses\n * TypeScript by stripping types and reads neither decorators nor enums, so one heavy import takes\n * a whole test file down with it. Labels and markup are the caller's half.\n */\n\n/** The roles that may appear more than once. Every other role names one value. */\nexport const REPEATABLE_ROLES = ['consequence', 'evidence'] as const\n\n/** Listed in the order the screen reads them: what is asked, then past, present, future. */\nexport const DECISION_ROLES = [\n  'headline',\n  'subject',\n  'reversibility',\n  'reason',\n  'evidence',\n  'currentState',\n  'consequence'\n] as const\n\nexport type DecisionKeyDeclaration = {\n  role?: string\n  inputPath?: string\n  name?: string\n  tKey?: string\n  unit?: string\n  /** i18n key for the value **sentence** — `approval.<door>.<inputPath>`, computed by the server. */\n  valueTKey?: string\n  /** What the sentence puts in its blanks: name in the sentence → inputPath to read it from. */\n  params?: { [name: string]: string }\n}\n\nexport type DecisionSlot = {\n  role: string\n  inputPath: string\n  /**\n   * 번역이 없을 때 화면이 보일 수 있는 단 하나의 글.\n   *\n   * 선언은 늘 이것을 주는데 슬롯이 버리고 있었다. 그래서 `tKey` 가 다섯 언어 어디에도 없으면 화면에\n   * 남는 것이 점 섞인 키뿐이었다 — 보일 것이 없는 게 아니라 **가진 것을 안 나른 것**이다.\n   */\n  name?: string\n  tKey?: string\n  unit?: string\n  /** i18n key for the value sentence. Absent means the frozen `value` is what this slot has. */\n  valueTKey?: string\n  /**\n   * The sentence's blanks, **already read out of the input.**\n   *\n   * The declaration says where each value lives; this says what was there. Resolving here rather\n   * than on the screen keeps the path language in one place — the same `valueAtPath` the slot's own\n   * value goes through, so a params path that leads nowhere behaves the way an inputPath does\n   * instead of inventing a second rule.\n   */\n  params?: { [name: string]: unknown }\n  /** What the path led to. Undefined both when the path leads nowhere and when the value is unset. */\n  value: unknown\n  /**\n   * Whether the path led anywhere at all.\n   *\n   * A reason nobody wrote and a reason whose path is wrong look identical in `value`, and the screen\n   * owes different answers: the first is 「사유 없음」 in grey, the second is a declaration that does\n   * not match the payload and must not be drawn as if the person left it blank. Folding them into\n   * one value is the fallback that shifts meaning.\n   */\n  found: boolean\n}\n\n/**\n * Reads a dotted path out of the input.\n *\n * Dots only. An array index or a wildcard is not part of the path language — drawing a list is the\n * slot's job — so 'shift.passes[0]' looks for a key spelled \"passes[0]\", finds nothing, and reports\n * found: false. The declaration guard refuses such a path when it arrives, so this is the second\n * line rather than the first.\n *\n * A path that runs into a non-object partway reports found: false rather than throwing. The screen\n * has to draw something either way, and a thrown error here would take the whole approval down over\n * one slot.\n */\nexport function valueAtPath(input: any, path: string): { value: unknown; found: boolean } {\n  const steps = String(path ?? '')\n    .split('.')\n    .filter(step => step.length > 0)\n\n  if (!steps.length) {\n    return { value: undefined, found: false }\n  }\n\n  let at: any = input\n\n  for (const step of steps) {\n    if (at === null || at === undefined || typeof at !== 'object') {\n      return { value: undefined, found: false }\n    }\n\n    if (!Object.prototype.hasOwnProperty.call(at, step)) {\n      return { value: undefined, found: false }\n    }\n\n    at = at[step]\n  }\n\n  return { value: at, found: true }\n}\n\n/**\n * The slots to draw, in the order they were declared.\n *\n * Declaration order is the screen's hierarchy: plant wrote four of these screens by hand and all\n * four put the headline first, then the subject, the reason, what changes, and why it came up. That\n * agreement is what makes the order part of the contract rather than a preference, so this function\n * neither sorts nor groups.\n *\n * Every declared key produces a slot, including one whose path leads nowhere. Dropping those would\n * leave the screen unable to say that a declaration and a payload disagree, and a reader would see\n * a screen that looks complete.\n */\nexport function decisionSlots(\n  decisionKeys: DecisionKeyDeclaration[] | null | undefined,\n  input: any\n): DecisionSlot[] {\n  if (!decisionKeys?.length) {\n    return []\n  }\n\n  return decisionKeys.map(key => {\n    const { value, found } = valueAtPath(input, String(key?.inputPath ?? ''))\n\n    return {\n      role: String(key?.role ?? ''),\n      inputPath: String(key?.inputPath ?? ''),\n      name: key?.name,\n      tKey: key?.tKey,\n      unit: key?.unit,\n      valueTKey: key?.valueTKey,\n      params: paramsFrom(key?.params, input),\n      value,\n      found\n    }\n  })\n}\n\n/**\n * Read the sentence's blanks out of the input.\n *\n * A path that leads nowhere lands as `undefined`, the same as a slot's own value — i18next prints\n * an empty blank rather than the word `undefined`, and the sentence still says the rest. Folding it\n * into an empty string here would hide which of the two it was from anyone looking later.\n *\n * Returns undefined when nothing was declared, so a slot without a sentence carries no empty object\n * for a reader to puzzle over.\n */\nfunction paramsFrom(\n  declared: { [name: string]: string } | undefined,\n  input: { [key: string]: any } | undefined | null\n): { [name: string]: unknown } | undefined {\n  const names = Object.keys(declared || {})\n\n  if (!names.length) {\n    return undefined\n  }\n\n  const read: { [name: string]: unknown } = {}\n\n  for (const name of names) {\n    read[name] = valueAtPath(input, String(declared![name] ?? '')).value\n  }\n\n  return read\n}\n\n/** The slots for one role, in declared order. Empty when the activity declared none. */\nexport function slotsOfRole(slots: DecisionSlot[], role: string): DecisionSlot[] {\n  return slots.filter(slot => slot.role === role)\n}\n\n/**\n * The single slot for a role that names one value, or undefined.\n *\n * Reaching for a second one would be reading a declaration the guard refuses, so this answers the\n * first and does not quietly merge.\n */\nexport function slotOfRole(slots: DecisionSlot[], role: string): DecisionSlot | undefined {\n  return slots.find(slot => slot.role === role)\n}\n\n/**\n * What the declaration says about undoing this approval.\n *\n * The value is an object: `reversible` is required and `caveat` is the module's own sentence about\n * it. The asymmetry is the point — the boolean decides how heavily the screen draws the band, and\n * a sentence alone cannot decide that.\n *\n *   { reversible: false, caveat: '버린 자재는 돌아오지 않습니다' }\n *\n * ── A condition is written as false ───────────────────────────────────────\n * 「되돌릴 수 있습니다 — 단, 실적이 마감되기 전까지」 is written `false` with the condition in the\n * caveat. Written `true` the screen draws it lightly and the reader walks past the condition. There\n * is no third value: a middle one always draws ambiguously, and the reader has to guess which side\n * it is on. (2026-09-11, architect's ruling)\n *\n * ── Not `note` ───────────────────────────────────────────────────────────\n * ops-contract already has CommandApproval.note, and that one is **the approver's own comment** —\n * a person's words, in the same neighbourhood as this screen. Same word for a module's sentence\n * would be read as the person's. `caveat` is used nowhere in the three repositories.\n */\n/**\n * The kinds of an effect, as shell names them (shell server/reversibility, ADR-0064 decision 1).\n *\n * A copy, and the only one on this side: shell's client entry carries side effects and a client\n * importing server code moves the build, so the shell file itself says screens do not import it.\n * test/reversibility-kinds.test.ts holds this list to shell's, word for word.\n */\nexport const REVERSIBILITY_KINDS = ['irreversible', 'compensable', 'reversible', 'unknown'] as const\nexport type ReversibilityKind = (typeof REVERSIBILITY_KINDS)[number]\n\n/** The one kind that is not undone and still not destructive: the original stays, a new record corrects it. */\nexport const COMPENSABLE: ReversibilityKind = 'compensable'\n\n/** Undone by a paired operation. The only kind that agrees with reversible: true. */\nexport const REVERSIBLE: ReversibilityKind = 'reversible'\n\nexport type Reversibility = { reversible: boolean; kind?: ReversibilityKind; caveat?: string }\n\n/**\n * What the slot says, or undefined when it does not say.\n *\n * Undefined covers both \"the path led nowhere\" and \"nobody declared the role\". Drawing nothing is\n * right for both: telling an approver an action can be taken back when the payload never said so\n * is the one mistake this line cannot make, and a truthy read would make it — the string\n * '되돌릴 수 없습니다…' is truthy.\n */\nexport function reversibilityOf(slot?: DecisionSlot): Reversibility | undefined {\n  const value: any = slot?.value\n\n  if (!value || typeof value !== 'object' || typeof value.reversible !== 'boolean') {\n    return undefined\n  }\n  if (value.kind !== undefined && (!(REVERSIBILITY_KINDS as readonly string[]).includes(value.kind) || (value.kind === REVERSIBLE) !== value.reversible)) return undefined\n\n  return {\n    reversible: value.reversible,\n    ...(value.kind ? { kind: value.kind } : {}),\n    ...(typeof value.caveat === 'string' && value.caveat.trim() ? { caveat: value.caveat } : {})\n  }\n}\n\n/**\n * The value is there but not the shape this role takes.\n *\n * plant declared the role and put a sentence at that path, so the band drew nothing at all and the\n * heaviest line on the screen was silently missing. Reporting nothing to the reader is right — the\n * screen cannot tell which way it goes — but a developer should not have to find it by hand. The\n * caller logs this; the rule stays free of side effects so a test can hold it.\n */\nexport function reversibilityIsMalformed(slot?: DecisionSlot): boolean {\n  return !!slot && slot.found && slot.value != null && reversibilityOf(slot) === undefined\n}\n"]}
+{"version":3,"file":"decision-slots.js","sourceRoot":"","sources":["../../client/components/decision-slots.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Turns an activity's decisionKeys declaration plus an instance's input into the slots a decision\n * screen draws.\n *\n * ── Nothing heavy is imported ─────────────────────────────────────────────\n * No lit, no i18next — only the pure reading of the input in `shared/decision-sentences`, which the\n * server freezes sentences with. The rule is a mapping from a declaration and a payload to an ordered list,\n * and keeping it free of imports is what lets the test runner hold it: that runner parses\n * TypeScript by stripping types and reads neither decorators nor enums, so one heavy import takes\n * a whole test file down with it. Labels and markup are the caller's half.\n */\n\nimport { paramsFrom, valueAtPath } from '../../shared/decision-sentences.js'\n\n/* The blanks are read the same way the server freezes them — one reading, in `shared/decision-sentences`. */\nexport { valueAtPath }\n\n/** The roles that may appear more than once. Every other role names one value. */\nexport const REPEATABLE_ROLES = ['consequence', 'evidence'] as const\n\n/** Listed in the order the screen reads them: what is asked, then past, present, future. */\nexport const DECISION_ROLES = [\n  'headline',\n  'subject',\n  'reversibility',\n  'reason',\n  'evidence',\n  'currentState',\n  'consequence'\n] as const\n\nexport type DecisionKeyDeclaration = {\n  role?: string\n  inputPath?: string\n  name?: string\n  tKey?: string\n  unit?: string\n  /** i18n key for the value **sentence** — `approval.<door>.<inputPath>`, computed by the server. */\n  valueTKey?: string\n  /** What the sentence puts in its blanks: name in the sentence → inputPath to read it from. */\n  params?: { [name: string]: string }\n}\n\nexport type DecisionSlot = {\n  role: string\n  inputPath: string\n  /**\n   * 번역이 없을 때 화면이 보일 수 있는 단 하나의 글.\n   *\n   * 선언은 늘 이것을 주는데 슬롯이 버리고 있었다. 그래서 `tKey` 가 다섯 언어 어디에도 없으면 화면에\n   * 남는 것이 점 섞인 키뿐이었다 — 보일 것이 없는 게 아니라 **가진 것을 안 나른 것**이다.\n   */\n  name?: string\n  tKey?: string\n  unit?: string\n  /** i18n key for the value sentence. Absent means the frozen `value` is what this slot has. */\n  valueTKey?: string\n  /**\n   * The sentence's blanks, **already read out of the input.**\n   *\n   * The declaration says where each value lives; this says what was there. Resolving here rather\n   * than on the screen keeps the path language in one place — the same `valueAtPath` the slot's own\n   * value goes through, so a params path that leads nowhere behaves the way an inputPath does\n   * instead of inventing a second rule.\n   */\n  params?: { [name: string]: unknown }\n  /** What the path led to. Undefined both when the path leads nowhere and when the value is unset. */\n  value: unknown\n  /**\n   * Whether the path led anywhere at all.\n   *\n   * A reason nobody wrote and a reason whose path is wrong look identical in `value`, and the screen\n   * owes different answers: the first is 「사유 없음」 in grey, the second is a declaration that does\n   * not match the payload and must not be drawn as if the person left it blank. Folding them into\n   * one value is the fallback that shifts meaning.\n   */\n  found: boolean\n}\n\n\n/**\n * The slots to draw, in the order they were declared.\n *\n * Declaration order is the screen's hierarchy: plant wrote four of these screens by hand and all\n * four put the headline first, then the subject, the reason, what changes, and why it came up. That\n * agreement is what makes the order part of the contract rather than a preference, so this function\n * neither sorts nor groups.\n *\n * Every declared key produces a slot, including one whose path leads nowhere. Dropping those would\n * leave the screen unable to say that a declaration and a payload disagree, and a reader would see\n * a screen that looks complete.\n */\nexport function decisionSlots(\n  decisionKeys: DecisionKeyDeclaration[] | null | undefined,\n  input: any\n): DecisionSlot[] {\n  if (!decisionKeys?.length) {\n    return []\n  }\n\n  return decisionKeys.map(key => {\n    const { value, found } = valueAtPath(input, String(key?.inputPath ?? ''))\n\n    return {\n      role: String(key?.role ?? ''),\n      inputPath: String(key?.inputPath ?? ''),\n      name: key?.name,\n      tKey: key?.tKey,\n      unit: key?.unit,\n      valueTKey: key?.valueTKey,\n      params: paramsFrom(key?.params, input),\n      value,\n      found\n    }\n  })\n}\n\n\n/** The slots for one role, in declared order. Empty when the activity declared none. */\nexport function slotsOfRole(slots: DecisionSlot[], role: string): DecisionSlot[] {\n  return slots.filter(slot => slot.role === role)\n}\n\n/**\n * The single slot for a role that names one value, or undefined.\n *\n * Reaching for a second one would be reading a declaration the guard refuses, so this answers the\n * first and does not quietly merge.\n */\nexport function slotOfRole(slots: DecisionSlot[], role: string): DecisionSlot | undefined {\n  return slots.find(slot => slot.role === role)\n}\n\n/**\n * What the declaration says about undoing this approval.\n *\n * The value is an object: `reversible` is required and `caveat` is the module's own sentence about\n * it. The asymmetry is the point — the boolean decides how heavily the screen draws the band, and\n * a sentence alone cannot decide that.\n *\n *   { reversible: false, caveat: '버린 자재는 돌아오지 않습니다' }\n *\n * ── A condition is written as false ───────────────────────────────────────\n * 「되돌릴 수 있습니다 — 단, 실적이 마감되기 전까지」 is written `false` with the condition in the\n * caveat. Written `true` the screen draws it lightly and the reader walks past the condition. There\n * is no third value: a middle one always draws ambiguously, and the reader has to guess which side\n * it is on. (2026-09-11, architect's ruling)\n *\n * ── Not `note` ───────────────────────────────────────────────────────────\n * ops-contract already has CommandApproval.note, and that one is **the approver's own comment** —\n * a person's words, in the same neighbourhood as this screen. Same word for a module's sentence\n * would be read as the person's. `caveat` is used nowhere in the three repositories.\n */\n/**\n * The kinds of an effect, as shell names them (shell server/reversibility, ADR-0064 decision 1).\n *\n * A copy, and the only one on this side: shell's client entry carries side effects and a client\n * importing server code moves the build, so the shell file itself says screens do not import it.\n * test/reversibility-kinds.test.ts holds this list to shell's, word for word.\n */\nexport const REVERSIBILITY_KINDS = ['irreversible', 'compensable', 'reversible', 'unknown'] as const\nexport type ReversibilityKind = (typeof REVERSIBILITY_KINDS)[number]\n\n/** The one kind that is not undone and still not destructive: the original stays, a new record corrects it. */\nexport const COMPENSABLE: ReversibilityKind = 'compensable'\n\n/** Undone by a paired operation. The only kind that agrees with reversible: true. */\nexport const REVERSIBLE: ReversibilityKind = 'reversible'\n\nexport type Reversibility = { reversible: boolean; kind?: ReversibilityKind; caveat?: string }\n\n/**\n * What the slot says, or undefined when it does not say.\n *\n * Undefined covers both \"the path led nowhere\" and \"nobody declared the role\". Drawing nothing is\n * right for both: telling an approver an action can be taken back when the payload never said so\n * is the one mistake this line cannot make, and a truthy read would make it — the string\n * '되돌릴 수 없습니다…' is truthy.\n */\nexport function reversibilityOf(slot?: DecisionSlot): Reversibility | undefined {\n  const value: any = slot?.value\n\n  if (!value || typeof value !== 'object' || typeof value.reversible !== 'boolean') {\n    return undefined\n  }\n  if (value.kind !== undefined && (!(REVERSIBILITY_KINDS as readonly string[]).includes(value.kind) || (value.kind === REVERSIBLE) !== value.reversible)) return undefined\n\n  return {\n    reversible: value.reversible,\n    ...(value.kind ? { kind: value.kind } : {}),\n    ...(typeof value.caveat === 'string' && value.caveat.trim() ? { caveat: value.caveat } : {})\n  }\n}\n\n/**\n * The value is there but not the shape this role takes.\n *\n * plant declared the role and put a sentence at that path, so the band drew nothing at all and the\n * heaviest line on the screen was silently missing. Reporting nothing to the reader is right — the\n * screen cannot tell which way it goes — but a developer should not have to find it by hand. The\n * caller logs this; the rule stays free of side effects so a test can hold it.\n */\nexport function reversibilityIsMalformed(slot?: DecisionSlot): boolean {\n  return !!slot && slot.found && slot.value != null && reversibilityOf(slot) === undefined\n}\n"]}