@things-factory/shell 10.1.40 → 10.1.46

package/dist-server/utils/after-commit.d.ts

@@ -0,0 +1,15 @@
+export type AfterCommitStep = {
+    name: string;
+    run: () => unknown | Promise<unknown>;
+};
+export type AfterCommit = AfterCommitStep[];
+/** Adds a step. With no list (outside a transaction) it returns false, and the caller does it at once. */
+export declare function whenCommitted(afterCommit: AfterCommit | undefined, name: string, run: AfterCommitStep['run']): boolean;
+/** Runs the steps in order. A failing one is reported by name and the rest still run. */
+export declare function runAfterCommit(afterCommit: AfterCommit, report: (message: string, error: unknown) => void): Promise<void>;
+/**
+ * Opens the transaction, hands the body the list, and runs the list once committed. The directive and
+ * any code that opens a transaction by hand share it. transact has the shape of dataSource.transaction:
+ * if the body throws, it rolls back and throws.
+ */
+export declare function runTransaction<T, TX>(transact: (work: (tx: TX) => Promise<T>) => Promise<T>, body: (tx: TX, afterCommit: AfterCommit) => Promise<T>, report: (message: string, error: unknown) => void): Promise<T>;

package/dist-server/utils/after-commit.js

@@ -0,0 +1,60 @@
+"use strict";
+/*
+ * What to do after the commit - a list @transaction hangs on the request it opens (ruling 2026-09-24).
+ *
+ * -- Why --------------------------------------------------------------------
+ * Something that cannot be undone, such as deleting a file from storage, done inside the transaction
+ * outlives a commit that then fails: the rows come back and the file does not. An attachment row is
+ * left pointing at nothing.
+ *
+ * -- Shape ------------------------------------------------------------------
+ * The directive puts an empty list on context.state.afterCommit. Code inside does not do the
+ * irreversible thing at once; it adds it to the list with a name. The moment the transaction returns
+ * its value is the moment after the commit, and the list is run then, in order. On a rollback the
+ * transaction throws, the list is never reached, and it is dropped.
+ *
+ * -- A failure afterwards does not fail the request -------------------------
+ * The commit has happened; there is nothing to roll back. A failing step is logged with its name, so
+ * what was left behind can be found, and the next step runs. One orphaned file is less harm than an
+ * attachment row with no file.
+ *
+ * -- Where there is no list -------------------------------------------------
+ * Outside the directive - a call with no transaction - there is no list and nothing to roll back, so
+ * the caller does it at once. A transaction opened by hand (getDataSource().transaction(...) called
+ * directly) has no list either, and the same hole remains there; such code gets the list by opening
+ * its transaction with runTransaction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.whenCommitted = whenCommitted;
+exports.runAfterCommit = runAfterCommit;
+exports.runTransaction = runTransaction;
+/** Adds a step. With no list (outside a transaction) it returns false, and the caller does it at once. */
+function whenCommitted(afterCommit, name, run) {
+    if (!Array.isArray(afterCommit))
+        return false;
+    afterCommit.push({ name, run });
+    return true;
+}
+/** Runs the steps in order. A failing one is reported by name and the rest still run. */
+async function runAfterCommit(afterCommit, report) {
+    for (const step of afterCommit) {
+        try {
+            await step.run();
+        }
+        catch (error) {
+            report(`after commit, "${step.name}" failed - left behind`, error);
+        }
+    }
+}
+/**
+ * Opens the transaction, hands the body the list, and runs the list once committed. The directive and
+ * any code that opens a transaction by hand share it. transact has the shape of dataSource.transaction:
+ * if the body throws, it rolls back and throws.
+ */
+async function runTransaction(transact, body, report) {
+    const afterCommit = [];
+    const result = await transact(tx => body(tx, afterCommit));
+    await runAfterCommit(afterCommit, report);
+    return result;
+}
+//# sourceMappingURL=after-commit.js.map

