@things-factory/ops-master 10.0.19 → 10.1.1

package/dist-client/pages/master/iso-duration.js

@@ -0,0 +1,76 @@
+import { parseIsoDuration } from '@operato/ops-contract';
+/**
+ * ISO 8601 기간을 화면에서 다룬다 — **커널이 읽는 표기 그대로 저장한다.**
+ *
+ * ── 왜 있는 편집기를 안 썼나 ────────────────────────────────────────────────
+ * `@operato/grist-editor` 에 `duration` 편집기와 렌더러가 있다. 그런데 그것은 **초 숫자**를 받는다.
+ * 소스를 보면 첫 줄이 `Number(value) || 0` 이다. 우리 칸에는 `PT209S` 가 들어 있고 `Number('PT209S')`
+ * 는 NaN 이라 0 으로 떨어져서, 화면에 **아무것도 안 나왔다.** 붙여 놓고 확인하지 않았으면 「소요시간이
+ * 비어 있다」로 보였을 것이다. [확인함] 2026-09-04
+ *
+ * 더 나쁜 것은 쓰는 쪽이다. 그 편집기로 고치면 초 숫자가 저장되고, 커널은 그 칸을 ISO 8601 로
+ * 읽으므로 그때부터 이 공정의 소요시간이 「모른다」가 된다. 화면에는 값이 있는데.
+ *
+ * ── 읽는 쪽은 커널 것을 쓴다 ───────────────────────────────────────────────
+ * `parseIsoDuration` 이 계약에 있다. 해석 규칙을 여기서 다시 쓰면 두 곳에 생기고, 커널이 받아주지 않는 것을
+ * 화면이 받아들이는 날이 온다(연·월은 달력에 기대므로 커널이 받아주지 않는다).
+ *
+ * 쓰는 쪽은 계약에 없다. 여기서 만들고 아키텍트에게 올려 두었다 — 읽는 쪽을 가진 곳이 쓰는 쪽도
+ * 가지는 편이 맞다.
+ */
+/** 초 → ISO 8601. 편집기가 저장할 때 쓴다. */
+export function isoDurationOfSeconds(seconds) {
+    /*
+     * **`PT<초>S` 하나로만 쓴다.** 시·분으로 나눠 쓰면 보기에는 좋지만, 고칠 때마다 표기가 달라져서
+     * 같은 값인데 저장된 글자가 계속 바뀐다. 사람이 읽는 것은 렌더러가 맡는다.
+     *
+     * **소수를 반올림하지 않는다.** 처음에 `Math.round` 를 넣었더니 작업표준서의 6.5초가 7초로
+     * 저장됐다 — 화면에는 「6.5초」로 보이던 값을 열었다 닫기만 해도 0.5초가 늘어난다. 공정
+     * 스물넷이면 12초다. [확인함] 2026-09-04
+     *
+     * 밀리초 자리에서 끊는다. 커널의 해석기가 밀리초로 내주므로 그보다 잘게 적어 봐야 돌아오지
+     * 않고, 부동소수 찌꺼기(`0.30000000000000004`)만 글자에 남는다.
+     */
+    const rounded = Math.round(seconds * 1000) / 1000;
+    return `PT${rounded}S`;
+}
+/** ISO 8601 → 초. 해석할 수 없으면 `undefined` — 0 이 아니다. */
+export function secondsOfIsoDuration(text) {
+    const ms = parseIsoDuration(text);
+    return ms === undefined ? undefined : ms / 1000;
+}
+/**
+ * 사람이 읽는 글자.
+ *
+ * **해석할 수 없으면 원문을 그대로 낸다.** 빈 칸으로 두면 「값이 없다」와 「값이 이상하다」가 같아
+ * 보인다. `PT30` 처럼 커널이 못 읽는 것이 들어 있으면 그것이 화면에 보여야 고칠 수 있다.
+ */
+export function durationText(value, unit) {
+    if (!value) {
+        return '';
+    }
+    const seconds = secondsOfIsoDuration(value);
+    if (seconds === undefined) {
+        return value;
+    }
+    const negative = seconds < 0;
+    let rest = Math.abs(seconds);
+    const hours = Math.floor(rest / 3600);
+    rest -= hours * 3600;
+    const minutes = Math.floor(rest / 60);
+    /* 소수 초가 있을 수 있다 — `PT0.5S`. 버리지 않는다. */
+    const secs = Math.round((rest - minutes * 60) * 1000) / 1000;
+    const parts = [];
+    if (hours) {
+        parts.push(`${hours}${unit.hour}`);
+    }
+    if (minutes) {
+        parts.push(`${minutes}${unit.minute}`);
+    }
+    /* 0초는 「0초」라고 적는다 — 다른 자리가 하나도 없을 때만. 아니면 「1분 0초」가 된다. */
+    if (secs || parts.length === 0) {
+        parts.push(`${secs}${unit.second}`);
+    }
+    return `${negative ? '-' : ''}${parts.join(' ')}`;
+}
+//# sourceMappingURL=iso-duration.js.map

