@fayz-ai/core 0.9.0 → 0.10.0

package/dist/integrations/index.js

@@ -1,3 +1,3 @@
-export { connectorDirection, connectorPlanes, preferredPlane, withAfterHooks } from '../chunk-L4TLMYGC.js';
+export { connectorDirection, connectorPlanes, preferredPlane, withAfterHooks } from '../chunk-6RBW2Y5K.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{integrations/index.d.ts → integrations.d.ts}

@@ -91,7 +91,7 @@ export interface ConnectorStatus {
  * UI-facing connector descriptor. Built on the data-plane `Connector` concept
  * (`pluginId` → `hostPluginId`), plus the control-plane hooks the unified
  * Integrations hub calls. Lives in core so `PluginManifest.connectors` can type
- * it; the rendering hub lives in `@fayz-ai/saas`.
+ * it; the rendering hub lives in `@fayz-ai/admin`.
  */
 export interface ConnectorDefinition {
     /** Stable connector id, e.g. 'google-calendar', 'plugbank'. */
@@ -156,4 +156,4 @@ export declare function connectorDirection(def: Pick<ConnectorDefinition, 'direc
  * updated. The handler runs fire-and-forget; its failures never break the call.
  */
 export declare function withAfterHooks<T extends object>(target: T, methods: Partial<Record<keyof T, (args: unknown[], result: unknown) => void | Promise<void>>>): T;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=integrations.d.ts.map

package/dist/integrations.d.ts.map

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

package/dist/{address/index.d.ts → lib/address.d.ts}

@@ -49,4 +49,4 @@ export declare function getPostalLookupProvider(): PostalLookupProvider;
  * "no such CEP" from "we could not check right now" and say the right thing.
  */
 export declare function lookupPostalCode(postalCode: string): Promise<PostalAddress | null>;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=address.d.ts.map

package/dist/{address/index.d.ts.map → lib/address.d.ts.map}

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/address/index.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;kFACkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CAC1D;AAED,wBAAwB;AACxB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AA2CD,iFAAiF;AACjF,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAgBD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAwB/F;AAUD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAG9D;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAUxF"}
+{"version":3,"file":"address.d.ts","sourceRoot":"","sources":["../../src/lib/address.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;kFACkF;AAClF,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAA;CAC1D;AAED,wBAAwB;AACxB,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,oFAAoF;AACpF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AA2CD,iFAAiF;AACjF,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAgBD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAAG,oBAAoB,CAwB/F;AAUD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAEnF;AAED,wBAAgB,uBAAuB,IAAI,oBAAoB,CAG9D;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAUxF"}

package/dist/{phone/index.d.ts → lib/phone.d.ts}

@@ -25,4 +25,4 @@ export declare function unmaskPhone(value: string): string;
 export declare function maskPhone(value: string, mask: string): string;
 /** Count how many digits a mask expects. */
 export declare function maskDigitCount(mask: string): number;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=phone.d.ts.map

package/dist/lib/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/lib/phone.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAA;IACZ,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;CACb;AAyBD,eAAO,MAAM,SAAS,EAAE,UAAU,EAAqD,CAAA;AAEvF,eAAO,MAAM,eAAe,OAAO,CAAA;AAInC,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAE/D;AAED,kCAAkC;AAClC,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAa7D;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/{seo/index.d.ts → lib/seo.d.ts}

@@ -12,6 +12,23 @@ export interface SeoConfig {
 export declare function seoOrigin(): string;
 /** Build an absolute URL from a path, using the current origin. */
 export declare function absoluteUrl(path: string): string;
+export interface SeoMetaTag {
+    name?: string;
+    property?: string;
+    content: string;
+}
+export interface SeoLinkTag {
+    rel: string;
+    href: string;
+}
+export interface SeoTags {
+    title: string;
+    meta: SeoMetaTag[];
+    links: SeoLinkTag[];
+    jsonLd: Array<Record<string, unknown>>;
+}
+/** Pure: turn an SeoConfig into the exact tag set a page should carry. */
+export declare function buildSeoTags(config: SeoConfig): SeoTags;
 /** Imperatively apply SEO tags (used by useSeo; exported for non-React callers). */
 export declare function applySeo(config: SeoConfig): void;
 /** Apply SEO head tags for the current route; cleans up on unmount. */
@@ -24,4 +41,4 @@ export interface BreadcrumbItem {
 export declare function breadcrumbJsonLd(items: BreadcrumbItem[]): Record<string, unknown>;
 /** schema.org Organization publisher block. */
 export declare function organizationJsonLd(name: string, extra?: Record<string, unknown>): Record<string, unknown>;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=seo.d.ts.map

package/dist/lib/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../../src/lib/seo.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACxC;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAoCD,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,UAAU,EAAE,CAAA;IAClB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACvC;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAwBvD;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAkBhD;AAED,uEAAuE;AACvE,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAO9C;AAID,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAWjF;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzG"}

package/dist/{tenant/index.d.ts → lib/tenant.d.ts}

@@ -10,4 +10,4 @@ export declare function subscribeActiveTenant(listener: () => void): () => void;
 /** The active tenant, re-rendering when it resolves or changes. Use this to key
  *  effects that fetch tenant-scoped data. */
 export declare function useActiveTenantId(): string | undefined;
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=tenant.d.ts.map

package/dist/lib/tenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.d.ts","sourceRoot":"","sources":["../../src/lib/tenant.ts"],"names":[],"mappings":"AAUA,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAM9D;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGtE;AAED;6CAC6C;AAC7C,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD"}

package/dist/manifest/index.d.ts

@@ -4,7 +4,7 @@ import type { PermissionsConfig, FeatureDeclaration } from '../types/permissions
 import type { BillingConfig } from '../types/billing';
 import type { LimitDeclaration } from '../types/entitlements';
 import type { AIToolParameters, AIToolExecution, AgentRpcDeclaration } from '../types/plugins';
-import type { BlockNode } from '../blocks';
+import type { BlockNode } from '../registry/blocks';
 export declare const CURRENT_MANIFEST_VERSION = 3;
 export type BackendProvider = 'supabase' | 'fayz-api' | 'fayz-shop' | 'mock' | 'custom';
 export interface BackendRef {

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

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

package/dist/messaging/index.d.ts

@@ -0,0 +1,3 @@
+export type { MessageChannel, MessageKind, MessageDefault, MessageDefaultsDef, MessageTemplate, UpsertMessageTemplateInput, ResolvedMessage, } from './types';
+export { registerMessageDefaults, getMessageDefaults, clearMessageDefaults, renderMessageTemplate, resolveMessages, resolveMessage, getEventsWithoutMessages, loadMessageOverrides, MESSAGE_TEMPLATES_TABLE, } from './registry';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/messaging/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAC/D,eAAe,EAAE,0BAA0B,EAAE,eAAe,GAC7D,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,uBAAuB,EAAE,kBAAkB,EAAE,oBAAoB,EACjE,qBAAqB,EAAE,eAAe,EAAE,cAAc,EACtD,wBAAwB,EAAE,oBAAoB,EAAE,uBAAuB,GACxE,MAAM,YAAY,CAAA"}

package/dist/messaging/registry.d.ts

@@ -0,0 +1,35 @@
+import type { MessageChannel, MessageDefaultsDef, MessageTemplate, ResolvedMessage } from './types';
+import type { ResolvedDomainEvent } from '../types/plugins';
+export declare function registerMessageDefaults(defs: MessageDefaultsDef[]): void;
+export declare function getMessageDefaults(): MessageDefaultsDef[];
+export declare function clearMessageDefaults(): void;
+/**
+ * Substitutes the merge fields. Lives beside the catalog because PREVIEW and
+ * SEND must agree: a screen doing its own `replace` approves one text and
+ * delivers another.
+ *
+ * An unknown field stays visible as `{{foo}}` on purpose — in the preview that
+ * exposes the typo; hiding it would hide the gap until the message had gone out.
+ */
+export declare function renderMessageTemplate(text: string, values: Record<string, string>): string;
+/**
+ * Joins event (code) + default text (code) + customisation (database).
+ *
+ * A function and not a query: the merge must give the same answer in the list,
+ * the editor and the send, and three places doing the same `??` is how they
+ * start to disagree.
+ *
+ * One row per (event × offered channel). A channel with no default text is left
+ * out — there is nothing to switch on.
+ */
+export declare function resolveMessages(overrides: MessageTemplate[], events: ResolvedDomainEvent[]): ResolvedMessage[];
+/** A single resolved event×channel pair — what the detail screen opens. */
+export declare function resolveMessage(eventKey: string, channel: MessageChannel, overrides: MessageTemplate[], events: ResolvedDomainEvent[]): ResolvedMessage | null;
+/** Events that exist with no text written for them — what webhooks and audit
+ *  can see and the message list cannot. */
+export declare function getEventsWithoutMessages(events: ResolvedDomainEvent[]): ResolvedDomainEvent[];
+export declare const MESSAGE_TEMPLATES_TABLE = "plg_automations_templates";
+/** Never throws: with no client, no table or no permission the whole catalog
+ *  still holds on its defaults — a complete state, not an error. */
+export declare function loadMessageOverrides(tenantId?: string): Promise<MessageTemplate[]>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/messaging/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/messaging/registry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EACrE,MAAM,SAAS,CAAA;AAChB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAY3D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAExE;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CAEzD;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAE1F;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,eAAe,EAAE,EAC5B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,eAAe,EAAE,CAiCnB;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,eAAe,EAAE,EAC5B,MAAM,EAAE,mBAAmB,EAAE,GAC5B,eAAe,GAAG,IAAI,CAGxB;AAED;2CAC2C;AAC3C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,EAAE,GAAG,mBAAmB,EAAE,CAE7F;AAUD,eAAO,MAAM,uBAAuB,8BAA8B,CAAA;AAElE;oEACoE;AACpE,wBAAsB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAwBxF"}

package/dist/messaging/types.d.ts

@@ -0,0 +1,67 @@
+import type { ResolvedDomainEvent } from '../types/plugins';
+/** The same set the inbox uses (plugin-conversations). */
+export type MessageChannel = 'email' | 'whatsapp' | 'sms' | 'push' | 'webchat';
+/**
+ * Transactional answers something the person did; marketing is the company's
+ * initiative — the distinction that decides whether sending needs consent.
+ */
+export type MessageKind = 'transactional' | 'marketing';
+export interface MessageDefault {
+    /** Only meaningful on channels with a subject (email). */
+    subject?: string;
+    body: string;
+}
+/**
+ * The default text a module suggests for an event. Registered separately from
+ * the event on purpose: a module may emit facts with nothing to say about them,
+ * and whoever writes the webhook should not trip over email copy.
+ */
+export interface MessageDefaultsDef {
+    /** The domain event this text reacts to. */
+    eventKey: string;
+    kind: MessageKind;
+    /** Channels this event MAY go out on. */
+    channels: MessageChannel[];
+    /** Default text per channel. A channel with no default cannot be switched on. */
+    defaults: Partial<Record<MessageChannel, MessageDefault>>;
+    /** On in a new account, per channel. Absent = off. */
+    defaultEnabled?: Partial<Record<MessageChannel, boolean>>;
+}
+/** What the customer customised. No row = use the default. */
+export interface MessageTemplate {
+    id: string;
+    tenantId: string;
+    eventKey: string;
+    channel: MessageChannel;
+    /** Null = use the catalog's `defaultEnabled`. */
+    enabled: boolean | null;
+    /** Null = use the catalog default. */
+    subject: string | null;
+    body: string | null;
+    /** Name given when duplicating. Null = the event's title. */
+    name: string | null;
+    updatedAt: string;
+}
+export interface UpsertMessageTemplateInput {
+    eventKey: string;
+    channel: MessageChannel;
+    enabled?: boolean | null;
+    subject?: string | null;
+    body?: string | null;
+    name?: string | null;
+}
+/** Event + channel + text, resolved — what the screen shows. */
+export interface ResolvedMessage {
+    event: ResolvedDomainEvent;
+    kind: MessageKind;
+    channel: MessageChannel;
+    override: MessageTemplate | null;
+    enabled: boolean;
+    subject: string;
+    body: string;
+    /** true when the text was rewritten — the list flags it. */
+    customized: boolean;
+    /** Merge fields, derived from the event payload. */
+    placeholders: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/messaging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/messaging/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAc3D,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,SAAS,CAAA;AAE9E;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,WAAW,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,WAAW,CAAA;IACjB,yCAAyC;IACzC,QAAQ,EAAE,cAAc,EAAE,CAAA;IAC1B,iFAAiF;IACjF,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAA;IACzD,sDAAsD;IACtD,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAA;CAC1D;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,cAAc,CAAA;IACvB,iDAAiD;IACjD,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACvB,sCAAsC;IACtC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,6DAA6D;IAC7D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,cAAc,CAAA;IACvB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,mBAAmB,CAAA;IAC1B,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,cAAc,CAAA;IACvB,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAA;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,UAAU,EAAE,OAAO,CAAA;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB"}

package/dist/plugin/index.js

@@ -1,3 +1,4 @@
-export { PluginRuntimeProvider, definePlugin, getWidgetsForZone, resolvePluginRuntime, usePluginRuntime, usePluginRuntimeOptional } from '../chunk-YH25Y4FW.js';
+export { PluginRuntimeProvider, definePlugin, getWidgetsForZone, resolvePluginRuntime, usePluginRuntime, usePluginRuntimeOptional } from '../chunk-732GZEUI.js';
+import '../chunk-CU64QI4A.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/plugin/runtime.d.ts

@@ -1,5 +1,6 @@
 import * as React from 'react';
 import type { PluginManifest, PluginRuntime, PluginRuntimeContext, PluginWidgetZone, ResolvedPluginWidget, TenantPluginBinding, ResolvedDashboardWidget, DashboardSurface } from '../types/plugins';
+import type { ResolvedAnalyticsCard } from '../types/analytics';
 import type { ConnectorDefinition } from '../integrations';
 /** The plugin contract version this runtime understands. A plugin declaring a
  *  higher apiVersion is rejected rather than mis-rendered. */
@@ -19,6 +20,22 @@ interface ResolvePluginRuntimeOptions {
 export declare function definePlugin<T extends PluginManifest>(plugin: T): T;
 export declare function resolvePluginRuntime({ plugins, tenantPlugins, hasTenantBindings, context, }: ResolvePluginRuntimeOptions): PluginRuntime;
 export declare function getWidgetsForZone(runtime: PluginRuntime, zone: PluginWidgetZone, contextOverrides?: Partial<PluginRuntimeContext>): ResolvedPluginWidget[];
+/**
+ * Analytics cards visible to the current tenant/user.
+ *
+ * The report LIST wants every card the user may read; the overview wants only
+ * the ones a pack placed on the grid — hence `placedOnly`, rather than two
+ * registries that could drift apart.
+ */
+export declare function getAnalyticsCards(runtime: PluginRuntime, options?: {
+    domain?: string;
+    category?: string;
+    /** Only cards with a `dashboard` placement (the overview grid). */
+    placedOnly?: boolean;
+    /** Restrict placement to one surface. Implies `placedOnly`. */
+    surface?: DashboardSurface;
+    contextOverrides?: Partial<PluginRuntimeContext>;
+}): ResolvedAnalyticsCard[];
 export declare function getDashboardWidgets(runtime: PluginRuntime, options: {
     surface: DashboardSurface;
     domain?: string;

package/dist/plugin/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/plugin/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,oBAAoB,EAKpB,gBAAgB,EAEhB,oBAAoB,EACpB,mBAAmB,EAMnB,uBAAuB,EACvB,gBAAgB,EACjB,MAAM,kBAAkB,CAAA;AAGzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAG1D;8DAC8D;AAC9D,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC;+EAC+E;AAC/E,wBAAgB,sBAAsB,CACpC,GAAG,EAAE;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAI1C;AAED,UAAU,2BAA2B;IACnC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;IAC1B,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,OAAO,EAAE,oBAAoB,CAAA;CAC9B;AAyED,wBAAgB,YAAY,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEnE;AAED,wBAAgB,oBAAoB,CAAC,EACnC,OAAY,EACZ,aAAkB,EAClB,iBAAiB,EACjB,OAAO,GACR,EAAE,2BAA2B,GAAG,aAAa,CAmK7C;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,gBAAgB,EACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC/C,oBAAoB,EAAE,CAGxB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAAE,GACxG,uBAAuB,EAAE,CAU3B;AAED,QAAA,MAAM,oBAAoB,qCAAkD,CAAA;AAC5E,eAAO,MAAM,qBAAqB,sCAAgC,CAAA;AAElE,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,aAAa,GAAG,IAAI,CAE/D;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAElF"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/plugin/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,oBAAoB,EAKpB,gBAAgB,EAEhB,oBAAoB,EACpB,mBAAmB,EAMnB,uBAAuB,EACvB,gBAAgB,EAEjB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAI/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAI1D;8DAC8D;AAC9D,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC;+EAC+E;AAC/E,wBAAgB,sBAAsB,CACpC,GAAG,EAAE;IAAE,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,SAAS,CAI1C;AAED,UAAU,2BAA2B;IACnC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;IAC1B,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACrC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,OAAO,EAAE,oBAAoB,CAAA;CAC9B;AA2ED,wBAAgB,YAAY,CAAC,CAAC,SAAS,cAAc,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEnE;AAED,wBAAgB,oBAAoB,CAAC,EACnC,OAAY,EACZ,aAAkB,EAClB,iBAAiB,EACjB,OAAO,GACR,EAAE,2BAA2B,GAAG,aAAa,CA0L7C;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,gBAAgB,EACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAC/C,oBAAoB,EAAE,CAGxB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mEAAmE;IACnE,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC5C,GACL,qBAAqB,EAAE,CAezB;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE;IAAE,OAAO,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAAE,GACxG,uBAAuB,EAAE,CAU3B;AAED,QAAA,MAAM,oBAAoB,qCAAkD,CAAA;AAC5E,eAAO,MAAM,qBAAqB,sCAAgC,CAAA;AAElE,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD;AAED,wBAAgB,wBAAwB,IAAI,aAAa,GAAG,IAAI,CAE/D;AAED,iFAAiF;AACjF,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAElF"}

package/dist/registry/block-catalog.d.ts

@@ -0,0 +1,78 @@
+import type { JsonSchema, RegistrySource, RequiredBlockChild } from './index';
+import type { BlockPreset, BlockSetting, BlockStability } from './block-schema';
+/** A block, described well enough to configure it without reading its source. */
+export interface BlockDescriptor {
+    id: string;
+    label?: string;
+    description?: string;
+    source?: RegistrySource;
+    pluginId?: string;
+    settings: readonly BlockSetting[];
+    presets: readonly BlockPreset[];
+    /** Surfaces this block may be placed on. Empty means "anywhere". */
+    enabledOn: readonly string[];
+    stability: BlockStability;
+    /** The machine contract, compiled from `settings`. Absent if never described. */
+    propsSchema?: JsonSchema;
+    /** Props a freshly inserted instance starts with, when no preset is chosen. */
+    defaults: Record<string, unknown>;
+    parent: readonly string[];
+    ancestor: readonly string[];
+    usesContext: readonly string[];
+    providesContext: readonly string[];
+    allowMultiple: boolean;
+    requiredChildren: readonly RequiredBlockChild[];
+}
+export interface BlockCatalogOptions {
+    /** Keep only blocks placeable on this surface (`home`, `product`, …). */
+    enabledOn?: string;
+    /** Keep only blocks from these origins. */
+    source?: readonly RegistrySource[];
+    /** Include `experimental` blocks. Default false — an agent should reach for a
+     *  stable block unless something explicitly asks it not to. */
+    includeExperimental?: boolean;
+}
+/** Describe one registered block. Undefined if the id is not registered. */
+export declare function describeBlock(id: string): BlockDescriptor | undefined;
+/**
+ * The whole registry as descriptors, filtered and sorted by id.
+ *
+ * Sorted because this feeds prompts and generated documentation: registration
+ * order is an implementation detail, and letting it leak makes every diff of a
+ * generated artifact noisy for no reason.
+ */
+export declare function describeBlocks(options?: BlockCatalogOptions): BlockDescriptor[];
+/** True when `block` may be placed on `surface`. */
+export declare function isBlockEnabledOn(block: Pick<BlockDescriptor, 'enabledOn'>, surface: string): boolean;
+export type BlockAuditLevel = 'error' | 'warning';
+export interface BlockAudit {
+    level: BlockAuditLevel;
+    /** Stable machine-readable rule id, so tooling can filter or waive one rule. */
+    rule: string;
+    blockId: string;
+    detail: string;
+}
+/**
+ * Conformance findings for the registered blocks.
+ *
+ * Errors mean the schema misdescribes the block — that is worth failing a build
+ * over, because an editor and an agent both act on it. Warnings mean the block
+ * is under-described: it works, but it cannot be configured well by anything
+ * that did not read its source.
+ *
+ * `requirePresets`/`requireEnabledOn` are opt-in because they are a standard the
+ * SDK holds itself to, not a rule an app's one-off block should fail. An app
+ * block that only ever appears in one store needs no preset.
+ */
+export declare function auditBlocks(options?: {
+    source?: readonly RegistrySource[];
+    requirePresets?: boolean;
+    requireEnabledOn?: boolean;
+}): BlockAudit[];
+/** Convenience: the audit reduced to a pass/fail plus its counts. */
+export declare function summarizeBlockAudit(findings: readonly BlockAudit[]): {
+    ok: boolean;
+    errors: number;
+    warnings: number;
+};
+//# sourceMappingURL=block-catalog.d.ts.map

package/dist/registry/block-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-catalog.d.ts","sourceRoot":"","sources":["../../src/registry/block-catalog.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAA+B,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAE1G,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAwB/E,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;IACjC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAA;IAC/B,oEAAoE;IACpE,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,SAAS,EAAE,cAAc,CAAA;IACzB,iFAAiF;IACjF,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAIjC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IACzB,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,eAAe,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,aAAa,EAAE,OAAO,CAAA;IACtB,gBAAgB,EAAE,SAAS,kBAAkB,EAAE,CAAA;CAChD;AAED,MAAM,WAAW,mBAAmB;IAClC,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAClC;mEAC+D;IAC/D,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC9B;AA0BD,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,EAAE,CAenF;AAED,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAEpG;AAID,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,CAAA;AAEjD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,eAAe,CAAA;IACtB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AA4HD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE;IACnC,MAAM,CAAC,EAAE,SAAS,cAAc,EAAE,CAAA;IAClC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAA;CACtB,GAAG,UAAU,EAAE,CAyFpB;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG;IACpE,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;CACjB,CAGA"}

package/dist/registry/block-constraints.d.ts

@@ -0,0 +1,64 @@
+/** Structural view of a block tree node — matches `BlockNode` without importing it. */
+export interface BlockTreeNode {
+    type: string;
+    id?: string;
+    props?: Record<string, unknown>;
+    children?: BlockTreeNode[];
+}
+export type BlockConstraintRule = 'constraint-parent' | 'constraint-ancestor' | 'constraint-multiple';
+export interface BlockConstraintViolation {
+    /** Path relative to the checked list, e.g. '[2].children[0]'. */
+    path: string;
+    /** The violating block's type. */
+    type: string;
+    rule: BlockConstraintRule;
+    detail: string;
+    /** The valid set (I2): the declared parent/ancestor ids, or for
+     *  constraint-multiple the path of the instance that is allowed to stay. */
+    valid?: string[];
+}
+/** One node's parent/ancestor verdicts — shared by the validator and the renderer. */
+export declare function checkNodePlacement(type: string, ancestors: readonly string[]): BlockConstraintViolation[];
+/**
+ * Structural constraint violations in one block tree: `parent` (direct child
+ * only), `ancestor` (any depth), `allowMultiple` (per tree). Unregistered
+ * types are skipped — they are a different error (`unknown-block`) with its
+ * own reporter.
+ */
+export declare function checkBlockConstraints(nodes: readonly BlockTreeNode[]): BlockConstraintViolation[];
+export interface BlockContextFinding {
+    path: string;
+    type: string;
+    /** Context keys the block declares in `usesContext` that nothing provides. */
+    missing: string[];
+}
+/**
+ * Placements where a block's `usesContext` keys are satisfied neither by an
+ * ancestor's `providesContext` nor by the surface itself (`provided` — e.g. a
+ * slot area's context keys).
+ *
+ * Advisory, not an error: context also arrives through runtime channels a
+ * static tree cannot see, so the honest verdict is "nothing declares this",
+ * not "this is broken". `checkPageBlocks` maps these to warnings.
+ */
+export declare function checkBlockContext(nodes: readonly BlockTreeNode[], provided?: readonly string[]): BlockContextFinding[];
+export interface BlockTreeRepair {
+    /** Path of the PARENT whose child list was repaired ('' for a root-level list). */
+    path: string;
+    /** Type of the block that was re-inserted. */
+    inserted: string;
+    /** Index it was re-inserted at. */
+    index: number;
+}
+export interface RepairBlockTreeResult {
+    nodes: BlockTreeNode[];
+    repairs: BlockTreeRepair[];
+}
+/**
+ * Re-insert required children that went missing, at the index the declaring
+ * block's template gives them (use-forced-layout). Returns the INPUT array
+ * untouched when nothing was repaired, so memoized consumers can keep
+ * reference equality.
+ */
+export declare function repairBlockTree(nodes: readonly BlockTreeNode[]): RepairBlockTreeResult;
+//# sourceMappingURL=block-constraints.d.ts.map

package/dist/registry/block-constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-constraints.d.ts","sourceRoot":"","sources":["../../src/registry/block-constraints.ts"],"names":[],"mappings":"AAuBA,uFAAuF;AACvF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAA;CAC3B;AAED,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,GAAG,qBAAqB,GAAG,qBAAqB,CAAA;AAErG,MAAM,WAAW,wBAAwB;IACvC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,mBAAmB,CAAA;IACzB,MAAM,EAAE,MAAM,CAAA;IACd;gFAC4E;IAC5E,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CACjB;AA6BD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,wBAAwB,EAAE,CA2B5B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,wBAAwB,EAAE,CA2BjG;AAID,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,QAAQ,GAAE,SAAS,MAAM,EAAO,GAC/B,mBAAmB,EAAE,CAavB;AAID,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAA;CACd;AAmDD,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,qBAAqB,CAatF"}

package/dist/registry/block-schema.d.ts

@@ -0,0 +1,69 @@
+import type { JsonSchema } from './registry-class';
+/**
+ * The control a setting is edited with — and, by implication, the shape of the
+ * prop. Semantic types (`product`, `category`, `collection`) serialize as
+ * strings but must not degrade to a free-text input: the editor owes the author
+ * a picker, and an AI generating a block needs to know the value is an id it has
+ * to resolve rather than copy invent. `entity` names a DECLARED entity
+ * (defineEntity key) — validators check it against the declared set (I2).
+ */
+export type BlockSettingType = 'text' | 'richtext' | 'number' | 'boolean' | 'color' | 'image' | 'url' | 'select' | 'product' | 'category' | 'collection' | 'entity' | 'list';
+/**
+ * The setting-type vocabulary as a runtime value, for catalogs (`describeStore`)
+ * and validators. The `satisfies` + exhaustiveness pair keeps it impossible to
+ * add a type to the union without it appearing here.
+ */
+export declare const BLOCK_SETTING_TYPES: readonly ["text", "richtext", "number", "boolean", "color", "image", "url", "select", "product", "category", "collection", "entity", "list"];
+export interface BlockSettingOption {
+    value: string;
+    label: string;
+}
+export interface BlockSetting {
+    /** Prop name this setting writes to. */
+    id: string;
+    type: BlockSettingType;
+    label: string;
+    /** Shown under the field in the editor; also the best hint an AI gets. */
+    help?: string;
+    default?: unknown;
+    required?: boolean;
+    /** `select` only. */
+    options?: readonly BlockSettingOption[];
+    /**
+     * `list` only — the shape of each item. This is what makes a block accept
+     * repeatable children (slides, FAQ rows, testimonials) without every such
+     * block inventing its own array format.
+     */
+    of?: readonly BlockSetting[];
+    /** `number` only. */
+    min?: number;
+    max?: number;
+}
+/**
+ * A named starting point for the block.
+ *
+ * The reason this exists: adding a section that lands as an empty skeleton reads
+ * as work to do, while one that lands already populated reads as progress. The
+ * preset is what the editor (and the AI) inserts, not the bare component.
+ */
+export interface BlockPreset {
+    name: string;
+    props?: Record<string, unknown>;
+}
+/** Contract stability. Absent means `stable`. */
+export type BlockStability = 'stable' | 'experimental';
+/**
+ * Compile authoring `settings` into the `propsSchema` JSON Schema that the
+ * editor, `fayz doctor` and AI generation already expect.
+ *
+ * Returns a schema with no properties for an empty list rather than `undefined`,
+ * so "this block was authored and declares no props" stays distinguishable from
+ * "this block was never authored" (which is `propsSchema` absent entirely).
+ */
+export declare function settingsToJsonSchema(settings?: readonly BlockSetting[]): JsonSchema;
+/**
+ * Default props implied by a block's settings — every setting that declares
+ * one. Used to seed a freshly inserted block when no preset is chosen.
+ */
+export declare function defaultPropsFromSettings(settings?: readonly BlockSetting[]): Record<string, unknown>;
+//# sourceMappingURL=block-schema.d.ts.map

package/dist/registry/block-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-schema.d.ts","sourceRoot":"","sources":["../../src/registry/block-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAoBlD;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,OAAO,GACP,KAAK,GACL,QAAQ,GACR,SAAS,GACT,UAAU,GACV,YAAY,GACZ,QAAQ,GACR,MAAM,CAAA;AAEV;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,8IAcgB,CAAA;AAKhD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,qBAAqB;IACrB,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAA;IACvC;;;;OAIG;IACH,EAAE,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC5B,qBAAqB;IACrB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,cAAc,CAAA;AA0EtD;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,GAAE,SAAS,YAAY,EAAO,GAAG,UAAU,CAYvF;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,GAAE,SAAS,YAAY,EAAO,GACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMzB"}

package/dist/registry/blocks.d.ts

@@ -0,0 +1,84 @@
+import * as React from 'react';
+import type { BlockDataNeeds } from './index';
+export interface BlockNode {
+    /** Registered block id, e.g. 'hero', 'products', 'kpi-grid', 'custom:foo'. */
+    type: string;
+    /** Stable id for keys / editing; optional. */
+    id?: string;
+    props?: Record<string, unknown>;
+    children?: BlockNode[];
+    /**
+     * Instance-level data needs, same shape as the block meta's `data`
+     * declaration. Merged over the meta declaration by need name — how a
+     * document rebinds a loader param (e.g. to a route param) without a new
+     * block type. Resolved by the page-level resolver, never by the block.
+     */
+    data?: BlockDataNeeds;
+}
+/** A block component receives its declared props plus the raw node (so a block
+ *  can render its own children via <BlockChildren>). */
+export type BlockComponentProps = Record<string, unknown> & {
+    node?: BlockNode;
+    children?: React.ReactNode;
+};
+export type BlockErrorVisibility = 'visible' | 'silent';
+/**
+ * Who sees block failures. 'visible' renders an error card in place of a
+ * broken/misplaced block (dev, admin, the visual editor); 'silent' renders
+ * nothing there (shoppers). Defaults to 'visible' outside production builds.
+ * Pass null to restore the default.
+ */
+export declare function setBlockErrorVisibility(visibility: BlockErrorVisibility | null): void;
+/** Whether renders stamp each block with its document path. Editor only. */
+export declare function setBlockEditorMode(enabled: boolean): void;
+export declare function blockEditorMode(): boolean;
+/** The attribute a picker walks the DOM looking for. */
+export declare const BLOCK_PATH_ATTRIBUTE = "data-fayz-block";
+export declare const BLOCK_TYPE_ATTRIBUTE = "data-fayz-block-type";
+export declare function useBlockPath(): string;
+export declare function getBlockErrorVisibility(): BlockErrorVisibility;
+interface BlockErrorBoundaryProps {
+    blockType: string;
+    children?: React.ReactNode;
+}
+interface BlockErrorBoundaryState {
+    error: Error | null;
+}
+/**
+ * Isolates one block: a throw during its render removes THAT block, never the
+ * page. Always logs (a store hitting this in production is better off with the
+ * reason in the console); shows the card only per {@link getBlockErrorVisibility}.
+ */
+export declare class BlockErrorBoundary extends React.Component<BlockErrorBoundaryProps, BlockErrorBoundaryState> {
+    state: BlockErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): BlockErrorBoundaryState;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    render(): React.ReactNode;
+}
+export declare function BlockRenderer({ node, path }: {
+    node: BlockNode;
+    path?: string;
+}): React.ReactElement | null;
+/**
+ * Render an ordered list of blocks (a page body).
+ *
+ * `basePath` is the document path of the ARRAY these nodes came from, e.g.
+ * `presentation.pages.home.blocks`. Pages pass it so each block can carry the
+ * path back to the document node that produced it; callers that have no
+ * document (a preview, a test) pass nothing and get today's behaviour exactly.
+ */
+export declare function renderBlocks(nodes: BlockNode[], basePath?: string): React.ReactNode;
+/**
+ * Convenience for block components that render their own children.
+ *
+ * Reads its own path from context rather than taking one: a block that renders
+ * <BlockChildren> does not know where in the document it sits, and threading a
+ * path through every such block would be the signature change the wrapper
+ * design exists to avoid. Without this, nested blocks rendered this way carry
+ * no identity and are invisible to the editor.
+ */
+export declare function BlockChildren({ node }: {
+    node?: BlockNode;
+}): React.ReactNode;
+export {};
+//# sourceMappingURL=blocks.d.ts.map