package/dist-server/utils/after-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-commit.js","sourceRoot":"","sources":["../../server/utils/after-commit.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AAMH,sCAIC;AAGD,wCAWC;AAOD,wCAWC;AArCD,0GAA0G;AAC1G,SAAgB,aAAa,CAAC,WAAoC,EAAE,IAAY,EAAE,GAA2B;IAC3G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7C,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAA;IAC/B,OAAO,IAAI,CAAA;AACb,CAAC;AAED,yFAAyF;AAClF,KAAK,UAAU,cAAc,CAClC,WAAwB,EACxB,MAAiD;IAEjD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,EAAE,CAAA;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,kBAAkB,IAAI,CAAC,IAAI,wBAAwB,EAAE,KAAK,CAAC,CAAA;QACpE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,cAAc,CAClC,QAAsD,EACtD,IAAsD,EACtD,MAAiD;IAEjD,MAAM,WAAW,GAAgB,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAAA;IAE1D,MAAM,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAEzC,OAAO,MAAM,CAAA;AACf,CAAC","sourcesContent":["/*\n * What to do after the commit - a list @transaction hangs on the request it opens (ruling 2026-09-24).\n *\n * -- Why --------------------------------------------------------------------\n * Something that cannot be undone, such as deleting a file from storage, done inside the transaction\n * outlives a commit that then fails: the rows come back and the file does not. An attachment row is\n * left pointing at nothing.\n *\n * -- Shape ------------------------------------------------------------------\n * The directive puts an empty list on context.state.afterCommit. Code inside does not do the\n * irreversible thing at once; it adds it to the list with a name. The moment the transaction returns\n * its value is the moment after the commit, and the list is run then, in order. On a rollback the\n * transaction throws, the list is never reached, and it is dropped.\n *\n * -- A failure afterwards does not fail the request -------------------------\n * The commit has happened; there is nothing to roll back. A failing step is logged with its name, so\n * what was left behind can be found, and the next step runs. One orphaned file is less harm than an\n * attachment row with no file.\n *\n * -- Where there is no list -------------------------------------------------\n * Outside the directive - a call with no transaction - there is no list and nothing to roll back, so\n * the caller does it at once. A transaction opened by hand (getDataSource().transaction(...) called\n * directly) has no list either, and the same hole remains there; such code gets the list by opening\n * its transaction with runTransaction.\n */\n\nexport type AfterCommitStep = { name: string; run: () => unknown | Promise<unknown> }\nexport type AfterCommit = AfterCommitStep[]\n\n/** Adds a step. With no list (outside a transaction) it returns false, and the caller does it at once. */\nexport function whenCommitted(afterCommit: AfterCommit | undefined, name: string, run: AfterCommitStep['run']): boolean {\n  if (!Array.isArray(afterCommit)) return false\n  afterCommit.push({ name, run })\n  return true\n}\n\n/** Runs the steps in order. A failing one is reported by name and the rest still run. */\nexport async function runAfterCommit(\n  afterCommit: AfterCommit,\n  report: (message: string, error: unknown) => void\n): Promise<void> {\n  for (const step of afterCommit) {\n    try {\n      await step.run()\n    } catch (error) {\n      report(`after commit, \"${step.name}\" failed - left behind`, error)\n    }\n  }\n}\n\n/**\n * Opens the transaction, hands the body the list, and runs the list once committed. The directive and\n * any code that opens a transaction by hand share it. transact has the shape of dataSource.transaction:\n * if the body throws, it rolls back and throws.\n */\nexport async function runTransaction<T, TX>(\n  transact: (work: (tx: TX) => Promise<T>) => Promise<T>,\n  body: (tx: TX, afterCommit: AfterCommit) => Promise<T>,\n  report: (message: string, error: unknown) => void\n): Promise<T> {\n  const afterCommit: AfterCommit = []\n  const result = await transact(tx => body(tx, afterCommit))\n\n  await runAfterCommit(afterCommit, report)\n\n  return result\n}\n"]}

package/dist-server/utils/index.d.ts

