@operato/layout 10.23.0 → 10.24.0

package/dist/src/actions/entity360-registry.d.ts

@@ -0,0 +1,69 @@
+import { type TemplateResult } from 'lit';
+/**
+ * Which kinds of thing open a 360, and what each module puts in it (ADR-0067, the person 360 ruling).
+ *
+ * An entity's name is a link to its 360 (ADR-0067 decision 1), and a grid shows names by the dozen -
+ * `updater` alone is a person column on 65 framework screens. Writing an opener into every column
+ * would never finish. Instead a kind is declared once with the GraphQL `__typename`s it claims, and
+ * whatever draws a value can ask `entity360KindOf(value)`: registered, it is a link; not, it stays
+ * text, exactly as before.
+ *
+ * This file knows no product words and imports no product module. A kind brings its own title; each
+ * module hangs its own section with its own read door (`registerEntity360Section`), the way activity
+ * panels hang on the activity detail. Opening a kind with no section says so in one line - never a
+ * blank dock.
+ */
+/** The thing a 360 is about: its kind, its id, and the value it was opened from. */
+export interface Entity360Subject {
+    kind: string;
+    id: string;
+    value: Record<string, any>;
+}
+export interface Entity360KindDeclaration {
+    /** The name sections register under - 'person', 'role', … */
+    kind: string;
+    /** The GraphQL `__typename`s whose values open this kind. A typename belongs to one kind. */
+    typenames: string[];
+    /** The dock's title for a subject - what a person recognises it by. */
+    title(subject: Entity360Subject): string;
+    /** A line under the title, if the kind has one. */
+    context?(subject: Entity360Subject): string;
+}
+export interface Entity360Section {
+    /** Unique within its kind. */
+    name: string;
+    /** Lower comes first; equal orders keep the order they were registered in. */
+    order?: number;
+    /** The section's content - usually the module's own element, which reads its own door. */
+    render(subject: Entity360Subject): TemplateResult;
+}
+export type Entity360Rejection = {
+    kind: string;
+    name?: string;
+    reason: string;
+};
+/**
+ * Declare a kind. A kind named twice, or a typename another kind already claims, is refused and
+ * kept in `entity360Rejections()` - silently taking the second would reroute links nobody asked to move.
+ */
+export declare function registerEntity360Kind(declaration: Entity360KindDeclaration): void;
+/** Hang a section on a kind. A name already on that kind is refused. */
+export declare function registerEntity360Section(kind: string, section: Entity360Section): void;
+/**
+ * The kind a value opens, or `undefined`.
+ *
+ * `undefined` for anything not registered and for a value without `__typename` (a call that turned
+ * the cache off) - the caller draws it as it always has.
+ */
+export declare function entity360KindOf(value: unknown): string | undefined;
+/** The sections hung on a kind, in order. */
+export declare function entity360Sections(kind: string): Entity360Section[];
+/** What was refused, and why - for a test or a boot check to read. */
+export declare function entity360Rejections(): Entity360Rejection[];
+/**
+ * Open the 360 of a value.
+ *
+ * A kind with sections shows them in order. A kind with none - or a value that opens no kind -
+ * shows one line saying there is no 360 for it yet. The dock is never blank.
+ */
+export declare function openEntity360For(value: Record<string, any>, returnFocus?: () => void): void;

package/dist/src/actions/entity360-registry.js

