@adminiumjs/add-on-contracts 0.2.9 → 0.3.0-rc.1

package/dist/add-on-block.d.ts

@@ -1,13 +1,14 @@
 /**
- * The `addOn` manifest block (24-marketplace-wave-4.md §5.3) and its validation
- * rules. Lives here rather than in `@adminium/manifest` because the rules are
- * assertions ABOUT the registries in this package — a slot id or a contract id
- * is only meaningful against the closed lists in `slots.ts` / `contracts.ts`.
+ * The `addOn` manifest block and its validation rules. Lives here rather than
+ * in `@adminium/manifest` because the rules are assertions ABOUT the registries
+ * in this package — a slot id or a contract id is only meaningful against the
+ * closed lists in `slots.ts` / `contracts.ts`.
  *
  * `@adminium/manifest` imports this to build the `kind: "add-on"` branch of its
  * discriminated union.
  */
 import { z } from 'zod';
+import { type BuiltinNavGroupKey } from './nav-groups.js';
 /**
  * Add-ons get their OWN closed category vocabulary (D2), because an add-on is
  * not a vertical and forcing it into the app facet set would make a carrier a
@@ -23,7 +24,7 @@ export declare const addOnCategorySchema: z.ZodEnum<{
     data: "data";
 }>;
 export type AddOnCategory = (typeof ADD_ON_CATEGORIES)[number];
-/** How the shop supplies credentials, if at all (§5.6). */
+/** How the shop supplies credentials, if at all. */
 export declare const CONNECT_KINDS: readonly ["none", "api-key", "oauth2"];
 export declare const connectKindSchema: z.ZodEnum<{
     none: "none";
@@ -91,6 +92,109 @@ export declare const addOnConnectSchema: z.ZodObject<{
 export declare const addOnNetworkSchema: z.ZodObject<{
     allow: z.ZodArray<z.ZodString>;
 }, z.core.$strict>;
+/**
+ * An i18n message: a catalog key plus the English fallback rendered when the
+ * key is absent.
+ *
+ * MOVED HERE FROM `@adminium/manifest` by 51a, which now re-exports it under
+ * the same name. One definition rather than two, because both ends need it: a
+ * page title and a nav-group label are written in a manifest and validated
+ * there, and read back by a host through the schemas in THIS package. Two
+ * four-line copies of the same shape are exactly the duplicate that drifts in a
+ * field nobody reads — `max(400)` here and `max(200)` there — and then the
+ * stricter copy refuses first, for a reason no message names.
+ */
+export declare const i18nMessageSchema: z.ZodObject<{
+    key: z.ZodString;
+    fallback: z.ZodString;
+}, z.core.$strict>;
+export type I18nMessage = z.infer<typeof i18nMessageSchema>;
+/**
+ * THE RAIL'S BUILT-IN GROUPS now live in `nav-groups.ts`, re-exported here so
+ * this module's public surface is unchanged. They moved so that a host needing
+ * only the five keys — the dashboard's entry-chunk `app/bootstrap.ts` — can
+ * import them without making this whole module, and everything the barrel
+ * reaches from it, statically reachable. See that file's note.
+ */
+export { BUILTIN_NAV_GROUP_KEYS, type BuiltinNavGroupKey } from './nav-groups.js';
+/**
+ * Where a page goes when its manifest asks for no group (the owner's ruling,
+ * 51 D-nav). Applied at PARSE, so what a host reads is already resolved and the
+ * rail never has to guess.
+ *
+ * The alternative is what generated pages do today, and it is worse: an app
+ * page whose `navGroup` is not in the closed set is dropped into `hidden` at
+ * `bootstrap/handlers.ts:146` — the page exists, nothing links to it, and
+ * nothing says why. An add-on that omits a group has not made a mistake, so it
+ * gets a home rather than a silence.
+ */
+export declare const DEFAULT_NAV_GROUP: BuiltinNavGroupKey;
+/**
+ * A group key, built-in or declared. Kebab-case, because it appears in no URL
+ * but is compared against the built-in five, which are kebab.
+ */
+export declare const navGroupKeySchema: z.ZodString;
+/**
+ * The host API an add-on's client code is written against.
+ *
+ * A version rather than a boolean because publishing `Modal` and `useNavigate`
+ * to code the engine did not build makes them public API: the day that surface
+ * changes shape, an add-on built against the old one must be REFUSED with its
+ * version named, not mounted into a blank screen. `z.literal(1)` becomes a
+ * union the first time there is a 2 — and there is deliberately no `"*"`.
+ */
+export declare const hostApiVersionSchema: z.ZodLiteral<1>;
+export declare const HOST_API_VERSION = 1;
+/**
+ * A rail row. Omit `nav` entirely and the page is routable but unlisted —
+ * a detail screen an add-on links to itself.
+ */
+export declare const addOnPageNavSchema: z.ZodObject<{
+    group: z.ZodDefault<z.ZodString>;
+    order: z.ZodNumber;
+    adminOnly: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+/**
+ * A page an add-on renders from its OWN bundle.
+ *
+ * NOT `pageSchema` in `@adminium/manifest`, which is a generated page: a
+ * `template` the engine renders with `bindings` and `config`. This is code. The
+ * two deliberately do not share a name in the same document — an add-on's live
+ * under `addOn.pages` — because "page" meaning both a template row and a
+ * JavaScript module in one manifest is how a reader ends up writing `template`
+ * here and waiting for a screen that never comes.
+ */
+export declare const addOnPageSchema: z.ZodObject<{
+    ref: z.ZodString;
+    title: z.ZodObject<{
+        key: z.ZodString;
+        fallback: z.ZodString;
+    }, z.core.$strict>;
+    icon: z.ZodString;
+    client: z.ZodString;
+    nav: z.ZodOptional<z.ZodObject<{
+        group: z.ZodDefault<z.ZodString>;
+        order: z.ZodNumber;
+        adminOnly: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>;
+    detail: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strict>;
+export type AddOnPage = z.infer<typeof addOnPageSchema>;
+/**
+ * A group this add-on brings with it. Its label travels WITH the add-on — a key
+ * plus an English fallback, resolved against the add-on's own translations —
+ * which is the whole reason the engine does not have to own
+ * `nav.group.<whatever>` in eight locales to let somebody name a group.
+ */
+export declare const addOnNavGroupSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodObject<{
+        key: z.ZodString;
+        fallback: z.ZodString;
+    }, z.core.$strict>;
+    order: z.ZodNumber;
+}, z.core.$strict>;
+export type AddOnNavGroup = z.infer<typeof addOnNavGroupSchema>;
 export declare const addOnBlockSchema: z.ZodObject<{
     attaches: z.ZodArray<z.ZodObject<{
         app: z.ZodUnion<readonly [z.ZodLiteral<"*">, z.ZodString]>;
@@ -155,9 +259,33 @@ export declare const addOnBlockSchema: z.ZodObject<{
     }, z.core.$strict>>;
     publicSettings: z.ZodOptional<z.ZodArray<z.ZodString>>;
     demoTransport: z.ZodOptional<z.ZodString>;
+    pages: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ref: z.ZodString;
+        title: z.ZodObject<{
+            key: z.ZodString;
+            fallback: z.ZodString;
+        }, z.core.$strict>;
+        icon: z.ZodString;
+        client: z.ZodString;
+        nav: z.ZodOptional<z.ZodObject<{
+            group: z.ZodDefault<z.ZodString>;
+            order: z.ZodNumber;
+            adminOnly: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strict>>;
+        detail: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strict>>>;
+    navGroups: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodObject<{
+            key: z.ZodString;
+            fallback: z.ZodString;
+        }, z.core.$strict>;
+        order: z.ZodNumber;
+    }, z.core.$strict>>>;
+    hostApi: z.ZodOptional<z.ZodLiteral<1>>;
 }, z.core.$strict>;
 export type AddOnBlock = z.infer<typeof addOnBlockSchema>;
-/** Issue codes the validators emit (13 §3.2 convention, extended by 24 §5.3). */
+/** Issue codes the validators emit. */
 export declare const ADD_ON_ISSUE_CODES: readonly ["ATTACH_TARGET_UNKNOWN", "SLOT_UNKNOWN", "CONTRACT_UNKNOWN", "SCOPE_OUT_OF_RANGE", "NETWORK_ALLOW_REQUIRED", "CAPABILITY_CONFLICT", "FRONTEND_SECRET_LEAK", "SLOT_CONFLICT"];
 export type AddOnIssueCode = (typeof ADD_ON_ISSUE_CODES)[number];
 //# sourceMappingURL=add-on-block.d.ts.map

package/dist/add-on-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-on-block.d.ts","sourceRoot":"","sources":["../src/add-on-block.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,+DAAgE,CAAC;AAC/F,eAAO,MAAM,mBAAmB;;;;;;EAA4B,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,2DAA2D;AAC3D,eAAO,MAAM,aAAa,wCAAyC,CAAC;AACpE,eAAO,MAAM,iBAAiB;;;;EAAwB,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAazD,eAAO,MAAM,kBAAkB;;;;kBAQpB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;;kBAMhB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;kBAKhB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;kBAMhB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;kBAKlB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;;;;;;;kBAOpB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;kBAIpB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAmC1B,CAAC;AAEJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,wLASrB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"add-on-block.d.ts","sourceRoot":"","sources":["../src/add-on-block.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAElF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,+DAAgE,CAAC;AAC/F,eAAO,MAAM,mBAAmB;;;;;;EAA4B,CAAC;AAC7D,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,oDAAoD;AACpD,eAAO,MAAM,aAAa,wCAAyC,CAAC;AACpE,eAAO,MAAM,iBAAiB;;;;EAAwB,CAAC;AACvD,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAazD,eAAO,MAAM,kBAAkB;;;;kBAQpB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;;kBAMhB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;kBAKhB,CAAC;AAEZ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;kBAMhB,CAAC;AAEZ,eAAO,MAAM,gBAAgB;;;kBAKlB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;;;;;;;;kBAOpB,CAAC;AAEZ,eAAO,MAAM,kBAAkB;;kBAIpB,CAAC;AAIZ;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB;;;kBAKnB,CAAC;AACZ,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;;;GAMG;AACH,OAAO,EAAE,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAElF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,iBAAiB,EAAE,kBAA8B,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAE2D,CAAC;AAE1F;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,iBAAe,CAAC;AACjD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;kBAOpB,CAAC;AAEZ;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;kBAYjB,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB;;;;;;;kBAOrB,CAAC;AACZ,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwG1B,CAAC;AAEJ,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,uCAAuC;AACvC,eAAO,MAAM,kBAAkB,wLAgBrB,CAAC;AACX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/add-on-block.js

@@ -1,9 +1,9 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * The `addOn` manifest block (24-marketplace-wave-4.md §5.3) and its validation
- * rules. Lives here rather than in `@adminium/manifest` because the rules are
- * assertions ABOUT the registries in this package — a slot id or a contract id
- * is only meaningful against the closed lists in `slots.ts` / `contracts.ts`.
+ * The `addOn` manifest block and its validation rules. Lives here rather than
+ * in `@adminium/manifest` because the rules are assertions ABOUT the registries
+ * in this package — a slot id or a contract id is only meaningful against the
+ * closed lists in `slots.ts` / `contracts.ts`.
  *
  * `@adminium/manifest` imports this to build the `kind: "add-on"` branch of its
  * discriminated union.
@@ -11,6 +11,7 @@
 import { z } from 'zod';
 import { contractIdSchema, hasContractVersion } from './contracts.js';
 import { slotIdSchema } from './slots.js';
+import { BUILTIN_NAV_GROUP_KEYS } from './nav-groups.js';
 /**
  * Add-ons get their OWN closed category vocabulary (D2), because an add-on is
  * not a vertical and forcing it into the app facet set would make a carrier a
@@ -19,7 +20,7 @@ import { slotIdSchema } from './slots.js';
  */
 export const ADD_ON_CATEGORIES = ['artwork', 'delivery', 'payments', 'email', 'data'];
 export const addOnCategorySchema = z.enum(ADD_ON_CATEGORIES);
-/** How the shop supplies credentials, if at all (§5.6). */
+/** How the shop supplies credentials, if at all. */
 export const CONNECT_KINDS = ['none', 'api-key', 'oauth2'];
 export const connectKindSchema = z.enum(CONNECT_KINDS);
 const SEMVER_RANGE = /^[\^~]?(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$|^\*$/;
@@ -79,6 +80,112 @@ export const addOnNetworkSchema = z
     allow: z.array(z.string().regex(HOSTNAME, 'must be an exact https hostname')),
 })
     .strict();
+// ── pages and navigation ─────────────────────────────────────────────────────
+/**
+ * An i18n message: a catalog key plus the English fallback rendered when the
+ * key is absent.
+ *
+ * MOVED HERE FROM `@adminium/manifest` by 51a, which now re-exports it under
+ * the same name. One definition rather than two, because both ends need it: a
+ * page title and a nav-group label are written in a manifest and validated
+ * there, and read back by a host through the schemas in THIS package. Two
+ * four-line copies of the same shape are exactly the duplicate that drifts in a
+ * field nobody reads — `max(400)` here and `max(200)` there — and then the
+ * stricter copy refuses first, for a reason no message names.
+ */
+export const i18nMessageSchema = z
+    .object({
+    key: z.string().min(1).max(120),
+    fallback: z.string().min(1).max(400),
+})
+    .strict();
+/**
+ * THE RAIL'S BUILT-IN GROUPS now live in `nav-groups.ts`, re-exported here so
+ * this module's public surface is unchanged. They moved so that a host needing
+ * only the five keys — the dashboard's entry-chunk `app/bootstrap.ts` — can
+ * import them without making this whole module, and everything the barrel
+ * reaches from it, statically reachable. See that file's note.
+ */
+export { BUILTIN_NAV_GROUP_KEYS } from './nav-groups.js';
+/**
+ * Where a page goes when its manifest asks for no group (the owner's ruling,
+ * 51 D-nav). Applied at PARSE, so what a host reads is already resolved and the
+ * rail never has to guess.
+ *
+ * The alternative is what generated pages do today, and it is worse: an app
+ * page whose `navGroup` is not in the closed set is dropped into `hidden` at
+ * `bootstrap/handlers.ts:146` — the page exists, nothing links to it, and
+ * nothing says why. An add-on that omits a group has not made a mistake, so it
+ * gets a home rather than a silence.
+ */
+export const DEFAULT_NAV_GROUP = 'library';
+/**
+ * A group key, built-in or declared. Kebab-case, because it appears in no URL
+ * but is compared against the built-in five, which are kebab.
+ */
+export const navGroupKeySchema = z
+    .string()
+    .regex(/^[a-z][a-z0-9-]{0,39}$/, 'a nav group key must be kebab-case, 1–40 characters');
+/**
+ * The host API an add-on's client code is written against.
+ *
+ * A version rather than a boolean because publishing `Modal` and `useNavigate`
+ * to code the engine did not build makes them public API: the day that surface
+ * changes shape, an add-on built against the old one must be REFUSED with its
+ * version named, not mounted into a blank screen. `z.literal(1)` becomes a
+ * union the first time there is a 2 — and there is deliberately no `"*"`.
+ */
+export const hostApiVersionSchema = z.literal(1);
+export const HOST_API_VERSION = 1;
+/**
+ * A rail row. Omit `nav` entirely and the page is routable but unlisted —
+ * a detail screen an add-on links to itself.
+ */
+export const addOnPageNavSchema = z
+    .object({
+    group: navGroupKeySchema.default(DEFAULT_NAV_GROUP),
+    order: z.number().int(),
+    /** Same audience the engine's own admin-only rail rows have. */
+    adminOnly: z.boolean().optional(),
+})
+    .strict();
+/**
+ * A page an add-on renders from its OWN bundle.
+ *
+ * NOT `pageSchema` in `@adminium/manifest`, which is a generated page: a
+ * `template` the engine renders with `bindings` and `config`. This is code. The
+ * two deliberately do not share a name in the same document — an add-on's live
+ * under `addOn.pages` — because "page" meaning both a template row and a
+ * JavaScript module in one manifest is how a reader ends up writing `template`
+ * here and waiting for a screen that never comes.
+ */
+export const addOnPageSchema = z
+    .object({
+    /** The last segment of `/add-ons/<key>/<ref>`. */
+    ref: z.string().regex(/^[a-z][a-z0-9-]*$/, 'page ref must be a kebab-case identifier'),
+    title: i18nMessageSchema,
+    icon: z.string().min(1).max(60),
+    /** A path the bundle route will serve; its default export is the page. */
+    client: z.string().min(1),
+    nav: addOnPageNavSchema.optional(),
+    /** Reserve `/add-ons/<key>/<ref>/*` for the page's own sub-routes. */
+    detail: z.boolean().optional(),
+})
+    .strict();
+/**
+ * A group this add-on brings with it. Its label travels WITH the add-on — a key
+ * plus an English fallback, resolved against the add-on's own translations —
+ * which is the whole reason the engine does not have to own
+ * `nav.group.<whatever>` in eight locales to let somebody name a group.
+ */
+export const addOnNavGroupSchema = z
+    .object({
+    key: navGroupKeySchema,
+    label: i18nMessageSchema,
+    /** Orders the trailing add-on band only; built-in groups do not move. */
+    order: z.number().int(),
+})
+    .strict();
 export const addOnBlockSchema = z
     .object({
     attaches: z.array(attachTargetSchema).min(1),
@@ -94,8 +201,60 @@ export const addOnBlockSchema = z
     publicSettings: z.array(z.string().min(1)).optional(),
     /** D11 — required to ship a demo that makes no real third-party call. */
     demoTransport: z.string().min(1).optional(),
+    /**
+     * Dashboard pages this add-on renders itself, and the groups it brings for
+     * them. Both optional and additive: every manifest written before this
+     * validates unchanged, which is the same promise `kind` kept when the
+     * add-on branch itself was added.
+     */
+    pages: z.array(addOnPageSchema).min(1).optional(),
+    navGroups: z.array(addOnNavGroupSchema).min(1).optional(),
+    /** Required once `pages` is present; see {@link hostApiVersionSchema}. */
+    hostApi: hostApiVersionSchema.optional(),
 })
     .strict()
+    // A ref is a URL segment, so two pages sharing one is two screens at one
+    // address — and the loser is whichever the host's lookup happens to find.
+    .refine((b) => new Set((b.pages ?? []).map((p) => p.ref)).size === (b.pages ?? []).length, {
+    message: 'duplicate page ref',
+    path: ['pages'],
+})
+    .refine((b) => new Set((b.navGroups ?? []).map((g) => g.key)).size === (b.navGroups ?? []).length, {
+    message: 'duplicate nav group key',
+    path: ['navGroups'],
+})
+    // A declared group may not shadow a built-in one: the built-in label comes
+    // from the engine's catalogue and the declared one from the add-on, so a
+    // collision is two labels for one heading with no rule about which wins.
+    .refine((b) => !(b.navGroups ?? []).some((g) => BUILTIN_NAV_GROUP_KEYS.includes(g.key)), {
+    message: `a nav group key may not be one of the built-in groups (${BUILTIN_NAV_GROUP_KEYS.join(', ')})`,
+    path: ['navGroups'],
+})
+    // NAV_GROUP_UNKNOWN, refused at parse rather than resolved at render. A group
+    // nobody defines is the one failure this whole block exists to prevent: the
+    // rail would draw a raw key as a heading, or drop the row into `hidden` the
+    // way an unknown app group is dropped today, and both look like the add-on
+    // simply not working.
+    .refine((b) => (b.pages ?? []).every((p) => p.nav === undefined ||
+    BUILTIN_NAV_GROUP_KEYS.includes(p.nav.group) ||
+    (b.navGroups ?? []).some((g) => g.key === p.nav?.group)), {
+    message: 'a page names a nav group that is neither built in nor declared in navGroups',
+    path: ['pages'],
+})
+    // The mirror of the rule above. A declared group no page uses renders as
+    // nothing, so it is a typo in one of the two places — and refusing here names
+    // it, where a silent empty heading would not.
+    .refine((b) => (b.navGroups ?? []).every((g) => (b.pages ?? []).some((p) => p.nav?.group === g.key)), {
+    message: 'a declared nav group is used by none of this add-on’s pages',
+    path: ['navGroups'],
+})
+    // Pages are code the host runs against a published API surface. An add-on
+    // that does not say which version it was built against cannot be refused
+    // later on version grounds, which is the entire point of having a version.
+    .refine((b) => b.pages === undefined || b.hostApi !== undefined, {
+    message: 'an add-on that declares pages must declare the hostApi version it is built against',
+    path: ['hostApi'],
+})
     // Every `provides[].contract` must be in the registry AT the declared version.
     .refine((b) => (b.provides ?? []).every((p) => hasContractVersion(p.contract, p.version)), {
     message: 'CONTRACT_UNKNOWN: a provided contract is not in the registry at that version',
@@ -105,13 +264,13 @@ export const addOnBlockSchema = z
     message: 'CONTRACT_UNKNOWN: a consumed contract is not in the registry at that version',
     path: ['consumes'],
 })
-    // §5.6 — an oauth2 connect must name where it authorizes.
+    // An oauth2 connect must name where it authorizes.
     .refine((b) => b.connect.kind !== 'oauth2' ||
     (b.connect.authorizeUrl !== undefined && b.connect.tokenUrl !== undefined), {
     message: 'an oauth2 connect must declare authorizeUrl and tokenUrl',
     path: ['connect'],
 });
-/** Issue codes the validators emit (13 §3.2 convention, extended by 24 §5.3). */
+/** Issue codes the validators emit. */
 export const ADD_ON_ISSUE_CODES = [
     'ATTACH_TARGET_UNKNOWN',
     'SLOT_UNKNOWN',
@@ -121,5 +280,12 @@ export const ADD_ON_ISSUE_CODES = [
     'CAPABILITY_CONFLICT',
     'FRONTEND_SECRET_LEAK',
     'SLOT_CONFLICT',
+    /*
+     * 51a adds no code for a bad nav group on purpose. `addOnBlockSchema` refuses
+     * an undeclared group itself, and the cross-block rules in
+     * `@adminium/manifest` run only after that schema has parsed — so a code here
+     * would name a state no manifest can be in. The refusal is a schema issue
+     * carrying the message, which is what a reader gets either way.
+     */
 ];
 //# sourceMappingURL=add-on-block.js.map

package/dist/add-on-block.js.map

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

package/dist/artwork-source.d.ts

@@ -1,6 +1,6 @@
 /**
- * `artwork-source@1` (24 §5.5) — a way for a customer to supply artwork that is
- * not a plain upload.
+ * `artwork-source@1` — a way for a customer to supply artwork that is not a
+ * plain upload.
  *
  * The asymmetry that makes this contract worth having: the HOST, not the
  * add-on, runs the artwork checks on the returned `ArtworkRef`. Design Studio's

package/dist/artwork-source.js

@@ -1,7 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * `artwork-source@1` (24 §5.5) — a way for a customer to supply artwork that is
- * not a plain upload.
+ * `artwork-source@1` — a way for a customer to supply artwork that is not a
+ * plain upload.
  *
  * The asymmetry that makes this contract worth having: the HOST, not the
  * add-on, runs the artwork checks on the returned `ArtworkRef`. Design Studio's

package/dist/contracts.d.ts

@@ -1,10 +1,10 @@
 /**
- * Provider contract registry v1 — CLOSED (24-marketplace-wave-4.md §5.5).
+ * Provider contract registry v1 — CLOSED.
  *
  * Four, not eight. A contract that has no implementation is a guess about a
  * future add-on; the only way a contract gets in is alongside the add-on that
- * implements it. The fourth was bought on a seven-exhibit dossier
- * (34-invoices-add-on.md Appendix A), not on a shape somebody liked.
+ * implements it. The fourth was bought on a seven-exhibit dossier, not on a
+ * shape somebody liked.
  */
 import { z } from 'zod';
 export interface ContractDefinition {

package/dist/contracts.js

@@ -1,11 +1,11 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 /**
- * Provider contract registry v1 — CLOSED (24-marketplace-wave-4.md §5.5).
+ * Provider contract registry v1 — CLOSED.
  *
  * Four, not eight. A contract that has no implementation is a guess about a
  * future add-on; the only way a contract gets in is alongside the add-on that
- * implements it. The fourth was bought on a seven-exhibit dossier
- * (34-invoices-add-on.md Appendix A), not on a shape somebody liked.
+ * implements it. The fourth was bought on a seven-exhibit dossier, not on a
+ * shape somebody liked.
  */
 import { z } from 'zod';
 export const CONTRACT_REGISTRY = [
@@ -29,19 +29,19 @@ export const CONTRACT_REGISTRY = [
     },
     {
         /*
-         * THE FOURTH, BOUGHT 2026-09-10 (34-invoices-add-on.md O1/O11). 25 §5 drew
-         * this interface twice and never built it; zero occurrences in either repo
-         * until now. Its dossier is 34 Appendix A — seven exhibits, two
-         * implementers in the same sub-wave (invoices; barcode-labels wrapping
-         * renderLabelSheet), which meets 25 D4's count — and, by 34 O11's ruling,
-         * relaxes its "different means" clause for a contract Adminium ITSELF
-         * consumes. It PROVIDES kinds of document an add-on can describe and
-         * render, as an outline of slots (labels in all eight locales) and bytes
-         * (each kind declares its own formats and glyph coverage); it is CONSUMED
-         * BY the engine document pipeline (profiles, triggers, the document.render
-         * job, the /documents routes) — the first production read of
-         * runtime.providers, selected by add-on key, never by resolveProvider's
-         * lowest-key choice. "Add-ons compose" runs for real here.
+         * THE FOURTH, BOUGHT 2026-09-10. This interface had been drawn twice and
+         * never built; zero occurrences in either repo until now. Its dossier is
+         * seven exhibits and two implementers in the same sub-wave (invoices;
+         * barcode-labels wrapping renderLabelSheet), which meets the count a new
+         * contract has to clear — and, by the owner's ruling, relaxes the
+         * "different means" clause for a contract Adminium ITSELF consumes. It PROVIDES kinds of document an add-on can
+         * describe and render, as an outline of slots (labels in all eight
+         * locales) and bytes (each kind declares its own formats and glyph
+         * coverage); it is CONSUMED BY the engine document pipeline (profiles,
+         * triggers, the document.render job, the /documents routes) — the first
+         * production read of runtime.providers, selected by add-on key, never by
+         * resolveProvider's lowest-key choice. "Add-ons compose" runs for real
+         * here.
          */
         id: 'document-render',
         version: 1,

package/dist/document-render.d.ts

@@ -1,6 +1,6 @@
 /**
- * `document-render@1` (34-invoices-add-on.md §4, Appendices A and B) — the
- * fourth contract, and the first one Adminium ITSELF consumes.
+ * `document-render@1` (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
@@ -13,9 +13,9 @@
  *
  * 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.
+ * only time it may read, which is what makes byte-identical claim testable
+ * rather than aspirational. `describeDocumentRenderer` renders twice and
+ * compares every byte.
  *
  * ── BYTES, NOT A `FileRef` ─────────────────────────────────────────────────
  *
@@ -32,11 +32,11 @@
  * 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).
+ * customer's name missing letters.
  *
  * ── THE `body` CHANNEL IS A ONE-WAY DOOR, AND IT IS OPEN ───────────────────
  *
- * §4.3 ships this module verbatim into eighteen repos before the first
+ * This module ships 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
@@ -73,7 +73,7 @@ export type DocumentLocaleId = (typeof DOCUMENT_LOCALE_IDS)[number];
  * (0.3 trap 19), because the Studio profile editor renders these labels
  * directly and a hole in one language becomes a raw slot id on somebody's
  * screen. The server half of an add-on carries its own strings — the engine
- * needs no bundle from it (34 D14).
+ * needs no bundle from it.
  */
 export type LocalizedText = Readonly<Record<DocumentLocaleId, string>>;
 export declare const localizedTextSchema: z.ZodObject<{
@@ -146,10 +146,10 @@ export type OutlineSlotType = (typeof OUTLINE_SLOT_TYPES)[number];
 /**
  * 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.
+ * `sequence` — the engine's CAS document number, minted after render.
+ * `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 declare const OUTLINE_SLOT_DEFAULTS: readonly ["sequence", "connection", "setting", "now"];
 export type OutlineSlotDefault = (typeof OUTLINE_SLOT_DEFAULTS)[number];
@@ -391,7 +391,7 @@ export declare const documentOutlineSchema: z.ZodObject<{
  * Structurally the same object as `@adminium/meta`'s `recordRefSchema`
  * (`json-payloads.ts:17-25`), which is the AUTHORITY for the shape; it is
  * restated here because this package has no `node:` and no meta dependency by
- * design (01 §3). A file that imports both should alias one — they are two
+ * design. A file that imports both should alias one — they are two
  * declarations of one shape, not two shapes.
  */
 export interface RecordRef {
@@ -404,9 +404,9 @@ export interface RecordRef {
     label: string;
 }
 /**
- * What a PUBLIC caller may send (34 D15): values, and nothing that decides
- * anything. The server stamps `business`, `now`, `currency`, `entity: null`
- * and `number: null` itself — a request that carries one of them is refused
+ * What a PUBLIC caller may send: values, and nothing that decides anything.
+ * The server stamps `business`, `now`, `currency`, `entity: null` and
+ * `number: null` itself — a request that carries one of them is refused
  * `INVALID_REQUEST` rather than quietly overwritten, so a customer cannot
  * post a document that claims to come from a different business or to have
  * been issued last year.
@@ -443,7 +443,7 @@ export interface DocumentSubject {
         lines: readonly string[];
         logoDataUrl?: string;
     };
-    /** `null` for request-shaped intents (34 D15). */
+    /** `null` for request-shaped intents. */
     entity: RecordRef | null;
     /** `null` until minted; a re-render carries the number it already has. */
     number: string | null;

package/dist/document-render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-render.d.ts","sourceRoot":"","sources":["../src/document-render.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,mFAStB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,eAAO,MAAM,mBAAmB;;;;;;;;;kBAMrB,CAAC;AAEZ,sCAAsC;AACtC,eAAO,MAAM,gBAAgB,0BAA2B,CAAC;AACzD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,iFAAiF;AACjF,eAAO,MAAM,eAAe,2CAA4C,CAAC;AACzE,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,sCAAuC,CAAC;AACvE,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,gEAAgE;IAChE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;kBAQpB,CAAC;AAEZ,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,sGAUrB,CAAC;AACX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,uDAAwD,CAAC;AAC3F,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,aAAa,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,0EAA0E;IAC1E,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CAClC;AAWD,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAAsC,CAAC;AAEzE;;;;;;;;;GASG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEnB,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CAC/B;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAEvB,CAAC;AAEZ;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,EAAE,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACtC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,2BAA2B;;;;;;kBAY7B,CAAC;AAEZ,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,kDAAkD;IAClD,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iFAAiF;IACjF,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1C,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACrF;AAED,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;kBAyBvB,CAAC;AAEZ,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,6EAA6E;IAC7E,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5C;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;kBASxB,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,gFASvB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,mBAAmB;;;;;;;;;kBAMrB,CAAC;AAEZ,qFAAqF;AACrF,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,aAAa,GACjD,KAAK,IAAI,aAAa,CAExB;AAED,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,SAAS,YAAY,EAAE,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC;IACxC,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,GAAG,aAAa,CAAC,CAAC;CAClF"}
+{"version":3,"file":"document-render.d.ts","sourceRoot":"","sources":["../src/document-render.ts"],"names":[],"mappings":"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"}