@aglyn/aglyn 1.0.0-beta.143

package/src/lib/plugin-manager/plugin-record-cards.js

@@ -0,0 +1,59 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
+import { definePluginServiceContract, registerPluginService, resolvePluginServices } from "./plugin-services.js";
+export const PLUGIN_RECORD_CARDS = definePluginServiceContract('core.record-cards', {
+    multiple: true
+});
+export function registerPluginRecordCardReader(kind, reader, options) {
+    var _ref, _getRegisteringPluginId;
+    const key = kind.trim();
+    if (!key) throw new Error('a record card reader needs a record kind');
+    const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId) != null ? _ref : '').trim();
+    const incumbent = resolvePluginServices(PLUGIN_RECORD_CARDS).find((entry)=>entry.key === key);
+    if (incumbent && pluginId && incumbent.pluginId !== pluginId) {
+        throw new Error(`record kind "${key}" already publishes a card from ` + `"${incumbent.pluginId}"; refused "${pluginId}"`);
+    }
+    registerPluginService(PLUGIN_RECORD_CARDS, reader, _extends({}, (options == null ? void 0 : options.pluginId) ? {
+        pluginId: options.pluginId
+    } : {}, {
+        key
+    }));
+}
+/** The reader for a kind with its owner, or `null` when none publishes it. */ export function pluginRecordCardReader(kind) {
+    const key = kind.trim();
+    const entry = resolvePluginServices(PLUGIN_RECORD_CARDS).find((one)=>one.key === key);
+    return entry ? {
+        pluginId: entry.pluginId,
+        reader: entry.impl
+    } : null;
+}
+/** One record's card; `null` when no plugin publishes the kind or it is gone. */ export async function readPluginRecordCard(kind, request) {
+    const found = pluginRecordCardReader(kind);
+    return found ? found.reader.read(request) : null;
+}
+/** Every published kind with its owner. */ export function listPluginRecordCardKinds() {
+    return resolvePluginServices(PLUGIN_RECORD_CARDS).map((entry)=>{
+        var _entry_key;
+        return {
+            kind: (_entry_key = entry.key) != null ? _entry_key : '',
+            pluginId: entry.pluginId
+        };
+    });
+}
+
+//# sourceMappingURL=plugin-record-cards.js.map