@@ -0,0 +1,96 @@
+import { html } from 'lit';
+import { i18next } from '@operato/i18n';
+import { showEntity360, hideEntity360, canGoBackEntity360 } from './entity360.js';
+const kinds = new Map();
+const kindOfTypename = new Map();
+const sections = new Map();
+const rejected = [];
+let registered = 0;
+/** The dock has one owner for everything opened through this registry. */
+const OWNER = {};
+/**
+ * Declare a kind. A kind named twice, or a typename another kind already claims, is refused and
+ * kept in `entity360Rejections()` - silently taking the second would reroute links nobody asked to move.
+ */
+export function registerEntity360Kind(declaration) {
+    var _a;
+    const kind = String((_a = declaration === null || declaration === void 0 ? void 0 : declaration.kind) !== null && _a !== void 0 ? _a : '').trim();
+    if (!kind)
+        return void rejected.push({ kind: '(no kind)', reason: 'no-kind' });
+    if (kinds.has(kind))
+        return void rejected.push({ kind, reason: 'duplicate-kind' });
+    if (typeof declaration.title !== 'function')
+        return void rejected.push({ kind, reason: 'no-title' });
+    const taken = (declaration.typenames || []).find(typename => kindOfTypename.has(typename));
+    if (taken)
+        return void rejected.push({ kind, name: taken, reason: 'typename-claimed' });
+    kinds.set(kind, { ...declaration, kind });
+    for (const typename of declaration.typenames || [])
+        kindOfTypename.set(typename, kind);
+}
+/** Hang a section on a kind. A name already on that kind is refused. */
+export function registerEntity360Section(kind, section) {
+    var _a, _b;
+    const name = String((_a = section === null || section === void 0 ? void 0 : section.name) !== null && _a !== void 0 ? _a : '').trim();
+    if (!name)
+        return void rejected.push({ kind, reason: 'no-name' });
+    if (typeof section.render !== 'function')
+        return void rejected.push({ kind, name, reason: 'no-render' });
+    const list = (_b = sections.get(kind)) !== null && _b !== void 0 ? _b : [];
+    if (list.some(one => one.name === name))
+        return void rejected.push({ kind, name, reason: 'duplicate-name' });
+    list.push({ ...section, name, at: registered++ });
+    list.sort((a, b) => { var _a, _b; return ((_a = a.order) !== null && _a !== void 0 ? _a : 0) - ((_b = b.order) !== null && _b !== void 0 ? _b : 0) || a.at - b.at; });
+    sections.set(kind, list);
+}
+/**
+ * The kind a value opens, or `undefined`.
+ *
+ * `undefined` for anything not registered and for a value without `__typename` (a call that turned
+ * the cache off) - the caller draws it as it always has.
+ */
+export function entity360KindOf(value) {
+    const typename = value === null || value === void 0 ? void 0 : value.__typename;
+    return typeof typename === 'string' ? kindOfTypename.get(typename) : undefined;
+}
+/** The sections hung on a kind, in order. */
+export function entity360Sections(kind) {
+    var _a;
+    return [...((_a = sections.get(kind)) !== null && _a !== void 0 ? _a : [])];
+}
+/** What was refused, and why - for a test or a boot check to read. */
+export function entity360Rejections() {
+    return [...rejected];
+}
+/**
+ * Open the 360 of a value.
+ *
+ * A kind with sections shows them in order. A kind with none - or a value that opens no kind -
+ * shows one line saying there is no 360 for it yet. The dock is never blank.
+ */
+export function openEntity360For(value, returnFocus) {
+    var _a, _b, _c, _d;
+    const kind = (_a = entity360KindOf(value)) !== null && _a !== void 0 ? _a : '';
+    const subject = { kind, id: String((_b = value === null || value === void 0 ? void 0 : value.id) !== null && _b !== void 0 ? _b : ''), value: value !== null && value !== void 0 ? value : {} };
+    const declaration = kinds.get(kind);
+    const hung = entity360Sections(kind);
+    const content = hung.length
+        ? html `${hung.map(section => section.render(subject))}`
+        : html `<p data-not-yet>${i18next.t('text.entity360-not-yet', { defaultValue: 'there is no 360 for this kind yet.' })}</p>`;
+    showEntity360(OWNER, {
+        key: `${kind}:${subject.id}`,
+        title: declaration ? declaration.title(subject) : String((_d = (_c = value === null || value === void 0 ? void 0 : value.name) !== null && _c !== void 0 ? _c : value === null || value === void 0 ? void 0 : value.id) !== null && _d !== void 0 ? _d : ''),
+        context: (declaration === null || declaration === void 0 ? void 0 : declaration.context) ? declaration.context(subject) : '',
+        content,
+        labels: {
+            close: i18next.t('button.close', { defaultValue: 'close' }),
+            expand: i18next.t('button.expand', { defaultValue: 'expand' }),
+            collapse: i18next.t('button.collapse', { defaultValue: 'collapse' }),
+            resize: i18next.t('label.resize', { defaultValue: 'resize' }),
+            back: i18next.t('button.back', { defaultValue: 'back' })
+        },
+        onClose: () => hideEntity360(OWNER),
+        onBack: canGoBackEntity360() ? () => history.back() : undefined
+    }, returnFocus);
+}
+//# sourceMappingURL=entity360-registry.js.map

