@adminiumjs/add-on-contracts 0.2.5 → 0.2.6

package/dist/document-render.js

@@ -0,0 +1,228 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * `document-render@1` (34-invoices-add-on.md §4, Appendices A and B) — the
+ * fourth contract, and the first one Adminium ITSELF consumes.
+ *
+ * It provides KINDS OF DOCUMENT an add-on can describe — an outline of slots,
+ * every label written in all eight compiled locales — and render to BYTES. The
+ * consumer is the engine document pipeline (profiles, the record trigger, the
+ * `document.render` job, the `/documents` routes), which is the first
+ * production read of `runtime.providers`: a provider is selected by the
+ * profile's add-on key, never by `resolveProvider`'s lowest-key choice.
+ *
+ * ── THE SUBJECT IS THE ONLY DOOR (31 A.1's rule, applied to a contract) ─────
+ *
+ * A provider receives VALUES and returns BYTES. It gets no database handle, no
+ * network, and — the one that gets forgotten — no clock: `subject.now` is the
+ * only time it may read, which is what makes 25 D12's byte-identical claim
+ * testable rather than aspirational. `describeDocumentRenderer` renders twice
+ * and compares every byte.
+ *
+ * ── BYTES, NOT A `FileRef` ─────────────────────────────────────────────────
+ *
+ * {@link RenderedDocument.bytes} is a `Uint8Array`. `FileRef.bytes`
+ * (`common.ts:14,22`) is a COUNT, and a provider that returned one would be
+ * claiming it had already stored the file — which it cannot do, having no file
+ * seam. The engine stores what comes back; the provider never does.
+ *
+ * ── PER-KIND `formats` AND `coverage`, AND WHY THEY ARE ON THE KIND ────────
+ *
+ * "HTML always, PDF always" is NOT this contract's law. `label-sheet` is
+ * `['pdf']` with nothing to say in HTML; `receipt` draws on 80 mm paper no A4
+ * consumer wants. And a writer that draws Helvetica's WinAnsi repertoire
+ * cannot draw Arabic or Han — so a kind declares the glyphs it covers and
+ * REFUSES what it cannot draw, typed, as {@link DocumentError} `LATIN_ONLY`
+ * carrying the offending glyphs. A silent drop would ship an invoice with a
+ * customer's name missing letters (34 D6, O11, O12).
+ *
+ * ── THE `body` CHANNEL IS A ONE-WAY DOOR, AND IT IS OPEN ───────────────────
+ *
+ * §4.3 ships this module verbatim into eighteen repos before the first
+ * provider exists, so a field added later is a second eighteen-repo ceremony
+ * plus a second contract release. {@link RenderInput.body} is therefore here in
+ * the first release. Its shape is O28(a2) — ruled 2026-09-07 as **D54**: an
+ * opaque `Readonly<Record<string, unknown>>` whose schema the PROVIDER owns. A
+ * typed union would have frozen the redesigned comp's 27 block kinds
+ * (`Invoice Builder.dc.html` blockOrder:1114, custom:1266-1272) into a
+ * contract eighteen repos vendor, making every later block a contract release.
+ *
+ * A starter is a TEMPLATE PRESET, not a kind (O28(b), D54) — which is why
+ * `kinds()` stays at three for the invoices provider while the surface offers
+ * twelve starters over eight titles.
+ */
+import { z } from 'zod';
+/**
+ * The eight compiled locales, HYPHENATED — the spelling the add-ons repo
+ * already writes (`barcode-labels/src/i18n/strings.ts`, and the `LOCALES`
+ * array repeated in `host/src/app-neutral.test.ts:435`).
+ *
+ * **[DEP-33 — a departure from Appendix B, forced and minimal.]** Appendix B
+ * names this type `BuiltinLocaleId`. `@adminium/i18n` ALREADY exports a
+ * `BuiltinLocaleId` (`locales.ts:82`) and its members are the UNDERSCORE
+ * spellings — `en_US`, `ar_EG`. Two same-named unions with different members
+ * is not a nuisance, it is a data bug waiting in `apps/server`, which will
+ * import both the moment 34b wires the pipeline: `'en-US'` assigned where
+ * `'en_US'` is meant fails no compile and produces a missing translation at
+ * run time. So the contract's type is named for the contract. The MEMBERS are
+ * Appendix B's, unchanged.
+ */
+export const DOCUMENT_LOCALE_IDS = [
+    'ar-EG',
+    'cs-CZ',
+    'da-DK',
+    'de-DE',
+    'en-US',
+    'fr-FR',
+    'zh-CN',
+    'zh-TW',
+];
+export const localizedTextSchema = z
+    .object(Object.fromEntries(DOCUMENT_LOCALE_IDS.map((id) => [id, z.string().min(1)])))
+    .strict();
+/** What a kind may be rendered to. */
+export const DOCUMENT_FORMATS = ['html', 'pdf'];
+/** The paper a kind is drawn for. `receipt-80mm` is a till roll, not a sheet. */
+export const DOCUMENT_PAPERS = ['a4', 'letter', 'receipt-80mm'];
+/**
+ * Which glyphs the kind's PDF writer can draw.
+ *
+ * `ascii` — 0x20..0x7E only (barcode-labels' scaffold: every byte is ASCII, so
+ * `String.length` is the byte length and the xref offsets are exact).
+ * `winansi` — the 224 drawable code points of WinAnsiEncoding, which is base-14
+ * Helvetica's repertoire: Latin-1 plus €, the smart quotes and the dashes.
+ * `all` — no refusal is possible; nothing claims it yet.
+ */
+export const DOCUMENT_COVERAGES = ['ascii', 'winansi', 'all'];
+export const documentKindSchema = z
+    .object({
+    id: z.string().regex(/^[a-z][a-z0-9-]*$/, 'kind id must be kebab-case'),
+    label: localizedTextSchema,
+    formats: z.array(z.enum(DOCUMENT_FORMATS)).min(1),
+    paper: z.array(z.enum(DOCUMENT_PAPERS)).min(1),
+    coverage: z.enum(DOCUMENT_COVERAGES),
+})
+    .strict();
+/** The value types a slot can carry. `money` is integer minor units; `percent` is basis points. */
+export const OUTLINE_SLOT_TYPES = [
+    'text',
+    'text[]',
+    'date',
+    'email',
+    'money',
+    'percent',
+    'currency',
+    'number',
+    'collection',
+];
+/**
+ * Where an unmapped slot's value comes from, if anywhere.
+ *
+ * `sequence` — the engine's CAS document number, minted after render (34 D11).
+ * `connection` — the connection's currency.
+ * `setting` — one of the add-on's own non-secret settings.
+ * `now` — `subject.now.iso`, never the provider's own clock.
+ */
+export const OUTLINE_SLOT_DEFAULTS = ['sequence', 'connection', 'setting', 'now'];
+const outlineSlotShape = {
+    id: z.string().regex(/^[A-Za-z][A-Za-z0-9_]*$/, 'slot id must be an identifier'),
+    label: localizedTextSchema,
+    help: localizedTextSchema.optional(),
+    type: z.enum(OUTLINE_SLOT_TYPES),
+    required: z.boolean(),
+    default: z.enum(OUTLINE_SLOT_DEFAULTS).optional(),
+};
+/** One column of a `collection`. A column is never itself a collection. */
+export const outlineLeafSlotSchema = z.object(outlineSlotShape).strict();
+/**
+ * The depth limit is in the SCHEMA, not in a comment.
+ *
+ * `OutlineSlot.columns` is typed `readonly OutlineSlot[]` (Appendix B), which
+ * would admit a collection of collections; nothing maps one, no renderer draws
+ * one, and the Studio mapping editor has no row for one. So the validator
+ * accepts exactly two levels and refuses the third — a provider that returns a
+ * nested collection fails `describeDocumentRenderer` with a parse error naming
+ * the slot, rather than passing here and rendering an empty table later.
+ */
+export const outlineSlotSchema = z
+    .object({ ...outlineSlotShape, columns: z.array(outlineLeafSlotSchema).optional() })
+    .strict();
+export const documentOutlineSchema = z
+    .object({ slots: z.array(outlineSlotSchema) })
+    .strict();
+export const publicDocumentRequestSchema = z
+    .object({
+    kind: z.string().min(1),
+    locale: z.string().min(2).optional(),
+    fields: z.record(z.string(), z.unknown()),
+    collections: z.record(z.string(), z.array(z.record(z.string(), z.unknown()))),
+    // Loose on purpose, the way `emailTestSendBody` is
+    // (`apps/server/src/routes/email-templates/schema.ts:160-165`): the SMTP
+    // relay is the real authority on what it will accept, and this address is
+    // stored for a person to review before anything is sent.
+    customerEmail: z.string().trim().min(3).max(320).optional(),
+})
+    .strict();
+export const documentSubjectSchema = z
+    .object({
+    now: z.object({ iso: z.string().min(1), timezone: z.string().min(1) }).strict(),
+    locale: z.string().min(2),
+    currency: z.string().length(3),
+    business: z
+        .object({
+        name: z.string().min(1),
+        lines: z.array(z.string()),
+        logoDataUrl: z.string().optional(),
+    })
+        .strict(),
+    entity: z
+        .object({
+        connectionId: z.string(),
+        table: z.string(),
+        pk: z.record(z.string(), z.unknown()),
+        label: z.string(),
+    })
+        .strict()
+        .nullable(),
+    number: z.string().nullable(),
+    fields: z.record(z.string(), z.unknown()),
+    collections: z.record(z.string(), z.array(z.record(z.string(), z.unknown()))),
+})
+    .strict();
+export const renderedDocumentSchema = z
+    .object({
+    format: z.enum(DOCUMENT_FORMATS),
+    filename: z.string().min(1),
+    mediaType: z.string().min(1),
+    bytes: z.instanceof(Uint8Array),
+    locale: z.string().min(2),
+    warnings: z.array(z.string()),
+})
+    .strict();
+/**
+ * A refusal is DATA, returned — never thrown, and never a silent partial
+ * result. `shipping-carrier`'s `CarrierError` is a class because a carrier's
+ * own words have to reach the screen verbatim; here every refusal is one of
+ * four things the engine can act on, so a union of codes is the honest shape.
+ */
+export const DOCUMENT_ERROR_CODES = [
+    /** A glyph the kind's writer cannot draw. `dropped` names them. */
+    'LATIN_ONLY',
+    /** `render`/`describe` was called with a kind `kinds()` does not list. */
+    'UNSUPPORTED_KIND',
+    /** A slot the outline marks `required` had no value. */
+    'MISSING_SLOT',
+    /** The subject did not parse — a wrong type, a malformed body. */
+    'INVALID_SUBJECT',
+];
+export const documentErrorSchema = z
+    .object({
+    code: z.enum(DOCUMENT_ERROR_CODES),
+    detail: z.string().optional(),
+    dropped: z.array(z.string()).optional(),
+})
+    .strict();
+/** Narrows `render`'s union without a `code in x` incantation at every call site. */
+export function isDocumentError(value) {
+    return !Array.isArray(value);
+}
+//# sourceMappingURL=document-render.js.map

package/dist/document-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-render.js","sourceRoot":"","sources":["../src/document-render.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -14,5 +14,6 @@ export { CONTRACT_REGISTRY, CONTRACT_IDS, contractIdSchema, isContractId, hasCon
 export { ADD_ON_CATEGORIES, ADD_ON_ISSUE_CODES, CONNECT_KINDS, addOnBlockSchema, addOnCategorySchema, addOnConnectSchema, addOnEventSchema, addOnNetworkSchema, attachTargetSchema, connectKindSchema, consumesSchema, providesSchema, slotFillSchema, type AddOnBlock, type AddOnCategory, type AddOnIssueCode, type ConnectKind, } from './add-on-block.js';
 export { artworkRefSchema, jobSpecSchema, type ArtworkRef, type ArtworkSource, type AvailabilityVerdict, type JobSpec, } from './artwork-source.js';
 export { CarrierError, addressSchema, parcelSchema, rateSchema, shipmentSchema, trackEventSchema, type Address, type OrderRef, type Parcel, type Rate, type Shipment, type ShippingCarrier, type TrackEvent, } from './shipping-carrier.js';
+export { DOCUMENT_COVERAGES, DOCUMENT_ERROR_CODES, DOCUMENT_FORMATS, DOCUMENT_LOCALE_IDS, DOCUMENT_PAPERS, OUTLINE_SLOT_DEFAULTS, OUTLINE_SLOT_TYPES, documentErrorSchema, documentKindSchema, documentOutlineSchema, documentSubjectSchema, isDocumentError, localizedTextSchema, outlineSlotSchema, publicDocumentRequestSchema, renderedDocumentSchema, type DocumentCoverage, type DocumentError, type DocumentErrorCode, type DocumentFormat, type DocumentKind, type DocumentLocaleId, type DocumentOutline, type DocumentPaper, type DocumentRenderer, type DocumentSubject, type LocalizedText, type OutlineSlot, type OutlineSlotDefault, type OutlineSlotType, type PublicDocumentRequest, type RecordRef, type RenderInput, type RenderedDocument, } from './document-render.js';
 export { personalizationSchema, templateSchema, zoneSchema, type Personalization, type PreviewRef, type ProductPersonalizer, type ProductRef, type Template, type Verdict, type Zone, type ZoneFinish, type ZoneKind, } from './product-personalizer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,OAAO,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,+BAA+B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,EACd,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,OAAO,GACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,gBAAgB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -15,5 +15,6 @@ export { CONTRACT_REGISTRY, CONTRACT_IDS, contractIdSchema, isContractId, hasCon
 export { ADD_ON_CATEGORIES, ADD_ON_ISSUE_CODES, CONNECT_KINDS, addOnBlockSchema, addOnCategorySchema, addOnConnectSchema, addOnEventSchema, addOnNetworkSchema, attachTargetSchema, connectKindSchema, consumesSchema, providesSchema, slotFillSchema, } from './add-on-block.js';
 export { artworkRefSchema, jobSpecSchema, } from './artwork-source.js';
 export { CarrierError, addressSchema, parcelSchema, rateSchema, shipmentSchema, trackEventSchema, } from './shipping-carrier.js';
+export { DOCUMENT_COVERAGES, DOCUMENT_ERROR_CODES, DOCUMENT_FORMATS, DOCUMENT_LOCALE_IDS, DOCUMENT_PAPERS, OUTLINE_SLOT_DEFAULTS, OUTLINE_SLOT_TYPES, documentErrorSchema, documentKindSchema, documentOutlineSchema, documentSubjectSchema, isDocumentError, localizedTextSchema, outlineSlotSchema, publicDocumentRequestSchema, renderedDocumentSchema, } from './document-render.js';
 export { personalizationSchema, templateSchema, zoneSchema, } from './product-personalizer.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,GAKf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,GAKf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,GAQjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,GAUX,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAEzD,OAAO,EAAE,aAAa,EAAgB,MAAM,aAAa,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,GAKf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,GAGnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,cAAc,GAKf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,aAAa,GAKd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,gBAAgB,GAQjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,eAAe,EACf,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,qBAAqB,EACrB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,2BAA2B,EAC3B,sBAAsB,GAmBvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,UAAU,GAUX,MAAM,2BAA2B,CAAC"}

package/dist/slots.d.ts

@@ -1,6 +1,7 @@
 /**
  * Slot registry v1 — CLOSED (24-marketplace-wave-4.md §5.4; eleven slots, plus
- * one bought on 2026-08-28 and named at the end of the list).
+ * two bought since and named at the end of the list, in the order they were
+ * bought).
  *
  * A slot is a named place in a host surface, its payload, and its fill rule.
  * The registry is closed for the same reason the widget-id vocabulary is: an
@@ -27,6 +28,18 @@
  * reader does not have to take the distinction on trust. If a second slot ever
  * lands here on weaker evidence than that, this paragraph is the thing it
  * should be measured against.
+ *
+ * A SECOND SLOT DID, AND IT IS MEASURED AGAINST THIS PARAGRAPH IN ITS OWN
+ * ENTRY. `shell.overlay` (2026-09-01) carries FOUR exhibits, not seven, and one
+ * of the four is an absence. It is therefore the weaker dossier and its entry
+ * says so in those words rather than dressing four up as enough. What it has
+ * that `record.actions` did not is the thing the paragraph above the last one
+ * asks for: it ships WITH its fill, in the same wave, so the registry's founding
+ * rule — a slot nobody fills is a guess — is satisfied on the day it lands
+ * instead of being owed to a later wave. The two entries are the two ways a
+ * purchase can be honest, and neither is the template for a third: a third that
+ * has neither seven exhibits nor a fill in the same wave is the guess this
+ * registry is closed against.
  */
 import { z } from 'zod';
 /** Which persona's surface the slot lives in. */
@@ -121,6 +134,12 @@ export declare const SLOT_REGISTRY: readonly [{
     readonly fill: "multi";
     readonly payload: "what kind of record it is, the record, and a way to write back";
     readonly renders: "an action and the panel its result lands in";
+}, {
+    readonly id: "shell.overlay";
+    readonly surface: "customer";
+    readonly fill: "multi";
+    readonly payload: "the host shell: brand, screen, locale, clock, what it knows of the visitor, an open request, and the environment handles (token, storage, public client, suggest, handoff)";
+    readonly renders: "a floating affordance and its panel, stacked at the inline-end corner";
 }];
 export type SlotId = (typeof SLOT_REGISTRY)[number]['id'];
 export declare const SLOT_IDS: readonly SlotId[];
@@ -137,6 +156,7 @@ export declare const slotIdSchema: z.ZodEnum<{
     "order.line.actions": "order.line.actions";
     "record.editor.panel": "record.editor.panel";
     "record.actions": "record.actions";
+    "shell.overlay": "shell.overlay";
 }>;
 export declare function isSlotId(v: unknown): v is SlotId;
 export declare function slotDefinition(id: SlotId): SlotDefinition;

package/dist/slots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iDAAiD;AACjD,eAAO,MAAM,aAAa,iDAAkD,CAAC;AAC7E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,4CAA6C,CAAC;AACrE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmKoB,CAAC;AAE/C,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ,EAAqC,SAAS,MAAM,EAAE,CAAC;AAE5E,eAAO,MAAM,YAAY;;;;;;;;;;;;;EAAuD,CAAC;AAIjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAKzD"}
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,iDAAiD;AACjD,eAAO,MAAM,aAAa,iDAAkD,CAAC;AAC7E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,4CAA6C,CAAC;AACrE,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoPoB,CAAC;AAE/C,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ,EAAqC,SAAS,MAAM,EAAE,CAAC;AAE5E,eAAO,MAAM,YAAY;;;;;;;;;;;;;;EAAuD,CAAC;AAIjF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAEhD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,CAKzD"}

package/dist/slots.js

@@ -1,7 +1,8 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
  * Slot registry v1 — CLOSED (24-marketplace-wave-4.md §5.4; eleven slots, plus
- * one bought on 2026-08-28 and named at the end of the list).
+ * two bought since and named at the end of the list, in the order they were
+ * bought).
  *
  * A slot is a named place in a host surface, its payload, and its fill rule.
  * The registry is closed for the same reason the widget-id vocabulary is: an
@@ -28,6 +29,18 @@
  * reader does not have to take the distinction on trust. If a second slot ever
  * lands here on weaker evidence than that, this paragraph is the thing it
  * should be measured against.
+ *
+ * A SECOND SLOT DID, AND IT IS MEASURED AGAINST THIS PARAGRAPH IN ITS OWN
+ * ENTRY. `shell.overlay` (2026-09-01) carries FOUR exhibits, not seven, and one
+ * of the four is an absence. It is therefore the weaker dossier and its entry
+ * says so in those words rather than dressing four up as enough. What it has
+ * that `record.actions` did not is the thing the paragraph above the last one
+ * asks for: it ships WITH its fill, in the same wave, so the registry's founding
+ * rule — a slot nobody fills is a guess — is satisfied on the day it lands
+ * instead of being owed to a later wave. The two entries are the two ways a
+ * purchase can be honest, and neither is the template for a third: a third that
+ * has neither seven exhibits nor a fill in the same wave is the guess this
+ * registry is closed against.
  */
 import { z } from 'zod';
 /** Which persona's surface the slot lives in. */
@@ -202,6 +215,86 @@ export const SLOT_REGISTRY = [
         payload: 'what kind of record it is, the record, and a way to write back',
         renders: 'an action and the panel its result lands in',
     },
+    {
+        /*
+         * THE THIRTEENTH, BOUGHT ON 2026-09-01 (33-live-chat-add-on.md O1 → D17).
+         *
+         * The first slot on a CUSTOMER SHELL. Every other customer id in this list
+         * is a place inside a flow — a product being configured, a basket line, a
+         * checkout's delivery step, a dispatch being read. This one is the layer
+         * ABOVE the page: a floating affordance a visitor can reach from any screen
+         * in the app, and the panel it opens.
+         *
+         * ── ITS DOSSIER IS WEAKER THAN `record.actions`', AND SAYS SO ────────────
+         *
+         * Four exhibits, not seven, written down in 33 Appendix A (deposited into
+         * 31 Appendix A as A.4):
+         *
+         *   1. one shipped implementation — the help desk's chat panel, a
+         *      store-connected overlay mounted once at the shell and therefore
+         *      present on all 54 of its views, with SIX host entry points and a
+         *      hand-off into the host's own ticket model
+         *      (`support-desk/src/components/ChatWidget.tsx`, `app/App.tsx:320`)
+         *   2. the gap the previous purchase's own review recorded — 31 A.3,
+         *      "neither the 11 nor A.1 covers a customer surface"
+         *   3. a dead affordance in the flagship — the storefront footer's
+         *      "Contact", wired to a demo toast (`Footer.tsx:107-110`)
+         *   4. ABSENCE, MEASURED: ten customer-side repos grepped for any way to
+         *      reach the operator from the shell; zero hits outside the help desk
+         *
+         * Exhibit 4 is an absence, and an absence is the weakest kind of evidence
+         * there is — it says nobody built this, which is equally consistent with
+         * nobody wanting it. It is in the list because it is the honest state of
+         * the fleet and not because it carries the purchase. What carries the
+         * purchase is exhibit 1 plus the condition below.
+         *
+         * ── WHAT IT HAS THAT THE TWELFTH DID NOT: IT SHIPS WITH ITS FILL ────────
+         *
+         * `record.actions` arrives unfilled and its entry spends four paragraphs
+         * on why that is not a guess. This id needs none of them: `live-chat` fills
+         * it in the same wave, from the same plan, and the help desk's own widget
+         * is what becomes the fill. The registry's founding rule is therefore met
+         * on the day the id lands rather than owed to a later one — which is the
+         * whole of the difference, and the reason a four-exhibit dossier was
+         * accepted here and would not have been for the twelfth.
+         *
+         * ── `customer`, AND WHY NOT `both` ──────────────────────────────────────
+         *
+         * The temptation is `both`: a staff app could hang a floating panel in its
+         * corner too. Nothing in the fleet does, and ruling it `both` on that
+         * reasoning would be buying a second surface on no exhibits at all — the
+         * mistake this entry has just spent forty lines refusing. A staff overlay
+         * can be bought the day a staff screen wants one, on its own evidence.
+         * `record.actions` went the other way on exhibits, not on symmetry: two of
+         * its seven were a reader's own record, so `staff` would have excluded
+         * them.
+         *
+         * ── THE ALTERNATIVE THAT WAS REJECTED, AND IS STILL ON FILE ─────────────
+         *
+         * Adminium injecting a script into every hosted customer surface, with no
+         * slot at all. Rejected for v1 (D3): demo mode needs the seam regardless —
+         * an example app running on fixtures has no Adminium to inject anything —
+         * and a second mount mechanism is the duplication this layer exists to
+         * prevent. It stays on file as the way to reach OPERATOR-BUILT customer
+         * pages, which have no seam to mount into (33 D22).
+         *
+         * ── THE ONE THING A READER SHOULD HOLD AGAINST IT ───────────────────────
+         *
+         * `fill: 'multi'` promises stacked overlays and there has never been more
+         * than one. A second overlay add-on would want to open A PARTICULAR fill
+         * from a host entry point, and the payload's `openRequest` is a bare
+         * counter that opens every one of them. That is recorded as un-purchased
+         * standing evidence (33 D16) rather than pre-solved with a `target` field
+         * nothing would pass: `multi` is right because two overlays must coexist
+         * without one of them winning, and the day a second one exists the request
+         * widens. Until then a host with one fill gets the behaviour it wants.
+         */
+        id: 'shell.overlay',
+        surface: 'customer',
+        fill: 'multi',
+        payload: 'the host shell: brand, screen, locale, clock, what it knows of the visitor, an open request, and the environment handles (token, storage, public client, suggest, handoff)',
+        renders: 'a floating affordance and its panel, stacked at the inline-end corner',
+    },
 ];
 export const SLOT_IDS = SLOT_REGISTRY.map((s) => s.id);
 export const slotIdSchema = z.enum(SLOT_IDS);