@@ -10,3 +10,4 @@ export * from './list-param-adjuster.js';
 export * from './get-times-for-period.js';
 export * from './headless-pool/index.js';
 export * from './subscribe-auth.js';
+export * from './after-commit.js';

package/dist-server/utils/index.js

@@ -13,4 +13,5 @@ tslib_1.__exportStar(require("./list-param-adjuster.js"), exports);
 tslib_1.__exportStar(require("./get-times-for-period.js"), exports);
 tslib_1.__exportStar(require("./headless-pool/index.js"), exports);
 tslib_1.__exportStar(require("./subscribe-auth.js"), exports);
+tslib_1.__exportStar(require("./after-commit.js"), exports);
 //# sourceMappingURL=index.js.map

package/dist-server/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/utils/index.ts"],"names":[],"mappings":";;;AAAA,0DAA+B;AAC/B,mEAAwC;AACxC,iEAAsC;AACtC,kEAAuC;AACvC,qEAA0C;AAC1C,gEAAqC;AACrC,kFAAuD;AACvD,6DAAkC;AAClC,mEAAwC;AACxC,oEAAyC;AACzC,mEAAwC;AACxC,8DAAmC","sourcesContent":["export * from './get-domain.js'\nexport * from './apply-domain-filter.js'\nexport * from './condition-builder.js'\nexport * from './list-query-builder.js'\nexport * from './list-params-converter.js'\nexport * from './publish-progress.js'\nexport * from './get-query-builder-from-list-params.js'\nexport * from './keyset-cursor.js'\nexport * from './list-param-adjuster.js'\nexport * from './get-times-for-period.js'\nexport * from './headless-pool/index.js'\nexport * from './subscribe-auth.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/utils/index.ts"],"names":[],"mappings":";;;AAAA,0DAA+B;AAC/B,mEAAwC;AACxC,iEAAsC;AACtC,kEAAuC;AACvC,qEAA0C;AAC1C,gEAAqC;AACrC,kFAAuD;AACvD,6DAAkC;AAClC,mEAAwC;AACxC,oEAAyC;AACzC,mEAAwC;AACxC,8DAAmC;AACnC,4DAAiC","sourcesContent":["export * from './get-domain.js'\nexport * from './apply-domain-filter.js'\nexport * from './condition-builder.js'\nexport * from './list-query-builder.js'\nexport * from './list-params-converter.js'\nexport * from './publish-progress.js'\nexport * from './get-query-builder-from-list-params.js'\nexport * from './keyset-cursor.js'\nexport * from './list-param-adjuster.js'\nexport * from './get-times-for-period.js'\nexport * from './headless-pool/index.js'\nexport * from './subscribe-auth.js'\nexport * from './after-commit.js'\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/shell",
-  "version": "10.1.40",
+  "version": "10.1.46",
   "description": "Core module for framework",
   "bin": {
     "things-factory": "bin/things-factory",
@@ -126,5 +126,5 @@
     "pg": "^8.7.3",
     "sqlite3": "^5.0.8"
   },
-  "gitHead": "51c5d804c14ad8fcc6d4707e6ef80c9deede2766"
+  "gitHead": "d3467cde550453f3348fed0ed6c79a12a6ba0db4"
 }

package/tests/after-commit.test.ts