package/dist/src/actions/entity360-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity360-registry.js","sourceRoot":"","sources":["../../../src/actions/entity360-registry.ts"],"names":[],"mappings":"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","sourcesContent":["import { html, type TemplateResult } from 'lit'\nimport { i18next } from '@operato/i18n'\n\nimport { showEntity360, hideEntity360, canGoBackEntity360 } from './entity360.js'\n\n/**\n * Which kinds of thing open a 360, and what each module puts in it (ADR-0067, the person 360 ruling).\n *\n * An entity's name is a link to its 360 (ADR-0067 decision 1), and a grid shows names by the dozen -\n * `updater` alone is a person column on 65 framework screens. Writing an opener into every column\n * would never finish. Instead a kind is declared once with the GraphQL `__typename`s it claims, and\n * whatever draws a value can ask `entity360KindOf(value)`: registered, it is a link; not, it stays\n * text, exactly as before.\n *\n * This file knows no product words and imports no product module. A kind brings its own title; each\n * module hangs its own section with its own read door (`registerEntity360Section`), the way activity\n * panels hang on the activity detail. Opening a kind with no section says so in one line - never a\n * blank dock.\n */\n\n/** The thing a 360 is about: its kind, its id, and the value it was opened from. */\nexport interface Entity360Subject {\n  kind: string\n  id: string\n  value: Record<string, any>\n}\n\nexport interface Entity360KindDeclaration {\n  /** The name sections register under - 'person', 'role', … */\n  kind: string\n  /** The GraphQL `__typename`s whose values open this kind. A typename belongs to one kind. */\n  typenames: string[]\n  /** The dock's title for a subject - what a person recognises it by. */\n  title(subject: Entity360Subject): string\n  /** A line under the title, if the kind has one. */\n  context?(subject: Entity360Subject): string\n}\n\nexport interface Entity360Section {\n  /** Unique within its kind. */\n  name: string\n  /** Lower comes first; equal orders keep the order they were registered in. */\n  order?: number\n  /** The section's content - usually the module's own element, which reads its own door. */\n  render(subject: Entity360Subject): TemplateResult\n}\n\nexport type Entity360Rejection = { kind: string; name?: string; reason: string }\n\nconst kinds = new Map<string, Entity360KindDeclaration>()\nconst kindOfTypename = new Map<string, string>()\nconst sections = new Map<string, (Entity360Section & { at: number })[]>()\nconst rejected: Entity360Rejection[] = []\nlet registered = 0\n\n/** The dock has one owner for everything opened through this registry. */\nconst OWNER = {}\n\n/**\n * Declare a kind. A kind named twice, or a typename another kind already claims, is refused and\n * kept in `entity360Rejections()` - silently taking the second would reroute links nobody asked to move.\n */\nexport function registerEntity360Kind(declaration: Entity360KindDeclaration): void {\n  const kind = String(declaration?.kind ?? '').trim()\n\n  if (!kind) return void rejected.push({ kind: '(no kind)', reason: 'no-kind' })\n  if (kinds.has(kind)) return void rejected.push({ kind, reason: 'duplicate-kind' })\n  if (typeof declaration.title !== 'function') return void rejected.push({ kind, reason: 'no-title' })\n\n  const taken = (declaration.typenames || []).find(typename => kindOfTypename.has(typename))\n  if (taken) return void rejected.push({ kind, name: taken, reason: 'typename-claimed' })\n\n  kinds.set(kind, { ...declaration, kind })\n  for (const typename of declaration.typenames || []) kindOfTypename.set(typename, kind)\n}\n\n/** Hang a section on a kind. A name already on that kind is refused. */\nexport function registerEntity360Section(kind: string, section: Entity360Section): void {\n  const name = String(section?.name ?? '').trim()\n\n  if (!name) return void rejected.push({ kind, reason: 'no-name' })\n  if (typeof section.render !== 'function') return void rejected.push({ kind, name, reason: 'no-render' })\n\n  const list = sections.get(kind) ?? []\n  if (list.some(one => one.name === name)) return void rejected.push({ kind, name, reason: 'duplicate-name' })\n\n  list.push({ ...section, name, at: registered++ })\n  list.sort((a, b) => (a.order ?? 0) - (b.order ?? 0) || a.at - b.at)\n  sections.set(kind, list)\n}\n\n/**\n * The kind a value opens, or `undefined`.\n *\n * `undefined` for anything not registered and for a value without `__typename` (a call that turned\n * the cache off) - the caller draws it as it always has.\n */\nexport function entity360KindOf(value: unknown): string | undefined {\n  const typename = (value as any)?.__typename\n  return typeof typename === 'string' ? kindOfTypename.get(typename) : undefined\n}\n\n/** The sections hung on a kind, in order. */\nexport function entity360Sections(kind: string): Entity360Section[] {\n  return [...(sections.get(kind) ?? [])]\n}\n\n/** What was refused, and why - for a test or a boot check to read. */\nexport function entity360Rejections(): Entity360Rejection[] {\n  return [...rejected]\n}\n\n/**\n * Open the 360 of a value.\n *\n * A kind with sections shows them in order. A kind with none - or a value that opens no kind -\n * shows one line saying there is no 360 for it yet. The dock is never blank.\n */\nexport function openEntity360For(value: Record<string, any>, returnFocus?: () => void): void {\n  const kind = entity360KindOf(value) ?? ''\n  const subject: Entity360Subject = { kind, id: String(value?.id ?? ''), value: value ?? {} }\n  const declaration = kinds.get(kind)\n  const hung = entity360Sections(kind)\n\n  const content = hung.length\n    ? html`${hung.map(section => section.render(subject))}`\n    : html`<p data-not-yet>${i18next.t('text.entity360-not-yet', { defaultValue: 'there is no 360 for this kind yet.' })}</p>`\n\n  showEntity360(\n    OWNER,\n    {\n      key: `${kind}:${subject.id}`,\n      title: declaration ? declaration.title(subject) : String(value?.name ?? value?.id ?? ''),\n      context: declaration?.context ? declaration.context(subject) : '',\n      content,\n      labels: {\n        close: i18next.t('button.close', { defaultValue: 'close' }),\n        expand: i18next.t('button.expand', { defaultValue: 'expand' }),\n        collapse: i18next.t('button.collapse', { defaultValue: 'collapse' }),\n        resize: i18next.t('label.resize', { defaultValue: 'resize' }),\n        back: i18next.t('button.back', { defaultValue: 'back' })\n      },\n      onClose: () => hideEntity360(OWNER),\n      onBack: canGoBackEntity360() ? () => history.back() : undefined\n    },\n    returnFocus\n  )\n}\n"]}

