@vivoa/plugin-sdk 0.6.6 → 0.6.8

package/dist/{host-api-C1VylW5l.d.mts → host-api-BbIT_sLc.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",
@@ -544,6 +540,40 @@ interface WebhookSignatureResult {
     isValid: boolean;
     error?: string;
 }
+/**
+ * "Connect" handshake (authorization code + PKCE) a gateway can offer so a
+ * merchant links their account with one click instead of pasting credentials.
+ * The HOST owns state, code_verifier and the callback route; the plugin only
+ * knows the gateway's URLs and wire format. STATELESS like every other verb.
+ */
+interface PaymentConnectParams {
+    /** Opaque anti-CSRF value; echoed back on the callback. */
+    state: string;
+    /** base64url(SHA-256(code_verifier)) — S256. */
+    codeChallenge: string;
+    /** Host callback the gateway redirects the merchant to (`?code&state`). */
+    redirectUri: string;
+    /** Host webhook endpoint for this gateway, to register on the gateway side. */
+    webhookUrl: string;
+    /** Store origin (https://host) — the only origin the gateway may wire to. */
+    origin: string;
+    /** Store display name, shown on the gateway's consent screen. */
+    storeName: string;
+}
+interface PaymentConnectExchange {
+    code: string;
+    codeVerifier: string;
+    redirectUri: string;
+}
+interface PaymentConnect {
+    /** Where to send the merchant to log in and approve the store. */
+    authorizeUrl(params: PaymentConnectParams, ctx: DispatchContext): string;
+    /**
+     * Redeem the authorization code. Returns a CONFIG PATCH (credentials etc.)
+     * the host persists exactly like an admin save.
+     */
+    exchange(params: PaymentConnectExchange, ctx: DispatchContext): Promise<Record<string, unknown>>;
+}
 interface IPaymentPlugin extends IPlugin {
     readonly gatewayCode: PaymentGatewayCode;
     readonly staticConfig: GatewayStaticConfig;
@@ -568,6 +598,8 @@ interface IPaymentPlugin extends IPlugin {
      * call via `ctx.config` (INV-4); no card data is ever passed here (INV-1).
      */
     createPaymentSession?(payload: PaymentSessionPayload, ctx: DispatchContext): Promise<PaymentSessionResult>;
+    /** OPTIONAL one-click account linking (see {@link PaymentConnect}). */
+    readonly connect?: PaymentConnect;
 }
 
 declare enum ShippingFeature {
@@ -608,6 +640,8 @@ interface ShippingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: ShippingFeature[];
     configSchema: PluginConfigField[];
@@ -750,6 +784,8 @@ interface SuppliersStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedCapabilities: SuppliersFeature[];
     configSchema: PluginConfigField[];
@@ -1054,6 +1090,8 @@ interface AnalyticsStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCapabilities: AnalyticsFeature[];
     configSchema: PluginConfigField[];
 }
@@ -1257,6 +1295,8 @@ interface InvoicingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: InvoicingFeature[];
     supportedDocumentTypes: InvoiceDocumentType[];
@@ -1290,6 +1330,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 +1452,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 +1466,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 +1566,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, type ShippingQuote 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 PaymentRenderMode as aA, type PaymentResult as aB, type PaymentSessionPayload as aC, type PaymentSessionResult as aD, type PaymentVerifyPayload as aE, type PlaceSupplierOrderInput as aF, type Plugin as aG, type PluginActionContext as aH, type PluginActionResult as aI, type PluginAuthor as aJ, type PluginConfigFieldDependency as aK, type PluginFactory as aL, type PluginManifest as aM, type RepeaterBlock as aN, RepeaterSource as aO, type SecretStore as aP, type SequenceStore as aQ, type SetupAction as aR, type SetupLayout as aS, type SetupLayoutValidation as aT, type SetupStep as aU, type ShipmentAddress as aV, type ShipmentParcel as aW, type ShipmentResult as aX, type ShippingDefaultConfig as aY, ShippingFeature as aZ, type ShippingPluginConfig 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 PaymentConnect as at, type PaymentConnectExchange as au, type PaymentConnectParams as av, type PaymentCustomer as aw, type PaymentGatewayCode as ax, type PaymentPayload as ay, type PaymentPluginConfig as az, type AccordionSection as b, type ShippingQuoteParams as b0, type ShippingStaticConfig as b1, StepStatusFrom as b2, type StepStatusFromAction as b3, type StepStatusFromFields as b4, type StepStatusSource as b5, type StorageBroker as b6, type SupplierCatalogQuery as b7, type SupplierFulfillmentEvent as b8, type SupplierListing as b9, crossValidateSetupLayout as bA, definePlugin as bB, invoicingCapability as bC, isConfigurablePlugin as bD, isPluginFactory as bE, paymentCapability as bF, shippingCapability as bG, suppliersCapability as bH, uiCapability as bI, validatePluginAuthor as bJ, validateSetupLayout as bK, validateUiContributions as bL, type SupplierListingAttribute as ba, type SupplierListingPage as bb, type SupplierListingVariant as bc, type SupplierMoney as bd, type SupplierOrderAddressLevel as be, type SupplierOrderCustomer as bf, type SupplierOrderLine as bg, type SupplierOrderResult as bh, type SupplierOrderStatus as bi, type SupplierShipTo as bj, type SupplierStock as bk, type SuppliersDefaultConfig as bl, SuppliersFeature as bm, type SuppliersPluginConfig as bn, type SuppliersStaticConfig as bo, type TabItem as bp, type TabsBlock as bq, type ToggleBlock as br, type TrackingEvent as bs, TransactionStatus as bt, type UiContribution as bu, type UiContributionsValidation as bv, type VoidInvoiceInput as bw, type WebhookSignatureResult as bx, analyticsCapability as by, capability 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-BbIT_sLc.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",
@@ -544,6 +540,40 @@ interface WebhookSignatureResult {
     isValid: boolean;
     error?: string;
 }
+/**
+ * "Connect" handshake (authorization code + PKCE) a gateway can offer so a
+ * merchant links their account with one click instead of pasting credentials.
+ * The HOST owns state, code_verifier and the callback route; the plugin only
+ * knows the gateway's URLs and wire format. STATELESS like every other verb.
+ */
+interface PaymentConnectParams {
+    /** Opaque anti-CSRF value; echoed back on the callback. */
+    state: string;
+    /** base64url(SHA-256(code_verifier)) — S256. */
+    codeChallenge: string;
+    /** Host callback the gateway redirects the merchant to (`?code&state`). */
+    redirectUri: string;
+    /** Host webhook endpoint for this gateway, to register on the gateway side. */
+    webhookUrl: string;
+    /** Store origin (https://host) — the only origin the gateway may wire to. */
+    origin: string;
+    /** Store display name, shown on the gateway's consent screen. */
+    storeName: string;
+}
+interface PaymentConnectExchange {
+    code: string;
+    codeVerifier: string;
+    redirectUri: string;
+}
+interface PaymentConnect {
+    /** Where to send the merchant to log in and approve the store. */
+    authorizeUrl(params: PaymentConnectParams, ctx: DispatchContext): string;
+    /**
+     * Redeem the authorization code. Returns a CONFIG PATCH (credentials etc.)
+     * the host persists exactly like an admin save.
+     */
+    exchange(params: PaymentConnectExchange, ctx: DispatchContext): Promise<Record<string, unknown>>;
+}
 interface IPaymentPlugin extends IPlugin {
     readonly gatewayCode: PaymentGatewayCode;
     readonly staticConfig: GatewayStaticConfig;
@@ -568,6 +598,8 @@ interface IPaymentPlugin extends IPlugin {
      * call via `ctx.config` (INV-4); no card data is ever passed here (INV-1).
      */
     createPaymentSession?(payload: PaymentSessionPayload, ctx: DispatchContext): Promise<PaymentSessionResult>;
+    /** OPTIONAL one-click account linking (see {@link PaymentConnect}). */
+    readonly connect?: PaymentConnect;
 }
 
 declare enum ShippingFeature {
@@ -608,6 +640,8 @@ interface ShippingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: ShippingFeature[];
     configSchema: PluginConfigField[];
@@ -750,6 +784,8 @@ interface SuppliersStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedCapabilities: SuppliersFeature[];
     configSchema: PluginConfigField[];
@@ -1054,6 +1090,8 @@ interface AnalyticsStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCapabilities: AnalyticsFeature[];
     configSchema: PluginConfigField[];
 }
@@ -1257,6 +1295,8 @@ interface InvoicingStaticConfig {
     displayName: string;
     description: string;
     iconUrl?: string;
+    authorName?: string;
+    authorUrl?: string;
     supportedCountries: string[];
     supportedFeatures: InvoicingFeature[];
     supportedDocumentTypes: InvoiceDocumentType[];
@@ -1290,6 +1330,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 +1452,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 +1466,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 +1566,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, type ShippingQuote 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 PaymentRenderMode as aA, type PaymentResult as aB, type PaymentSessionPayload as aC, type PaymentSessionResult as aD, type PaymentVerifyPayload as aE, type PlaceSupplierOrderInput as aF, type Plugin as aG, type PluginActionContext as aH, type PluginActionResult as aI, type PluginAuthor as aJ, type PluginConfigFieldDependency as aK, type PluginFactory as aL, type PluginManifest as aM, type RepeaterBlock as aN, RepeaterSource as aO, type SecretStore as aP, type SequenceStore as aQ, type SetupAction as aR, type SetupLayout as aS, type SetupLayoutValidation as aT, type SetupStep as aU, type ShipmentAddress as aV, type ShipmentParcel as aW, type ShipmentResult as aX, type ShippingDefaultConfig as aY, ShippingFeature as aZ, type ShippingPluginConfig 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 PaymentConnect as at, type PaymentConnectExchange as au, type PaymentConnectParams as av, type PaymentCustomer as aw, type PaymentGatewayCode as ax, type PaymentPayload as ay, type PaymentPluginConfig as az, type AccordionSection as b, type ShippingQuoteParams as b0, type ShippingStaticConfig as b1, StepStatusFrom as b2, type StepStatusFromAction as b3, type StepStatusFromFields as b4, type StepStatusSource as b5, type StorageBroker as b6, type SupplierCatalogQuery as b7, type SupplierFulfillmentEvent as b8, type SupplierListing as b9, crossValidateSetupLayout as bA, definePlugin as bB, invoicingCapability as bC, isConfigurablePlugin as bD, isPluginFactory as bE, paymentCapability as bF, shippingCapability as bG, suppliersCapability as bH, uiCapability as bI, validatePluginAuthor as bJ, validateSetupLayout as bK, validateUiContributions as bL, type SupplierListingAttribute as ba, type SupplierListingPage as bb, type SupplierListingVariant as bc, type SupplierMoney as bd, type SupplierOrderAddressLevel as be, type SupplierOrderCustomer as bf, type SupplierOrderLine as bg, type SupplierOrderResult as bh, type SupplierOrderStatus as bi, type SupplierShipTo as bj, type SupplierStock as bk, type SuppliersDefaultConfig as bl, SuppliersFeature as bm, type SuppliersPluginConfig as bn, type SuppliersStaticConfig as bo, type TabItem as bp, type TabsBlock as bq, type ToggleBlock as br, type TrackingEvent as bs, TransactionStatus as bt, type UiContribution as bu, type UiContributionsValidation as bv, type VoidInvoiceInput as bw, type WebhookSignatureResult as bx, analyticsCapability as by, capability 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-BbIT_sLc.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 PaymentConnect, au as PaymentConnectExchange, av as PaymentConnectParams, aw as PaymentCustomer, ax as PaymentGatewayCode, ay as PaymentPayload, az as PaymentPluginConfig, aA as PaymentRenderMode, aB as PaymentResult, aC as PaymentSessionPayload, aD as PaymentSessionResult, aE as PaymentVerifyPayload, aF as PlaceSupplierOrderInput, aG as Plugin, aH as PluginActionContext, aI as PluginActionResult, aJ as PluginAuthor, aK as PluginConfigFieldDependency, aL as PluginFactory, aM as PluginManifest, aN as RepeaterBlock, aO as RepeaterSource, aP as SecretStore, aQ as SequenceStore, aR as SetupAction, aS as SetupLayout, aT as SetupLayoutValidation, aU as SetupStep, aV as ShipmentAddress, aW as ShipmentParcel, aX as ShipmentResult, aY as ShippingDefaultConfig, aZ as ShippingFeature, a_ as ShippingPluginConfig, a$ as ShippingQuote, b0 as ShippingQuoteParams, b1 as ShippingStaticConfig, b2 as StepStatusFrom, b3 as StepStatusFromAction, b4 as StepStatusFromFields, b5 as StepStatusSource, b6 as StorageBroker, b7 as SupplierCatalogQuery, b8 as SupplierFulfillmentEvent, b9 as SupplierListing, ba as SupplierListingAttribute, bb as SupplierListingPage, bc as SupplierListingVariant, bd as SupplierMoney, be as SupplierOrderAddressLevel, bf as SupplierOrderCustomer, bg as SupplierOrderLine, bh as SupplierOrderResult, bi as SupplierOrderStatus, bj as SupplierShipTo, bk as SupplierStock, bl as SuppliersDefaultConfig, bm as SuppliersFeature, bn as SuppliersPluginConfig, bo as SuppliersStaticConfig, bp as TabItem, bq as TabsBlock, br as ToggleBlock, bs as TrackingEvent, bt as TransactionStatus, bu as UiContribution, bv as UiContributionsValidation, bw as VoidInvoiceInput, bx as WebhookSignatureResult, by as analyticsCapability, bz as capability, bA as crossValidateSetupLayout, bB as definePlugin, bC as invoicingCapability, bD as isConfigurablePlugin, bE as isPluginFactory, bF as paymentCapability, bG as shippingCapability, bH as suppliersCapability, bI as uiCapability, bJ as validatePluginAuthor, bK as validateSetupLayout, bL as validateUiContributions } from './host-api-BbIT_sLc.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.8";
 /**
  * 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-BbIT_sLc.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 PaymentConnect, au as PaymentConnectExchange, av as PaymentConnectParams, aw as PaymentCustomer, ax as PaymentGatewayCode, ay as PaymentPayload, az as PaymentPluginConfig, aA as PaymentRenderMode, aB as PaymentResult, aC as PaymentSessionPayload, aD as PaymentSessionResult, aE as PaymentVerifyPayload, aF as PlaceSupplierOrderInput, aG as Plugin, aH as PluginActionContext, aI as PluginActionResult, aJ as PluginAuthor, aK as PluginConfigFieldDependency, aL as PluginFactory, aM as PluginManifest, aN as RepeaterBlock, aO as RepeaterSource, aP as SecretStore, aQ as SequenceStore, aR as SetupAction, aS as SetupLayout, aT as SetupLayoutValidation, aU as SetupStep, aV as ShipmentAddress, aW as ShipmentParcel, aX as ShipmentResult, aY as ShippingDefaultConfig, aZ as ShippingFeature, a_ as ShippingPluginConfig, a$ as ShippingQuote, b0 as ShippingQuoteParams, b1 as ShippingStaticConfig, b2 as StepStatusFrom, b3 as StepStatusFromAction, b4 as StepStatusFromFields, b5 as StepStatusSource, b6 as StorageBroker, b7 as SupplierCatalogQuery, b8 as SupplierFulfillmentEvent, b9 as SupplierListing, ba as SupplierListingAttribute, bb as SupplierListingPage, bc as SupplierListingVariant, bd as SupplierMoney, be as SupplierOrderAddressLevel, bf as SupplierOrderCustomer, bg as SupplierOrderLine, bh as SupplierOrderResult, bi as SupplierOrderStatus, bj as SupplierShipTo, bk as SupplierStock, bl as SuppliersDefaultConfig, bm as SuppliersFeature, bn as SuppliersPluginConfig, bo as SuppliersStaticConfig, bp as TabItem, bq as TabsBlock, br as ToggleBlock, bs as TrackingEvent, bt as TransactionStatus, bu as UiContribution, bv as UiContributionsValidation, bw as VoidInvoiceInput, bx as WebhookSignatureResult, by as analyticsCapability, bz as capability, bA as crossValidateSetupLayout, bB as definePlugin, bC as invoicingCapability, bD as isConfigurablePlugin, bE as isPluginFactory, bF as paymentCapability, bG as shippingCapability, bH as suppliersCapability, bI as uiCapability, bJ as validatePluginAuthor, bK as validateSetupLayout, bL as validateUiContributions } from './host-api-BbIT_sLc.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.8";
 /**
  * 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.8";
 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.8";
 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-BbIT_sLc.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-BbIT_sLc.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.8",
   "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"
   }
-}
+}