package/dist-client/pages/master/iso-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iso-duration.js","sourceRoot":"","sources":["../../../client/pages/master/iso-duration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mCAAmC;AACnC,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD;;;;;;;;;;OAUG;IACH,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAEjD,OAAO,KAAK,OAAO,GAAG,CAAA;AACxB,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,oBAAoB,CAAC,IAAwB;IAC3D,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAEjC,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAA;AACjD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,KAAyB,EAAE,IAAsD;IAC5G,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAE3C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAA;IAC5B,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAE5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAA;IACrC,IAAI,IAAI,KAAK,GAAG,IAAI,CAAA;IACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,EAAE,CAAC,CAAA;IACrC,wCAAwC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,GAAG,OAAO,GAAG,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAE5D,MAAM,KAAK,GAAa,EAAE,CAAA;IAE1B,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACpC,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACxC,CAAC;IACD,yDAAyD;IACzD,IAAI,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IACrC,CAAC;IAED,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAA;AACnD,CAAC","sourcesContent":["import { parseIsoDuration } from '@operato/ops-contract'\n\n/**\n * ISO 8601 기간을 화면에서 다룬다 — **커널이 읽는 표기 그대로 저장한다.**\n *\n * ── 왜 있는 편집기를 안 썼나 ────────────────────────────────────────────────\n * `@operato/grist-editor` 에 `duration` 편집기와 렌더러가 있다. 그런데 그것은 **초 숫자**를 받는다.\n * 소스를 보면 첫 줄이 `Number(value) || 0` 이다. 우리 칸에는 `PT209S` 가 들어 있고 `Number('PT209S')`\n * 는 NaN 이라 0 으로 떨어져서, 화면에 **아무것도 안 나왔다.** 붙여 놓고 확인하지 않았으면 「소요시간이\n * 비어 있다」로 보였을 것이다. [확인함] 2026-09-04\n *\n * 더 나쁜 것은 쓰는 쪽이다. 그 편집기로 고치면 초 숫자가 저장되고, 커널은 그 칸을 ISO 8601 로\n * 읽으므로 그때부터 이 공정의 소요시간이 「모른다」가 된다. 화면에는 값이 있는데.\n *\n * ── 읽는 쪽은 커널 것을 쓴다 ───────────────────────────────────────────────\n * `parseIsoDuration` 이 계약에 있다. 해석 규칙을 여기서 다시 쓰면 두 곳에 생기고, 커널이 받아주지 않는 것을\n * 화면이 받아들이는 날이 온다(연·월은 달력에 기대므로 커널이 받아주지 않는다).\n *\n * 쓰는 쪽은 계약에 없다. 여기서 만들고 아키텍트에게 올려 두었다 — 읽는 쪽을 가진 곳이 쓰는 쪽도\n * 가지는 편이 맞다.\n */\n\n/** 초 → ISO 8601. 편집기가 저장할 때 쓴다. */\nexport function isoDurationOfSeconds(seconds: number): string {\n  /*\n   * **`PT<초>S` 하나로만 쓴다.** 시·분으로 나눠 쓰면 보기에는 좋지만, 고칠 때마다 표기가 달라져서\n   * 같은 값인데 저장된 글자가 계속 바뀐다. 사람이 읽는 것은 렌더러가 맡는다.\n   *\n   * **소수를 반올림하지 않는다.** 처음에 `Math.round` 를 넣었더니 작업표준서의 6.5초가 7초로\n   * 저장됐다 — 화면에는 「6.5초」로 보이던 값을 열었다 닫기만 해도 0.5초가 늘어난다. 공정\n   * 스물넷이면 12초다. [확인함] 2026-09-04\n   *\n   * 밀리초 자리에서 끊는다. 커널의 해석기가 밀리초로 내주므로 그보다 잘게 적어 봐야 돌아오지\n   * 않고, 부동소수 찌꺼기(`0.30000000000000004`)만 글자에 남는다.\n   */\n  const rounded = Math.round(seconds * 1000) / 1000\n\n  return `PT${rounded}S`\n}\n\n/** ISO 8601 → 초. 해석할 수 없으면 `undefined` — 0 이 아니다. */\nexport function secondsOfIsoDuration(text: string | undefined): number | undefined {\n  const ms = parseIsoDuration(text)\n\n  return ms === undefined ? undefined : ms / 1000\n}\n\n/**\n * 사람이 읽는 글자.\n *\n * **해석할 수 없으면 원문을 그대로 낸다.** 빈 칸으로 두면 「값이 없다」와 「값이 이상하다」가 같아\n * 보인다. `PT30` 처럼 커널이 못 읽는 것이 들어 있으면 그것이 화면에 보여야 고칠 수 있다.\n */\nexport function durationText(value: string | undefined, unit: { hour: string; minute: string; second: string }): string {\n  if (!value) {\n    return ''\n  }\n\n  const seconds = secondsOfIsoDuration(value)\n\n  if (seconds === undefined) {\n    return value\n  }\n\n  const negative = seconds < 0\n  let rest = Math.abs(seconds)\n\n  const hours = Math.floor(rest / 3600)\n  rest -= hours * 3600\n  const minutes = Math.floor(rest / 60)\n  /* 소수 초가 있을 수 있다 — `PT0.5S`. 버리지 않는다. */\n  const secs = Math.round((rest - minutes * 60) * 1000) / 1000\n\n  const parts: string[] = []\n\n  if (hours) {\n    parts.push(`${hours}${unit.hour}`)\n  }\n  if (minutes) {\n    parts.push(`${minutes}${unit.minute}`)\n  }\n  /* 0초는 「0초」라고 적는다 — 다른 자리가 하나도 없을 때만. 아니면 「1분 0초」가 된다. */\n  if (secs || parts.length === 0) {\n    parts.push(`${secs}${unit.second}`)\n  }\n\n  return `${negative ? '-' : ''}${parts.join(' ')}`\n}\n"]}