package/src/lib/plugin-manager/plugin-record-cards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-record-cards.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * How a plugin's record presents as a card, published by the plugin that owns\n * it (AGL-3080).\n *\n * A surface that is not the record's own sometimes has to DRAW it rather than\n * link to it: a designed email that features a product, a picker that lists\n * what another plugin keeps. Doing that by reading the owner's collection and\n * importing the owner's model is two couplings at once — to where the record\n * is stored and to what its fields mean — and the second is the one that goes\n * wrong quietly, because a price rule that changes in the owner is still\n * computed the old way everywhere it was copied.\n *\n * So the owner answers the fourth question about a record kind. The facts\n * reader says what a member may know about it, the timeline what happened on\n * it, the route where a person reads it; this says what it looks like in one\n * line and one image. It is keyed by the same RECORD KIND as those three, so\n * a plugin that owns `product` registers them together.\n *\n * ## What a card is\n *\n * A title, an optional caption already worded for a reader (a price, a date, a\n * status — the owner decides, and formats it), an optional image, and an\n * optional `path` on the published site. Nothing here is the owner's model:\n * no field a caller could compute on, which is what keeps the rule in one\n * place.\n *\n * ## Server-side, and unauthenticated on purpose\n *\n * A reader runs with the Admin SDK for a caller that has already decided the\n * read is the workspace's to make — a send the merchant started, a job the\n * platform scheduled. That is a different question from `plugin-record-facts`,\n * which answers ONE member and applies their permissions, and the two are\n * separate contracts so neither borrows the other's trust.\n *\n * Both apps load every plugin's server entry before any plugin handler runs\n * (`ensureAll`), so a reader registered from a server registrar is present\n * wherever a handler asks. `null` still has two meanings a caller must treat\n * alike — no plugin publishes the kind, or the record is not there — and both\n * mean the same thing to it: there is nothing to draw.\n *\n * ## One kind, one owner\n *\n * A second plugin publishing a card for a kind another already publishes is\n * refused naming both, and the incumbent keeps serving; the owner registering\n * again replaces its own.\n *\n * Import this module by its own subpath\n * (`@aglyn/aglyn/plugin-manager/plugin-record-cards`); it is not in the barrel.\n */\n\nexport interface PluginRecordCardRequest {\n  hostId: string\n  /** The record's document id. */\n  id: string\n}\n\nexport interface PluginRecordCard {\n  title: string\n  /** One short line the owner has already worded for a reader. */\n  caption?: string\n  imageUrl?: string\n  /** Where the record is read on the published site, site-relative. */\n  path?: string\n}\n\nexport interface PluginRecordCardReader {\n  /** `null` when the record does not exist. */\n  read(request: PluginRecordCardRequest): Promise<PluginRecordCard | null>\n}\n\nexport interface ResolvedPluginRecordCardReader {\n  pluginId: string\n  reader: PluginRecordCardReader\n}\n\nexport const PLUGIN_RECORD_CARDS =\n  definePluginServiceContract<PluginRecordCardReader>('core.record-cards', {\n    multiple: true,\n  })\n\nexport function registerPluginRecordCardReader(\n  kind: string,\n  reader: PluginRecordCardReader,\n  options?: { pluginId?: string },\n): void {\n  const key = kind.trim()\n  if (!key) throw new Error('a record card reader needs a record kind')\n  const pluginId = (getRegisteringPluginId() ?? options?.pluginId ?? '').trim()\n  const incumbent = resolvePluginServices(PLUGIN_RECORD_CARDS).find(\n    (entry) => entry.key === key,\n  )\n  if (incumbent && pluginId && incumbent.pluginId !== pluginId) {\n    throw new Error(\n      `record kind \"${key}\" already publishes a card from ` +\n        `\"${incumbent.pluginId}\"; refused \"${pluginId}\"`,\n    )\n  }\n  registerPluginService(PLUGIN_RECORD_CARDS, reader, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n    key,\n  })\n}\n\n/** The reader for a kind with its owner, or `null` when none publishes it. */\nexport function pluginRecordCardReader(\n  kind: string,\n): ResolvedPluginRecordCardReader | null {\n  const key = kind.trim()\n  const entry = resolvePluginServices(PLUGIN_RECORD_CARDS).find(\n    (one) => one.key === key,\n  )\n  return entry ? { pluginId: entry.pluginId, reader: entry.impl } : null\n}\n\n/** One record's card; `null` when no plugin publishes the kind or it is gone. */\nexport async function readPluginRecordCard(\n  kind: string,\n  request: PluginRecordCardRequest,\n): Promise<PluginRecordCard | null> {\n  const found = pluginRecordCardReader(kind)\n  return found ? found.reader.read(request) : null\n}\n\n/** Every published kind with its owner. */\nexport function listPluginRecordCardKinds(): Array<{\n  kind: string\n  pluginId: string\n}> {\n  return resolvePluginServices(PLUGIN_RECORD_CARDS).map((entry) => ({\n    kind: entry.key ?? '',\n    pluginId: entry.pluginId,\n  }))\n}\n"],"names":["getRegisteringPluginId","definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_RECORD_CARDS","multiple","registerPluginRecordCardReader","kind","reader","options","key","trim","Error","pluginId","incumbent","find","entry","pluginRecordCardReader","one","impl","readPluginRecordCard","request","found","read","listPluginRecordCardKinds","map"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,sBAAsB,QAAQ,qCAAiC;AACxE,SACEC,2BAA2B,EAC3BC,qBAAqB,EACrBC,qBAAqB,QAChB,uBAAmB;AA6E1B,OAAO,MAAMC,sBACXH,4BAAoD,qBAAqB;IACvEI,UAAU;AACZ,GAAE;AAEJ,OAAO,SAASC,+BACdC,IAAY,EACZC,MAA8B,EAC9BC,OAA+B;QAIbT,MAAAA;IAFlB,MAAMU,MAAMH,KAAKI,IAAI;IACrB,IAAI,CAACD,KAAK,MAAM,IAAIE,MAAM;IAC1B,MAAMC,WAAW,EAACb,QAAAA,0BAAAA,oCAAAA,0BAA4BS,2BAAAA,QAASI,QAAQ,YAA7Cb,OAAiD,IAAIW,IAAI;IAC3E,MAAMG,YAAYX,sBAAsBC,qBAAqBW,IAAI,CAC/D,CAACC,QAAUA,MAAMN,GAAG,KAAKA;IAE3B,IAAII,aAAaD,YAAYC,UAAUD,QAAQ,KAAKA,UAAU;QAC5D,MAAM,IAAID,MACR,CAAC,aAAa,EAAEF,IAAI,gCAAgC,CAAC,GACnD,CAAC,CAAC,EAAEI,UAAUD,QAAQ,CAAC,YAAY,EAAEA,SAAS,CAAC,CAAC;IAEtD;IACAX,sBAAsBE,qBAAqBI,QAAQ,aAC7CC,CAAAA,2BAAAA,QAASI,QAAQ,IAAG;QAAEA,UAAUJ,QAAQI,QAAQ;IAAC,IAAI,CAAC;QAC1DH;;AAEJ;AAEA,4EAA4E,GAC5E,OAAO,SAASO,uBACdV,IAAY;IAEZ,MAAMG,MAAMH,KAAKI,IAAI;IACrB,MAAMK,QAAQb,sBAAsBC,qBAAqBW,IAAI,CAC3D,CAACG,MAAQA,IAAIR,GAAG,KAAKA;IAEvB,OAAOM,QAAQ;QAAEH,UAAUG,MAAMH,QAAQ;QAAEL,QAAQQ,MAAMG,IAAI;IAAC,IAAI;AACpE;AAEA,+EAA+E,GAC/E,OAAO,eAAeC,qBACpBb,IAAY,EACZc,OAAgC;IAEhC,MAAMC,QAAQL,uBAAuBV;IACrC,OAAOe,QAAQA,MAAMd,MAAM,CAACe,IAAI,CAACF,WAAW;AAC9C;AAEA,yCAAyC,GACzC,OAAO,SAASG;IAId,OAAOrB,sBAAsBC,qBAAqBqB,GAAG,CAAC,CAACT;YAC/CA;eAD0D;YAChET,IAAI,GAAES,aAAAA,MAAMN,GAAG,YAATM,aAAa;YACnBH,UAAUG,MAAMH,QAAQ;QAC1B;;AACF"}

package/src/lib/plugin-manager/plugin-record-facts.d.ts