package/dist/src/index.d.ts

@@ -12,3 +12,4 @@ export * from './actions/snackbar.js';
 export * from './components/ox-split-pane.js';
 export * from './components/ox-entity360-dock.js';
 export * from './actions/entity360.js';
+export * from './actions/entity360-registry.js';

package/dist/src/index.js

@@ -11,4 +11,5 @@ export * from './actions/snackbar.js';
 export * from './components/ox-split-pane.js';
 export * from './components/ox-entity360-dock.js';
 export * from './actions/entity360.js';
+export * from './actions/entity360-registry.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAIzB,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iCAAiC,CAAA;AAE/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA","sourcesContent":["import './initializer.js'\n\nexport { PopupHandle, PopupOptions } from '@operato/popup'\n\nexport * from './layouts/ox-snack-bar.js'\nexport * from './layouts/ox-header-bar.js'\nexport * from './layouts/ox-nav-bar.js'\nexport * from './layouts/ox-aside-bar.js'\nexport * from './layouts/ox-footer-bar.js'\nexport * from './layouts/ox-page-header-bar.js'\nexport * from './layouts/ox-page-footer-bar.js'\n\nexport * from './actions/layout.js'\nexport * from './actions/snackbar.js'\n\nexport * from './components/ox-split-pane.js'\nexport * from './components/ox-entity360-dock.js'\nexport * from './actions/entity360.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAIzB,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,yBAAyB,CAAA;AACvC,cAAc,2BAA2B,CAAA;AACzC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,iCAAiC,CAAA;AAC/C,cAAc,iCAAiC,CAAA;AAE/C,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mCAAmC,CAAA;AACjD,cAAc,wBAAwB,CAAA;AACtC,cAAc,iCAAiC,CAAA","sourcesContent":["import './initializer.js'\n\nexport { PopupHandle, PopupOptions } from '@operato/popup'\n\nexport * from './layouts/ox-snack-bar.js'\nexport * from './layouts/ox-header-bar.js'\nexport * from './layouts/ox-nav-bar.js'\nexport * from './layouts/ox-aside-bar.js'\nexport * from './layouts/ox-footer-bar.js'\nexport * from './layouts/ox-page-header-bar.js'\nexport * from './layouts/ox-page-footer-bar.js'\n\nexport * from './actions/layout.js'\nexport * from './actions/snackbar.js'\n\nexport * from './components/ox-split-pane.js'\nexport * from './components/ox-entity360-dock.js'\nexport * from './actions/entity360.js'\nexport * from './actions/entity360-registry.js'\n"]}