package/dist-client/pages/master/master-options.d.ts

@@ -0,0 +1,33 @@
+/**
+ * 닫힌 값 집합 — **고르는 칸의 값은 커널에서 온다.**
+ *
+ * ── 왜 이 파일이 있나 ──────────────────────────────────────────────────────
+ * 마스터 화면의 칸이 거의 다 자유 텍스트였다. `level` 에 `WorkCel` 이라고 쳐도 아무 일도 안 나고,
+ * 저장되고, 그 뒤로 그 자리는 어떤 계산에도 안 잡힌다. 값이 정해져 있는 칸은 고르게 해야 한다.
+ *
+ * ── 목록을 여기에 손으로 적지 않는다 ────────────────────────────────────────
+ * 화면에 값을 베껴 적으면 커널이 값을 하나 늘렸을 때 화면만 옛 목록을 보인다. 그래서 **계약이
+ * 실행시 상수로 내주는 것은 그대로 가져다 쓴다.**
+ *
+ * 계약이 **타입으로만** 주는 것이 있다. 타입은 실행시에 사라지므로 목록을 만들 수 없다. 그때만
+ * 거울을 두고, **컴파일러가 그 거울을 계약에 묶는다** — 계약 쪽이 값을 더하거나 빼면 이 파일이
+ * 컴파일되지 않는다. 베껴 적은 것과 다른 점이 그것이다.
+ *
+ * 계약이 상수를 내주면 거울을 지운다. 아키텍트에게 올려 두었다(`EQUIPMENT_LEVEL` ·
+ * `DISPOSITION_DECISION` 처럼 `OPERATION_INTENT` 도 상수로).
+ */
+/** 자리의 계층 — ISA-95 장비 계층. 계약이 실행시 상수로 준다. */
+export declare const LEVEL_OPTIONS: readonly string[];
+/**
+ * 공정의 의도 — 운반 · 가공 · 체류.
+ *
+ * 계약은 `OperationIntent` 를 **타입**으로만 낸다. 아래 두 줄이 이 배열을 그 타입에 묶는다.
+ */
+export declare const INTENT_OPTIONS: readonly ["transport", "process", "dwell"];
+/**
+ * 고르는 칸의 첫 줄은 **빈 값**이다.
+ *
+ * 안 넣으면 「아직 안 정했다」를 고를 수 없어서, 칸을 한 번 건드리면 되돌릴 수 없다. 비워 둘 수
+ * 있는 칸에만 붙인다.
+ */
+export declare function withBlank(options: readonly string[]): string[];

package/dist-client/pages/master/master-options.js