package/dist/slots.js.map

@@ -1 +1 @@
-{"version":3,"file":"slots.js","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../src/slots.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -12,6 +12,7 @@
  * storefront, the SPAs and Electron can all use it (01 §3).
  */
 import { type ArtworkSource, type JobSpec } from '../artwork-source.js';
+import { type DocumentKind, type DocumentRenderer, type DocumentSubject } from '../document-render.js';
 import { type Personalization, type ProductPersonalizer, type ProductRef, type Template } from '../product-personalizer.js';
 import { type Address, type OrderRef, type Parcel, type ShippingCarrier } from '../shipping-carrier.js';
 export interface ArtworkSourceFixtures {
@@ -45,4 +46,64 @@ export interface ProductPersonalizerFixtures {
     angle: string;
 }
 export declare function describeProductPersonalizer(impl: ProductPersonalizer, fixtures: ProductPersonalizerFixtures): void;
+/**
+ * What an implementer supplies. Deliberately three fields, not ten.
+ *
+ * Every hard case this suite exercises — a missing required slot, an accented
+ * subject, an Arabic one, a different clock — is DERIVED here from the one
+ * valid subject, by rewriting the fields the outline already describes. That
+ * keeps the derivations identical across providers (a fixture author cannot
+ * accidentally make `MISSING_SLOT` easy by omitting an optional slot instead
+ * of a required one), and it keeps the cost of a second implementer near zero,
+ * which is the claim `shipping-carrier` makes and this contract inherits.
+ */
+export interface DocumentRendererFixtures {
+    /** The add-on's own non-secret values, as the engine would pass them. */
+    settings: Readonly<Record<string, unknown>>;
+    /** One subject the provider renders happily, per kind. */
+    subject: (kind: DocumentKind) => DocumentSubject;
+    /** The authored composition, for a provider that takes one (34 D54). */
+    body?: (kind: DocumentKind) => Readonly<Record<string, unknown>> | undefined;
+    /**
+     * The id of a slot whose value the renderer DRAWS VERBATIM — where the suite
+     * puts `<script>`, `é ß ø €` and Arabic to see what comes back.
+     *
+     * It defaults to the kind's first `text` slot, which is right for most
+     * providers and wrong for two kinds this suite has already met:
+     *
+     *   · a slot the provider VALIDATES. Push `é` into a slot holding a
+     *     barcode number and the refusal that comes back is `INVALID_SUBJECT`
+     *     from the check digit, never `LATIN_ONLY` from the writer — the
+     *     assertion goes green on the wrong evidence, or red for the wrong
+     *     reason;
+     *   · a slot the provider does not PRINT. `barcode-labels`' first text slot
+     *     is the row key, which is a lookup and appears nowhere on the sheet, so
+     *     the accented subject rendered perfectly happily and the coverage
+     *     assertion failed with the provider being entirely correct (found
+     *     2026-09-10, 34-T06).
+     *
+     * A provider with no drawn free-text slot at all returns `undefined` and the
+     * escaping and coverage assertions skip — loudly, in the name.
+     */
+    textSlot?: (kind: DocumentKind) => string | undefined;
+}
+/**
+ * Walk a PDF's cross-reference table back to the objects it points at.
+ *
+ * This is the assertion that a hand-rolled writer cannot fake. Every offset in
+ * the table is a BYTE offset, so a writer that computed them from
+ * `String.length` over a stream containing one multi-byte character produces a
+ * file every viewer opens and every parser mis-seeks — the exact failure 34's
+ * §0.3 trap 8 sends the invoices writer over byte buffers to avoid. Seeking to
+ * each offset and requiring `<n> 0 obj` there catches it on the first render.
+ *
+ * Exported so a writer's own tests can walk its table with the same rules the
+ * suite applies, rather than re-deriving a second walker that drifts from
+ * this one. Every refusal throws an `Error` naming what it found.
+ */
+export declare function parseXrefBack(bytes: Uint8Array): {
+    objects: number;
+    offsets: number[];
+};
+export declare function describeDocumentRenderer(impl: DocumentRenderer, fixtures: DocumentRendererFixtures): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CA2CN;AAID,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAkFN;AAID,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,4EAA4E;IAC5E,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,2BAA2B,GACpC,IAAI,CAqDN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EAOL,KAAK,YAAY,EAEjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,QAAQ,EACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAIhC,MAAM,WAAW,qBAAqB;IACpC,kCAAkC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,qBAAqB,GAC9B,IAAI,CA2CN;AAID,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,uBAAuB,GAChC,IAAI,CAoHN;AAID,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,kCAAkC;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,4EAA4E;IAC5E,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,mBAAmB,EACzB,QAAQ,EAAE,2BAA2B,GACpC,IAAI,CAqDN;AAID;;;;;;;;;;GAUG;AACH,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C,0DAA0D;IAC1D,OAAO,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,eAAe,CAAC;IACjD,wEAAwE;IACxE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;CACvD;AAyDD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0CvF;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,wBAAwB,GACjC,IAAI,CAoSN"}