package/dist/test/entity360-registry.test.d.ts

@@ -0,0 +1 @@
+import '../src/index.js';

package/dist/test/entity360-registry.test.js

@@ -0,0 +1,61 @@
+import { expect, fixture } from '@open-wc/testing';
+import { html } from 'lit';
+import '../src/index.js';
+import { entity360KindOf, entity360Rejections, entity360Sections, hideEntity360, openEntity360For, registerEntity360Kind, registerEntity360Section } from '../src/index.js';
+/**
+ * The 360 registry (ADR-0067, the person 360 ruling): a kind claims GraphQL typenames, modules hang
+ * sections on it, and anything drawing a value asks whether it opens a 360. The registry lives for
+ * the page, so every test uses kinds and typenames of its own.
+ */
+const settle = () => new Promise(resolve => setTimeout(resolve, 50));
+let bar;
+const dock = () => bar.shadowRoot.querySelector('ox-entity360-dock');
+describe('entity 360 registry', () => {
+    beforeEach(async () => {
+        bar = await fixture(html `<ox-aside-bar></ox-aside-bar>`);
+    });
+    afterEach(() => { var _a, _b; return (_b = (_a = dock()) === null || _a === void 0 ? void 0 : _a.view) === null || _b === void 0 ? void 0 : _b.onClose(); });
+    it('a value opens the kind its typename was claimed by', () => {
+        registerEntity360Kind({ kind: 'k1', typenames: ['T1'], title: s => s.value.name });
+        expect(entity360KindOf({ __typename: 'T1', id: '1' })).to.equal('k1');
+    });
+    it('★ an unregistered typename, or a value without one, opens nothing - drawn as before', () => {
+        expect(entity360KindOf({ __typename: 'NobodyClaimsThis', id: '1' })).to.equal(undefined);
+        expect(entity360KindOf({ id: '1', name: 'no typename' })).to.equal(undefined);
+        expect(entity360KindOf(null)).to.equal(undefined);
+    });
+    it('★ opens the dock with the sections in order, each given the subject', async () => {
+        registerEntity360Kind({ kind: 'k2', typenames: ['T2'], title: s => `title ${s.value.name}`, context: s => `id ${s.id}` });
+        registerEntity360Section('k2', { name: 'later', order: 2, render: s => html `<p data-section="later">${s.id}</p>` });
+        registerEntity360Section('k2', { name: 'first', order: 1, render: s => html `<p data-section="first">${s.kind}</p>` });
+        openEntity360For({ __typename: 'T2', id: '42', name: 'Kim' });
+        await settle();
+        expect(dock().view.title).to.equal('title Kim');
+        expect(dock().view.context).to.equal('id 42');
+        expect(entity360Sections('k2').map(section => section.name)).to.deep.equal(['first', 'later']);
+    });
+    it('★ a kind with no section says so in one line - never a blank dock', async () => {
+        registerEntity360Kind({ kind: 'k3', typenames: ['T3'], title: s => s.value.name });
+        openEntity360For({ __typename: 'T3', id: '7', name: 'Lee' });
+        await settle();
+        const content = await fixture(html `<div>${dock().view.content}</div>`);
+        expect(content.querySelector('[data-not-yet]')).to.exist;
+    });
+    it('★ refuses a second kind of the same name and a typename already claimed', () => {
+        registerEntity360Kind({ kind: 'k4', typenames: ['T4'], title: () => '' });
+        registerEntity360Kind({ kind: 'k4', typenames: ['T4b'], title: () => '' });
+        registerEntity360Kind({ kind: 'k5', typenames: ['T4'], title: () => '' });
+        const reasons = entity360Rejections().filter(one => one.kind === 'k4' || one.kind === 'k5').map(one => one.reason);
+        expect(reasons).to.include('duplicate-kind');
+        expect(reasons).to.include('typename-claimed');
+        expect(entity360KindOf({ __typename: 'T4' })).to.equal('k4');
+    });
+    it('refuses a section name used twice on one kind', () => {
+        registerEntity360Section('k6', { name: 'same', render: () => html `` });
+        registerEntity360Section('k6', { name: 'same', render: () => html `` });
+        expect(entity360Sections('k6').length).to.equal(1);
+        expect(entity360Rejections().some(one => one.kind === 'k6' && one.reason === 'duplicate-name')).to.equal(true);
+    });
+});
+void hideEntity360;
+//# sourceMappingURL=entity360-registry.test.js.map