@@ -0,0 +1,200 @@
+import { graphql } from 'graphql'
+import gql from 'graphql-tag'
+import { makeExecutableSchema } from '@graphql-tools/schema'
+
+/**
+ * What waits for the commit (ADR-0091 decision 8).
+ *
+ * What this splits: after the commit against before it, a rollback against a commit, one failing step
+ * against the rest, and a call with a list against one without. The directive is driven through a real
+ * schema with the data source replaced by one that records when it commits.
+ */
+
+const mockEvents: string[] = []
+let mockFailCommit = false
+
+jest.mock('../server/initializers/database', () => ({
+  getDataSource: () => ({
+    transaction: async (work: (tx: any) => Promise<any>) => {
+      const result = await work('tx')
+      if (mockFailCommit) throw new Error('commit failed')
+      mockEvents.push('commit')
+      return result
+    }
+  })
+}))
+
+jest.mock('@things-factory/env', () => ({ logger: { error: (message: string) => mockEvents.push(`logged: ${message}`) } }))
+
+import { runAfterCommit, runTransaction, whenCommitted } from '../server/utils/after-commit'
+import { transactionDirectiveResolver, transactionDirectiveTypeDefs } from '../server/service/directive-transaction/transaction'
+
+beforeEach(() => {
+  mockEvents.length = 0
+  mockFailCommit = false
+})
+
+describe('the list', () => {
+  it('without a list there is nothing to wait for: the caller is told to do it now', () => {
+    expect(whenCommitted(undefined, 'x', () => {})).toBe(false)
+  })
+
+  it('with a list the step is added, not run', () => {
+    const list: any[] = []
+    let ran = false
+
+    expect(whenCommitted(list, 'x', () => (ran = true))).toBe(true)
+    expect(list.map(one => one.name)).toEqual(['x'])
+    expect(ran).toBe(false)
+  })
+
+  it('steps run in order, and a failing one is reported by name while the rest still run', async () => {
+    const reported: string[] = []
+
+    await runAfterCommit(
+      [
+        { name: 'first', run: () => mockEvents.push('first') },
+        { name: 'breaks', run: () => Promise.reject(new Error('storage down')) },
+        { name: 'third', run: () => mockEvents.push('third') }
+      ],
+      message => reported.push(message)
+    )
+
+    expect(mockEvents).toEqual(['first', 'third'])
+    expect(reported).toEqual(['after commit, "breaks" failed - left behind'])
+  })
+
+  it('an empty list does nothing', async () => {
+    await runAfterCommit([], () => mockEvents.push('reported'))
+    expect(mockEvents).toEqual([])
+  })
+})
+
+describe('runTransaction', () => {
+  const transact = async (work: (tx: any) => Promise<any>) => {
+    const result = await work('tx')
+    if (mockFailCommit) throw new Error('commit failed')
+    mockEvents.push('commit')
+    return result
+  }
+
+  it('runs the list after the commit, not before', async () => {
+    await runTransaction(
+      transact,
+      async (_tx, afterCommit) => {
+        whenCommitted(afterCommit, 'file', () => mockEvents.push('file'))
+        mockEvents.push('body')
+        return 1
+      },
+      () => {}
+    )
+
+    expect(mockEvents).toEqual(['body', 'commit', 'file'])
+  })
+
+  it('a body that throws rolls back and the list is dropped', async () => {
+    await expect(
+      runTransaction(
+        transact,
+        async (_tx, afterCommit) => {
+          whenCommitted(afterCommit, 'file', () => mockEvents.push('file'))
+          throw new Error('refused')
+        },
+        () => {}
+      )
+    ).rejects.toThrow('refused')
+
+    expect(mockEvents).not.toContain('file')
+  })
+
+  it('a commit that fails drops the list too', async () => {
+    mockFailCommit = true
+
+    await expect(
+      runTransaction(
+        transact,
+        async (_tx, afterCommit) => {
+          whenCommitted(afterCommit, 'file', () => mockEvents.push('file'))
+          return 1
+        },
+        () => {}
+      )
+    ).rejects.toThrow('commit failed')
+
+    expect(mockEvents).not.toContain('file')
+  })
+
+  it('a step that fails after the commit does not fail the request', async () => {
+    const result = await runTransaction(
+      transact,
+      async (_tx, afterCommit) => {
+        whenCommitted(afterCommit, 'file', () => Promise.reject(new Error('storage down')))
+        return 'done'
+      },
+      message => mockEvents.push(`reported: ${message}`)
+    )
+
+    expect(result).toBe('done')
+    expect(mockEvents).toEqual(['commit', 'reported: after commit, "file" failed - left behind'])
+  })
+})
+
+describe('the @transaction directive', () => {
+  function schemaWith(resolve: (context: any) => any) {
+    const schema = makeExecutableSchema({
+      typeDefs: [
+        transactionDirectiveTypeDefs,
+        gql`
+          type Query {
+            ok: Boolean
+          }
+          type Mutation {
+            save: String @transaction
+          }
+        `
+      ],
+      resolvers: { Mutation: { save: (_: any, __: any, context: any) => resolve(context) } }
+    })
+
+    return transactionDirectiveResolver(schema)
+  }
+
+  const context = () => ({ state: {}, t: (k: string) => k, app: { createContext: () => ({}) } })
+
+  it('hands the resolver a list and runs it after the commit', async () => {
+    const schema = schemaWith(context => {
+      whenCommitted(context.state.afterCommit, 'file', () => mockEvents.push('file'))
+      mockEvents.push('resolved')
+      return 'saved'
+    })
+
+    const result = await graphql({ schema, source: 'mutation { save }', contextValue: context() })
+
+    expect(result.errors).toBeUndefined()
+    expect(mockEvents).toEqual(['resolved', 'commit', 'file'])
+  })
+
+  it('a resolver that throws leaves the list unrun', async () => {
+    const schema = schemaWith(context => {
+      whenCommitted(context.state.afterCommit, 'file', () => mockEvents.push('file'))
+      throw new Error('refused')
+    })
+
+    const result = await graphql({ schema, source: 'mutation { save }', contextValue: context() })
+
+    expect(result.errors?.[0]?.message).toBe('refused')
+    expect(mockEvents).not.toContain('file')
+  })
+
+  it('a failing step after the commit is logged with the field it came from, and the mutation succeeds', async () => {
+    const schema = schemaWith(context => {
+      whenCommitted(context.state.afterCommit, 'file', () => Promise.reject(new Error('storage down')))
+      return 'saved'
+    })
+
+    const result = await graphql({ schema, source: 'mutation { save }', contextValue: context() })
+
+    expect(result.data?.save).toBe('saved')
+    expect(mockEvents).toEqual(['commit', 'logged: after commit, "file" failed - left behind (field save)'])
+  })
+})