@@ -0,0 +1,111 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Facts one plugin reads about a record another plugin owns (AGL-2917).
+ *
+ * A record belongs to the plugin that models it: where it is stored, who may
+ * read it, which of its fields a site may see and which belong to another
+ * site. A different plugin that reasons over such a record — an assistant
+ * summarizing it, an automation deciding on it, a report joining it — must
+ * not read the documents itself, because it would restate the owner's read
+ * rules and drift from them the day the owner changes one. Nor may it import
+ * the owner, which the package map forbids.
+ *
+ * So the owner registers a READER for the record from its server surfaces,
+ * and a caller asks for one by resource name. Every rule stays the owner's:
+ *
+ *  - which member may read the record, on which site or at the organization
+ *    level, and what the plan allows;
+ *  - which of the record's facts leave the owner at all. A reader reports the
+ *    facts it documents and nothing else, so what a caller can pass on is
+ *    decided where the data is modeled, and a field the owner leaves out
+ *    cannot be read through the seam by accident.
+ *
+ * `read` never writes. A resource whose "record" is a catalog rather than a
+ * document — the fields an import may fill, say — is read the same way, with
+ * the catalog's name as its id.
+ *
+ * Built on the typed service registry (`plugin-services`): one contract, every
+ * reader registered under its resource name as the service's key.
+ *
+ * ## The caller proves who is asking
+ *
+ * Like `plugin-resource-drafts`, the registry authenticates nobody. A caller
+ * establishes, in its own terms and before it asks, who the member is and that
+ * they belong to the org; the reader then applies the owner's read rules to
+ * that member. A caller that could not name a member has nothing to ask with.
+ *
+ * ## One reader per resource
+ *
+ * A resource has one owner. A second plugin registering a reader for a
+ * resource another plugin already reads is refused, naming both, and the
+ * incumbent keeps serving; the same plugin registering again — from a second
+ * server surface, or on a hot reload — replaces its own.
+ */
+/** Whose view of which record, and when. */
+export interface PluginRecordFactsRequest {
+    orgId: string;
+    /**
+     * The site the record is read on, or `null` for the organization's own view
+     * of it. An owner whose records belong to sites reads a site's share of the
+     * record for a site, and the organization-wide record for `null`.
+     */
+    hostId: string | null;
+    /** The record's id, in the owner's terms. */
+    id: string;
+    /** The member the facts are read for: the owner applies its read rules to them. */
+    uid: string;
+    /** A verified staff caller, where the owner lets staff read; absent is not staff. */
+    staff?: boolean;
+    /** The org document the caller already read, for the owner's entitlement reads. */
+    org: Readonly<Record<string, unknown>> | null;
+    now: Date;
+}
+/** Why the facts cannot be read. */
+export interface PluginRecordFactsRefusal {
+    status: 400 | 403 | 404;
+    /** Customer-safe: a caller shows it as it stands. */
+    error: string;
+}
+export type PluginRecordFactsRead = {
+    ok: true;
+    /** The record's facts, in the shape the owner's reader documents. */
+    facts: Readonly<Record<string, unknown>>;
+} | (PluginRecordFactsRefusal & {
+    ok: false;
+});
+export interface PluginRecordFactsReader {
+    /** The facts of one record for one member; a refusal is returned, never thrown. */
+    read(request: PluginRecordFactsRequest): Promise<PluginRecordFactsRead>;
+}
+export declare const PLUGIN_RECORD_FACTS: import("./plugin-services").PluginServiceContract<PluginRecordFactsReader>;
+/**
+ * Registers the reader for a resource. The owner is the loader's marker when a
+ * register fn is running, else `options.pluginId`; with neither the
+ * registration throws. A reader for a resource another plugin reads throws
+ * naming both.
+ */
+export declare function registerPluginRecordFactsReader(resource: string, reader: PluginRecordFactsReader, options?: {
+    pluginId?: string;
+}): void;
+export interface ResolvedPluginRecordFactsReader {
+    /** The plugin that owns the resource. */
+    pluginId: string;
+    reader: PluginRecordFactsReader;
+}
+/** The reader for a resource, with its owner, or `null` when no plugin reads it. */
+export declare function pluginRecordFactsReader(resource: string): ResolvedPluginRecordFactsReader | null;

package/src/lib/plugin-manager/plugin-record-facts.js

@@ -0,0 +1,51 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
+import { definePluginServiceContract, registerPluginService, resolvePluginServices } from "./plugin-services.js";
+export const PLUGIN_RECORD_FACTS = definePluginServiceContract('core.record-facts', {
+    multiple: true
+});
+/**
+ * Registers the reader for a resource. The owner is the loader's marker when a
+ * register fn is running, else `options.pluginId`; with neither the
+ * registration throws. A reader for a resource another plugin reads throws
+ * naming both.
+ */ export function registerPluginRecordFactsReader(resource, reader, options) {
+    var _ref, _getRegisteringPluginId;
+    const key = resource.trim();
+    if (!key) throw new Error('a record facts reader needs a resource name');
+    const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId) != null ? _ref : '').trim();
+    const incumbent = resolvePluginServices(PLUGIN_RECORD_FACTS).find((entry)=>entry.key === key);
+    if (incumbent && pluginId && incumbent.pluginId !== pluginId) {
+        throw new Error(`resource "${key}" already has a facts reader from "${incumbent.pluginId}"; ` + `refused "${pluginId}"`);
+    }
+    registerPluginService(PLUGIN_RECORD_FACTS, reader, _extends({}, (options == null ? void 0 : options.pluginId) ? {
+        pluginId: options.pluginId
+    } : {}, {
+        key
+    }));
+}
+/** The reader for a resource, with its owner, or `null` when no plugin reads it. */ export function pluginRecordFactsReader(resource) {
+    const key = resource.trim();
+    const entry = resolvePluginServices(PLUGIN_RECORD_FACTS).find((one)=>one.key === key);
+    return entry ? {
+        pluginId: entry.pluginId,
+        reader: entry.impl
+    } : null;
+}
+
+//# sourceMappingURL=plugin-record-facts.js.map