@@ -0,0 +1,47 @@
+import { EQUIPMENT_LEVEL } from '@operato/ops-contract';
+/**
+ * 닫힌 값 집합 — **고르는 칸의 값은 커널에서 온다.**
+ *
+ * ── 왜 이 파일이 있나 ──────────────────────────────────────────────────────
+ * 마스터 화면의 칸이 거의 다 자유 텍스트였다. `level` 에 `WorkCel` 이라고 쳐도 아무 일도 안 나고,
+ * 저장되고, 그 뒤로 그 자리는 어떤 계산에도 안 잡힌다. 값이 정해져 있는 칸은 고르게 해야 한다.
+ *
+ * ── 목록을 여기에 손으로 적지 않는다 ────────────────────────────────────────
+ * 화면에 값을 베껴 적으면 커널이 값을 하나 늘렸을 때 화면만 옛 목록을 보인다. 그래서 **계약이
+ * 실행시 상수로 내주는 것은 그대로 가져다 쓴다.**
+ *
+ * 계약이 **타입으로만** 주는 것이 있다. 타입은 실행시에 사라지므로 목록을 만들 수 없다. 그때만
+ * 거울을 두고, **컴파일러가 그 거울을 계약에 묶는다** — 계약 쪽이 값을 더하거나 빼면 이 파일이
+ * 컴파일되지 않는다. 베껴 적은 것과 다른 점이 그것이다.
+ *
+ * 계약이 상수를 내주면 거울을 지운다. 아키텍트에게 올려 두었다(`EQUIPMENT_LEVEL` ·
+ * `DISPOSITION_DECISION` 처럼 `OPERATION_INTENT` 도 상수로).
+ */
+/** 자리의 계층 — ISA-95 장비 계층. 계약이 실행시 상수로 준다. */
+export const LEVEL_OPTIONS = EQUIPMENT_LEVEL;
+/**
+ * 공정의 의도 — 운반 · 가공 · 체류.
+ *
+ * 계약은 `OperationIntent` 를 **타입**으로만 낸다. 아래 두 줄이 이 배열을 그 타입에 묶는다.
+ */
+export const INTENT_OPTIONS = ['transport', 'process', 'dwell'];
+/*
+ * **양쪽으로 묶는다.**
+ *
+ * 위 줄만 있으면 계약이 값을 하나 빼도 안 깨진다(우리 것이 더 넓어질 뿐이다). 아래 줄만 있으면
+ * 계약이 값을 하나 더해도 안 깨진다. 둘 다 있어야 어느 쪽이 움직여도 컴파일이 멈춘다.
+ */
+const _intentIsInContract = [...INTENT_OPTIONS];
+const _contractIsInIntent = ['transport', 'process', 'dwell'];
+void _intentIsInContract;
+void _contractIsInIntent;
+/**
+ * 고르는 칸의 첫 줄은 **빈 값**이다.
+ *
+ * 안 넣으면 「아직 안 정했다」를 고를 수 없어서, 칸을 한 번 건드리면 되돌릴 수 없다. 비워 둘 수
+ * 있는 칸에만 붙인다.
+ */
+export function withBlank(options) {
+    return ['', ...options];
+}
+//# sourceMappingURL=master-options.js.map

package/dist-client/pages/master/master-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"master-options.js","sourceRoot":"","sources":["../../../client/pages/master/master-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAGvD;;;;;;;;;;;;;;;;;GAiBG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAsB,eAAe,CAAA;AAE/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAU,CAAA;AAExE;;;;;GAKG;AACH,MAAM,mBAAmB,GAAsB,CAAC,GAAG,cAAc,CAAC,CAAA;AAClE,MAAM,mBAAmB,GAAsC,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,CAAsB,CAAA;AAErH,KAAK,mBAAmB,CAAA;AACxB,KAAK,mBAAmB,CAAA;AAExB;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,OAA0B;IAClD,OAAO,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAA;AACzB,CAAC","sourcesContent":["import { EQUIPMENT_LEVEL } from '@operato/ops-contract'\nimport type { OperationIntent } from '@operato/ops-contract'\n\n/**\n * 닫힌 값 집합 — **고르는 칸의 값은 커널에서 온다.**\n *\n * ── 왜 이 파일이 있나 ──────────────────────────────────────────────────────\n * 마스터 화면의 칸이 거의 다 자유 텍스트였다. `level` 에 `WorkCel` 이라고 쳐도 아무 일도 안 나고,\n * 저장되고, 그 뒤로 그 자리는 어떤 계산에도 안 잡힌다. 값이 정해져 있는 칸은 고르게 해야 한다.\n *\n * ── 목록을 여기에 손으로 적지 않는다 ────────────────────────────────────────\n * 화면에 값을 베껴 적으면 커널이 값을 하나 늘렸을 때 화면만 옛 목록을 보인다. 그래서 **계약이\n * 실행시 상수로 내주는 것은 그대로 가져다 쓴다.**\n *\n * 계약이 **타입으로만** 주는 것이 있다. 타입은 실행시에 사라지므로 목록을 만들 수 없다. 그때만\n * 거울을 두고, **컴파일러가 그 거울을 계약에 묶는다** — 계약 쪽이 값을 더하거나 빼면 이 파일이\n * 컴파일되지 않는다. 베껴 적은 것과 다른 점이 그것이다.\n *\n * 계약이 상수를 내주면 거울을 지운다. 아키텍트에게 올려 두었다(`EQUIPMENT_LEVEL` ·\n * `DISPOSITION_DECISION` 처럼 `OPERATION_INTENT` 도 상수로).\n */\n\n/** 자리의 계층 — ISA-95 장비 계층. 계약이 실행시 상수로 준다. */\nexport const LEVEL_OPTIONS: readonly string[] = EQUIPMENT_LEVEL\n\n/**\n * 공정의 의도 — 운반 · 가공 · 체류.\n *\n * 계약은 `OperationIntent` 를 **타입**으로만 낸다. 아래 두 줄이 이 배열을 그 타입에 묶는다.\n */\nexport const INTENT_OPTIONS = ['transport', 'process', 'dwell'] as const\n\n/*\n * **양쪽으로 묶는다.**\n *\n * 위 줄만 있으면 계약이 값을 하나 빼도 안 깨진다(우리 것이 더 넓어질 뿐이다). 아래 줄만 있으면\n * 계약이 값을 하나 더해도 안 깨진다. 둘 다 있어야 어느 쪽이 움직여도 컴파일이 멈춘다.\n */\nconst _intentIsInContract: OperationIntent[] = [...INTENT_OPTIONS]\nconst _contractIsInIntent: (typeof INTENT_OPTIONS)[number][] = ['transport', 'process', 'dwell'] as OperationIntent[]\n\nvoid _intentIsInContract\nvoid _contractIsInIntent\n\n/**\n * 고르는 칸의 첫 줄은 **빈 값**이다.\n *\n * 안 넣으면 「아직 안 정했다」를 고를 수 없어서, 칸을 한 번 건드리면 되돌릴 수 없다. 비워 둘 수\n * 있는 칸에만 붙인다.\n */\nexport function withBlank(options: readonly string[]): string[] {\n  return ['', ...options]\n}\n"]}

