@vivoa/plugin-sdk 0.6.6 → 0.6.7

package/dist/{host-api-C1VylW5l.d.mts → host-api-yX49e7zE.d.mts}

@@ -31,6 +31,8 @@ interface PluginConfigField {
     internal?: boolean;
     /** Visual group header rendered above the first field of each new group. */
     group?: string;
+    /** External URL shown as "¿Cómo obtenerlo?" link below the field label. */
+    helpUrl?: string;
 }
 
 declare enum FieldVariant {
@@ -116,6 +118,8 @@ interface GroupBlock extends BlockBase {
     type: BlockType.Group;
     title: string;
     description?: string;
+    /** External URL shown as "¿Cómo obtenerlo?" link in the annotated aside. */
+    helpUrl?: string;
     /** configSchema keys included in this group. */
     fields: string[];
     collapsible?: boolean;
@@ -128,7 +132,7 @@ interface ToggleBlock extends BlockBase {
     label: string;
     description?: string;
 }
-interface ActionBlock extends BlockBase {
+interface ActionBlock$1 extends BlockBase {
     type: BlockType.Action;
     /** Matches a manifest.actions[id]. */
     id: string;
@@ -148,7 +152,7 @@ interface MarkdownBlock extends BlockBase {
     type: BlockType.Markdown;
     content: string;
 }
-interface DividerBlock extends BlockBase {
+interface DividerBlock$1 extends BlockBase {
     type: BlockType.Divider;
 }
 type ConditionalEquals = string | number | boolean | null;
@@ -168,14 +172,14 @@ interface RepeaterBlock extends BlockBase {
     blocks: Block[];
 }
 /** Titled container. Recurses into `blocks`. */
-interface CardBlock extends BlockBase {
+interface CardBlock$1 extends BlockBase {
     type: BlockType.Card;
     title?: string;
     description?: string;
     blocks: Block[];
 }
 /** Prominent variant-styled message. Leaf. */
-interface BannerBlock extends BlockBase {
+interface BannerBlock$1 extends BlockBase {
     type: BlockType.Banner;
     variant: MessageVariant;
     title?: string;
@@ -185,7 +189,7 @@ interface BannerBlock extends BlockBase {
  * Read-only value with a copy affordance. EXACTLY ONE source of the value:
  * a literal, a host `computedValues` key, or a read-only echo of a config key.
  */
-interface CopyFieldBlock extends BlockBase {
+interface CopyFieldBlock$1 extends BlockBase {
     type: BlockType.CopyField;
     label: string;
     /** Literal value. */
@@ -221,17 +225,17 @@ interface AccordionBlock extends BlockBase {
     type: BlockType.Accordion;
     sections: AccordionSection[];
 }
-interface KeyValueRow {
+interface KeyValueRow$1 {
     label: string;
     value?: string;
     computedKey?: string;
 }
 /** Read-only label/value list. Leaf. */
-interface KeyValueBlock extends BlockBase {
+interface KeyValueBlock$1 extends BlockBase {
     type: BlockType.KeyValue;
-    rows: KeyValueRow[];
+    rows: KeyValueRow$1[];
 }
-type Block = FieldBlock | GroupBlock | ToggleBlock | ActionBlock | CalloutBlock | MarkdownBlock | DividerBlock | ConditionalBlock | RepeaterBlock | CardBlock | BannerBlock | CopyFieldBlock | InlineRowBlock | TabsBlock | AccordionBlock | KeyValueBlock;
+type Block = FieldBlock | GroupBlock | ToggleBlock | ActionBlock$1 | CalloutBlock | MarkdownBlock | DividerBlock$1 | ConditionalBlock | RepeaterBlock | CardBlock$1 | BannerBlock$1 | CopyFieldBlock$1 | InlineRowBlock | TabsBlock | AccordionBlock | KeyValueBlock$1;
 interface StepStatusFromFields {
     from: StepStatusFrom.Fields;
 }
@@ -310,7 +314,6 @@ interface PluginManifest {
     displayName?: string;
     version: string;
     entry: string;
-    type?: PluginType;
     icon?: string;
     description?: string;
     dependencies?: string[];
@@ -336,13 +339,6 @@ interface PluginManifest {
     setup?: SetupLayout;
 }
 
-declare enum PluginType {
-    Payment = "payment",
-    Shipping = "shipping",
-    Analytics = "analytics",
-    Invoicing = "invoicing",
-    Generic = "generic"
-}
 /** Visual tone for messages, callouts and action results. */
 declare enum MessageVariant {
     Info = "info",
@@ -608,6 +604,8 @@ interface ShippingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: ShippingFeature[];
     configSchema: PluginConfigField[];
@@ -750,6 +748,8 @@ interface SuppliersStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedCapabilities: SuppliersFeature[];
     configSchema: PluginConfigField[];
@@ -1054,6 +1054,8 @@ interface AnalyticsStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCapabilities: AnalyticsFeature[];
     configSchema: PluginConfigField[];
 }
@@ -1257,6 +1259,8 @@ interface InvoicingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: InvoicingFeature[];
     supportedDocumentTypes: InvoiceDocumentType[];
@@ -1290,6 +1294,112 @@ interface IInvoicingPlugin extends IPlugin {
     isConfigured?(ctx: DispatchContext): boolean;
 }
 
+declare enum ContentBlockType {
+    Text = "text",
+    Banner = "banner",
+    Badge = "badge",
+    KeyValue = "keyValue",
+    CopyField = "copyField",
+    Link = "link",
+    Divider = "divider",
+    Action = "action",
+    Card = "card"
+}
+declare enum ContentActionVariant {
+    Primary = "primary",
+    Secondary = "secondary",
+    Danger = "danger"
+}
+/** Markdown/plain paragraph. Literal `content` or host-resolved `computedKey`. */
+interface TextBlock {
+    type: ContentBlockType.Text;
+    content?: string;
+    computedKey?: string;
+}
+/** Prominent variant-styled message. */
+interface BannerBlock {
+    type: ContentBlockType.Banner;
+    variant: MessageVariant;
+    title?: string;
+    text: string;
+}
+/** Inline status pill. Literal `text` or host-resolved `computedKey`. */
+interface BadgeBlock {
+    type: ContentBlockType.Badge;
+    variant: MessageVariant;
+    text?: string;
+    computedKey?: string;
+}
+interface KeyValueRow {
+    label: string;
+    value?: string;
+    computedKey?: string;
+}
+/** Read-only label/value list. */
+interface KeyValueBlock {
+    type: ContentBlockType.KeyValue;
+    rows: KeyValueRow[];
+}
+/** Read-only value with a copy affordance. Literal or host-resolved. */
+interface CopyFieldBlock {
+    type: ContentBlockType.CopyField;
+    label: string;
+    value?: string;
+    computedKey?: string;
+}
+/** Hyperlink (e.g. "Descargar PDF"). `href` literal or host-resolved. */
+interface LinkBlock {
+    type: ContentBlockType.Link;
+    label: string;
+    href?: string;
+    computedKey?: string;
+    external?: boolean;
+}
+interface DividerBlock {
+    type: ContentBlockType.Divider;
+}
+/**
+ * Triggers a plugin action. `id` matches a `manifest.setup.actions[id]`; the
+ * host dispatches it through the SAME runtime path as a setup-screen action
+ * (invokeAction), so a contribution reuses the plugin's existing action surface.
+ */
+interface ActionBlock {
+    type: ContentBlockType.Action;
+    id: string;
+    label: string;
+    variant?: ContentActionVariant;
+}
+/** Titled container. Recurses into child `blocks`. */
+interface CardBlock {
+    type: ContentBlockType.Card;
+    title?: string;
+    description?: string;
+    blocks: ContentBlock[];
+}
+type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock;
+/**
+ * One block tree the plugin injects into a host slot. `slot` names a host-owned
+ * target (e.g. "admin:order.detail.sidebar", "storefront:product.below"); the
+ * set of valid slots is owned by the host, not the SDK. `order` breaks ties when
+ * several plugins target the same slot (ascending; absent sorts last).
+ */
+interface UiContribution {
+    slot: string;
+    blocks: ContentBlock[];
+    order?: number;
+}
+/** Impl behind a `ui` capability — the static set a plugin declares up front. */
+interface IUiPlugin {
+    readonly contributions: UiContribution[];
+}
+interface UiContributionsValidation {
+    success: boolean;
+    data?: UiContribution[];
+    errors?: string[];
+}
+/** Validates a plugin's declared contributions, including recursive cards. */
+declare function validateUiContributions(input: unknown): UiContributionsValidation;
+
 /** A named unit of behaviour a plugin exposes to the host registry. */
 interface Capability<T = unknown> {
     kind: string;
@@ -1306,6 +1416,12 @@ declare const CapabilityKind: {
     readonly Suppliers: "suppliers";
     readonly Analytics: "analytics";
     readonly Invoicing: "invoicing";
+    /**
+     * Cross-cutting DISPLAY capability: a plugin of ANY surface may ALSO expose
+     * `ui` to contribute declarative blocks into host slots. Not a catalog
+     * "surface" — the host's AppSurface derivation excludes it on purpose.
+     */
+    readonly Ui: "ui";
 };
 type CapabilityKind = (typeof CapabilityKind)[keyof typeof CapabilityKind];
 declare function capability<T>(kind: string, impl: T): Capability<T>;
@@ -1314,6 +1430,7 @@ declare function shippingCapability(impl: IShippingPlugin): Capability<IShipping
 declare function suppliersCapability(impl: ISuppliersPlugin): Capability<ISuppliersPlugin>;
 declare function analyticsCapability(impl: IAnalyticsPlugin): Capability<IAnalyticsPlugin>;
 declare function invoicingCapability(impl: IInvoicingPlugin): Capability<IInvoicingPlugin>;
+declare function uiCapability(impl: IUiPlugin): Capability<IUiPlugin>;
 /**
  * A constructed plugin. `capabilities` is the static declaration the host reads
  * up front; `onActivate` runs when the host mounts the plugin for a tenant and
@@ -1413,4 +1530,4 @@ interface HostApi {
     registerCapability<T = unknown>(cap: Capability<T>): void;
 }
 
-export { type IAnalyticsPlugin as $, AUTHOR_HANDLE_RE as A, type BannerBlock as B, ConfigScope as C, type ConditionalBlock as D, type ConditionalEquals as E, FieldType as F, type ConditionalWhen as G, type ConfigurablePlugin as H, type CopyFieldBlock as I, type CreateShipmentParams as J, type DispatchContext as K, type DividerBlock as L, type DomainEventHandler as M, type DomainEventName as N, type EmbedInit as O, type PluginConfigField as P, type FieldBlock as Q, type FieldOption as R, type SelectOption as S, FieldVariant as T, GatewayEnvironment as U, type GatewayStaticConfig as V, type GroupBlock as W, type HostApi as X, type HttpClient as Y, type HttpRequest as Z, type HttpResponse as _, type AccordionBlock as a, type StepStatusSource as a$, type IInvoicingPlugin as a0, type IPaymentPlugin as a1, type IPlugin as a2, type IShippingPlugin as a3, type ISuppliersPlugin as a4, type InlineRowBlock as a5, InvoiceDocumentType as a6, type InvoiceLine as a7, type InvoiceMoney as a8, type InvoiceParty as a9, type PluginActionContext as aA, type PluginActionResult as aB, type PluginAuthor as aC, type PluginConfigFieldDependency as aD, type PluginFactory as aE, type PluginManifest as aF, PluginType as aG, type RepeaterBlock as aH, RepeaterSource as aI, type SecretStore as aJ, type SequenceStore as aK, type SetupAction as aL, type SetupLayout as aM, type SetupLayoutValidation as aN, type SetupStep as aO, type ShipmentAddress as aP, type ShipmentParcel as aQ, type ShipmentResult as aR, type ShippingDefaultConfig as aS, ShippingFeature as aT, type ShippingPluginConfig as aU, type ShippingQuote as aV, type ShippingQuoteParams as aW, type ShippingStaticConfig as aX, StepStatusFrom as aY, type StepStatusFromAction as aZ, type StepStatusFromFields as a_, type InvoiceRequest as aa, type InvoiceResult as ab, InvoiceStatus as ac, type InvoiceTax as ad, type InvoicingDefaultConfig as ae, InvoicingFeature as af, type InvoicingPluginConfig as ag, type InvoicingStaticConfig as ah, type KeyValueBlock as ai, type KeyValueRow as aj, LayoutMode as ak, type Logger as al, type MarkdownBlock as am, MessageVariant as an, type PaymentCard as ao, type PaymentCustomer as ap, type PaymentGatewayCode as aq, type PaymentPayload as ar, type PaymentPluginConfig as as, type PaymentRenderMode as at, type PaymentResult as au, type PaymentSessionPayload as av, type PaymentSessionResult as aw, type PaymentVerifyPayload as ax, type PlaceSupplierOrderInput as ay, type Plugin as az, type AccordionSection as b, type StorageBroker as b0, type SupplierCatalogQuery as b1, type SupplierFulfillmentEvent as b2, type SupplierListing as b3, type SupplierListingAttribute as b4, type SupplierListingPage as b5, type SupplierListingVariant as b6, type SupplierMoney as b7, type SupplierOrderAddressLevel as b8, type SupplierOrderCustomer as b9, validatePluginAuthor as bA, validateSetupLayout as bB, type SupplierOrderLine as ba, type SupplierOrderResult as bb, type SupplierOrderStatus as bc, type SupplierShipTo as bd, type SupplierStock as be, type SuppliersDefaultConfig as bf, SuppliersFeature as bg, type SuppliersPluginConfig as bh, type SuppliersStaticConfig as bi, type TabItem as bj, type TabsBlock as bk, type ToggleBlock as bl, type TrackingEvent as bm, TransactionStatus as bn, type VoidInvoiceInput as bo, type WebhookSignatureResult as bp, analyticsCapability as bq, capability as br, crossValidateSetupLayout as bs, definePlugin as bt, invoicingCapability as bu, isConfigurablePlugin as bv, isPluginFactory as bw, paymentCapability as bx, shippingCapability as by, suppliersCapability as bz, type ActionBlock as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsStaticConfig as m, type AnalyticsUserData as n, type AnalyticsUtm as o, type AuthorValidation as p, type Block as q, type BlockBase as r, BlockType as s, type CalloutBlock as t, type Capability as u, CapabilityKind as v, type CardBlock as w, type CodConfig as x, type CodFeeConfig as y, CodFeeType as z };
+export { type HttpClient as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type ConditionalBlock as D, type ConditionalEquals as E, FieldType as F, type ConditionalWhen as G, type ConfigurablePlugin as H, ContentActionVariant as I, type ContentBlock as J, ContentBlockType as K, type CopyFieldBlock$1 as L, type CreateShipmentParams as M, type DispatchContext as N, type DividerBlock$1 as O, type PluginConfigField as P, type DomainEventHandler as Q, type DomainEventName as R, type SelectOption as S, type EmbedInit as T, type FieldBlock as U, type FieldOption as V, FieldVariant as W, GatewayEnvironment as X, type GatewayStaticConfig as Y, type GroupBlock as Z, type HostApi as _, type AccordionBlock as a, StepStatusFrom as a$, type HttpRequest as a0, type HttpResponse as a1, type IAnalyticsPlugin as a2, type IInvoicingPlugin as a3, type IPaymentPlugin as a4, type IPlugin as a5, type IShippingPlugin as a6, type ISuppliersPlugin as a7, type IUiPlugin as a8, type InlineRowBlock as a9, type PaymentSessionResult as aA, type PaymentVerifyPayload as aB, type PlaceSupplierOrderInput as aC, type Plugin as aD, type PluginActionContext as aE, type PluginActionResult as aF, type PluginAuthor as aG, type PluginConfigFieldDependency as aH, type PluginFactory as aI, type PluginManifest as aJ, type RepeaterBlock as aK, RepeaterSource as aL, type SecretStore as aM, type SequenceStore as aN, type SetupAction as aO, type SetupLayout as aP, type SetupLayoutValidation as aQ, type SetupStep as aR, type ShipmentAddress as aS, type ShipmentParcel as aT, type ShipmentResult as aU, type ShippingDefaultConfig as aV, ShippingFeature as aW, type ShippingPluginConfig as aX, type ShippingQuote as aY, type ShippingQuoteParams as aZ, type ShippingStaticConfig as a_, InvoiceDocumentType as aa, type InvoiceLine as ab, type InvoiceMoney as ac, type InvoiceParty as ad, type InvoiceRequest as ae, type InvoiceResult as af, InvoiceStatus as ag, type InvoiceTax as ah, type InvoicingDefaultConfig as ai, InvoicingFeature as aj, type InvoicingPluginConfig as ak, type InvoicingStaticConfig as al, type KeyValueBlock$1 as am, type KeyValueRow$1 as an, LayoutMode as ao, type Logger as ap, type MarkdownBlock as aq, MessageVariant as ar, type PaymentCard as as, type PaymentCustomer as at, type PaymentGatewayCode as au, type PaymentPayload as av, type PaymentPluginConfig as aw, type PaymentRenderMode as ax, type PaymentResult as ay, type PaymentSessionPayload as az, type AccordionSection as b, type StepStatusFromAction as b0, type StepStatusFromFields as b1, type StepStatusSource as b2, type StorageBroker as b3, type SupplierCatalogQuery as b4, type SupplierFulfillmentEvent as b5, type SupplierListing as b6, type SupplierListingAttribute as b7, type SupplierListingPage as b8, type SupplierListingVariant as b9, isConfigurablePlugin as bA, isPluginFactory as bB, paymentCapability as bC, shippingCapability as bD, suppliersCapability as bE, uiCapability as bF, validatePluginAuthor as bG, validateSetupLayout as bH, validateUiContributions as bI, type SupplierMoney as ba, type SupplierOrderAddressLevel as bb, type SupplierOrderCustomer as bc, type SupplierOrderLine as bd, type SupplierOrderResult as be, type SupplierOrderStatus as bf, type SupplierShipTo as bg, type SupplierStock as bh, type SuppliersDefaultConfig as bi, SuppliersFeature as bj, type SuppliersPluginConfig as bk, type SuppliersStaticConfig as bl, type TabItem as bm, type TabsBlock as bn, type ToggleBlock as bo, type TrackingEvent as bp, TransactionStatus as bq, type UiContribution as br, type UiContributionsValidation as bs, type VoidInvoiceInput as bt, type WebhookSignatureResult as bu, analyticsCapability as bv, capability as bw, crossValidateSetupLayout as bx, definePlugin as by, invoicingCapability as bz, type ActionBlock$1 as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsStaticConfig as m, type AnalyticsUserData as n, type AnalyticsUtm as o, type AuthorValidation as p, type Block as q, type BlockBase as r, BlockType as s, type CalloutBlock as t, type Capability as u, CapabilityKind as v, type CardBlock$1 as w, type CodConfig as x, type CodFeeConfig as y, CodFeeType as z };

package/dist/{host-api-C1VylW5l.d.ts → host-api-yX49e7zE.d.ts}

@@ -31,6 +31,8 @@ interface PluginConfigField {
     internal?: boolean;
     /** Visual group header rendered above the first field of each new group. */
     group?: string;
+    /** External URL shown as "¿Cómo obtenerlo?" link below the field label. */
+    helpUrl?: string;
 }
 
 declare enum FieldVariant {
@@ -116,6 +118,8 @@ interface GroupBlock extends BlockBase {
     type: BlockType.Group;
     title: string;
     description?: string;
+    /** External URL shown as "¿Cómo obtenerlo?" link in the annotated aside. */
+    helpUrl?: string;
     /** configSchema keys included in this group. */
     fields: string[];
     collapsible?: boolean;
@@ -128,7 +132,7 @@ interface ToggleBlock extends BlockBase {
     label: string;
     description?: string;
 }
-interface ActionBlock extends BlockBase {
+interface ActionBlock$1 extends BlockBase {
     type: BlockType.Action;
     /** Matches a manifest.actions[id]. */
     id: string;
@@ -148,7 +152,7 @@ interface MarkdownBlock extends BlockBase {
     type: BlockType.Markdown;
     content: string;
 }
-interface DividerBlock extends BlockBase {
+interface DividerBlock$1 extends BlockBase {
     type: BlockType.Divider;
 }
 type ConditionalEquals = string | number | boolean | null;
@@ -168,14 +172,14 @@ interface RepeaterBlock extends BlockBase {
     blocks: Block[];
 }
 /** Titled container. Recurses into `blocks`. */
-interface CardBlock extends BlockBase {
+interface CardBlock$1 extends BlockBase {
     type: BlockType.Card;
     title?: string;
     description?: string;
     blocks: Block[];
 }
 /** Prominent variant-styled message. Leaf. */
-interface BannerBlock extends BlockBase {
+interface BannerBlock$1 extends BlockBase {
     type: BlockType.Banner;
     variant: MessageVariant;
     title?: string;
@@ -185,7 +189,7 @@ interface BannerBlock extends BlockBase {
  * Read-only value with a copy affordance. EXACTLY ONE source of the value:
  * a literal, a host `computedValues` key, or a read-only echo of a config key.
  */
-interface CopyFieldBlock extends BlockBase {
+interface CopyFieldBlock$1 extends BlockBase {
     type: BlockType.CopyField;
     label: string;
     /** Literal value. */
@@ -221,17 +225,17 @@ interface AccordionBlock extends BlockBase {
     type: BlockType.Accordion;
     sections: AccordionSection[];
 }
-interface KeyValueRow {
+interface KeyValueRow$1 {
     label: string;
     value?: string;
     computedKey?: string;
 }
 /** Read-only label/value list. Leaf. */
-interface KeyValueBlock extends BlockBase {
+interface KeyValueBlock$1 extends BlockBase {
     type: BlockType.KeyValue;
-    rows: KeyValueRow[];
+    rows: KeyValueRow$1[];
 }
-type Block = FieldBlock | GroupBlock | ToggleBlock | ActionBlock | CalloutBlock | MarkdownBlock | DividerBlock | ConditionalBlock | RepeaterBlock | CardBlock | BannerBlock | CopyFieldBlock | InlineRowBlock | TabsBlock | AccordionBlock | KeyValueBlock;
+type Block = FieldBlock | GroupBlock | ToggleBlock | ActionBlock$1 | CalloutBlock | MarkdownBlock | DividerBlock$1 | ConditionalBlock | RepeaterBlock | CardBlock$1 | BannerBlock$1 | CopyFieldBlock$1 | InlineRowBlock | TabsBlock | AccordionBlock | KeyValueBlock$1;
 interface StepStatusFromFields {
     from: StepStatusFrom.Fields;
 }
@@ -310,7 +314,6 @@ interface PluginManifest {
     displayName?: string;
     version: string;
     entry: string;
-    type?: PluginType;
     icon?: string;
     description?: string;
     dependencies?: string[];
@@ -336,13 +339,6 @@ interface PluginManifest {
     setup?: SetupLayout;
 }
 
-declare enum PluginType {
-    Payment = "payment",
-    Shipping = "shipping",
-    Analytics = "analytics",
-    Invoicing = "invoicing",
-    Generic = "generic"
-}
 /** Visual tone for messages, callouts and action results. */
 declare enum MessageVariant {
     Info = "info",
@@ -608,6 +604,8 @@ interface ShippingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: ShippingFeature[];
     configSchema: PluginConfigField[];
@@ -750,6 +748,8 @@ interface SuppliersStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedCapabilities: SuppliersFeature[];
     configSchema: PluginConfigField[];
@@ -1054,6 +1054,8 @@ interface AnalyticsStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCapabilities: AnalyticsFeature[];
     configSchema: PluginConfigField[];
 }
@@ -1257,6 +1259,8 @@ interface InvoicingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: InvoicingFeature[];
     supportedDocumentTypes: InvoiceDocumentType[];
@@ -1290,6 +1294,112 @@ interface IInvoicingPlugin extends IPlugin {
     isConfigured?(ctx: DispatchContext): boolean;
 }
 
+declare enum ContentBlockType {
+    Text = "text",
+    Banner = "banner",
+    Badge = "badge",
+    KeyValue = "keyValue",
+    CopyField = "copyField",
+    Link = "link",
+    Divider = "divider",
+    Action = "action",
+    Card = "card"
+}
+declare enum ContentActionVariant {
+    Primary = "primary",
+    Secondary = "secondary",
+    Danger = "danger"
+}
+/** Markdown/plain paragraph. Literal `content` or host-resolved `computedKey`. */
+interface TextBlock {
+    type: ContentBlockType.Text;
+    content?: string;
+    computedKey?: string;
+}
+/** Prominent variant-styled message. */
+interface BannerBlock {
+    type: ContentBlockType.Banner;
+    variant: MessageVariant;
+    title?: string;
+    text: string;
+}
+/** Inline status pill. Literal `text` or host-resolved `computedKey`. */
+interface BadgeBlock {
+    type: ContentBlockType.Badge;
+    variant: MessageVariant;
+    text?: string;
+    computedKey?: string;
+}
+interface KeyValueRow {
+    label: string;
+    value?: string;
+    computedKey?: string;
+}
+/** Read-only label/value list. */
+interface KeyValueBlock {
+    type: ContentBlockType.KeyValue;
+    rows: KeyValueRow[];
+}
+/** Read-only value with a copy affordance. Literal or host-resolved. */
+interface CopyFieldBlock {
+    type: ContentBlockType.CopyField;
+    label: string;
+    value?: string;
+    computedKey?: string;
+}
+/** Hyperlink (e.g. "Descargar PDF"). `href` literal or host-resolved. */
+interface LinkBlock {
+    type: ContentBlockType.Link;
+    label: string;
+    href?: string;
+    computedKey?: string;
+    external?: boolean;
+}
+interface DividerBlock {
+    type: ContentBlockType.Divider;
+}
+/**
+ * Triggers a plugin action. `id` matches a `manifest.setup.actions[id]`; the
+ * host dispatches it through the SAME runtime path as a setup-screen action
+ * (invokeAction), so a contribution reuses the plugin's existing action surface.
+ */
+interface ActionBlock {
+    type: ContentBlockType.Action;
+    id: string;
+    label: string;
+    variant?: ContentActionVariant;
+}
+/** Titled container. Recurses into child `blocks`. */
+interface CardBlock {
+    type: ContentBlockType.Card;
+    title?: string;
+    description?: string;
+    blocks: ContentBlock[];
+}
+type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock;
+/**
+ * One block tree the plugin injects into a host slot. `slot` names a host-owned
+ * target (e.g. "admin:order.detail.sidebar", "storefront:product.below"); the
+ * set of valid slots is owned by the host, not the SDK. `order` breaks ties when
+ * several plugins target the same slot (ascending; absent sorts last).
+ */
+interface UiContribution {
+    slot: string;
+    blocks: ContentBlock[];
+    order?: number;
+}
+/** Impl behind a `ui` capability — the static set a plugin declares up front. */
+interface IUiPlugin {
+    readonly contributions: UiContribution[];
+}
+interface UiContributionsValidation {
+    success: boolean;
+    data?: UiContribution[];
+    errors?: string[];
+}
+/** Validates a plugin's declared contributions, including recursive cards. */
+declare function validateUiContributions(input: unknown): UiContributionsValidation;
+
 /** A named unit of behaviour a plugin exposes to the host registry. */
 interface Capability<T = unknown> {
     kind: string;
@@ -1306,6 +1416,12 @@ declare const CapabilityKind: {
     readonly Suppliers: "suppliers";
     readonly Analytics: "analytics";
     readonly Invoicing: "invoicing";
+    /**
+     * Cross-cutting DISPLAY capability: a plugin of ANY surface may ALSO expose
+     * `ui` to contribute declarative blocks into host slots. Not a catalog
+     * "surface" — the host's AppSurface derivation excludes it on purpose.
+     */
+    readonly Ui: "ui";
 };
 type CapabilityKind = (typeof CapabilityKind)[keyof typeof CapabilityKind];
 declare function capability<T>(kind: string, impl: T): Capability<T>;
@@ -1314,6 +1430,7 @@ declare function shippingCapability(impl: IShippingPlugin): Capability<IShipping
 declare function suppliersCapability(impl: ISuppliersPlugin): Capability<ISuppliersPlugin>;
 declare function analyticsCapability(impl: IAnalyticsPlugin): Capability<IAnalyticsPlugin>;
 declare function invoicingCapability(impl: IInvoicingPlugin): Capability<IInvoicingPlugin>;
+declare function uiCapability(impl: IUiPlugin): Capability<IUiPlugin>;
 /**
  * A constructed plugin. `capabilities` is the static declaration the host reads
  * up front; `onActivate` runs when the host mounts the plugin for a tenant and
@@ -1413,4 +1530,4 @@ interface HostApi {
     registerCapability<T = unknown>(cap: Capability<T>): void;
 }
 
-export { type IAnalyticsPlugin as $, AUTHOR_HANDLE_RE as A, type BannerBlock as B, ConfigScope as C, type ConditionalBlock as D, type ConditionalEquals as E, FieldType as F, type ConditionalWhen as G, type ConfigurablePlugin as H, type CopyFieldBlock as I, type CreateShipmentParams as J, type DispatchContext as K, type DividerBlock as L, type DomainEventHandler as M, type DomainEventName as N, type EmbedInit as O, type PluginConfigField as P, type FieldBlock as Q, type FieldOption as R, type SelectOption as S, FieldVariant as T, GatewayEnvironment as U, type GatewayStaticConfig as V, type GroupBlock as W, type HostApi as X, type HttpClient as Y, type HttpRequest as Z, type HttpResponse as _, type AccordionBlock as a, type StepStatusSource as a$, type IInvoicingPlugin as a0, type IPaymentPlugin as a1, type IPlugin as a2, type IShippingPlugin as a3, type ISuppliersPlugin as a4, type InlineRowBlock as a5, InvoiceDocumentType as a6, type InvoiceLine as a7, type InvoiceMoney as a8, type InvoiceParty as a9, type PluginActionContext as aA, type PluginActionResult as aB, type PluginAuthor as aC, type PluginConfigFieldDependency as aD, type PluginFactory as aE, type PluginManifest as aF, PluginType as aG, type RepeaterBlock as aH, RepeaterSource as aI, type SecretStore as aJ, type SequenceStore as aK, type SetupAction as aL, type SetupLayout as aM, type SetupLayoutValidation as aN, type SetupStep as aO, type ShipmentAddress as aP, type ShipmentParcel as aQ, type ShipmentResult as aR, type ShippingDefaultConfig as aS, ShippingFeature as aT, type ShippingPluginConfig as aU, type ShippingQuote as aV, type ShippingQuoteParams as aW, type ShippingStaticConfig as aX, StepStatusFrom as aY, type StepStatusFromAction as aZ, type StepStatusFromFields as a_, type InvoiceRequest as aa, type InvoiceResult as ab, InvoiceStatus as ac, type InvoiceTax as ad, type InvoicingDefaultConfig as ae, InvoicingFeature as af, type InvoicingPluginConfig as ag, type InvoicingStaticConfig as ah, type KeyValueBlock as ai, type KeyValueRow as aj, LayoutMode as ak, type Logger as al, type MarkdownBlock as am, MessageVariant as an, type PaymentCard as ao, type PaymentCustomer as ap, type PaymentGatewayCode as aq, type PaymentPayload as ar, type PaymentPluginConfig as as, type PaymentRenderMode as at, type PaymentResult as au, type PaymentSessionPayload as av, type PaymentSessionResult as aw, type PaymentVerifyPayload as ax, type PlaceSupplierOrderInput as ay, type Plugin as az, type AccordionSection as b, type StorageBroker as b0, type SupplierCatalogQuery as b1, type SupplierFulfillmentEvent as b2, type SupplierListing as b3, type SupplierListingAttribute as b4, type SupplierListingPage as b5, type SupplierListingVariant as b6, type SupplierMoney as b7, type SupplierOrderAddressLevel as b8, type SupplierOrderCustomer as b9, validatePluginAuthor as bA, validateSetupLayout as bB, type SupplierOrderLine as ba, type SupplierOrderResult as bb, type SupplierOrderStatus as bc, type SupplierShipTo as bd, type SupplierStock as be, type SuppliersDefaultConfig as bf, SuppliersFeature as bg, type SuppliersPluginConfig as bh, type SuppliersStaticConfig as bi, type TabItem as bj, type TabsBlock as bk, type ToggleBlock as bl, type TrackingEvent as bm, TransactionStatus as bn, type VoidInvoiceInput as bo, type WebhookSignatureResult as bp, analyticsCapability as bq, capability as br, crossValidateSetupLayout as bs, definePlugin as bt, invoicingCapability as bu, isConfigurablePlugin as bv, isPluginFactory as bw, paymentCapability as bx, shippingCapability as by, suppliersCapability as bz, type ActionBlock as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsStaticConfig as m, type AnalyticsUserData as n, type AnalyticsUtm as o, type AuthorValidation as p, type Block as q, type BlockBase as r, BlockType as s, type CalloutBlock as t, type Capability as u, CapabilityKind as v, type CardBlock as w, type CodConfig as x, type CodFeeConfig as y, CodFeeType as z };
+export { type HttpClient as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type ConditionalBlock as D, type ConditionalEquals as E, FieldType as F, type ConditionalWhen as G, type ConfigurablePlugin as H, ContentActionVariant as I, type ContentBlock as J, ContentBlockType as K, type CopyFieldBlock$1 as L, type CreateShipmentParams as M, type DispatchContext as N, type DividerBlock$1 as O, type PluginConfigField as P, type DomainEventHandler as Q, type DomainEventName as R, type SelectOption as S, type EmbedInit as T, type FieldBlock as U, type FieldOption as V, FieldVariant as W, GatewayEnvironment as X, type GatewayStaticConfig as Y, type GroupBlock as Z, type HostApi as _, type AccordionBlock as a, StepStatusFrom as a$, type HttpRequest as a0, type HttpResponse as a1, type IAnalyticsPlugin as a2, type IInvoicingPlugin as a3, type IPaymentPlugin as a4, type IPlugin as a5, type IShippingPlugin as a6, type ISuppliersPlugin as a7, type IUiPlugin as a8, type InlineRowBlock as a9, type PaymentSessionResult as aA, type PaymentVerifyPayload as aB, type PlaceSupplierOrderInput as aC, type Plugin as aD, type PluginActionContext as aE, type PluginActionResult as aF, type PluginAuthor as aG, type PluginConfigFieldDependency as aH, type PluginFactory as aI, type PluginManifest as aJ, type RepeaterBlock as aK, RepeaterSource as aL, type SecretStore as aM, type SequenceStore as aN, type SetupAction as aO, type SetupLayout as aP, type SetupLayoutValidation as aQ, type SetupStep as aR, type ShipmentAddress as aS, type ShipmentParcel as aT, type ShipmentResult as aU, type ShippingDefaultConfig as aV, ShippingFeature as aW, type ShippingPluginConfig as aX, type ShippingQuote as aY, type ShippingQuoteParams as aZ, type ShippingStaticConfig as a_, InvoiceDocumentType as aa, type InvoiceLine as ab, type InvoiceMoney as ac, type InvoiceParty as ad, type InvoiceRequest as ae, type InvoiceResult as af, InvoiceStatus as ag, type InvoiceTax as ah, type InvoicingDefaultConfig as ai, InvoicingFeature as aj, type InvoicingPluginConfig as ak, type InvoicingStaticConfig as al, type KeyValueBlock$1 as am, type KeyValueRow$1 as an, LayoutMode as ao, type Logger as ap, type MarkdownBlock as aq, MessageVariant as ar, type PaymentCard as as, type PaymentCustomer as at, type PaymentGatewayCode as au, type PaymentPayload as av, type PaymentPluginConfig as aw, type PaymentRenderMode as ax, type PaymentResult as ay, type PaymentSessionPayload as az, type AccordionSection as b, type StepStatusFromAction as b0, type StepStatusFromFields as b1, type StepStatusSource as b2, type StorageBroker as b3, type SupplierCatalogQuery as b4, type SupplierFulfillmentEvent as b5, type SupplierListing as b6, type SupplierListingAttribute as b7, type SupplierListingPage as b8, type SupplierListingVariant as b9, isConfigurablePlugin as bA, isPluginFactory as bB, paymentCapability as bC, shippingCapability as bD, suppliersCapability as bE, uiCapability as bF, validatePluginAuthor as bG, validateSetupLayout as bH, validateUiContributions as bI, type SupplierMoney as ba, type SupplierOrderAddressLevel as bb, type SupplierOrderCustomer as bc, type SupplierOrderLine as bd, type SupplierOrderResult as be, type SupplierOrderStatus as bf, type SupplierShipTo as bg, type SupplierStock as bh, type SuppliersDefaultConfig as bi, SuppliersFeature as bj, type SuppliersPluginConfig as bk, type SuppliersStaticConfig as bl, type TabItem as bm, type TabsBlock as bn, type ToggleBlock as bo, type TrackingEvent as bp, TransactionStatus as bq, type UiContribution as br, type UiContributionsValidation as bs, type VoidInvoiceInput as bt, type WebhookSignatureResult as bu, analyticsCapability as bv, capability as bw, crossValidateSetupLayout as bx, definePlugin as by, invoicingCapability as bz, type ActionBlock$1 as c, ActionVariant as d, type AnalyticsActionSource as e, type AnalyticsConsent as f, type AnalyticsEvent as g, type AnalyticsEventName as h, AnalyticsFeature as i, type AnalyticsItem as j, type AnalyticsMoney as k, type AnalyticsPluginConfig as l, type AnalyticsStaticConfig as m, type AnalyticsUserData as n, type AnalyticsUtm as o, type AuthorValidation as p, type Block as q, type BlockBase as r, BlockType as s, type CalloutBlock as t, type Capability as u, CapabilityKind as v, type CardBlock$1 as w, type CodConfig as x, type CodFeeConfig as y, CodFeeType as z };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-C1VylW5l.mjs';
-export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsStaticConfig, n as AnalyticsUserData, o as AnalyticsUtm, p as AuthorValidation, B as BannerBlock, q as Block, r as BlockBase, s as BlockType, t as CalloutBlock, u as Capability, v as CapabilityKind, w as CardBlock, x as CodConfig, y as CodFeeConfig, z as CodFeeType, D as ConditionalBlock, E as ConditionalEquals, G as ConditionalWhen, H as ConfigurablePlugin, I as CopyFieldBlock, J as CreateShipmentParams, K as DispatchContext, L as DividerBlock, M as DomainEventHandler, N as DomainEventName, O as EmbedInit, Q as FieldBlock, R as FieldOption, T as FieldVariant, U as GatewayEnvironment, V as GatewayStaticConfig, W as GroupBlock, X as HostApi, Y as HttpClient, Z as HttpRequest, _ as HttpResponse, $ as IAnalyticsPlugin, a0 as IInvoicingPlugin, a1 as IPaymentPlugin, a2 as IPlugin, a3 as IShippingPlugin, a4 as ISuppliersPlugin, a5 as InlineRowBlock, a6 as InvoiceDocumentType, a7 as InvoiceLine, a8 as InvoiceMoney, a9 as InvoiceParty, aa as InvoiceRequest, ab as InvoiceResult, ac as InvoiceStatus, ad as InvoiceTax, ae as InvoicingDefaultConfig, af as InvoicingFeature, ag as InvoicingPluginConfig, ah as InvoicingStaticConfig, ai as KeyValueBlock, aj as KeyValueRow, ak as LayoutMode, al as Logger, am as MarkdownBlock, an as MessageVariant, ao as PaymentCard, ap as PaymentCustomer, aq as PaymentGatewayCode, ar as PaymentPayload, as as PaymentPluginConfig, at as PaymentRenderMode, au as PaymentResult, av as PaymentSessionPayload, aw as PaymentSessionResult, ax as PaymentVerifyPayload, ay as PlaceSupplierOrderInput, az as Plugin, aA as PluginActionContext, aB as PluginActionResult, aC as PluginAuthor, aD as PluginConfigFieldDependency, aE as PluginFactory, aF as PluginManifest, aG as PluginType, aH as RepeaterBlock, aI as RepeaterSource, aJ as SecretStore, aK as SequenceStore, aL as SetupAction, aM as SetupLayout, aN as SetupLayoutValidation, aO as SetupStep, aP as ShipmentAddress, aQ as ShipmentParcel, aR as ShipmentResult, aS as ShippingDefaultConfig, aT as ShippingFeature, aU as ShippingPluginConfig, aV as ShippingQuote, aW as ShippingQuoteParams, aX as ShippingStaticConfig, aY as StepStatusFrom, aZ as StepStatusFromAction, a_ as StepStatusFromFields, a$ as StepStatusSource, b0 as StorageBroker, b1 as SupplierCatalogQuery, b2 as SupplierFulfillmentEvent, b3 as SupplierListing, b4 as SupplierListingAttribute, b5 as SupplierListingPage, b6 as SupplierListingVariant, b7 as SupplierMoney, b8 as SupplierOrderAddressLevel, b9 as SupplierOrderCustomer, ba as SupplierOrderLine, bb as SupplierOrderResult, bc as SupplierOrderStatus, bd as SupplierShipTo, be as SupplierStock, bf as SuppliersDefaultConfig, bg as SuppliersFeature, bh as SuppliersPluginConfig, bi as SuppliersStaticConfig, bj as TabItem, bk as TabsBlock, bl as ToggleBlock, bm as TrackingEvent, bn as TransactionStatus, bo as VoidInvoiceInput, bp as WebhookSignatureResult, bq as analyticsCapability, br as capability, bs as crossValidateSetupLayout, bt as definePlugin, bu as invoicingCapability, bv as isConfigurablePlugin, bw as isPluginFactory, bx as paymentCapability, by as shippingCapability, bz as suppliersCapability, bA as validatePluginAuthor, bB as validateSetupLayout } from './host-api-C1VylW5l.mjs';
+import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-yX49e7zE.mjs';
+export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsStaticConfig, n as AnalyticsUserData, o as AnalyticsUtm, p as AuthorValidation, B as BannerBlock, q as Block, r as BlockBase, s as BlockType, t as CalloutBlock, u as Capability, v as CapabilityKind, w as CardBlock, x as CodConfig, y as CodFeeConfig, z as CodFeeType, D as ConditionalBlock, E as ConditionalEquals, G as ConditionalWhen, H as ConfigurablePlugin, I as ContentActionVariant, J as ContentBlock, K as ContentBlockType, L as CopyFieldBlock, M as CreateShipmentParams, N as DispatchContext, O as DividerBlock, Q as DomainEventHandler, R as DomainEventName, T as EmbedInit, U as FieldBlock, V as FieldOption, W as FieldVariant, X as GatewayEnvironment, Y as GatewayStaticConfig, Z as GroupBlock, _ as HostApi, $ as HttpClient, a0 as HttpRequest, a1 as HttpResponse, a2 as IAnalyticsPlugin, a3 as IInvoicingPlugin, a4 as IPaymentPlugin, a5 as IPlugin, a6 as IShippingPlugin, a7 as ISuppliersPlugin, a8 as IUiPlugin, a9 as InlineRowBlock, aa as InvoiceDocumentType, ab as InvoiceLine, ac as InvoiceMoney, ad as InvoiceParty, ae as InvoiceRequest, af as InvoiceResult, ag as InvoiceStatus, ah as InvoiceTax, ai as InvoicingDefaultConfig, aj as InvoicingFeature, ak as InvoicingPluginConfig, al as InvoicingStaticConfig, am as KeyValueBlock, an as KeyValueRow, ao as LayoutMode, ap as Logger, aq as MarkdownBlock, ar as MessageVariant, as as PaymentCard, at as PaymentCustomer, au as PaymentGatewayCode, av as PaymentPayload, aw as PaymentPluginConfig, ax as PaymentRenderMode, ay as PaymentResult, az as PaymentSessionPayload, aA as PaymentSessionResult, aB as PaymentVerifyPayload, aC as PlaceSupplierOrderInput, aD as Plugin, aE as PluginActionContext, aF as PluginActionResult, aG as PluginAuthor, aH as PluginConfigFieldDependency, aI as PluginFactory, aJ as PluginManifest, aK as RepeaterBlock, aL as RepeaterSource, aM as SecretStore, aN as SequenceStore, aO as SetupAction, aP as SetupLayout, aQ as SetupLayoutValidation, aR as SetupStep, aS as ShipmentAddress, aT as ShipmentParcel, aU as ShipmentResult, aV as ShippingDefaultConfig, aW as ShippingFeature, aX as ShippingPluginConfig, aY as ShippingQuote, aZ as ShippingQuoteParams, a_ as ShippingStaticConfig, a$ as StepStatusFrom, b0 as StepStatusFromAction, b1 as StepStatusFromFields, b2 as StepStatusSource, b3 as StorageBroker, b4 as SupplierCatalogQuery, b5 as SupplierFulfillmentEvent, b6 as SupplierListing, b7 as SupplierListingAttribute, b8 as SupplierListingPage, b9 as SupplierListingVariant, ba as SupplierMoney, bb as SupplierOrderAddressLevel, bc as SupplierOrderCustomer, bd as SupplierOrderLine, be as SupplierOrderResult, bf as SupplierOrderStatus, bg as SupplierShipTo, bh as SupplierStock, bi as SuppliersDefaultConfig, bj as SuppliersFeature, bk as SuppliersPluginConfig, bl as SuppliersStaticConfig, bm as TabItem, bn as TabsBlock, bo as ToggleBlock, bp as TrackingEvent, bq as TransactionStatus, br as UiContribution, bs as UiContributionsValidation, bt as VoidInvoiceInput, bu as WebhookSignatureResult, bv as analyticsCapability, bw as capability, bx as crossValidateSetupLayout, by as definePlugin, bz as invoicingCapability, bA as isConfigurablePlugin, bB as isPluginFactory, bC as paymentCapability, bD as shippingCapability, bE as suppliersCapability, bF as uiCapability, bG as validatePluginAuthor, bH as validateSetupLayout, bI as validateUiContributions } from './host-api-yX49e7zE.mjs';
 
 declare const PAYMENT_PLUGIN_TOKEN: "PAYMENT_PLUGINS";
 declare const SHIPPING_PLUGIN_TOKEN: "SHIPPING_PLUGINS";
@@ -74,7 +74,7 @@ declare function checkPermissions(required: string[], grantedRaw: string[]): Per
  * - MINOR: additive (new optional fields, new tokens) — backwards compatible.
  * - PATCH: docs/fixes with zero shape changes.
  */
-declare const SDK_VERSION = "0.6.6";
+declare const SDK_VERSION = "0.6.7";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-C1VylW5l.js';
-export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsStaticConfig, n as AnalyticsUserData, o as AnalyticsUtm, p as AuthorValidation, B as BannerBlock, q as Block, r as BlockBase, s as BlockType, t as CalloutBlock, u as Capability, v as CapabilityKind, w as CardBlock, x as CodConfig, y as CodFeeConfig, z as CodFeeType, D as ConditionalBlock, E as ConditionalEquals, G as ConditionalWhen, H as ConfigurablePlugin, I as CopyFieldBlock, J as CreateShipmentParams, K as DispatchContext, L as DividerBlock, M as DomainEventHandler, N as DomainEventName, O as EmbedInit, Q as FieldBlock, R as FieldOption, T as FieldVariant, U as GatewayEnvironment, V as GatewayStaticConfig, W as GroupBlock, X as HostApi, Y as HttpClient, Z as HttpRequest, _ as HttpResponse, $ as IAnalyticsPlugin, a0 as IInvoicingPlugin, a1 as IPaymentPlugin, a2 as IPlugin, a3 as IShippingPlugin, a4 as ISuppliersPlugin, a5 as InlineRowBlock, a6 as InvoiceDocumentType, a7 as InvoiceLine, a8 as InvoiceMoney, a9 as InvoiceParty, aa as InvoiceRequest, ab as InvoiceResult, ac as InvoiceStatus, ad as InvoiceTax, ae as InvoicingDefaultConfig, af as InvoicingFeature, ag as InvoicingPluginConfig, ah as InvoicingStaticConfig, ai as KeyValueBlock, aj as KeyValueRow, ak as LayoutMode, al as Logger, am as MarkdownBlock, an as MessageVariant, ao as PaymentCard, ap as PaymentCustomer, aq as PaymentGatewayCode, ar as PaymentPayload, as as PaymentPluginConfig, at as PaymentRenderMode, au as PaymentResult, av as PaymentSessionPayload, aw as PaymentSessionResult, ax as PaymentVerifyPayload, ay as PlaceSupplierOrderInput, az as Plugin, aA as PluginActionContext, aB as PluginActionResult, aC as PluginAuthor, aD as PluginConfigFieldDependency, aE as PluginFactory, aF as PluginManifest, aG as PluginType, aH as RepeaterBlock, aI as RepeaterSource, aJ as SecretStore, aK as SequenceStore, aL as SetupAction, aM as SetupLayout, aN as SetupLayoutValidation, aO as SetupStep, aP as ShipmentAddress, aQ as ShipmentParcel, aR as ShipmentResult, aS as ShippingDefaultConfig, aT as ShippingFeature, aU as ShippingPluginConfig, aV as ShippingQuote, aW as ShippingQuoteParams, aX as ShippingStaticConfig, aY as StepStatusFrom, aZ as StepStatusFromAction, a_ as StepStatusFromFields, a$ as StepStatusSource, b0 as StorageBroker, b1 as SupplierCatalogQuery, b2 as SupplierFulfillmentEvent, b3 as SupplierListing, b4 as SupplierListingAttribute, b5 as SupplierListingPage, b6 as SupplierListingVariant, b7 as SupplierMoney, b8 as SupplierOrderAddressLevel, b9 as SupplierOrderCustomer, ba as SupplierOrderLine, bb as SupplierOrderResult, bc as SupplierOrderStatus, bd as SupplierShipTo, be as SupplierStock, bf as SuppliersDefaultConfig, bg as SuppliersFeature, bh as SuppliersPluginConfig, bi as SuppliersStaticConfig, bj as TabItem, bk as TabsBlock, bl as ToggleBlock, bm as TrackingEvent, bn as TransactionStatus, bo as VoidInvoiceInput, bp as WebhookSignatureResult, bq as analyticsCapability, br as capability, bs as crossValidateSetupLayout, bt as definePlugin, bu as invoicingCapability, bv as isConfigurablePlugin, bw as isPluginFactory, bx as paymentCapability, by as shippingCapability, bz as suppliersCapability, bA as validatePluginAuthor, bB as validateSetupLayout } from './host-api-C1VylW5l.js';
+import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-yX49e7zE.js';
+export { A as AUTHOR_HANDLE_RE, a as AccordionBlock, b as AccordionSection, c as ActionBlock, d as ActionVariant, e as AnalyticsActionSource, f as AnalyticsConsent, g as AnalyticsEvent, h as AnalyticsEventName, i as AnalyticsFeature, j as AnalyticsItem, k as AnalyticsMoney, l as AnalyticsPluginConfig, m as AnalyticsStaticConfig, n as AnalyticsUserData, o as AnalyticsUtm, p as AuthorValidation, B as BannerBlock, q as Block, r as BlockBase, s as BlockType, t as CalloutBlock, u as Capability, v as CapabilityKind, w as CardBlock, x as CodConfig, y as CodFeeConfig, z as CodFeeType, D as ConditionalBlock, E as ConditionalEquals, G as ConditionalWhen, H as ConfigurablePlugin, I as ContentActionVariant, J as ContentBlock, K as ContentBlockType, L as CopyFieldBlock, M as CreateShipmentParams, N as DispatchContext, O as DividerBlock, Q as DomainEventHandler, R as DomainEventName, T as EmbedInit, U as FieldBlock, V as FieldOption, W as FieldVariant, X as GatewayEnvironment, Y as GatewayStaticConfig, Z as GroupBlock, _ as HostApi, $ as HttpClient, a0 as HttpRequest, a1 as HttpResponse, a2 as IAnalyticsPlugin, a3 as IInvoicingPlugin, a4 as IPaymentPlugin, a5 as IPlugin, a6 as IShippingPlugin, a7 as ISuppliersPlugin, a8 as IUiPlugin, a9 as InlineRowBlock, aa as InvoiceDocumentType, ab as InvoiceLine, ac as InvoiceMoney, ad as InvoiceParty, ae as InvoiceRequest, af as InvoiceResult, ag as InvoiceStatus, ah as InvoiceTax, ai as InvoicingDefaultConfig, aj as InvoicingFeature, ak as InvoicingPluginConfig, al as InvoicingStaticConfig, am as KeyValueBlock, an as KeyValueRow, ao as LayoutMode, ap as Logger, aq as MarkdownBlock, ar as MessageVariant, as as PaymentCard, at as PaymentCustomer, au as PaymentGatewayCode, av as PaymentPayload, aw as PaymentPluginConfig, ax as PaymentRenderMode, ay as PaymentResult, az as PaymentSessionPayload, aA as PaymentSessionResult, aB as PaymentVerifyPayload, aC as PlaceSupplierOrderInput, aD as Plugin, aE as PluginActionContext, aF as PluginActionResult, aG as PluginAuthor, aH as PluginConfigFieldDependency, aI as PluginFactory, aJ as PluginManifest, aK as RepeaterBlock, aL as RepeaterSource, aM as SecretStore, aN as SequenceStore, aO as SetupAction, aP as SetupLayout, aQ as SetupLayoutValidation, aR as SetupStep, aS as ShipmentAddress, aT as ShipmentParcel, aU as ShipmentResult, aV as ShippingDefaultConfig, aW as ShippingFeature, aX as ShippingPluginConfig, aY as ShippingQuote, aZ as ShippingQuoteParams, a_ as ShippingStaticConfig, a$ as StepStatusFrom, b0 as StepStatusFromAction, b1 as StepStatusFromFields, b2 as StepStatusSource, b3 as StorageBroker, b4 as SupplierCatalogQuery, b5 as SupplierFulfillmentEvent, b6 as SupplierListing, b7 as SupplierListingAttribute, b8 as SupplierListingPage, b9 as SupplierListingVariant, ba as SupplierMoney, bb as SupplierOrderAddressLevel, bc as SupplierOrderCustomer, bd as SupplierOrderLine, be as SupplierOrderResult, bf as SupplierOrderStatus, bg as SupplierShipTo, bh as SupplierStock, bi as SuppliersDefaultConfig, bj as SuppliersFeature, bk as SuppliersPluginConfig, bl as SuppliersStaticConfig, bm as TabItem, bn as TabsBlock, bo as ToggleBlock, bp as TrackingEvent, bq as TransactionStatus, br as UiContribution, bs as UiContributionsValidation, bt as VoidInvoiceInput, bu as WebhookSignatureResult, bv as analyticsCapability, bw as capability, bx as crossValidateSetupLayout, by as definePlugin, bz as invoicingCapability, bA as isConfigurablePlugin, bB as isPluginFactory, bC as paymentCapability, bD as shippingCapability, bE as suppliersCapability, bF as uiCapability, bG as validatePluginAuthor, bH as validateSetupLayout, bI as validateUiContributions } from './host-api-yX49e7zE.js';
 
 declare const PAYMENT_PLUGIN_TOKEN: "PAYMENT_PLUGINS";
 declare const SHIPPING_PLUGIN_TOKEN: "SHIPPING_PLUGINS";
@@ -74,7 +74,7 @@ declare function checkPermissions(required: string[], grantedRaw: string[]): Per
  * - MINOR: additive (new optional fields, new tokens) — backwards compatible.
  * - PATCH: docs/fixes with zero shape changes.
  */
-declare const SDK_VERSION = "0.6.6";
+declare const SDK_VERSION = "0.6.7";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.

package/dist/index.js

@@ -28,6 +28,8 @@ __export(index_exports, {
   CapabilityKind: () => CapabilityKind,
   CodFeeType: () => CodFeeType,
   ConfigScope: () => ConfigScope,
+  ContentActionVariant: () => ContentActionVariant,
+  ContentBlockType: () => ContentBlockType,
   FieldType: () => FieldType,
   FieldVariant: () => FieldVariant,
   GatewayEnvironment: () => GatewayEnvironment,
@@ -38,7 +40,6 @@ __export(index_exports, {
   LayoutMode: () => LayoutMode,
   MessageVariant: () => MessageVariant,
   PAYMENT_PLUGIN_TOKEN: () => PAYMENT_PLUGIN_TOKEN,
-  PluginType: () => PluginType,
   RepeaterSource: () => RepeaterSource,
   SDK_VERSION: () => SDK_VERSION,
   SHIPPING_PLUGIN_TOKEN: () => SHIPPING_PLUGIN_TOKEN,
@@ -63,8 +64,10 @@ __export(index_exports, {
   paymentCapability: () => paymentCapability,
   shippingCapability: () => shippingCapability,
   suppliersCapability: () => suppliersCapability,
+  uiCapability: () => uiCapability,
   validatePluginAuthor: () => validatePluginAuthor,
-  validateSetupLayout: () => validateSetupLayout
+  validateSetupLayout: () => validateSetupLayout,
+  validateUiContributions: () => validateUiContributions
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -76,14 +79,6 @@ var ANALYTICS_PLUGIN_TOKEN = "ANALYTICS_PLUGINS";
 var INVOICING_PLUGIN_TOKEN = "INVOICING_PLUGINS";
 
 // src/plugin.ts
-var PluginType = /* @__PURE__ */ ((PluginType2) => {
-  PluginType2["Payment"] = "payment";
-  PluginType2["Shipping"] = "shipping";
-  PluginType2["Analytics"] = "analytics";
-  PluginType2["Invoicing"] = "invoicing";
-  PluginType2["Generic"] = "generic";
-  return PluginType2;
-})(PluginType || {});
 var MessageVariant = /* @__PURE__ */ ((MessageVariant2) => {
   MessageVariant2["Info"] = "info";
   MessageVariant2["Warning"] = "warning";
@@ -340,6 +335,7 @@ var sGroupBlock = (0, import_superstruct2.object)({
   type: (0, import_superstruct2.literal)("group" /* Group */),
   title: (0, import_superstruct2.string)(),
   description: (0, import_superstruct2.optional)((0, import_superstruct2.string)()),
+  helpUrl: (0, import_superstruct2.optional)((0, import_superstruct2.string)()),
   fields: (0, import_superstruct2.array)((0, import_superstruct2.string)()),
   collapsible: (0, import_superstruct2.optional)((0, import_superstruct2.boolean)()),
   defaultOpen: (0, import_superstruct2.optional)((0, import_superstruct2.boolean)()),
@@ -536,13 +532,124 @@ function crossValidateSetupLayout(layout, configSchema) {
   return errors;
 }
 
+// src/ui.ts
+var import_superstruct3 = require("superstruct");
+var ContentBlockType = /* @__PURE__ */ ((ContentBlockType2) => {
+  ContentBlockType2["Text"] = "text";
+  ContentBlockType2["Banner"] = "banner";
+  ContentBlockType2["Badge"] = "badge";
+  ContentBlockType2["KeyValue"] = "keyValue";
+  ContentBlockType2["CopyField"] = "copyField";
+  ContentBlockType2["Link"] = "link";
+  ContentBlockType2["Divider"] = "divider";
+  ContentBlockType2["Action"] = "action";
+  ContentBlockType2["Card"] = "card";
+  return ContentBlockType2;
+})(ContentBlockType || {});
+var ContentActionVariant = /* @__PURE__ */ ((ContentActionVariant2) => {
+  ContentActionVariant2["Primary"] = "primary";
+  ContentActionVariant2["Secondary"] = "secondary";
+  ContentActionVariant2["Danger"] = "danger";
+  return ContentActionVariant2;
+})(ContentActionVariant || {});
+var sMessageVariant2 = (0, import_superstruct3.enums)(Object.values(MessageVariant));
+var sContentActionVariant = (0, import_superstruct3.enums)(Object.values(ContentActionVariant));
+var sTextBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("text" /* Text */),
+  content: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)())
+});
+var sBannerBlock2 = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("banner" /* Banner */),
+  variant: sMessageVariant2,
+  title: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  text: (0, import_superstruct3.string)()
+});
+var sBadgeBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("badge" /* Badge */),
+  variant: sMessageVariant2,
+  text: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)())
+});
+var sKeyValueBlock2 = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("keyValue" /* KeyValue */),
+  rows: (0, import_superstruct3.array)(
+    (0, import_superstruct3.object)({
+      label: (0, import_superstruct3.string)(),
+      value: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+      computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)())
+    })
+  )
+});
+var sCopyFieldBlock2 = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("copyField" /* CopyField */),
+  label: (0, import_superstruct3.string)(),
+  value: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)())
+});
+var sLinkBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("link" /* Link */),
+  label: (0, import_superstruct3.string)(),
+  href: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  external: (0, import_superstruct3.optional)((0, import_superstruct3.boolean)())
+});
+var sDividerBlock2 = (0, import_superstruct3.object)({ type: (0, import_superstruct3.literal)("divider" /* Divider */) });
+var sActionBlock2 = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("action" /* Action */),
+  id: (0, import_superstruct3.string)(),
+  label: (0, import_superstruct3.string)(),
+  variant: (0, import_superstruct3.optional)(sContentActionVariant)
+});
+var sCardBlock2 = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("card" /* Card */),
+  title: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  description: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  blocks: (0, import_superstruct3.array)((0, import_superstruct3.lazy)(() => sContentBlock))
+});
+var sContentBlock = (0, import_superstruct3.union)([
+  sTextBlock,
+  sBannerBlock2,
+  sBadgeBlock,
+  sKeyValueBlock2,
+  sCopyFieldBlock2,
+  sLinkBlock,
+  sDividerBlock2,
+  sActionBlock2,
+  sCardBlock2
+]);
+var sUiContribution = (0, import_superstruct3.object)({
+  slot: (0, import_superstruct3.string)(),
+  blocks: (0, import_superstruct3.array)(sContentBlock),
+  order: (0, import_superstruct3.optional)((0, import_superstruct3.number)())
+});
+function validateUiContributions(input) {
+  const [error, result] = (0, import_superstruct3.validate)(input, (0, import_superstruct3.array)(sUiContribution));
+  if (error) {
+    return {
+      success: false,
+      errors: error.failures().map((f) => {
+        const path = f.path.join(".");
+        return path ? `${path}: ${f.message}` : f.message;
+      })
+    };
+  }
+  return { success: true, data: result };
+}
+
 // src/capability.ts
 var CapabilityKind = {
   Payment: "payment",
   Shipping: "shipping",
   Suppliers: "suppliers",
   Analytics: "analytics",
-  Invoicing: "invoicing"
+  Invoicing: "invoicing",
+  /**
+   * Cross-cutting DISPLAY capability: a plugin of ANY surface may ALSO expose
+   * `ui` to contribute declarative blocks into host slots. Not a catalog
+   * "surface" — the host's AppSurface derivation excludes it on purpose.
+   */
+  Ui: "ui"
 };
 function capability(kind, impl) {
   return { kind, impl };
@@ -562,6 +669,9 @@ function analyticsCapability(impl) {
 function invoicingCapability(impl) {
   return { kind: CapabilityKind.Invoicing, impl };
 }
+function uiCapability(impl) {
+  return { kind: CapabilityKind.Ui, impl };
+}
 var PLUGIN_FACTORY_BRAND = /* @__PURE__ */ Symbol.for("vivoa.plugin.factory");
 function definePlugin(factory) {
   Object.defineProperty(factory, PLUGIN_FACTORY_BRAND, {
@@ -607,7 +717,7 @@ function checkPermissions(required, grantedRaw) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.6.6";
+var SDK_VERSION = "0.6.7";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -632,6 +742,8 @@ function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   CapabilityKind,
   CodFeeType,
   ConfigScope,
+  ContentActionVariant,
+  ContentBlockType,
   FieldType,
   FieldVariant,
   GatewayEnvironment,
@@ -642,7 +754,6 @@ function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   LayoutMode,
   MessageVariant,
   PAYMENT_PLUGIN_TOKEN,
-  PluginType,
   RepeaterSource,
   SDK_VERSION,
   SHIPPING_PLUGIN_TOKEN,
@@ -667,6 +778,8 @@ function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   paymentCapability,
   shippingCapability,
   suppliersCapability,
+  uiCapability,
   validatePluginAuthor,
-  validateSetupLayout
+  validateSetupLayout,
+  validateUiContributions
 });

package/dist/index.mjs

@@ -12,14 +12,6 @@ var ANALYTICS_PLUGIN_TOKEN = "ANALYTICS_PLUGINS";
 var INVOICING_PLUGIN_TOKEN = "INVOICING_PLUGINS";
 
 // src/plugin.ts
-var PluginType = /* @__PURE__ */ ((PluginType2) => {
-  PluginType2["Payment"] = "payment";
-  PluginType2["Shipping"] = "shipping";
-  PluginType2["Analytics"] = "analytics";
-  PluginType2["Invoicing"] = "invoicing";
-  PluginType2["Generic"] = "generic";
-  return PluginType2;
-})(PluginType || {});
 var MessageVariant = /* @__PURE__ */ ((MessageVariant2) => {
   MessageVariant2["Info"] = "info";
   MessageVariant2["Warning"] = "warning";
@@ -297,6 +289,7 @@ var sGroupBlock = object({
   type: literal("group" /* Group */),
   title: string2(),
   description: optional2(string2()),
+  helpUrl: optional2(string2()),
   fields: array(string2()),
   collapsible: optional2(boolean2()),
   defaultOpen: optional2(boolean2()),
@@ -493,13 +486,136 @@ function crossValidateSetupLayout(layout, configSchema) {
   return errors;
 }
 
+// src/ui.ts
+import {
+  array as array2,
+  boolean as boolean3,
+  enums as enums3,
+  lazy as lazy2,
+  literal as literal2,
+  number as number3,
+  object as object2,
+  optional as optional3,
+  string as string3,
+  union as union2,
+  validate as validate3
+} from "superstruct";
+var ContentBlockType = /* @__PURE__ */ ((ContentBlockType2) => {
+  ContentBlockType2["Text"] = "text";
+  ContentBlockType2["Banner"] = "banner";
+  ContentBlockType2["Badge"] = "badge";
+  ContentBlockType2["KeyValue"] = "keyValue";
+  ContentBlockType2["CopyField"] = "copyField";
+  ContentBlockType2["Link"] = "link";
+  ContentBlockType2["Divider"] = "divider";
+  ContentBlockType2["Action"] = "action";
+  ContentBlockType2["Card"] = "card";
+  return ContentBlockType2;
+})(ContentBlockType || {});
+var ContentActionVariant = /* @__PURE__ */ ((ContentActionVariant2) => {
+  ContentActionVariant2["Primary"] = "primary";
+  ContentActionVariant2["Secondary"] = "secondary";
+  ContentActionVariant2["Danger"] = "danger";
+  return ContentActionVariant2;
+})(ContentActionVariant || {});
+var sMessageVariant2 = enums3(Object.values(MessageVariant));
+var sContentActionVariant = enums3(Object.values(ContentActionVariant));
+var sTextBlock = object2({
+  type: literal2("text" /* Text */),
+  content: optional3(string3()),
+  computedKey: optional3(string3())
+});
+var sBannerBlock2 = object2({
+  type: literal2("banner" /* Banner */),
+  variant: sMessageVariant2,
+  title: optional3(string3()),
+  text: string3()
+});
+var sBadgeBlock = object2({
+  type: literal2("badge" /* Badge */),
+  variant: sMessageVariant2,
+  text: optional3(string3()),
+  computedKey: optional3(string3())
+});
+var sKeyValueBlock2 = object2({
+  type: literal2("keyValue" /* KeyValue */),
+  rows: array2(
+    object2({
+      label: string3(),
+      value: optional3(string3()),
+      computedKey: optional3(string3())
+    })
+  )
+});
+var sCopyFieldBlock2 = object2({
+  type: literal2("copyField" /* CopyField */),
+  label: string3(),
+  value: optional3(string3()),
+  computedKey: optional3(string3())
+});
+var sLinkBlock = object2({
+  type: literal2("link" /* Link */),
+  label: string3(),
+  href: optional3(string3()),
+  computedKey: optional3(string3()),
+  external: optional3(boolean3())
+});
+var sDividerBlock2 = object2({ type: literal2("divider" /* Divider */) });
+var sActionBlock2 = object2({
+  type: literal2("action" /* Action */),
+  id: string3(),
+  label: string3(),
+  variant: optional3(sContentActionVariant)
+});
+var sCardBlock2 = object2({
+  type: literal2("card" /* Card */),
+  title: optional3(string3()),
+  description: optional3(string3()),
+  blocks: array2(lazy2(() => sContentBlock))
+});
+var sContentBlock = union2([
+  sTextBlock,
+  sBannerBlock2,
+  sBadgeBlock,
+  sKeyValueBlock2,
+  sCopyFieldBlock2,
+  sLinkBlock,
+  sDividerBlock2,
+  sActionBlock2,
+  sCardBlock2
+]);
+var sUiContribution = object2({
+  slot: string3(),
+  blocks: array2(sContentBlock),
+  order: optional3(number3())
+});
+function validateUiContributions(input) {
+  const [error, result] = validate3(input, array2(sUiContribution));
+  if (error) {
+    return {
+      success: false,
+      errors: error.failures().map((f) => {
+        const path = f.path.join(".");
+        return path ? `${path}: ${f.message}` : f.message;
+      })
+    };
+  }
+  return { success: true, data: result };
+}
+
 // src/capability.ts
 var CapabilityKind = {
   Payment: "payment",
   Shipping: "shipping",
   Suppliers: "suppliers",
   Analytics: "analytics",
-  Invoicing: "invoicing"
+  Invoicing: "invoicing",
+  /**
+   * Cross-cutting DISPLAY capability: a plugin of ANY surface may ALSO expose
+   * `ui` to contribute declarative blocks into host slots. Not a catalog
+   * "surface" — the host's AppSurface derivation excludes it on purpose.
+   */
+  Ui: "ui"
 };
 function capability(kind, impl) {
   return { kind, impl };
@@ -519,6 +635,9 @@ function analyticsCapability(impl) {
 function invoicingCapability(impl) {
   return { kind: CapabilityKind.Invoicing, impl };
 }
+function uiCapability(impl) {
+  return { kind: CapabilityKind.Ui, impl };
+}
 var PLUGIN_FACTORY_BRAND = /* @__PURE__ */ Symbol.for("vivoa.plugin.factory");
 function definePlugin(factory) {
   Object.defineProperty(factory, PLUGIN_FACTORY_BRAND, {
@@ -532,7 +651,7 @@ function isPluginFactory(value) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.6.6";
+var SDK_VERSION = "0.6.7";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -556,6 +675,8 @@ export {
   CapabilityKind,
   CodFeeType,
   ConfigScope,
+  ContentActionVariant,
+  ContentBlockType,
   FieldType,
   FieldVariant,
   GatewayEnvironment,
@@ -566,7 +687,6 @@ export {
   LayoutMode,
   MessageVariant,
   PAYMENT_PLUGIN_TOKEN,
-  PluginType,
   RepeaterSource,
   SDK_VERSION,
   SHIPPING_PLUGIN_TOKEN,
@@ -591,6 +711,8 @@ export {
   paymentCapability,
   shippingCapability,
   suppliersCapability,
+  uiCapability,
   validatePluginAuthor,
-  validateSetupLayout
+  validateSetupLayout,
+  validateUiContributions
 };

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { X as HostApi, Z as HttpRequest, N as DomainEventName, u as Capability, M as DomainEventHandler, _ as HttpResponse, K as DispatchContext } from '../host-api-C1VylW5l.mjs';
+import { _ as HostApi, a0 as HttpRequest, R as DomainEventName, u as Capability, Q as DomainEventHandler, a1 as HttpResponse, N as DispatchContext } from '../host-api-yX49e7zE.mjs';
 
 /** Every recorded interaction, keyed by `"port.method"`. */
 interface MockHostCalls {

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { X as HostApi, Z as HttpRequest, N as DomainEventName, u as Capability, M as DomainEventHandler, _ as HttpResponse, K as DispatchContext } from '../host-api-C1VylW5l.js';
+import { _ as HostApi, a0 as HttpRequest, R as DomainEventName, u as Capability, Q as DomainEventHandler, a1 as HttpResponse, N as DispatchContext } from '../host-api-yX49e7zE.js';
 
 /** Every recorded interaction, keyed by `"port.method"`. */
 interface MockHostCalls {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivoa/plugin-sdk",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "description": "Public contracts for Vivoa plugins (types, DI tokens, config + setup-layout validators)",
   "license": "MIT",
   "author": "Vivoa",
@@ -39,6 +39,14 @@
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
+  "scripts": {
+    "build": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --clean --target node18",
+    "dev": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --watch --target node18",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "prepublishOnly": "pnpm run typecheck && pnpm run test && pnpm run build"
+  },
   "dependencies": {
     "superstruct": "^2.0.2"
   },
@@ -47,12 +55,5 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.3",
     "vitest": "^2.1.8"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --clean --target node18",
-    "dev": "tsup src/index.ts src/testing/index.ts --format cjs,esm --dts --watch --target node18",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit -p tsconfig.json"
   }
-}
+}