package/dist/test/entity360-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity360-registry.test.js","sourceRoot":"","sources":["../../test/entity360-registry.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { expect, fixture } from '@open-wc/testing'\nimport { html } from 'lit'\nimport '../src/index.js'\nimport {\n  entity360KindOf,\n  entity360Rejections,\n  entity360Sections,\n  hideEntity360,\n  openEntity360For,\n  registerEntity360Kind,\n  registerEntity360Section,\n  type OxEntity360Dock\n} from '../src/index.js'\n\n/**\n * The 360 registry (ADR-0067, the person 360 ruling): a kind claims GraphQL typenames, modules hang\n * sections on it, and anything drawing a value asks whether it opens a 360. The registry lives for\n * the page, so every test uses kinds and typenames of its own.\n */\n\nconst settle = () => new Promise(resolve => setTimeout(resolve, 50))\nlet bar: HTMLElement\nconst dock = () => bar.shadowRoot!.querySelector('ox-entity360-dock') as OxEntity360Dock\n\ndescribe('entity 360 registry', () => {\n  beforeEach(async () => {\n    bar = await fixture(html`<ox-aside-bar></ox-aside-bar>`)\n  })\n  afterEach(() => dock()?.view?.onClose())\n\n  it('a value opens the kind its typename was claimed by', () => {\n    registerEntity360Kind({ kind: 'k1', typenames: ['T1'], title: s => s.value.name })\n    expect(entity360KindOf({ __typename: 'T1', id: '1' })).to.equal('k1')\n  })\n\n  it('★ an unregistered typename, or a value without one, opens nothing - drawn as before', () => {\n    expect(entity360KindOf({ __typename: 'NobodyClaimsThis', id: '1' })).to.equal(undefined)\n    expect(entity360KindOf({ id: '1', name: 'no typename' })).to.equal(undefined)\n    expect(entity360KindOf(null)).to.equal(undefined)\n  })\n\n  it('★ opens the dock with the sections in order, each given the subject', async () => {\n    registerEntity360Kind({ kind: 'k2', typenames: ['T2'], title: s => `title ${s.value.name}`, context: s => `id ${s.id}` })\n    registerEntity360Section('k2', { name: 'later', order: 2, render: s => html`<p data-section=\"later\">${s.id}</p>` })\n    registerEntity360Section('k2', { name: 'first', order: 1, render: s => html`<p data-section=\"first\">${s.kind}</p>` })\n\n    openEntity360For({ __typename: 'T2', id: '42', name: 'Kim' })\n    await settle()\n\n    expect(dock().view!.title).to.equal('title Kim')\n    expect(dock().view!.context).to.equal('id 42')\n    expect(entity360Sections('k2').map(section => section.name)).to.deep.equal(['first', 'later'])\n  })\n\n  it('★ a kind with no section says so in one line - never a blank dock', async () => {\n    registerEntity360Kind({ kind: 'k3', typenames: ['T3'], title: s => s.value.name })\n\n    openEntity360For({ __typename: 'T3', id: '7', name: 'Lee' })\n    await settle()\n\n    const content = await fixture(html`<div>${dock().view!.content}</div>`)\n    expect(content.querySelector('[data-not-yet]')).to.exist\n  })\n\n  it('★ refuses a second kind of the same name and a typename already claimed', () => {\n    registerEntity360Kind({ kind: 'k4', typenames: ['T4'], title: () => '' })\n    registerEntity360Kind({ kind: 'k4', typenames: ['T4b'], title: () => '' })\n    registerEntity360Kind({ kind: 'k5', typenames: ['T4'], title: () => '' })\n\n    const reasons = entity360Rejections().filter(one => one.kind === 'k4' || one.kind === 'k5').map(one => one.reason)\n    expect(reasons).to.include('duplicate-kind')\n    expect(reasons).to.include('typename-claimed')\n    expect(entity360KindOf({ __typename: 'T4' })).to.equal('k4')\n  })\n\n  it('refuses a section name used twice on one kind', () => {\n    registerEntity360Section('k6', { name: 'same', render: () => html`` })\n    registerEntity360Section('k6', { name: 'same', render: () => html`` })\n    expect(entity360Sections('k6').length).to.equal(1)\n    expect(entity360Rejections().some(one => one.kind === 'k6' && one.reason === 'duplicate-name')).to.equal(true)\n  })\n})\n\nvoid hideEntity360\n"]}