package/src/lib/plugin-manager/plugin-record-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-record-facts.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * Facts one plugin reads about a record another plugin owns (AGL-2917).\n *\n * A record belongs to the plugin that models it: where it is stored, who may\n * read it, which of its fields a site may see and which belong to another\n * site. A different plugin that reasons over such a record — an assistant\n * summarizing it, an automation deciding on it, a report joining it — must\n * not read the documents itself, because it would restate the owner's read\n * rules and drift from them the day the owner changes one. Nor may it import\n * the owner, which the package map forbids.\n *\n * So the owner registers a READER for the record from its server surfaces,\n * and a caller asks for one by resource name. Every rule stays the owner's:\n *\n *  - which member may read the record, on which site or at the organization\n *    level, and what the plan allows;\n *  - which of the record's facts leave the owner at all. A reader reports the\n *    facts it documents and nothing else, so what a caller can pass on is\n *    decided where the data is modeled, and a field the owner leaves out\n *    cannot be read through the seam by accident.\n *\n * `read` never writes. A resource whose \"record\" is a catalog rather than a\n * document — the fields an import may fill, say — is read the same way, with\n * the catalog's name as its id.\n *\n * Built on the typed service registry (`plugin-services`): one contract, every\n * reader registered under its resource name as the service's key.\n *\n * ## The caller proves who is asking\n *\n * Like `plugin-resource-drafts`, the registry authenticates nobody. A caller\n * establishes, in its own terms and before it asks, who the member is and that\n * they belong to the org; the reader then applies the owner's read rules to\n * that member. A caller that could not name a member has nothing to ask with.\n *\n * ## One reader per resource\n *\n * A resource has one owner. A second plugin registering a reader for a\n * resource another plugin already reads is refused, naming both, and the\n * incumbent keeps serving; the same plugin registering again — from a second\n * server surface, or on a hot reload — replaces its own.\n */\n\n/** Whose view of which record, and when. */\nexport interface PluginRecordFactsRequest {\n  orgId: string\n  /**\n   * The site the record is read on, or `null` for the organization's own view\n   * of it. An owner whose records belong to sites reads a site's share of the\n   * record for a site, and the organization-wide record for `null`.\n   */\n  hostId: string | null\n  /** The record's id, in the owner's terms. */\n  id: string\n  /** The member the facts are read for: the owner applies its read rules to them. */\n  uid: string\n  /** A verified staff caller, where the owner lets staff read; absent is not staff. */\n  staff?: boolean\n  /** The org document the caller already read, for the owner's entitlement reads. */\n  org: Readonly<Record<string, unknown>> | null\n  now: Date\n}\n\n/** Why the facts cannot be read. */\nexport interface PluginRecordFactsRefusal {\n  status: 400 | 403 | 404\n  /** Customer-safe: a caller shows it as it stands. */\n  error: string\n}\n\nexport type PluginRecordFactsRead =\n  | {\n      ok: true\n      /** The record's facts, in the shape the owner's reader documents. */\n      facts: Readonly<Record<string, unknown>>\n    }\n  | (PluginRecordFactsRefusal & { ok: false })\n\nexport interface PluginRecordFactsReader {\n  /** The facts of one record for one member; a refusal is returned, never thrown. */\n  read(request: PluginRecordFactsRequest): Promise<PluginRecordFactsRead>\n}\n\nexport const PLUGIN_RECORD_FACTS = definePluginServiceContract<PluginRecordFactsReader>(\n  'core.record-facts',\n  { multiple: true },\n)\n\n/**\n * Registers the reader for a resource. The owner is the loader's marker when a\n * register fn is running, else `options.pluginId`; with neither the\n * registration throws. A reader for a resource another plugin reads throws\n * naming both.\n */\nexport function registerPluginRecordFactsReader(\n  resource: string,\n  reader: PluginRecordFactsReader,\n  options?: { pluginId?: string },\n): void {\n  const key = resource.trim()\n  if (!key) throw new Error('a record facts reader needs a resource name')\n  const pluginId = (getRegisteringPluginId() ?? options?.pluginId ?? '').trim()\n  const incumbent = resolvePluginServices(PLUGIN_RECORD_FACTS).find((entry) => entry.key === key)\n  if (incumbent && pluginId && incumbent.pluginId !== pluginId) {\n    throw new Error(\n      `resource \"${key}\" already has a facts reader from \"${incumbent.pluginId}\"; ` +\n        `refused \"${pluginId}\"`,\n    )\n  }\n  registerPluginService(PLUGIN_RECORD_FACTS, reader, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n    key,\n  })\n}\n\nexport interface ResolvedPluginRecordFactsReader {\n  /** The plugin that owns the resource. */\n  pluginId: string\n  reader: PluginRecordFactsReader\n}\n\n/** The reader for a resource, with its owner, or `null` when no plugin reads it. */\nexport function pluginRecordFactsReader(resource: string): ResolvedPluginRecordFactsReader | null {\n  const key = resource.trim()\n  const entry = resolvePluginServices(PLUGIN_RECORD_FACTS).find((one) => one.key === key)\n  return entry ? { pluginId: entry.pluginId, reader: entry.impl } : null\n}\n"],"names":["getRegisteringPluginId","definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_RECORD_FACTS","multiple","registerPluginRecordFactsReader","resource","reader","options","key","trim","Error","pluginId","incumbent","find","entry","pluginRecordFactsReader","one","impl"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,sBAAsB,QAAQ,qCAAiC;AACxE,SACEC,2BAA2B,EAC3BC,qBAAqB,EACrBC,qBAAqB,QAChB,uBAAmB;AAqF1B,OAAO,MAAMC,sBAAsBH,4BACjC,qBACA;IAAEI,UAAU;AAAK,GAClB;AAED;;;;;CAKC,GACD,OAAO,SAASC,gCACdC,QAAgB,EAChBC,MAA+B,EAC/BC,OAA+B;QAIbT,MAAAA;IAFlB,MAAMU,MAAMH,SAASI,IAAI;IACzB,IAAI,CAACD,KAAK,MAAM,IAAIE,MAAM;IAC1B,MAAMC,WAAW,EAACb,QAAAA,0BAAAA,oCAAAA,0BAA4BS,2BAAAA,QAASI,QAAQ,YAA7Cb,OAAiD,IAAIW,IAAI;IAC3E,MAAMG,YAAYX,sBAAsBC,qBAAqBW,IAAI,CAAC,CAACC,QAAUA,MAAMN,GAAG,KAAKA;IAC3F,IAAII,aAAaD,YAAYC,UAAUD,QAAQ,KAAKA,UAAU;QAC5D,MAAM,IAAID,MACR,CAAC,UAAU,EAAEF,IAAI,mCAAmC,EAAEI,UAAUD,QAAQ,CAAC,GAAG,CAAC,GAC3E,CAAC,SAAS,EAAEA,SAAS,CAAC,CAAC;IAE7B;IACAX,sBAAsBE,qBAAqBI,QAAQ,aAC7CC,CAAAA,2BAAAA,QAASI,QAAQ,IAAG;QAAEA,UAAUJ,QAAQI,QAAQ;IAAC,IAAI,CAAC;QAC1DH;;AAEJ;AAQA,kFAAkF,GAClF,OAAO,SAASO,wBAAwBV,QAAgB;IACtD,MAAMG,MAAMH,SAASI,IAAI;IACzB,MAAMK,QAAQb,sBAAsBC,qBAAqBW,IAAI,CAAC,CAACG,MAAQA,IAAIR,GAAG,KAAKA;IACnF,OAAOM,QAAQ;QAAEH,UAAUG,MAAMH,QAAQ;QAAEL,QAAQQ,MAAMG,IAAI;IAAC,IAAI;AACpE"}

