@things-factory/worklist 10.1.248 → 10.1.250

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

@@ -0,0 +1,35 @@
+import '@material/web/icon/icon.js';
+import { nothing, TemplateResult } from 'lit';
+/**
+ * The decision an activity declared, drawn the one way every screen draws it.
+ *
+ * The approval screen drew it and the task screen did not. An activity whose model is all hidden -
+ * the expenditure request carries its payee and lines only for its decisionKeys - then showed the
+ * approver what was asked and showed the person who asked an empty box. Both read the same
+ * declaration and the same input, so one drawing serves both.
+ */
+/**
+ * The fields a page asks for to draw the decision - every field renderDecision reads.
+ *
+ * `name` is the label when the translation `tKey` names is missing (decisionLabel), and `valueTKey` with `params`
+ * builds the value sentence at reading time (slotText). Leaving them out drew the sentence frozen
+ * at issue, in the language of whoever raised it, with nothing to say a field was missing.
+ */
+export declare const DecisionKeysFields = "decisionKeys {\n  role\n  inputPath\n  name\n  tKey\n  valueTKey\n  params\n  unit\n}";
+/**
+ * The decision, or `nothing` when the activity declared none or none of it is in this input.
+ *
+ * Returning nothing is how a page knows to fall back to the model. An activity with no
+ * decisionKeys draws exactly what it drew before.
+ *
+ * A slot whose path led nowhere is skipped rather than drawn empty. Older instances of an activity
+ * predate a field the declaration names and an empty bar on the screen would read as "there is no
+ * reason" when the truth is that this record has no such value. What cannot be shown is left out;
+ * what is shown is only what the payload actually carries.
+ *
+ * `reason` is the exception. Missing and blank mean the same thing to whoever is reading - nobody
+ * wrote one - so both draw the grey line rather than disappearing. A reason that silently vanishes
+ * would let an approver assume it was never asked for.
+ */
+export declare function renderDecision(decisionKeys: any, input: any): TemplateResult | typeof nothing;
+export declare const DecisionContentStyles: import("lit").CSSResult;

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