package/tests/generator-list-page-template.test.ts

@@ -0,0 +1,24 @@
+import { readFileSync } from 'fs'
+import path from 'path'
+
+/**
+ * The generator's list page does not stamp colours nothing uses.
+ *
+ * The template set `--grid-record-emphasized-background-color: #8B0000` and a `#FF6B6B` text on every
+ * generated list page. Emphasis only happens through a grid `classifier`, and the template has none,
+ * so 64 of the 66 pages that carry the pair never emphasize a row - and the two that declare a
+ * classifier leave it empty [확인함 2026-09-24]. The pair was also a contrast failure waiting to
+ * happen (about 3.6:1 against WCAG AA's 4.5) and ignored the dark theme. A page that does emphasize
+ * rows chooses its colours from the theme where it needs them.
+ */
+
+const TEMPLATE = path.resolve(
+  __dirname,
+  '../../generator/templates/service/client/pages/entity/{{name}}-list-page.ts.hbs'
+)
+
+describe("the generator's list page template", () => {
+  it('★ stamps no emphasized-row colours', () => {
+    expect(readFileSync(TEMPLATE, 'utf-8')).not.toMatch(/--grid-record-emphasized-(background-)?color\s*:/)
+  })
+})

package/tests/undefined-custom-properties.test.ts