package/src/lib/plugin-manager/plugin-record-routes.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Where a plugin's records live, published by the plugin that owns them
+ * (AGL-3124).
+ *
+ * A surface that is not the record's own routinely wants to link to it: an
+ * inbox row to the person it is from, a form's page to the people who filled
+ * it in, an assistant's job list to the campaign it wrote. Today each of those
+ * builds the other plugin's address itself — four plugins spell each other's
+ * URLs, and the core carries a fifth copy for the console app, which may not
+ * import a plugin at all.
+ *
+ * Every copy is the same bug waiting: an address is the owner's to change, and
+ * a section that moves leaves a link that still resolves, to the wrong place.
+ *
+ * So the owner publishes its addresses under the RECORD KIND, and a caller
+ * asks for a kind. `plugin-record-facts` already keys a reader by resource
+ * name and `plugin-record-timeline` already files an entry on a record; this
+ * is the third question about the same record — where a person reads it — and
+ * it is keyed the same way, so a plugin that owns `contact` registers the
+ * facts reader and the route together and a caller names `contact` for both.
+ *
+ * ## What a caller passes, and why it is the two route params
+ *
+ * Every site console page is addressed by `/{orgSlug}/hosts/{host}/…`, and both
+ * segments are already in the URL the calling surface is rendered on. Building
+ * from them costs nothing; resolving them from a host id costs two document
+ * reads on every render of a card, to draw a link. `host: null` asks for the
+ * ORGANIZATION-level address, which some kinds have and some do not — a route
+ * answers `null` for a scope it does not serve, and the caller renders text
+ * rather than a link to nowhere.
+ *
+ * ## One kind, one owner
+ *
+ * A record kind belongs to the plugin that models it, so a second plugin
+ * publishing addresses for a kind another already publishes is refused naming
+ * both, and the incumbent keeps serving. The same plugin registering again —
+ * a second surface, a hot reload — replaces its own.
+ *
+ * The registry knows nothing about permissions: a link is not access, and the
+ * page at the far end applies its own gates, as it does for a person who typed
+ * the address.
+ */
+/** The scope an address is asked for. */
+export interface PluginRecordRouteContext {
+    /** The organization's path slug, as the console URL spells it. */
+    orgSlug: string;
+    /** The site's subdomain, or `null` for the organization-level address. */
+    host: string | null;
+}
+/**
+ * The addresses one record kind publishes. Every member answers `null` for a
+ * scope the owner does not serve — an org-level page a host-scoped kind has
+ * no address for, a list a kind does not have.
+ */
+export interface PluginRecordRoute {
+    /** The list the kind lives on. */
+    list(context: PluginRecordRouteContext): string | null;
+    /** One record's own page. */
+    record(context: PluginRecordRouteContext, id: string): string | null;
+    /**
+     * The list opened on the one person with an address, where the owner offers
+     * it — for a caller that holds an email and no record id.
+     */
+    byEmail?(context: PluginRecordRouteContext, email: string): string | null;
+    /**
+     * The list narrowed by one of the owner's own filters, where the owner
+     * offers it: `filter` and `value` are the owner's words, and a filter it
+     * does not know answers `null` rather than a list showing everything.
+     */
+    filtered?(context: PluginRecordRouteContext, filter: string, value: string): string | null;
+}
+/** A route with the plugin that publishes it. */
+export interface ResolvedPluginRecordRoute {
+    /** The plugin that owns the kind. */
+    pluginId: string;
+    route: PluginRecordRoute;
+}
+export declare const PLUGIN_RECORD_ROUTES: import("./plugin-services").PluginServiceContract<PluginRecordRoute>;
+/**
+ * Publishes the addresses for one record kind. The owner is the loader's
+ * marker when a register fn is running, else `options.pluginId`; with neither
+ * the registration throws. A kind another plugin publishes throws naming both.
+ */
+export declare function registerPluginRecordRoute(kind: string, route: PluginRecordRoute, options?: {
+    pluginId?: string;
+}): void;
+/** The route for a kind, with its owner, or `null` when no plugin publishes it. */
+export declare function pluginRecordRoute(kind: string): ResolvedPluginRecordRoute | null;
+/** Every kind with a published route, in registration order. */
+export declare function listPluginRecordRouteKinds(): Array<{
+    kind: string;
+    pluginId: string;
+}>;
+/**
+ * One record's page, or `null` — no plugin publishes the kind, or the owner
+ * has no address for it at this scope. A caller renders text for `null`
+ * rather than a link, which is what every one of these surfaces already does
+ * while its route params settle.
+ */
+export declare function pluginRecordHref(kind: string, context: PluginRecordRouteContext, id: string): string | null;
+/** The list a kind lives on, on the same terms as {@link pluginRecordHref}. */
+export declare function pluginRecordListHref(kind: string, context: PluginRecordRouteContext): string | null;
+/**
+ * The list opened on one person's address, or `null` — including when the
+ * owner publishes routes for the kind but offers no address lookup.
+ */
+export declare function pluginRecordByEmailHref(kind: string, context: PluginRecordRouteContext, email: string): string | null;
+/**
+ * The list narrowed by one of the owner's filters, or `null` — including for
+ * a filter the owner does not know, which it answers `null` for rather than
+ * serving a list that ignores the narrowing.
+ */
+export declare function pluginRecordFilteredHref(kind: string, context: PluginRecordRouteContext, filter: string, value: string): string | null;