@@ -0,0 +1,331 @@
+import '@material/web/icon/icon.js';
+import { css, html, nothing } from 'lit';
+import { i18next } from '@operato/i18n';
+import { entity360KindOf, entity360Name } from '@operato/layout';
+import { declaredLabel, fieldValue } from './activity-fields.js';
+import { COMPENSABLE, decisionDrawable, decisionSlots, reversibilityIsMalformed, reversibilityOf, slotOfRole, slotsOfRole } from './decision-slots.js';
+/**
+ * The decision an activity declared, drawn the one way every screen draws it.
+ *
+ * The approval screen drew it and the task screen did not. An activity whose model is all hidden -
+ * the expenditure request carries its payee and lines only for its decisionKeys - then showed the
+ * approver what was asked and showed the person who asked an empty box. Both read the same
+ * declaration and the same input, so one drawing serves both.
+ */
+/**
+ * The fields a page asks for to draw the decision - every field renderDecision reads.
+ *
+ * `name` is the label when the translation `tKey` names is missing (decisionLabel), and `valueTKey` with `params`
+ * builds the value sentence at reading time (slotText). Leaving them out drew the sentence frozen
+ * at issue, in the language of whoever raised it, with nothing to say a field was missing.
+ */
+export const DecisionKeysFields = `decisionKeys {
+  role
+  inputPath
+  name
+  tKey
+  valueTKey
+  params
+  unit
+}`;
+/**
+ * The decision, or `nothing` when the activity declared none or none of it is in this input.
+ *
+ * Returning nothing is how a page knows to fall back to the model. An activity with no
+ * decisionKeys draws exactly what it drew before.
+ *
+ * A slot whose path led nowhere is skipped rather than drawn empty. Older instances of an activity
+ * predate a field the declaration names and an empty bar on the screen would read as "there is no
+ * reason" when the truth is that this record has no such value. What cannot be shown is left out;
+ * what is shown is only what the payload actually carries.
+ *
+ * `reason` is the exception. Missing and blank mean the same thing to whoever is reading - nobody
+ * wrote one - so both draw the grey line rather than disappearing. A reason that silently vanishes
+ * would let an approver assume it was never asked for.
+ */
+export function renderDecision(decisionKeys, input) {
+    const slots = decisionSlots(decisionKeys, input);
+    if (!decisionDrawable(slots)) {
+        return nothing;
+    }
+    const headline = slotOfRole(slots, 'headline');
+    const subject = slotOfRole(slots, 'subject');
+    const reason = slotOfRole(slots, 'reason');
+    const consequences = slotsOfRole(slots, 'consequence').filter(slot => slot.found);
+    const evidence = slotsOfRole(slots, 'evidence').filter(slot => slot.found);
+    const currentState = slotOfRole(slots, 'currentState');
+    const reversibility = slotOfRole(slots, 'reversibility');
+    return html `
+    <section decision>
+      ${headline?.found ? html `<div class="headline">${slotText(headline)}</div>` : ''}
+      ${subject?.found ? html `<div class="subject">${slotText(subject)}</div>` : ''}
+      ${reason
+        ? html `
+              <div class="block">
+                <div class="label">${i18next.t('field.reason')}</div>
+                <div class="said ${hasWords(reason) ? '' : 'none'}">
+                  ${hasWords(reason) ? slotText(reason) : i18next.t('text.no-reason-given')}
+                </div>
+              </div>
+            `
+        : ''}
+      ${renderReversibility(reversibility)}
+      ${evidence.length
+        ? html `
+              <div class="block">
+                <div class="label">${i18next.t('label.what-it-was-judged-from')}</div>
+                ${evidence.map(slot => html `
+                    <div class="evidence">
+                      ${decisionLabel(slot) ? html `<div class="label">${decisionLabel(slot)}</div>` : ''}
+                      <div>${slotText(slot)}</div>
+                    </div>
+                  `)}
+              </div>
+            `
+        : ''}
+      ${currentState?.found
+        ? html `
+              <div class="current-state">
+                <div class="label">${decisionLabel(currentState) || i18next.t('label.current-state')}</div>
+                <div>${slotText(currentState)}</div>
+              </div>
+            `
+        : ''}
+      ${consequences.length
+        ? html `
+              <div class="block">
+                <div class="label">${i18next.t('label.what-changes')}</div>
+                ${consequences.map(slot => html `
+                    <div class="consequence">
+                      ${decisionLabel(slot) ? html `<div class="label">${decisionLabel(slot)}</div>` : ''}
+                      <div>${slotText(slot)}</div>
+                    </div>
+                  `)}
+              </div>
+            `
+        : ''}
+    </section>
+  `;
+}
+/**
+ * A slot's own label - only where the declaration names one with `tKey`.
+ *
+ * A decision key's `name` is the developer's note ("Never shown on a screen", ActivityDecisionKeyItem),
+ * and without `tKey` the screen shows no label. declaredLabel falls back to `name` whenever `tKey` is
+ * absent - right for a search key, whose name is its column, and wrong here: asking for `name` put
+ * "what approving does" under 「승인하면 달라지는 것」 on a Korean screen (2026-10-16). The fallback
+ * stays for a declared key whose translation is missing.
+ */
+function decisionLabel(slot) {
+    return slot.tKey ? declaredLabel(slot) : '';
+}
+/**
+ * Whether approving can be undone, drawn as the frame around the decision.
+ *
+ * Only an explicit true or false draws. Anything else - the path led nowhere, or the value is not
+ * a boolean - draws nothing, because saying "this can be undone" on a screen that does not know is
+ * the one mistake this line must never make.
+ *
+ * This is not rejectionIsFinal. That one says whether **rejecting** ends the case for good; this
+ * says whether **approving** can be taken back. The twin actuation carries both, which is exactly
+ * why they must not share a sentence.
+ */
+function renderReversibility(slot) {
+    const said = reversibilityOf(slot);
+    if (!said) {
+        if (reversibilityIsMalformed(slot)) {
+            /*
+             * Declared, and the value is there, but not the shape this role takes - a bare sentence
+             * where { reversible, caveat } belongs. Nothing is drawn, because this side cannot tell
+             * which way it goes; the log is so a developer does not have to find it by hand, which is
+             * how it was found the first time.
+             */
+            console.error(`[worklist] reversibility at "${slot?.inputPath}" is not { reversible, caveat } — nothing drawn`);
+        }
+        return '';
+    }
+    /*
+     * The module's own sentence when it wrote one. 「버린 자재는 돌아오지 않습니다」 says why, which
+     * the plain wording cannot; the boolean beside it is what decides how heavily this is drawn.
+     */
+    return html `
+    <div class="reversibility" ?irreversible=${!said.reversible}>
+      <md-icon>${said.kind === COMPENSABLE ? 'history' : said.reversible ? 'undo' : 'lock'}</md-icon>
+      <span
+        >${said.caveat || (said.kind === COMPENSABLE
+        ? i18next.t('text.approval-is-compensable', { defaultValue: 'The original decision remains. A subsequent corrective action is required.' })
+        : i18next.t(said.reversible ? 'text.approval-is-reversible' : 'text.approval-is-irreversible'))}</span
+      >
+    </div>
+  `;
+}
+/**
+ * One slot's value as something to read.
+ *
+ * A scalar prints with its unit when one was declared. Anything shaped - an object, a list - goes
+ * through fieldValue, the same laying-out the model sections use, so a payload reads the same way
+ * wherever it appears and a four-level object does not become one long line.
+ *
+ * ── The sentence is built here, not frozen when the request was raised ──
+ * Eighteen doors write a Korean sentence at issue and the issue snapshots it, so it stands in the
+ * language of whoever raised it and an approver reading another language never catches up. Where
+ * a door declares `valueTKey`, the sentence is made at reading time instead, out of the values
+ * the request did freeze.
+ *
+ * **A door that has not moved yet draws exactly what it drew before.** That is what lets plant
+ * move them one at a time instead of eighteen at once, and it covers a door that moved into a
+ * locale nobody has written yet: an empty `defaultValue` means a missing key falls through to the
+ * frozen sentence rather than printing `approval.…` on the card.
+ */
+function slotText(slot) {
+    const said = sentenceOf(slot);
+    if (said) {
+        return said;
+    }
+    /*
+     * A value that names what it is - `{ __typename, id, name }` - is drawn as its name, a link to its
+     * 360 (ADR-0067 decision 1: an entity's name opens its 360). The counterparty an expenditure pays
+     * opens the counterparty 360; a person opens the person 360. A kind nobody registered stays text.
+     */
+    if (slot.value && typeof slot.value === 'object' && !Array.isArray(slot.value) && entity360KindOf(slot.value)) {
+        return entity360Name(slot.value);
+    }
+    const scalar = slot.value !== null && slot.value !== undefined && typeof slot.value !== 'object';
+    if (scalar && slot.unit) {
+        return `${slot.value} ${slot.unit}`;
+    }
+    return scalar ? String(slot.value) : fieldValue(slot.value);
+}
+/** The sentence this slot declares, when it declares one and the locale has it. */
+function sentenceOf(slot) {
+    if (!slot.valueTKey) {
+        return '';
+    }
+    return String(i18next.t(slot.valueTKey, { ...(slot.params || {}), defaultValue: '' }) || '');
+}
+/** Did a person actually write something here. Whitespace is not words. */
+function hasWords(slot) {
+    return typeof slot.value === 'string' ? slot.value.trim().length > 0 : slot.found && slot.value != null;
+}
+/*
+ * The decision, drawn from the activity's declaration.
+ *
+ * The order is the declaration's and the weight descends with it: what is being asked reads
+ * first at title size, then what it is about, then the words a person wrote, then what changes
+ * on approval, and last why it came up at all.
+ */
+export const DecisionContentStyles = css `
+  section[decision] .headline {
+    font-size: var(--ui-t-headline, 19px);
+    font-weight: 600;
+    line-height: 1.35;
+    color: var(--ui-ink, #17242c);
+    word-break: keep-all;
+  }
+
+  section[decision] .subject {
+    margin-top: 3px;
+    font-family: var(--ui-mono, ui-monospace, Menlo, monospace);
+    font-size: var(--ui-t-body, 13px);
+    color: var(--ui-muted, #57676f);
+  }
+
+  section[decision] .block {
+    margin-top: 14px;
+  }
+
+  section[decision] .block > .label {
+    margin-bottom: 4px;
+    font-size: var(--ui-t-small, 11.5px);
+    color: var(--ui-muted, #57676f);
+  }
+
+  /* What a person wrote is set apart, because it is the only part nobody computed. */
+  section[decision] .said {
+    padding: 9px 11px;
+    border-left: 3px solid var(--ui-line, #d5dce0);
+    background: var(--ui-line-soft, #f2f5f7);
+    color: var(--ui-ink, #17242c);
+    word-break: break-word;
+  }
+
+  section[decision] .none {
+    color: var(--ui-faint, #8a959c);
+  }
+
+  section[decision] .consequence {
+    margin-top: 8px;
+    padding: 9px 11px;
+    border: 1px solid var(--ui-line, #d5dce0);
+    border-radius: var(--ui-r-small, 6px);
+  }
+
+  section[decision] .consequence > .label {
+    margin-bottom: 3px;
+    font-size: var(--ui-t-small, 11.5px);
+    color: var(--ui-muted, #57676f);
+  }
+
+  /*
+   * Whether approving can be undone reads as the frame around the decision, not as one of its
+   * consequences. Among them it carries the same weight as "four orders get pushed back", and
+   * on an approval that moves equipment it is the heaviest line on the screen.
+   */
+  section[decision] .reversibility {
+    display: flex;
+    align-items: center;
+    gap: 6px;
+
+    margin-top: 12px;
+    padding: 8px 11px;
+    border-radius: var(--ui-r-small, 6px);
+
+    background: var(--ui-line-soft, #f2f5f7);
+    color: var(--ui-muted, #57676f);
+    font-size: var(--ui-t-small, 11.5px);
+  }
+
+  section[decision] .reversibility[irreversible] {
+    background: var(--md-sys-color-error-container, #ffdad6);
+    color: var(--md-sys-color-on-error-container, #410002);
+    font-weight: 600;
+  }
+
+  section[decision] .reversibility md-icon {
+    font-size: 1.15em;
+  }
+
+  /*
+   * What the decision was made from. Set flatter than the consequences - it is the record the
+   * approver checks, not something the approval brings about.
+   */
+  section[decision] .evidence {
+    margin-top: 8px;
+    padding: 7px 0 7px 11px;
+    border-left: 2px solid var(--ui-line, #d5dce0);
+  }
+
+  section[decision] .evidence > .label {
+    margin-bottom: 2px;
+    font-size: var(--ui-t-small, 11.5px);
+    color: var(--ui-muted, #57676f);
+  }
+
+  /*
+   * What is true right now sits apart from what the approval would change. Sharing the box the
+   * consequences use would say the approval causes these readings.
+   */
+  section[decision] .current-state {
+    margin-top: 14px;
+    padding: 9px 11px;
+    border: 1px dashed var(--ui-line, #d5dce0);
+    border-radius: var(--ui-r-small, 6px);
+  }
+
+  section[decision] .current-state > .label {
+    margin-bottom: 3px;
+    font-size: var(--ui-t-small, 11.5px);
+    color: var(--ui-muted, #57676f);
+  }
+`;
+//# sourceMappingURL=decision-content.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decision-content.js","sourceRoot":"","sources":["../../client/components/decision-content.ts"],"names":[],"mappings":"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","sourcesContent":["import '@material/web/icon/icon.js'\n\nimport { css, html, nothing, TemplateResult } from 'lit'\nimport { i18next } from '@operato/i18n'\nimport { entity360KindOf, entity360Name } from '@operato/layout'\n\nimport { declaredLabel, fieldValue } from './activity-fields.js'\nimport {\n  COMPENSABLE,\n  DecisionSlot,\n  decisionDrawable,\n  decisionSlots,\n  reversibilityIsMalformed,\n  reversibilityOf,\n  slotOfRole,\n  slotsOfRole\n} from './decision-slots.js'\n\n/**\n * The decision an activity declared, drawn the one way every screen draws it.\n *\n * The approval screen drew it and the task screen did not. An activity whose model is all hidden -\n * the expenditure request carries its payee and lines only for its decisionKeys - then showed the\n * approver what was asked and showed the person who asked an empty box. Both read the same\n * declaration and the same input, so one drawing serves both.\n */\n\n/**\n * The fields a page asks for to draw the decision - every field renderDecision reads.\n *\n * `name` is the label when the translation `tKey` names is missing (decisionLabel), and `valueTKey` with `params`\n * builds the value sentence at reading time (slotText). Leaving them out drew the sentence frozen\n * at issue, in the language of whoever raised it, with nothing to say a field was missing.\n */\nexport const DecisionKeysFields = `decisionKeys {\n  role\n  inputPath\n  name\n  tKey\n  valueTKey\n  params\n  unit\n}`\n\n/**\n * The decision, or `nothing` when the activity declared none or none of it is in this input.\n *\n * Returning nothing is how a page knows to fall back to the model. An activity with no\n * decisionKeys draws exactly what it drew before.\n *\n * A slot whose path led nowhere is skipped rather than drawn empty. Older instances of an activity\n * predate a field the declaration names and an empty bar on the screen would read as \"there is no\n * reason\" when the truth is that this record has no such value. What cannot be shown is left out;\n * what is shown is only what the payload actually carries.\n *\n * `reason` is the exception. Missing and blank mean the same thing to whoever is reading - nobody\n * wrote one - so both draw the grey line rather than disappearing. A reason that silently vanishes\n * would let an approver assume it was never asked for.\n */\nexport function renderDecision(decisionKeys: any, input: any): TemplateResult | typeof nothing {\n  const slots = decisionSlots(decisionKeys, input)\n\n  if (!decisionDrawable(slots)) {\n    return nothing\n  }\n\n  const headline = slotOfRole(slots, 'headline')\n  const subject = slotOfRole(slots, 'subject')\n  const reason = slotOfRole(slots, 'reason')\n  const consequences = slotsOfRole(slots, 'consequence').filter(slot => slot.found)\n  const evidence = slotsOfRole(slots, 'evidence').filter(slot => slot.found)\n  const currentState = slotOfRole(slots, 'currentState')\n  const reversibility = slotOfRole(slots, 'reversibility')\n\n  return html`\n    <section decision>\n      ${headline?.found ? html`<div class=\"headline\">${slotText(headline)}</div>` : ''}\n      ${subject?.found ? html`<div class=\"subject\">${slotText(subject)}</div>` : ''}\n      ${\n        reason\n          ? html`\n              <div class=\"block\">\n                <div class=\"label\">${i18next.t('field.reason')}</div>\n                <div class=\"said ${hasWords(reason) ? '' : 'none'}\">\n                  ${hasWords(reason) ? slotText(reason) : i18next.t('text.no-reason-given')}\n                </div>\n              </div>\n            `\n          : ''\n      }\n      ${renderReversibility(reversibility)}\n      ${\n        evidence.length\n          ? html`\n              <div class=\"block\">\n                <div class=\"label\">${i18next.t('label.what-it-was-judged-from')}</div>\n                ${evidence.map(\n                  slot => html`\n                    <div class=\"evidence\">\n                      ${decisionLabel(slot) ? html`<div class=\"label\">${decisionLabel(slot)}</div>` : ''}\n                      <div>${slotText(slot)}</div>\n                    </div>\n                  `\n                )}\n              </div>\n            `\n          : ''\n      }\n      ${\n        currentState?.found\n          ? html`\n              <div class=\"current-state\">\n                <div class=\"label\">${decisionLabel(currentState) || i18next.t('label.current-state')}</div>\n                <div>${slotText(currentState)}</div>\n              </div>\n            `\n          : ''\n      }\n      ${\n        consequences.length\n          ? html`\n              <div class=\"block\">\n                <div class=\"label\">${i18next.t('label.what-changes')}</div>\n                ${consequences.map(\n                  slot => html`\n                    <div class=\"consequence\">\n                      ${decisionLabel(slot) ? html`<div class=\"label\">${decisionLabel(slot)}</div>` : ''}\n                      <div>${slotText(slot)}</div>\n                    </div>\n                  `\n                )}\n              </div>\n            `\n          : ''\n      }\n    </section>\n  `\n}\n\n/**\n * A slot's own label - only where the declaration names one with `tKey`.\n *\n * A decision key's `name` is the developer's note (\"Never shown on a screen\", ActivityDecisionKeyItem),\n * and without `tKey` the screen shows no label. declaredLabel falls back to `name` whenever `tKey` is\n * absent - right for a search key, whose name is its column, and wrong here: asking for `name` put\n * \"what approving does\" under 「승인하면 달라지는 것」 on a Korean screen (2026-10-16). The fallback\n * stays for a declared key whose translation is missing.\n */\nfunction decisionLabel(slot: DecisionSlot): string {\n  return slot.tKey ? declaredLabel(slot) : ''\n}\n\n/**\n * Whether approving can be undone, drawn as the frame around the decision.\n *\n * Only an explicit true or false draws. Anything else - the path led nowhere, or the value is not\n * a boolean - draws nothing, because saying \"this can be undone\" on a screen that does not know is\n * the one mistake this line must never make.\n *\n * This is not rejectionIsFinal. That one says whether **rejecting** ends the case for good; this\n * says whether **approving** can be taken back. The twin actuation carries both, which is exactly\n * why they must not share a sentence.\n */\nfunction renderReversibility(slot?: DecisionSlot) {\n  const said = reversibilityOf(slot)\n\n  if (!said) {\n    if (reversibilityIsMalformed(slot)) {\n      /*\n       * Declared, and the value is there, but not the shape this role takes - a bare sentence\n       * where { reversible, caveat } belongs. Nothing is drawn, because this side cannot tell\n       * which way it goes; the log is so a developer does not have to find it by hand, which is\n       * how it was found the first time.\n       */\n      console.error(`[worklist] reversibility at \"${slot?.inputPath}\" is not { reversible, caveat } — nothing drawn`)\n    }\n\n    return ''\n  }\n\n  /*\n   * The module's own sentence when it wrote one. 「버린 자재는 돌아오지 않습니다」 says why, which\n   * the plain wording cannot; the boolean beside it is what decides how heavily this is drawn.\n   */\n  return html`\n    <div class=\"reversibility\" ?irreversible=${!said.reversible}>\n      <md-icon>${said.kind === COMPENSABLE ? 'history' : said.reversible ? 'undo' : 'lock'}</md-icon>\n      <span\n        >${\n          said.caveat || (said.kind === COMPENSABLE\n            ? i18next.t('text.approval-is-compensable', { defaultValue: 'The original decision remains. A subsequent corrective action is required.' })\n            : i18next.t(said.reversible ? 'text.approval-is-reversible' : 'text.approval-is-irreversible'))\n        }</span\n      >\n    </div>\n  `\n}\n\n/**\n * One slot's value as something to read.\n *\n * A scalar prints with its unit when one was declared. Anything shaped - an object, a list - goes\n * through fieldValue, the same laying-out the model sections use, so a payload reads the same way\n * wherever it appears and a four-level object does not become one long line.\n *\n * ── The sentence is built here, not frozen when the request was raised ──\n * Eighteen doors write a Korean sentence at issue and the issue snapshots it, so it stands in the\n * language of whoever raised it and an approver reading another language never catches up. Where\n * a door declares `valueTKey`, the sentence is made at reading time instead, out of the values\n * the request did freeze.\n *\n * **A door that has not moved yet draws exactly what it drew before.** That is what lets plant\n * move them one at a time instead of eighteen at once, and it covers a door that moved into a\n * locale nobody has written yet: an empty `defaultValue` means a missing key falls through to the\n * frozen sentence rather than printing `approval.…` on the card.\n */\nfunction slotText(slot: DecisionSlot): unknown {\n  const said = sentenceOf(slot)\n\n  if (said) {\n    return said\n  }\n\n  /*\n   * A value that names what it is - `{ __typename, id, name }` - is drawn as its name, a link to its\n   * 360 (ADR-0067 decision 1: an entity's name opens its 360). The counterparty an expenditure pays\n   * opens the counterparty 360; a person opens the person 360. A kind nobody registered stays text.\n   */\n  if (slot.value && typeof slot.value === 'object' && !Array.isArray(slot.value) && entity360KindOf(slot.value)) {\n    return entity360Name(slot.value)\n  }\n\n  const scalar = slot.value !== null && slot.value !== undefined && typeof slot.value !== 'object'\n\n  if (scalar && slot.unit) {\n    return `${slot.value} ${slot.unit}`\n  }\n\n  return scalar ? String(slot.value) : fieldValue(slot.value)\n}\n\n/** The sentence this slot declares, when it declares one and the locale has it. */\nfunction sentenceOf(slot: DecisionSlot): string {\n  if (!slot.valueTKey) {\n    return ''\n  }\n\n  return String(i18next.t(slot.valueTKey, { ...(slot.params || {}), defaultValue: '' }) || '')\n}\n\n/** Did a person actually write something here. Whitespace is not words. */\nfunction hasWords(slot: DecisionSlot): boolean {\n  return typeof slot.value === 'string' ? slot.value.trim().length > 0 : slot.found && slot.value != null\n}\n\n/*\n * The decision, drawn from the activity's declaration.\n *\n * The order is the declaration's and the weight descends with it: what is being asked reads\n * first at title size, then what it is about, then the words a person wrote, then what changes\n * on approval, and last why it came up at all.\n */\nexport const DecisionContentStyles = css`\n  section[decision] .headline {\n    font-size: var(--ui-t-headline, 19px);\n    font-weight: 600;\n    line-height: 1.35;\n    color: var(--ui-ink, #17242c);\n    word-break: keep-all;\n  }\n\n  section[decision] .subject {\n    margin-top: 3px;\n    font-family: var(--ui-mono, ui-monospace, Menlo, monospace);\n    font-size: var(--ui-t-body, 13px);\n    color: var(--ui-muted, #57676f);\n  }\n\n  section[decision] .block {\n    margin-top: 14px;\n  }\n\n  section[decision] .block > .label {\n    margin-bottom: 4px;\n    font-size: var(--ui-t-small, 11.5px);\n    color: var(--ui-muted, #57676f);\n  }\n\n  /* What a person wrote is set apart, because it is the only part nobody computed. */\n  section[decision] .said {\n    padding: 9px 11px;\n    border-left: 3px solid var(--ui-line, #d5dce0);\n    background: var(--ui-line-soft, #f2f5f7);\n    color: var(--ui-ink, #17242c);\n    word-break: break-word;\n  }\n\n  section[decision] .none {\n    color: var(--ui-faint, #8a959c);\n  }\n\n  section[decision] .consequence {\n    margin-top: 8px;\n    padding: 9px 11px;\n    border: 1px solid var(--ui-line, #d5dce0);\n    border-radius: var(--ui-r-small, 6px);\n  }\n\n  section[decision] .consequence > .label {\n    margin-bottom: 3px;\n    font-size: var(--ui-t-small, 11.5px);\n    color: var(--ui-muted, #57676f);\n  }\n\n  /*\n   * Whether approving can be undone reads as the frame around the decision, not as one of its\n   * consequences. Among them it carries the same weight as \"four orders get pushed back\", and\n   * on an approval that moves equipment it is the heaviest line on the screen.\n   */\n  section[decision] .reversibility {\n    display: flex;\n    align-items: center;\n    gap: 6px;\n\n    margin-top: 12px;\n    padding: 8px 11px;\n    border-radius: var(--ui-r-small, 6px);\n\n    background: var(--ui-line-soft, #f2f5f7);\n    color: var(--ui-muted, #57676f);\n    font-size: var(--ui-t-small, 11.5px);\n  }\n\n  section[decision] .reversibility[irreversible] {\n    background: var(--md-sys-color-error-container, #ffdad6);\n    color: var(--md-sys-color-on-error-container, #410002);\n    font-weight: 600;\n  }\n\n  section[decision] .reversibility md-icon {\n    font-size: 1.15em;\n  }\n\n  /*\n   * What the decision was made from. Set flatter than the consequences - it is the record the\n   * approver checks, not something the approval brings about.\n   */\n  section[decision] .evidence {\n    margin-top: 8px;\n    padding: 7px 0 7px 11px;\n    border-left: 2px solid var(--ui-line, #d5dce0);\n  }\n\n  section[decision] .evidence > .label {\n    margin-bottom: 2px;\n    font-size: var(--ui-t-small, 11.5px);\n    color: var(--ui-muted, #57676f);\n  }\n\n  /*\n   * What is true right now sits apart from what the approval would change. Sharing the box the\n   * consequences use would say the approval causes these readings.\n   */\n  section[decision] .current-state {\n    margin-top: 14px;\n    padding: 9px 11px;\n    border: 1px dashed var(--ui-line, #d5dce0);\n    border-radius: var(--ui-r-small, 6px);\n  }\n\n  section[decision] .current-state > .label {\n    margin-bottom: 3px;\n    font-size: var(--ui-t-small, 11.5px);\n    color: var(--ui-muted, #57676f);\n  }\n`\n"]}

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