@@ -0,0 +1,133 @@
+import { readdirSync, readFileSync, statSync } from 'fs'
+import path from 'path'
+
+/**
+ * A custom property read with no fallback must be defined somewhere.
+ *
+ * `var(--x)` with nothing defining `--x` is not an error anywhere: the declaration becomes invalid at
+ * computed-value time and the property falls back to its initial value. A hover colour turns into no
+ * hover, a padding into none, and every test stays green. Measured 2026-09-24 over operato's
+ * components and this repository's clients: 28 such reads, most of them typos - `--spacing-smail`,
+ * `--pading-default`, `--md-sys-on-color-secondary`, `--md-sys-color-on-s` - and Material names that
+ * do not exist (`--md-sys-color-primary-container-high`, `--md-sys-shape-corner-tiny`).
+ *
+ * Two scopes: this repository's clients from source, and the operato components as installed, since
+ * that is what an app runs. What defines a name: any declaration in this repository, in the installed
+ * @operato and @material/web packages, or a `setProperty('--x')`.
+ *
+ * ADR-0060 decision 1 (the machine catches a token nobody defines). The token inventory that found
+ * these is recorded in the ADR's status line.
+ */
+
+const ROOT = path.resolve(__dirname, '../../..')
+const PACKAGES = path.join(ROOT, 'packages')
+const MODULES = path.join(ROOT, 'node_modules')
+
+function* files(dir: string, exts: RegExp): Generator<string> {
+  let entries: string[]
+  try {
+    entries = readdirSync(dir)
+  } catch {
+    return
+  }
+  for (const entry of entries) {
+    if (entry === 'node_modules' || entry === '.git' || entry === 'coverage') continue
+    const full = path.join(dir, entry)
+    let stat
+    try {
+      stat = statSync(full)
+    } catch {
+      continue
+    }
+    if (stat.isDirectory()) yield* files(full, exts)
+    else if (exts.test(entry)) yield full
+  }
+}
+
+const DEFINES = /(--[a-z0-9-]+)\s*:/g
+const SETS = /setProperty\(\s*['"`](--[a-z0-9-]+)/g
+const BARE_READ = /var\(\s*(--[a-z0-9-]+)\s*\)/g
+
+function definedNames(): Set<string> {
+  const names = new Set<string>()
+  const take = (file: string) => {
+    const text = readFileSync(file, 'utf-8')
+    for (const match of text.matchAll(DEFINES)) names.add(match[1])
+    for (const match of text.matchAll(SETS)) names.add(match[1])
+  }
+  for (const file of files(PACKAGES, /\.(ts|js|css|mjs|html)$/)) take(file)
+  for (const scope of ['@operato', '@material/web']) {
+    for (const file of files(path.join(MODULES, scope), /\.(js|css)$/)) take(file)
+  }
+  return names
+}
+
+function bareReadsOfUndefined(roots: string[], defined: Set<string>, skip: (file: string) => boolean): string[] {
+  const found = new Set<string>()
+  for (const root of roots) {
+    for (const file of files(root, /\.(ts|js|css)$/)) {
+      if (skip(file)) continue
+      for (const match of readFileSync(file, 'utf-8').matchAll(BARE_READ)) {
+        if (!defined.has(match[1])) found.add(match[1])
+      }
+    }
+  }
+  return [...found].sort()
+}
+
+/*
+ * Hooks: names a component reads so that a product's theme can set them, and none of ours does.
+ * fmsim sets `--button-active-border` (and operato's `--grid-record-focused-color`) in its own theme
+ * files, operato-pms sets `--content-container-max-width`. The rest are undefined in every codebase we
+ * checked - they draw nothing today, and deciding what they should draw is a design change, not a
+ * fix. A name leaves this list when something defines it or the read goes.
+ */
+const HOOKS = [
+  '--button-active-border',
+  '--content-container-max-width',
+  '--form-input-width',
+  '--menu-tile-list-favorite-color',
+  '--menu-tile-list-item-margin'
+]
+
+/*
+ * The installed operato components, as of @operato 10.19-10.22 (process is not installed here). The fixed typos leave this list when the
+ * next @operato release is installed - the test goes red then, and the line is deleted with it.
+ */
+const OPERATO_KNOWN = [
+  '--button-radius',
+  '--calendar-monthly-color',
+  '--component-detail-border-color',
+  '--form-input-width',
+  '--grid-record-focused-color',
+  '--legend-background-color',
+  '--legend-border',
+  '--legend-border-radius',
+  '--legend-margin',
+  '--md-sys-color-on-primary-container-rgb',
+  '--md-sys-on-color-secondary',
+  '--md-sys-shape-corner-tiny',
+  '--md-sys-typescale-label-medium-weight',
+  '--opacity-light-dark-color',
+  '--pading-default',
+  '--record-view-edit-border',
+  '--record-view-grid-field-border',
+  '--spacing-smail'
+]
+
+describe('custom properties read with no fallback are defined', () => {
+  const defined = definedNames()
+
+  it("★ in this repository's clients", () => {
+    const clients = readdirSync(PACKAGES).map(pkg => path.join(PACKAGES, pkg, 'client'))
+    const skip = (file: string) => /\.test\.|\/themes\/|\/dist/.test(file)
+
+    expect(bareReadsOfUndefined(clients, defined, skip)).toEqual(HOOKS)
+  })
+
+  it('★ in the operato components as installed', () => {
+    const skip = (file: string) => !/\/dist\//.test(file) || /\.(test|stories)\.|\/demo\/|\/test\//.test(file)
+
+    expect(bareReadsOfUndefined([path.join(MODULES, '@operato')], defined, skip)).toEqual(OPERATO_KNOWN)
+  })
+})

package/translations/en.json

@@ -1,7 +1,9 @@
 {
   "button.add": "Add",
+  "button.back": "back",
   "button.cancel": "cancel",
   "button.close": "Close",
+  "button.collapse": "collapse",
   "button.confirm": "confirm",
   "button.copy": "copy",
   "button.copy to draft": "copy to draft",
@@ -12,6 +14,7 @@
   "button.edit": "edit",
   "button.edit-contact": "edit contact",
   "button.empty": "empty",
+  "button.expand": "expand",
   "button.export": "export",
   "button.refresh": "refresh",
   "button.register": "register",
@@ -109,6 +112,7 @@
   "label.platform": "platform",
   "label.please_select_a_country": "please select a country",
   "label.please_select_a_platform": "please select a platform",
+  "label.resize": "resize",
   "label.seconds": "seconds",
   "label.state": "state",
   "label.status": "Status",
@@ -127,6 +131,7 @@
   "text.data_updated_successfully": "data updated successfully",
   "text.data_uploaded_successfully": "data uploaded successfully",
   "text.draft": "draft",
+  "text.entity360-not-yet": "there is no 360 for this kind yet.",
   "text.error": "error",
   "text.existing_item_found": "existing item found",
   "text.failed": "failed",
@@ -159,5 +164,7 @@
   "title.lookup role": "lookup role",
   "title.select_item": "select item",
   "term.domain": "site",
-  "field.roles": "roles"
+  "field.roles": "roles",
+  "label.released": "released",
+  "label.import": "import"
 }

package/translations/ja.json

@@ -1,7 +1,9 @@
 {
   "button.add": "追加",
+  "button.back": "戻る",
   "button.cancel": "キャンセル",
   "button.close": "閉じる",
+  "button.collapse": "縮める",
   "button.confirm": "確認",
   "button.copy": "コピー",
   "button.copy to draft": "ドラフトにコピー",
@@ -12,6 +14,7 @@
   "button.edit": "修正",
   "button.edit-contact": "連絡先を編集",
   "button.empty": "空にする",
+  "button.expand": "広げる",
   "button.export": "エクスポート",
   "button.refresh": "リロード",
   "button.register": "登録",
@@ -109,6 +112,7 @@
   "label.platform": "プラットフォーム",
   "label.please_select_a_country": "国を選択してください",
   "label.please_select_a_platform": "プラットフォームを選択してください",
+  "label.resize": "幅の調整",
   "label.seconds": "秒",
   "label.state": "状態",
   "label.status": "状態",
@@ -127,6 +131,7 @@
   "text.data_updated_successfully": "資料の修正に成功しました.",
   "text.data_uploaded_successfully": "資料が正常に作成されました.",
   "text.draft": "ドラフト保存",
+  "text.entity360-not-yet": "この種類の 360 はまだありません。",
   "text.error": "エラー",
   "text.existing_item_found": "既にある項目です",
   "text.failed": "失敗",
@@ -159,5 +164,7 @@
   "title.lookup role": "ロール検索",
   "title.select_item": "アイテム選択",
   "term.domain": "事業場",
-  "field.roles": "ロール"
+  "field.roles": "ロール",
+  "label.released": "公開済み",
+  "label.import": "インポート"
 }

package/translations/ko.json

@@ -1,7 +1,9 @@
 {
   "button.add": "추가",
+  "button.back": "뒤로",
   "button.cancel": "취소",
   "button.close": "닫기",
+  "button.collapse": "줄이기",
   "button.confirm": "확인",
   "button.copy": "복사",
   "button.copy to draft": "드래프트로 복사",
@@ -12,6 +14,7 @@
   "button.edit": "수정",
   "button.edit-contact": "연락처 편집",
   "button.empty": "비우기",
+  "button.expand": "넓히기",
   "button.export": "내보내기",
   "button.refresh": "새로고침",
   "button.register": "등록",
@@ -109,6 +112,7 @@
   "label.platform": "플랫폼",
   "label.please_select_a_country": "국가를 선택하세요",
   "label.please_select_a_platform": "플랫폼을 선택하세요",
+  "label.resize": "폭 조절",
   "label.seconds": "초",
   "label.state": "상태",
   "label.status": "상태",
@@ -127,6 +131,7 @@
   "text.data_updated_successfully": "성공적으로 자료를 수정하였습니다.",
   "text.data_uploaded_successfully": "성공적으로 자료를 업로드하였습니다.",
   "text.draft": "초안저장",
+  "text.entity360-not-yet": "이 종류의 360 은 아직 없습니다.",
   "text.error": "오류",
   "text.existing_item_found": "이미 있는 항목입니다",
   "text.failed": "실패",
@@ -159,5 +164,7 @@
   "title.lookup role": "역할 검색",
   "title.select_item": "아이템 선택",
   "term.domain": "사업장",
-  "field.roles": "역할"
+  "field.roles": "역할",
+  "label.released": "발행됨",
+  "label.import": "가져오기"
 }

package/translations/ms.json

@@ -1,7 +1,9 @@
 {
   "button.add": "Tambah",
+  "button.back": "kembali",
   "button.cancel": "batal",
   "button.close": "tutup",
+  "button.collapse": "kecilkan",
   "button.confirm": "sahkan",
   "button.copy": "salin",
   "button.copy to draft": "salin ke draf",
@@ -12,6 +14,7 @@
   "button.edit": "Edit",
   "button.edit-contact": "edit kenalan",
   "button.empty": "kosongkan",
+  "button.expand": "besarkan",
   "button.export": "Eksport",
   "button.refresh": "Segar Semula",
   "button.register": "daftar",
@@ -109,6 +112,7 @@
   "label.platform": "platform",
   "label.please_select_a_country": "please select a country",
   "label.please_select_a_platform": "please select a platform",
+  "label.resize": "ubah lebar",
   "label.seconds": "saat",
   "label.state": "negeri",
   "label.status": "Status",
@@ -127,6 +131,7 @@
   "text.data_updated_successfully": "data berjaya dikemaskini",
   "text.data_uploaded_successfully": "data uploaded successfully",
   "text.draft": "draf",
+  "text.entity360-not-yet": "belum ada 360 untuk jenis ini.",
   "text.error": "Ralat",
   "text.existing_item_found": "item ini sudah ada",
   "text.failed": "gagal",
@@ -159,5 +164,7 @@
   "title.lookup role": "cari peranan",
   "title.select_item": "pilih item",
   "term.domain": "tapak",
-  "field.roles": "peranan"
+  "field.roles": "peranan",
+  "label.released": "diterbitkan",
+  "label.import": "import"
 }