package/src/lib/plugin-manager/plugin-record-routes.js

@@ -0,0 +1,93 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import { getRegisteringPluginId } from "../app-utils/registering-plugin.js";
+import { definePluginServiceContract, registerPluginService, resolvePluginServices } from "./plugin-services.js";
+export const PLUGIN_RECORD_ROUTES = definePluginServiceContract('core.record-routes', {
+    multiple: true
+});
+/**
+ * Publishes the addresses for one record kind. The owner is the loader's
+ * marker when a register fn is running, else `options.pluginId`; with neither
+ * the registration throws. A kind another plugin publishes throws naming both.
+ */ export function registerPluginRecordRoute(kind, route, options) {
+    var _ref, _getRegisteringPluginId;
+    const key = kind.trim();
+    if (!key) throw new Error('a record route needs a record kind');
+    const pluginId = ((_ref = (_getRegisteringPluginId = getRegisteringPluginId()) != null ? _getRegisteringPluginId : options == null ? void 0 : options.pluginId) != null ? _ref : '').trim();
+    const incumbent = resolvePluginServices(PLUGIN_RECORD_ROUTES).find((entry)=>entry.key === key);
+    if (incumbent && pluginId && incumbent.pluginId !== pluginId) {
+        throw new Error(`record kind "${key}" already publishes routes from ` + `"${incumbent.pluginId}"; refused "${pluginId}"`);
+    }
+    registerPluginService(PLUGIN_RECORD_ROUTES, route, _extends({}, (options == null ? void 0 : options.pluginId) ? {
+        pluginId: options.pluginId
+    } : {}, {
+        key
+    }));
+}
+/** The route for a kind, with its owner, or `null` when no plugin publishes it. */ export function pluginRecordRoute(kind) {
+    const key = kind.trim();
+    const entry = resolvePluginServices(PLUGIN_RECORD_ROUTES).find((one)=>one.key === key);
+    return entry ? {
+        pluginId: entry.pluginId,
+        route: entry.impl
+    } : null;
+}
+/** Every kind with a published route, in registration order. */ export function listPluginRecordRouteKinds() {
+    return resolvePluginServices(PLUGIN_RECORD_ROUTES).map((entry)=>{
+        var _entry_key;
+        return {
+            kind: (_entry_key = entry.key) != null ? _entry_key : '',
+            pluginId: entry.pluginId
+        };
+    });
+}
+/**
+ * One record's page, or `null` — no plugin publishes the kind, or the owner
+ * has no address for it at this scope. A caller renders text for `null`
+ * rather than a link, which is what every one of these surfaces already does
+ * while its route params settle.
+ */ export function pluginRecordHref(kind, context, id) {
+    var _ref;
+    var _pluginRecordRoute;
+    return (_ref = (_pluginRecordRoute = pluginRecordRoute(kind)) == null ? void 0 : _pluginRecordRoute.route.record(context, id)) != null ? _ref : null;
+}
+/** The list a kind lives on, on the same terms as {@link pluginRecordHref}. */ export function pluginRecordListHref(kind, context) {
+    var _ref;
+    var _pluginRecordRoute;
+    return (_ref = (_pluginRecordRoute = pluginRecordRoute(kind)) == null ? void 0 : _pluginRecordRoute.route.list(context)) != null ? _ref : null;
+}
+/**
+ * The list opened on one person's address, or `null` — including when the
+ * owner publishes routes for the kind but offers no address lookup.
+ */ export function pluginRecordByEmailHref(kind, context, email) {
+    var _ref;
+    var _found_route_byEmail;
+    const found = pluginRecordRoute(kind);
+    return (_ref = found == null ? void 0 : (_found_route_byEmail = found.route.byEmail) == null ? void 0 : _found_route_byEmail.call(found.route, context, email)) != null ? _ref : null;
+}
+/**
+ * The list narrowed by one of the owner's filters, or `null` — including for
+ * a filter the owner does not know, which it answers `null` for rather than
+ * serving a list that ignores the narrowing.
+ */ export function pluginRecordFilteredHref(kind, context, filter, value) {
+    var _ref;
+    var _found_route_filtered;
+    const found = pluginRecordRoute(kind);
+    return (_ref = found == null ? void 0 : (_found_route_filtered = found.route.filtered) == null ? void 0 : _found_route_filtered.call(found.route, context, filter, value)) != null ? _ref : null;
+}
+
+//# sourceMappingURL=plugin-record-routes.js.map