@@ -0,0 +1,153 @@
+/**
+ * Turns an activity's decisionKeys declaration plus an instance's input into the slots a decision
+ * screen draws.
+ *
+ * ── 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. */
+export declare const DECISION_ROLES: readonly ["headline", "subject", "reversibility", "reason", "evidence", "currentState", "consequence"];
+export type DecisionKeyDeclaration = {
+    role?: string;
+    inputPath?: string;
+    name?: string;
+    tKey?: string;
+    unit?: string;
+    /** i18n key for the value **sentence** — `approval.<door>.<inputPath>`, computed by the server. */
+    valueTKey?: string;
+    /** What the sentence puts in its blanks: name in the sentence → inputPath to read it from. */
+    params?: {
+        [name: string]: string;
+    };
+};
+export type DecisionSlot = {
+    role: string;
+    inputPath: string;
+    /**
+     * 번역이 없을 때 화면이 보일 수 있는 단 하나의 글.
+     *
+     * 선언은 늘 이것을 주는데 슬롯이 버리고 있었다. 그래서 `tKey` 가 다섯 언어 어디에도 없으면 화면에
+     * 남는 것이 점 섞인 키뿐이었다 — 보일 것이 없는 게 아니라 **가진 것을 안 나른 것**이다.
+     */
+    name?: string;
+    tKey?: string;
+    unit?: string;
+    /** i18n key for the value sentence. Absent means the frozen `value` is what this slot has. */
+    valueTKey?: string;
+    /**
+     * The sentence's blanks, **already read out of the input.**
+     *
+     * The declaration says where each value lives; this says what was there. Resolving here rather
+     * than on the screen keeps the path language in one place — the same `valueAtPath` the slot's own
+     * value goes through, so a params path that leads nowhere behaves the way an inputPath does
+     * instead of inventing a second rule.
+     */
+    params?: {
+        [name: string]: unknown;
+    };
+    /** What the path led to. Undefined both when the path leads nowhere and when the value is unset. */
+    value: unknown;
+    /**
+     * Whether the path led anywhere at all.
+     *
+     * A reason nobody wrote and a reason whose path is wrong look identical in `value`, and the screen
+     * owes different answers: the first is 「사유 없음」 in grey, the second is a declaration that does
+     * not match the payload and must not be drawn as if the person left it blank. Folding them into
+     * one value is the fallback that shifts meaning.
+     */
+    found: boolean;
+};
+/**
+ * The slots to draw, in the order they were declared.
+ *
+ * Declaration order is the screen's hierarchy: plant wrote four of these screens by hand and all
+ * four put the headline first, then the subject, the reason, what changes, and why it came up. That
+ * agreement is what makes the order part of the contract rather than a preference, so this function
+ * neither sorts nor groups.
+ *
+ * Every declared key produces a slot, including one whose path leads nowhere. Dropping those would
+ * leave the screen unable to say that a declaration and a payload disagree, and a reader would see
+ * a screen that looks complete.
+ */
+export declare function decisionSlots(decisionKeys: DecisionKeyDeclaration[] | null | undefined, input: any): DecisionSlot[];
+/** The slots for one role, in declared order. Empty when the activity declared none. */
+export declare function slotsOfRole(slots: DecisionSlot[], role: string): DecisionSlot[];
+/**
+ * The single slot for a role that names one value, or undefined.
+ *
+ * Reaching for a second one would be reading a declaration the guard refuses, so this answers the
+ * first and does not quietly merge.
+ */
+export declare function slotOfRole(slots: DecisionSlot[], role: string): DecisionSlot | undefined;
+/**
+ * What the declaration says about undoing this approval.
+ *
+ * The value is an object: `reversible` is required and `caveat` is the module's own sentence about
+ * it. The asymmetry is the point — the boolean decides how heavily the screen draws the band, and
+ * a sentence alone cannot decide that.
+ *
+ *   { reversible: false, caveat: '버린 자재는 돌아오지 않습니다' }
+ *
+ * ── A condition is written as false ───────────────────────────────────────
+ * 「되돌릴 수 있습니다 — 단, 실적이 마감되기 전까지」 is written `false` with the condition in the
+ * caveat. Written `true` the screen draws it lightly and the reader walks past the condition. There
+ * is no third value: a middle one always draws ambiguously, and the reader has to guess which side
+ * it is on. (2026-09-11, architect's ruling)
+ *
+ * ── Not `note` ───────────────────────────────────────────────────────────
+ * ops-contract already has CommandApproval.note, and that one is **the approver's own comment** —
+ * a person's words, in the same neighbourhood as this screen. Same word for a module's sentence
+ * would be read as the person's. `caveat` is used nowhere in the three repositories.
+ */
+/**
+ * The kinds of an effect, as shell names them (shell server/reversibility, ADR-0064 decision 1).
+ *
+ * A copy, and the only one on this side: shell's client entry carries side effects and a client
+ * importing server code moves the build, so the shell file itself says screens do not import it.
+ * test/reversibility-kinds.test.ts holds this list to shell's, word for word.
+ */
+export declare const REVERSIBILITY_KINDS: readonly ["irreversible", "compensable", "reversible", "unknown"];
+export type ReversibilityKind = (typeof REVERSIBILITY_KINDS)[number];
+/** The one kind that is not undone and still not destructive: the original stays, a new record corrects it. */
+export declare const COMPENSABLE: ReversibilityKind;
+/** Undone by a paired operation. The only kind that agrees with reversible: true. */
+export declare const REVERSIBLE: ReversibilityKind;
+export type Reversibility = {
+    reversible: boolean;
+    kind?: ReversibilityKind;
+    caveat?: string;
+};
+/**
+ * What the slot says, or undefined when it does not say.
+ *
+ * Undefined covers both "the path led nowhere" and "nobody declared the role". Drawing nothing is
+ * right for both: telling an approver an action can be taken back when the payload never said so
+ * is the one mistake this line cannot make, and a truthy read would make it — the string
+ * '되돌릴 수 없습니다…' is truthy.
+ */
+export declare function reversibilityOf(slot?: DecisionSlot): Reversibility | undefined;
+/**
+ * The value is there but not the shape this role takes.
+ *
+ * plant declared the role and put a sentence at that path, so the band drew nothing at all and the
+ * heaviest line on the screen was silently missing. Reporting nothing to the reader is right — the
+ * screen cannot tell which way it goes — but a developer should not have to find it by hand. The
+ * caller logs this; the rule stays free of side effects so a test can hold it.
+ */
+export declare function reversibilityIsMalformed(slot?: DecisionSlot): boolean;
+/**
+ * Whether these slots draw anything at all.
+ *
+ * Every declared slot can miss a payload - an older instance predates the field a declaration
+ * names. Then a screen falls back to the model rather than drawing an empty decision box. `reason`
+ * draws even when missing, as the grey "nobody wrote one" line, so declaring it is enough.
+ */
+export declare function decisionDrawable(slots: DecisionSlot[]): boolean;