package/dist-client/pages/master/master-page-base.d.ts

@@ -0,0 +1,357 @@
+import '@material/web/icon/icon.js';
+import '@operato/data-grist/ox-grist.js';
+import { DataGrist, FetchOption } from '@operato/data-grist';
+import type { ReferenceOptions } from './grist-reference.js';
+import { PageView } from '@operato/shell';
+/**
+ * 마스터 화면이 함께 쓰는 것 — **코드 재사용은 여기서, 화면은 각자.**
+ *
+ * ── 왜 화면을 갈랐나 (2026-09-01) ──────────────────────────────────────────
+ * 전에는 화면 하나가 `?axis=` 로 열두 축을 다 맡았다. 근거는 「열두 축이 하는 일이 같다」였는데, 그
+ * 말은 **지금 자리표시자라서 같아 보이는 것**이었다. 선언을 읽으면 이미 갈라져 있다.
+ *
+ *   정지 사유 · 위치      계층(parentName · parentId) — 표가 아니라 나무여야 한다
+ *   등급 넷              baseIds 다중 상속 — 쉼표 문자열로 편집 중이다
+ *   인원 · 설비 · 자산    근무 캘린더 · 검사 결과를 JSON 원문으로 보인다
+ *   자재                 GTIN · 단위 · 보관처의 칸이 없어 properties JSON 이다
+ *   공정                 duration 이 ISO 기간, bizStep 이 EPCIS 어휘다
+ *   검사 기준            컬럼이 0개다 — 항목 · 상하한 · 단위 · 방법이 들어와야 한다
+ *
+ * 그 자리표시자를 걷으면 열둘이 서로 다른 화면이 된다. 공용 화면에 「이 축만」 분기를 열둘 넣는 것은
+ * 화면 열둘보다 나쁘다.
+ *
+ * ── UX 일관성과 일괄 개발 편의는 다르다 ────────────────────────────────────
+ * 일관성은 **쓰는 사람이 겪는 것**이다. 같은 뜻이 같은 자리에, 같은 용어로, 같은 조작으로. 그것은
+ * 어휘와 배치와 부품을 공유해서 얻는다.
+ *
+ * 일괄 개발의 편의는 **만드는 쪽이 겪는 것**이고, 기반 클래스로 얻으면 된다. 그것을 얻으려고 서로 다른
+ * 대상을 한 화면에 묶으면 편의는 만드는 쪽이 가져가고 값은 쓰는 쪽이 치른다.
+ *
+ * ── MDI 에서도 갈려야 한다 ─────────────────────────────────────────────────
+ * MDI 탭은 페이지 **요소**로 나뉜다(`page-mdibar.ts`). 한 라우트면 인원과 설비를 나란히 열 수 없는데,
+ * 마스터 작업의 대부분이 두 항목을 비교하며 옮겨 적는 일이다. 품목을 보면서 품목 등급을 채운다.
+ *
+ * ── 이 클래스가 갖는 것과 갖지 않는 것 ─────────────────────────────────────
+ * 갖는 것: 화면 골격 · 컬럼 설정 · 가져오기 · 저장 · 컬럼 하나를 그리는 방식.
+ * 갖지 않는 것: **무엇을 보이나.** 그것은 각 화면이 `spec` 으로 말한다.
+ */
+export type MasterColumnType = 'string' | 'number' | 'boolean' | 'date' | 'json' | 'list'
+/** 정해진 값 중에서 고른다. `options` 를 함께 준다. */
+ | 'select'
+/**
+ * ISO 8601 기간 — `PT30S`.
+ *
+ * 이름이 `duration` 이 아니다. 그 이름은 초 숫자용으로 이미 임자가 있다(`worklist`). 등록소를
+ * 앱 전체가 나눠 쓰므로, 이름이 겹치면 나중에 부팅한 쪽이 오류보고없이 이긴다.
+ */
+ | 'iso-duration'
+/** 다른 표의 이름 하나. `reference` 를 함께 준다. */
+ | 'reference' | 'reference-list';
+export interface MasterColumn {
+    name: string;
+    /** 화면 문구 키. `field.<이것>`. */
+    label: string;
+    type: MasterColumnType;
+    /**
+     * `select` 가 고를 값들.
+     *
+     * **여기에 손으로 적지 않는다.** `master-options.ts` 가 계약에서 가져오거나, 계약이 타입으로만
+     * 주는 것은 컴파일러가 계약에 묶은 거울에서 가져온다. 화면에 값을 베껴 적으면 커널이 값을 늘렸을
+     * 때 화면만 옛 목록을 보인다.
+     */
+    options?: readonly string[];
+    /**
+     * `reference` 가 어느 표에서 고르나.
+     *
+     * 저장되는 것은 **이름**이지 id 가 아니다 — 커널이 이름으로 주소를 잡는다.
+     */
+    reference?: ReferenceOptions;
+    width?: number;
+    /** 고칠 수 없는 칸. 자동으로 붙는 값이 여기 온다. */
+    readonly?: boolean;
+    /**
+     * 가로로 스크롤해도 화면에 남는 컬럼.
+     *
+     * 컬럼이 열 개를 넘고 폭 합이 1000px 을 넘는 축이 있다. 오른쪽 끝을 고치려고 스크롤하면 이름이 화면
+     * 밖으로 나가서 **어느 행을 고치는지 알 수 없다.**
+     */
+    fixed?: boolean;
+    /**
+     * 표에 그리지 않는다 — **검색에는 남는다.**
+     *
+     * 같은 사실을 두 번 보이지 않으려고 감추는 자리가 있다. 로케이션의 상위는 트리의 들여쓰기가 말하므로
+     * 컬럼으로 또 보일 필요가 없지만, 「LINE-1 아래 있는 것」을 찾는 일은 있다.
+     *
+     * `searchText` 는 `filter: 'search'` 를 선언한 컬럼마다 필터를 만들고 hidden 을 보지 않는다
+     * (`data-grist.ts` 의 `set searchText`). 그래서 감춘 컬럼도 검색에는 참여한다.
+     *
+     * 다만 컬럼 설정 목록에서는 **빠진다** — personalizer 가 페이지 설정의 hidden 을 걸러낸다
+     * (`ox-grist-personalizer.ts:51`). 사용자가 켜야 할 컬럼에는 쓰지 않는다.
+     */
+    hidden?: boolean;
+}
+/** 각 마스터 화면이 자기에 대해 말하는 것. */
+export interface MasterSpec {
+    /** 컬럼 설정을 사람마다 따로 저장하는 키. 화면마다 달라야 한다. */
+    key: string;
+    /** 제목 문구 키. `title.<이것>`. */
+    title: string;
+    /**
+     * 도움말 문서 키 — `helps/<이것>.md`.
+     *
+     * `ox-page-title-bar` 가 이 값이 있으면 제목 옆에 도움말 아이콘을 그린다. 상세한 설명은 그 문서가
+     * 갖는다 — 화면에 형식적인 소개 문장을 붙이는 것은 자리만 차지하고 도움이 안 된다.
+     */
+    help: string;
+    /** GraphQL 조회 이름 — 서버가 낸 그대로. */
+    query: string;
+    /** GraphQL 저장 이름. */
+    mutation: string;
+    columns: MasterColumn[];
+}
+/** 열두 축이 공통으로 갖는 유효 기간 — ISA-95. */
+export declare const EFFECTIVE: MasterColumn[];
+/** 이름과 설명은 열두 축이 모두 갖는다. 이름은 스크롤해도 남는다. */
+export declare const IDENTITY: MasterColumn[];
+declare const MasterPageBase_base: (new (...args: any[]) => {
+    __preferenceProviders: {
+        [element: string]: import("@operato/p13n").PagePreferenceProvider;
+    };
+    getPagePreferenceProvider(element: string): import("@operato/p13n").PagePreferenceProvider | undefined;
+}) & (new (...args: any[]) => import("lit").LitElement) & typeof PageView;
+export declare abstract class MasterPageBase extends MasterPageBase_base {
+    static styles: import("lit").CSSResult[];
+    /** 이 화면이 자기에 대해 말하는 것. 화면마다 자기 것을 준다. */
+    protected abstract get spec(): MasterSpec;
+    active: boolean;
+    gristConfig: any;
+    mode: 'CARD' | 'LIST' | 'GRID';
+    protected ready: boolean;
+    protected grist: DataGrist;
+    get context(): {
+        title: string;
+        importable: {
+            handler: (records: any[]) => Promise<void>;
+        };
+        help: string;
+        search: {
+            handler: (search: string) => void;
+            value: string;
+        };
+        actions: {
+            title: string;
+            action: () => Promise<void>;
+            icon: string;
+            emphasis: {
+                raised: boolean;
+            };
+        }[];
+        exportable: {
+            name: string;
+            data: () => any[];
+        };
+    };
+    /**
+     * 지금 무엇을 보고 있는가 — 표 바로 위.
+     *
+     * 계층을 드릴다운으로 걷는 화면은 「어디를 보고 있나」를 말해야 한다. 대부분의 화면은 표 하나가 전부라
+     * 범위가 없다 — 그런 화면은 아무것도 그리지 않고, 그 줄이 접힌다.
+     */
+    protected renderScope(): import("lit-html").TemplateResult<1>;
+    /**
+     * 화면 골격 — 표 하나와 컬럼 설정.
+     *
+     * 자기 인터페이스가 필요한 화면은 이것을 덮어쓴다. 위치와 정지 사유는 계층이라 표가 아니라 나무여야
+     * 하고, 그때 이 render 를 쓰지 않는다.
+     */
+    render(): import("lit-html").TemplateResult<1>;
+    /**
+     * 주소 끝의 이름 조각을 **목록 좁히기**에 쓰나.
+     *
+     * 다른 화면의 참조 칸에서 걸어 들어오면 주소가 `.../ops-master-material-definition/M0161-0003` 이
+     * 된다. 그 조각을 아무도 안 읽으면 106줄짜리 목록 첫 장이 뜨고, 사람은 방금 누른 이름을 다시
+     * 찾아야 한다 — 걸어온 보람이 없다.
+     *
+     * 자리 화면과 제조법 화면은 그 조각을 **파고들기**에 이미 쓰고 있다(그 이름 아래를 보여 준다).
+     * 그 둘은 여기서 빠진다 — 두 뜻이 한 조각에 겹치면 어느 쪽도 제대로 안 된다.
+     */
+    protected get pathSegmentNarrowsList(): boolean;
+    pageInitialized(): Promise<void>;
+    /**
+     * 셸은 `(changes, after, before)` 를 넘긴다 — 인수 없는 모양으로 좁히면 주소를 읽어야 하는 화면이
+     * 이것을 덮어쓸 수 없다(`after.resourceId` 와 `before.resourceId` 를 비교하는 자리다).
+     */
+    pageUpdated(_changes?: any, _after?: any, _before?: any): Promise<void>;
+    protected configOf(): any;
+    protected columnOf(column: MasterColumn): {
+        type: string;
+        name: string;
+        header: string;
+        record: {
+            editable: boolean;
+            options?: undefined;
+            reference?: undefined;
+            editor?: undefined;
+            opensPopup?: undefined;
+        };
+        sortable: boolean;
+        width: number | undefined;
+        fixed: boolean | undefined;
+        hidden: boolean | undefined;
+        filter?: undefined;
+    } | {
+        type: string;
+        name: string;
+        header: string;
+        record: {
+            editable: boolean;
+            options?: undefined;
+            reference?: undefined;
+            editor?: undefined;
+            opensPopup?: undefined;
+        };
+        width: number | undefined;
+        fixed: boolean | undefined;
+        hidden: boolean | undefined;
+        sortable?: undefined;
+        filter?: undefined;
+    } | {
+        type: string;
+        name: string;
+        header: string;
+        record: {
+            editable: boolean;
+            options: readonly string[];
+            reference?: undefined;
+            editor?: undefined;
+            opensPopup?: undefined;
+        };
+        filter: string;
+        sortable: boolean;
+        width: number | undefined;
+        fixed: boolean | undefined;
+        hidden: boolean | undefined;
+    } | {
+        type: string;
+        name: string;
+        header: string;
+        record: {
+            editable: boolean;
+            reference: {
+                queryName?: string | undefined;
+                multiple?: boolean;
+                title: string;
+                columns?: {
+                    name: string;
+                    header?: string;
+                    width?: number;
+                }[];
+                valueField?: string;
+            };
+            options?: undefined;
+            editor?: undefined;
+            opensPopup?: undefined;
+        };
+        filter: string;
+        sortable: boolean;
+        width: number | undefined;
+        fixed: boolean | undefined;
+        hidden: boolean | undefined;
+    } | {
+        type: string;
+        name: string;
+        header: string;
+        record: {
+            editable: boolean;
+            editor: import("@operato/data-grist").FieldEditor;
+            opensPopup: boolean;
+            reference: {
+                queryName?: string | undefined;
+                multiple: boolean;
+                title: string;
+                columns?: {
+                    name: string;
+                    header?: string;
+                    width?: number;
+                }[];
+                valueField?: string;
+            };
+            options?: undefined;
+        };
+        sortable: boolean;
+        width: number | undefined;
+        fixed: boolean | undefined;
+        hidden: boolean | undefined;
+        filter?: undefined;
+    } | {
+        type: string;
+        name: string;
+        header: string;
+        record: {
+            editable: boolean;
+            options?: undefined;
+            reference?: undefined;
+            editor?: undefined;
+            opensPopup?: undefined;
+        };
+        filter: string;
+        sortable: boolean;
+        width: number | undefined;
+        fixed: boolean | undefined;
+        hidden: boolean | undefined;
+    };
+    fetchHandler({ page, limit, sortings, filters }: FetchOption): Promise<{
+        total: any;
+        records: any;
+    }>;
+    /**
+     * JSON 칸을 **사람이 고칠 수 있는 글자로 편다.**
+     *
+     * 서버는 구조를 구조로 낸다(`ScalarObject` 로 선언하지만 **스키마에 나가는 이름은 `Object`** 다) — 그것이
+   * 사실이고, 곧 붙을 전용 편집기가 원하는 모양이다.
+     * 그런데 지금 이 그리드의 JSON 칸은 글자 편집기라 객체를 그대로 주면 `[object Object]` 가 된다.
+     * 그래서 **화면에 들어올 때만** 편다. 스키마를 화면 사정에 맞추지 않고, 화면이 자기 몫을 한다.
+     *
+     * 이 옮김은 `packJson` 과 짝이다. 한쪽만 고치면 저장이 오류보고없이 망가진다.
+     */
+    protected spreadJson(item: any): any;
+    /**
+     * 저장하기 전에 JSON 칸의 글자를 **구조로 되읽는다.**
+     *
+     * 읽지 못하면 **보내지 않는다.** 그냥 보내면 글자가 통째로 값이 되어, 사람이 적은 구조가 사라진 채로
+     * 저장이 성공했다고 나온다. 어느 행 어느 칸인지 말해 주어야 고칠 수 있다.
+     */
+    protected packJson(patches: any[]): {
+        patches: any[];
+        problems: string[];
+    };
+    /**
+     * 파일로 올린 줄들을 이 화면의 마스터로 넣는다.
+     *
+     * ── 오류보고없이 버리지 않는다 ─────────────────────────────────────────────────
+     * 모르는 열 이름, 이름이 없는 줄, 중복된 이름을 **알린다.** 오류보고없이 빼면 사람은 다 올라간 줄 알고,
+     * 빠진 것은 나중에 「그 설비가 왜 없지」로 나타난다.
+     *
+     * ── 하나라도 틀리면 아무것도 안 보낸다 ───────────────────────────────────
+     * 절반만 들어가면 무엇이 들어갔는지 사람이 모른다. 파일을 고쳐 다시 올리는 편이 낫다.
+     *
+     * ── 새로 만들 것과 고칠 것을 이름으로 구분한다 ─────────────────────────────
+     * 서버는 `+`(새로)와 `M`(고침, id 필요)을 나눠 받는다. 그러니 **올리기 전에 그 이름들이 이미
+     * 있는지 물어야 한다.** 안 물으면 같은 이름이 두 벌 생긴다.
+     */
+    protected importHandler(records: any[]): Promise<void>;
+    /**
+     * 파일의 머리글을 이 화면의 열 이름으로 바꾼다.
+     *
+     * **두 가지를 다 받는다** — 열 이름 그대로(`homeLocation`)와 화면에 보이는 말(`홈 자리`).
+     * 사람이 이 화면에서 내려받아 고쳐 올리면 머리글이 화면의 말이고, 다른 시스템에서 뽑아 오면
+     * 열 이름이다. 한쪽만 받으면 다른 쪽이 통째로 「모르는 열」이 된다.
+     */
+    /** 무엇이 잘못됐는지를 사람에게 보일 문장으로 바꾼다. 줄 번호는 엑셀에서 보는 그 번호다. */
+    private sayProblem;
+    private headerIndex;
+    /** 이 이름들이 이미 있나 — 있으면 그 `id`. 없는 이름은 지도에 없다. */
+    private idsByName;
+    protected save(): Promise<void>;
+}
+export {};