package/src/lib/plugin-manager/plugin-record-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/plugin-manager/plugin-record-routes.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { getRegisteringPluginId } from '../app-utils/registering-plugin'\nimport {\n  definePluginServiceContract,\n  registerPluginService,\n  resolvePluginServices,\n} from './plugin-services'\n\n/**\n * Where a plugin's records live, published by the plugin that owns them\n * (AGL-3124).\n *\n * A surface that is not the record's own routinely wants to link to it: an\n * inbox row to the person it is from, a form's page to the people who filled\n * it in, an assistant's job list to the campaign it wrote. Today each of those\n * builds the other plugin's address itself — four plugins spell each other's\n * URLs, and the core carries a fifth copy for the console app, which may not\n * import a plugin at all.\n *\n * Every copy is the same bug waiting: an address is the owner's to change, and\n * a section that moves leaves a link that still resolves, to the wrong place.\n *\n * So the owner publishes its addresses under the RECORD KIND, and a caller\n * asks for a kind. `plugin-record-facts` already keys a reader by resource\n * name and `plugin-record-timeline` already files an entry on a record; this\n * is the third question about the same record — where a person reads it — and\n * it is keyed the same way, so a plugin that owns `contact` registers the\n * facts reader and the route together and a caller names `contact` for both.\n *\n * ## What a caller passes, and why it is the two route params\n *\n * Every site console page is addressed by `/{orgSlug}/hosts/{host}/…`, and both\n * segments are already in the URL the calling surface is rendered on. Building\n * from them costs nothing; resolving them from a host id costs two document\n * reads on every render of a card, to draw a link. `host: null` asks for the\n * ORGANIZATION-level address, which some kinds have and some do not — a route\n * answers `null` for a scope it does not serve, and the caller renders text\n * rather than a link to nowhere.\n *\n * ## One kind, one owner\n *\n * A record kind belongs to the plugin that models it, so a second plugin\n * publishing addresses for a kind another already publishes is refused naming\n * both, and the incumbent keeps serving. The same plugin registering again —\n * a second surface, a hot reload — replaces its own.\n *\n * The registry knows nothing about permissions: a link is not access, and the\n * page at the far end applies its own gates, as it does for a person who typed\n * the address.\n */\n\n/** The scope an address is asked for. */\nexport interface PluginRecordRouteContext {\n  /** The organization's path slug, as the console URL spells it. */\n  orgSlug: string\n  /** The site's subdomain, or `null` for the organization-level address. */\n  host: string | null\n}\n\n/**\n * The addresses one record kind publishes. Every member answers `null` for a\n * scope the owner does not serve — an org-level page a host-scoped kind has\n * no address for, a list a kind does not have.\n */\nexport interface PluginRecordRoute {\n  /** The list the kind lives on. */\n  list(context: PluginRecordRouteContext): string | null\n  /** One record's own page. */\n  record(context: PluginRecordRouteContext, id: string): string | null\n  /**\n   * The list opened on the one person with an address, where the owner offers\n   * it — for a caller that holds an email and no record id.\n   */\n  byEmail?(context: PluginRecordRouteContext, email: string): string | null\n  /**\n   * The list narrowed by one of the owner's own filters, where the owner\n   * offers it: `filter` and `value` are the owner's words, and a filter it\n   * does not know answers `null` rather than a list showing everything.\n   */\n  filtered?(\n    context: PluginRecordRouteContext,\n    filter: string,\n    value: string,\n  ): string | null\n}\n\n/** A route with the plugin that publishes it. */\nexport interface ResolvedPluginRecordRoute {\n  /** The plugin that owns the kind. */\n  pluginId: string\n  route: PluginRecordRoute\n}\n\nexport const PLUGIN_RECORD_ROUTES =\n  definePluginServiceContract<PluginRecordRoute>('core.record-routes', {\n    multiple: true,\n  })\n\n/**\n * Publishes the addresses for one record kind. The owner is the loader's\n * marker when a register fn is running, else `options.pluginId`; with neither\n * the registration throws. A kind another plugin publishes throws naming both.\n */\nexport function registerPluginRecordRoute(\n  kind: string,\n  route: PluginRecordRoute,\n  options?: { pluginId?: string },\n): void {\n  const key = kind.trim()\n  if (!key) throw new Error('a record route needs a record kind')\n  const pluginId = (getRegisteringPluginId() ?? options?.pluginId ?? '').trim()\n  const incumbent = resolvePluginServices(PLUGIN_RECORD_ROUTES).find(\n    (entry) => entry.key === key,\n  )\n  if (incumbent && pluginId && incumbent.pluginId !== pluginId) {\n    throw new Error(\n      `record kind \"${key}\" already publishes routes from ` +\n        `\"${incumbent.pluginId}\"; refused \"${pluginId}\"`,\n    )\n  }\n  registerPluginService(PLUGIN_RECORD_ROUTES, route, {\n    ...(options?.pluginId ? { pluginId: options.pluginId } : {}),\n    key,\n  })\n}\n\n/** The route for a kind, with its owner, or `null` when no plugin publishes it. */\nexport function pluginRecordRoute(\n  kind: string,\n): ResolvedPluginRecordRoute | null {\n  const key = kind.trim()\n  const entry = resolvePluginServices(PLUGIN_RECORD_ROUTES).find(\n    (one) => one.key === key,\n  )\n  return entry ? { pluginId: entry.pluginId, route: entry.impl } : null\n}\n\n/** Every kind with a published route, in registration order. */\nexport function listPluginRecordRouteKinds(): Array<{\n  kind: string\n  pluginId: string\n}> {\n  return resolvePluginServices(PLUGIN_RECORD_ROUTES).map((entry) => ({\n    kind: entry.key ?? '',\n    pluginId: entry.pluginId,\n  }))\n}\n\n/**\n * One record's page, or `null` — no plugin publishes the kind, or the owner\n * has no address for it at this scope. A caller renders text for `null`\n * rather than a link, which is what every one of these surfaces already does\n * while its route params settle.\n */\nexport function pluginRecordHref(\n  kind: string,\n  context: PluginRecordRouteContext,\n  id: string,\n): string | null {\n  return pluginRecordRoute(kind)?.route.record(context, id) ?? null\n}\n\n/** The list a kind lives on, on the same terms as {@link pluginRecordHref}. */\nexport function pluginRecordListHref(\n  kind: string,\n  context: PluginRecordRouteContext,\n): string | null {\n  return pluginRecordRoute(kind)?.route.list(context) ?? null\n}\n\n/**\n * The list opened on one person's address, or `null` — including when the\n * owner publishes routes for the kind but offers no address lookup.\n */\nexport function pluginRecordByEmailHref(\n  kind: string,\n  context: PluginRecordRouteContext,\n  email: string,\n): string | null {\n  const found = pluginRecordRoute(kind)\n  return found?.route.byEmail?.(context, email) ?? null\n}\n\n/**\n * The list narrowed by one of the owner's filters, or `null` — including for\n * a filter the owner does not know, which it answers `null` for rather than\n * serving a list that ignores the narrowing.\n */\nexport function pluginRecordFilteredHref(\n  kind: string,\n  context: PluginRecordRouteContext,\n  filter: string,\n  value: string,\n): string | null {\n  const found = pluginRecordRoute(kind)\n  return found?.route.filtered?.(context, filter, value) ?? null\n}\n"],"names":["getRegisteringPluginId","definePluginServiceContract","registerPluginService","resolvePluginServices","PLUGIN_RECORD_ROUTES","multiple","registerPluginRecordRoute","kind","route","options","key","trim","Error","pluginId","incumbent","find","entry","pluginRecordRoute","one","impl","listPluginRecordRouteKinds","map","pluginRecordHref","context","id","record","pluginRecordListHref","list","pluginRecordByEmailHref","email","found","byEmail","pluginRecordFilteredHref","filter","value","filtered"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,SAASA,sBAAsB,QAAQ,qCAAiC;AACxE,SACEC,2BAA2B,EAC3BC,qBAAqB,EACrBC,qBAAqB,QAChB,uBAAmB;AAuF1B,OAAO,MAAMC,uBACXH,4BAA+C,sBAAsB;IACnEI,UAAU;AACZ,GAAE;AAEJ;;;;CAIC,GACD,OAAO,SAASC,0BACdC,IAAY,EACZC,KAAwB,EACxBC,OAA+B;QAIbT,MAAAA;IAFlB,MAAMU,MAAMH,KAAKI,IAAI;IACrB,IAAI,CAACD,KAAK,MAAM,IAAIE,MAAM;IAC1B,MAAMC,WAAW,EAACb,QAAAA,0BAAAA,oCAAAA,0BAA4BS,2BAAAA,QAASI,QAAQ,YAA7Cb,OAAiD,IAAIW,IAAI;IAC3E,MAAMG,YAAYX,sBAAsBC,sBAAsBW,IAAI,CAChE,CAACC,QAAUA,MAAMN,GAAG,KAAKA;IAE3B,IAAII,aAAaD,YAAYC,UAAUD,QAAQ,KAAKA,UAAU;QAC5D,MAAM,IAAID,MACR,CAAC,aAAa,EAAEF,IAAI,gCAAgC,CAAC,GACnD,CAAC,CAAC,EAAEI,UAAUD,QAAQ,CAAC,YAAY,EAAEA,SAAS,CAAC,CAAC;IAEtD;IACAX,sBAAsBE,sBAAsBI,OAAO,aAC7CC,CAAAA,2BAAAA,QAASI,QAAQ,IAAG;QAAEA,UAAUJ,QAAQI,QAAQ;IAAC,IAAI,CAAC;QAC1DH;;AAEJ;AAEA,iFAAiF,GACjF,OAAO,SAASO,kBACdV,IAAY;IAEZ,MAAMG,MAAMH,KAAKI,IAAI;IACrB,MAAMK,QAAQb,sBAAsBC,sBAAsBW,IAAI,CAC5D,CAACG,MAAQA,IAAIR,GAAG,KAAKA;IAEvB,OAAOM,QAAQ;QAAEH,UAAUG,MAAMH,QAAQ;QAAEL,OAAOQ,MAAMG,IAAI;IAAC,IAAI;AACnE;AAEA,8DAA8D,GAC9D,OAAO,SAASC;IAId,OAAOjB,sBAAsBC,sBAAsBiB,GAAG,CAAC,CAACL;YAChDA;eAD2D;YACjET,IAAI,GAAES,aAAAA,MAAMN,GAAG,YAATM,aAAa;YACnBH,UAAUG,MAAMH,QAAQ;QAC1B;;AACF;AAEA;;;;;CAKC,GACD,OAAO,SAASS,iBACdf,IAAY,EACZgB,OAAiC,EACjCC,EAAU;;QAEHP;IAAP,gBAAOA,qBAAAA,kBAAkBV,0BAAlBU,mBAAyBT,KAAK,CAACiB,MAAM,CAACF,SAASC,sBAAO;AAC/D;AAEA,6EAA6E,GAC7E,OAAO,SAASE,qBACdnB,IAAY,EACZgB,OAAiC;;QAE1BN;IAAP,gBAAOA,qBAAAA,kBAAkBV,0BAAlBU,mBAAyBT,KAAK,CAACmB,IAAI,CAACJ,2BAAY;AACzD;AAEA;;;CAGC,GACD,OAAO,SAASK,wBACdrB,IAAY,EACZgB,OAAiC,EACjCM,KAAa;;QAGNC;IADP,MAAMA,QAAQb,kBAAkBV;IAChC,eAAOuB,0BAAAA,uBAAAA,MAAOtB,KAAK,CAACuB,OAAO,qBAApBD,0BAAAA,MAAOtB,KAAK,EAAWe,SAASM,yBAAU;AACnD;AAEA;;;;CAIC,GACD,OAAO,SAASG,yBACdzB,IAAY,EACZgB,OAAiC,EACjCU,MAAc,EACdC,KAAa;;QAGNJ;IADP,MAAMA,QAAQb,kBAAkBV;IAChC,eAAOuB,0BAAAA,wBAAAA,MAAOtB,KAAK,CAAC2B,QAAQ,qBAArBL,2BAAAA,MAAOtB,KAAK,EAAYe,SAASU,QAAQC,yBAAU;AAC5D"}