@vivoa/plugin-sdk 0.7.0 → 0.7.2

package/dist/{host-api-CuLAVsQ2.d.mts → host-api-C5EsRbsA.d.mts}

@@ -332,6 +332,13 @@ interface PluginManifest {
      * `developer` string first-party manifests used to carry.
      */
     author?: PluginAuthor;
+    /**
+     * Catalog access hint. `restricted` = the store asks the platform for an
+     * entitlement before ENABLING the app (paid/granted apps). Absent or
+     * `public` = no entitlement check. Informational for the host: the platform
+     * stays the authority on who is allowed.
+     */
+    access?: 'public' | 'restricted';
     /**
      * Declarative admin setup screen. When omitted, host renders the legacy
      * auto-form derived from the plugin's configSchema.
@@ -984,6 +991,12 @@ interface SupplierStock {
 interface SupplierListing {
     /** Native id in the supplier catalog (product or catalog-item id). */
     externalId: string;
+    /**
+     * When `externalId` is an item of the SELLER's catalog (e.g. Drop's
+     * catalogId), the id of the marketplace product it wraps: the one the
+     * supplier's public catalog uses. Absent when both are the same id.
+     */
+    catalogProductId?: string | null;
     title: string;
     description?: string | null;
     sku?: string | null;
@@ -1573,8 +1586,44 @@ declare enum ContentBlockType {
     Link = "link",
     Divider = "divider",
     Action = "action",
-    Card = "card"
+    Card = "card",
+    /** Headline metric (label + pre-formatted value). Pure JSON data. */
+    Stat = "stat",
+    /** Read-only table of scalar cells. Pure JSON data. */
+    Table = "table",
+    /** Simple bar/line chart over labelled series. Pure JSON data. */
+    Chart = "chart",
+    /**
+     * Segmented choice bound to a page param (e.g. `days`). Picking an option
+     * makes the host re-resolve the slot with `params[param] = value`. A VIEW
+     * control, not config input: it never writes plugin settings.
+     */
+    Filter = "filter",
+    /** Lays its child blocks side by side in N responsive columns. */
+    Grid = "grid",
+    /** Free-text box bound to a page param (debounced by the host). */
+    Search = "search",
+    /** Collapsible section (closed by default): "how to read this", details. */
+    Details = "details",
+    /** One row of view controls (search, filters, links) above a list. */
+    Toolbar = "toolbar"
 }
+/**
+ * A patch over the page params, for IN-PAGE navigation (links, table rows,
+ * stats): the host merges it into the current params; `null` removes one.
+ * It navigates (history entry, so "back" works); filters only replace.
+ */
+type PageParams = Record<string, string | null>;
+/**
+ * Host-owned slots the SDK knows by name. `slot` stays a free string on the
+ * wire (an older host ignores a slot it does not know); these constants only
+ * give first-party plugins one spelling.
+ */
+declare const UiSlot: {
+    /** Full-page surface of an app in the admin (the app owns the whole body). */
+    readonly AdminAppPage: "admin:app.page";
+};
+type UiSlot = (typeof UiSlot)[keyof typeof UiSlot];
 declare enum ContentActionVariant {
     Primary = "primary",
     Secondary = "secondary",
@@ -1624,6 +1673,8 @@ interface LinkBlock {
     href?: string;
     computedKey?: string;
     external?: boolean;
+    /** In-page navigation instead of `href` (see `PageParams`). */
+    params?: PageParams;
 }
 interface DividerBlock {
     type: ContentBlockType.Divider;
@@ -1646,7 +1697,158 @@ interface CardBlock {
     description?: string;
     blocks: ContentBlock[];
 }
-type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock;
+/**
+ * Headline metric. `value` is already formatted by the plugin (the host does
+ * not guess units/locale). `estimate: true` makes the host label it as an
+ * ESTIMATE next to the value, so a derived number is never shown as a fact.
+ */
+interface StatBlock {
+    type: ContentBlockType.Stat;
+    label: string;
+    value?: string;
+    computedKey?: string;
+    hint?: string;
+    variant?: MessageVariant;
+    estimate?: boolean;
+    /** Makes the stat a link to more detail on the same page (e.g. what the KPI means). */
+    params?: PageParams;
+}
+/**
+ * A cell with more than its text: a second line, a thumbnail, a tone. Still
+ * pure data; the host decides how each part looks.
+ */
+interface TableRichCell {
+    text: string;
+    /** Muted second line under the text (e.g. vendor, category). */
+    caption?: string;
+    /**
+     * Thumbnail URL shown before the text. `null` = this row has no picture: the
+     * host shows a placeholder so the column stays aligned.
+     */
+    image?: string | null;
+    /** Tints the text (e.g. `danger` for "sold out"). Never the only signal: say it in `text`. */
+    tone?: MessageVariant;
+}
+type TableCell = string | number | boolean | null | TableRichCell;
+/** Makes a column header sort the table: the value its param takes when clicked. */
+interface TableColumnSort {
+    value: string;
+    /** Direction that value sorts in, for the header arrow (default `desc`). */
+    dir?: 'asc' | 'desc';
+}
+interface TableColumn {
+    key: string;
+    label: string;
+    align?: 'left' | 'right';
+    /** Short explanation of the column, shown on demand next to its header. */
+    hint?: string;
+    sort?: TableColumnSort;
+}
+/** The page param the sortable headers write, and the value the plugin sorted by. */
+interface TableSort {
+    param: string;
+    value: string;
+    /** Params cleared when the sort changes (e.g. `page`). */
+    resets?: string[];
+}
+/**
+ * Paging through a page param (1-based; the host removes the param on page 1).
+ * The plugin already sliced `rows`: the host only shows the range and the pager.
+ */
+interface TablePagination {
+    param: string;
+    page: number;
+    pageSize: number;
+    total: number;
+}
+/** Read-only table. Cells are looked up by `columns[].key`. */
+interface TableBlock {
+    type: ContentBlockType.Table;
+    title?: string;
+    columns: TableColumn[];
+    rows: Array<Record<string, TableCell>>;
+    /** Shown instead of the body when `rows` is empty. */
+    emptyText?: string;
+    /** Aligned with `rows`: a row with params is clickable (in-page navigation). */
+    rowParams?: Array<PageParams | null>;
+    /** Columns with `sort` become clickable headers bound to this param. */
+    sort?: TableSort;
+    pagination?: TablePagination;
+}
+interface ChartSeries {
+    name: string;
+    /** One value per label; `null` = no observation (a gap, not a zero). */
+    data: Array<number | null>;
+}
+/**
+ * Simple chart: `labels` is the category axis, every series aligns to it.
+ * `hbar` = horizontal bars, one row per label (best for long category names).
+ */
+interface ChartBlock {
+    type: ContentBlockType.Chart;
+    kind: 'bar' | 'line' | 'hbar';
+    title?: string;
+    labels: string[];
+    series: ChartSeries[];
+    unit?: string;
+    emptyText?: string;
+}
+interface FilterOption {
+    value: string;
+    label: string;
+}
+/**
+ * Choice over one page param. `value` is the option the plugin rendered with
+ * (it read it from `UiSlotContext.params`, or chose a default).
+ */
+interface FilterBlock {
+    type: ContentBlockType.Filter;
+    param: string;
+    label?: string;
+    value: string;
+    options: FilterOption[];
+    /**
+     * `segmented` (default) for a few options; `select` for many (in a `select`
+     * an option with an empty value means "no filter"); `tabs` for the views of
+     * the page.
+     */
+    display?: 'segmented' | 'select' | 'tabs';
+    /** Params cleared when this one changes (e.g. `page`). */
+    resets?: string[];
+}
+/** Free-text box over one page param; the host debounces and replaces the URL. */
+interface SearchBlock {
+    type: ContentBlockType.Search;
+    param: string;
+    value: string;
+    label?: string;
+    placeholder?: string;
+    /** Params cleared when the text changes (e.g. `page`). */
+    resets?: string[];
+}
+/** Collapsible section, closed unless `open`. Recurses into child `blocks`. */
+interface DetailsBlock {
+    type: ContentBlockType.Details;
+    summary: string;
+    blocks: ContentBlock[];
+    open?: boolean;
+}
+/**
+ * One row of view controls above a list: search, filters, a "clear" link. It
+ * wraps on a narrow screen and a search box takes the free width. Use `grid`
+ * for content, this for controls.
+ */
+interface ToolbarBlock {
+    type: ContentBlockType.Toolbar;
+    blocks: ContentBlock[];
+}
+/** Child blocks in `columns` responsive columns (one column on narrow screens). */
+interface GridBlock {
+    type: ContentBlockType.Grid;
+    columns: 2 | 3 | 4;
+    blocks: ContentBlock[];
+}
+type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock | StatBlock | TableBlock | ChartBlock | FilterBlock | GridBlock | SearchBlock | DetailsBlock | ToolbarBlock;
 /**
  * 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
@@ -1658,9 +1860,22 @@ interface UiContribution {
     blocks: ContentBlock[];
     order?: number;
 }
+/** Runtime context the host hands to {@link IUiPlugin.resolveContributions}. */
+interface UiSlotContext {
+    /** Free-form, JSON-serializable params chosen by the page (e.g. country). */
+    params?: Record<string, unknown>;
+}
 /** Impl behind a `ui` capability — the static set a plugin declares up front. */
 interface IUiPlugin {
     readonly contributions: UiContribution[];
+    /**
+     * Optional dynamic counterpart: for slots whose blocks depend on live data
+     * (a full-page report), the host asks the plugin to build the block tree at
+     * request time. Absent => the host serves the static `contributions`.
+     * MUST resolve to pure-JSON blocks and SHOULD NOT throw: degrade to a
+     * banner block explaining what is missing.
+     */
+    resolveContributions?(slot: string, ctx: UiSlotContext): Promise<UiContribution[]>;
 }
 interface UiContributionsValidation {
     success: boolean;
@@ -1779,6 +1994,32 @@ interface StorageBroker {
 interface SequenceStore {
     next(scope: string): Promise<number>;
 }
+/**
+ * A product of THIS store that was imported from a supplier's catalog
+ * (dropshipping). `externalId` is the supplier's own product id, so a plugin
+ * can join it with that supplier's data without reading the host database.
+ */
+interface SourcedProduct {
+    /** Local product id in this store. */
+    productId: string;
+    /** Local product title (what the merchant named it). */
+    title: string;
+    /** The supplier's product id. */
+    externalId: string;
+    /**
+     * The supplier marketplace product this one comes from, when the host knows
+     * it (see `SupplierListing.catalogProductId`). `null` = not linked yet.
+     */
+    catalogProductId: string | null;
+}
+/**
+ * Read-only view of the store catalog, scoped by the host to the tenant of the
+ * current call.
+ */
+interface CatalogReader {
+    /** Products of this store sourced from `supplierCode` (e.g. `soydrop`). */
+    listSourcedProducts(supplierCode: string): Promise<SourcedProduct[]>;
+}
 type DomainEventName = string;
 type DomainEventHandler = (payload: unknown) => void | Promise<void>;
 /**
@@ -1794,10 +2035,15 @@ interface HostApi {
     readonly secrets: SecretStore;
     readonly storage: StorageBroker;
     readonly sequence: SequenceStore;
+    /**
+     * Store catalog reads. Optional: a host that does not offer it leaves it
+     * out, so a plugin must handle its absence (degrade, never assume).
+     */
+    readonly catalog?: CatalogReader;
     /** Subscribe to a host domain event (order.created, product.updated, ...). */
     on(event: DomainEventName, handler: DomainEventHandler): void;
     /** Expose a capability to the host's generic registry. */
     registerCapability<T = unknown>(cap: Capability<T>): void;
 }
 
-export { FieldVariant as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CarrierSettlement as D, type CodConfig as E, FieldType as F, type CodFeeConfig as G, CodFeeType as H, type CodPurchaseTrigger as I, type ConditionalBlock as J, type ConditionalEquals as K, type ConditionalWhen as L, type ConfigurablePlugin as M, ContentActionVariant as N, type ContentBlock as O, type PluginConfigField as P, ContentBlockType as Q, type CopyFieldBlock$1 as R, type SelectOption as S, type CreateShipmentParams as T, type DispatchContext as U, type DividerBlock$1 as V, type DomainEventHandler as W, type DomainEventName as X, type EmbedInit as Y, type FieldBlock as Z, type FieldOption as _, type AccordionBlock as a, type SetupAction as a$, GatewayEnvironment as a0, type GatewayFeeConfig as a1, type GatewayStaticConfig as a2, type GroupBlock as a3, type HostApi as a4, type HttpClient as a5, type HttpRequest as a6, type HttpResponse as a7, type IAnalyticsPlugin as a8, type IInvoicingPlugin as a9, type PaymentConnectExchange as aA, type PaymentConnectParams as aB, type PaymentCustomer as aC, type PaymentGatewayCode as aD, type PaymentMerchantPricing as aE, type PaymentPayload as aF, type PaymentPluginConfig as aG, type PaymentRenderMode as aH, type PaymentResult as aI, type PaymentSessionFees as aJ, type PaymentSessionPayload as aK, type PaymentSessionResult as aL, type PaymentSettlementFees as aM, type PaymentVerifyPayload as aN, type PaymentWebhookSettlement as aO, type PlaceSupplierOrderInput as aP, type Plugin as aQ, type PluginActionContext as aR, type PluginActionResult as aS, type PluginAuthor as aT, type PluginConfigFieldDependency as aU, type PluginFactory as aV, type PluginManifest as aW, type RepeaterBlock as aX, RepeaterSource as aY, type SecretStore as aZ, type SequenceStore as a_, type IPaymentPlugin as aa, type IPlugin as ab, type IShippingPlugin as ac, type ISuppliersPlugin as ad, type IUiPlugin as ae, type InlineRowBlock as af, InvoiceDocumentType as ag, type InvoiceLine as ah, type InvoiceMoney as ai, type InvoiceParty as aj, type InvoiceRequest as ak, type InvoiceResult as al, InvoiceStatus as am, type InvoiceTax as an, type InvoicingDefaultConfig as ao, InvoicingFeature as ap, type InvoicingPluginConfig as aq, type InvoicingStaticConfig as ar, type KeyValueBlock$1 as as, type KeyValueRow$1 as at, LayoutMode as au, type Logger as av, type MarkdownBlock as aw, MessageVariant as ax, type PaymentCard as ay, type PaymentConnect as az, type AccordionSection as b, type SetupLayout as b0, type SetupLayoutValidation as b1, type SetupStep as b2, type ShipmentAddress as b3, type ShipmentParcel as b4, type ShipmentResult as b5, type ShippingDefaultConfig as b6, ShippingFeature as b7, type ShippingPluginConfig as b8, type ShippingQuote as b9, type SuppliersStaticConfig as bA, type TabItem as bB, type TabsBlock as bC, type ToggleBlock as bD, type TrackingEvent as bE, TransactionStatus as bF, type UiContribution as bG, type UiContributionsValidation as bH, type VoidInvoiceInput as bI, type WebhookSignatureResult as bJ, analyticsCapability as bK, capability as bL, crossValidateSetupLayout as bM, definePlugin as bN, invoicingCapability as bO, isConfigurablePlugin as bP, isPluginFactory as bQ, minorUnitDigits as bR, paymentCapability as bS, shippingCapability as bT, suppliersCapability as bU, toMajorUnits as bV, toMinorUnits as bW, uiCapability as bX, validatePluginAuthor as bY, validateSetupLayout as bZ, validateUiContributions as b_, type ShippingQuoteParams as ba, type ShippingStaticConfig as bb, StepStatusFrom as bc, type StepStatusFromAction as bd, type StepStatusFromFields as be, type StepStatusSource as bf, type StorageBroker as bg, type SupplierCatalogQuery as bh, type SupplierFulfillmentEvent as bi, type SupplierListing as bj, type SupplierListingAttribute as bk, type SupplierListingPage as bl, type SupplierListingVariant as bm, type SupplierMoney as bn, type SupplierOrderAddressLevel as bo, type SupplierOrderCustomer as bp, type SupplierOrderLine as bq, type SupplierOrderResult as br, type SupplierOrderStatus as bs, type SupplierShipTo as bt, type SupplierShippingQuote as bu, type SupplierShippingQuoteInput as bv, type SupplierStock as bw, type SuppliersDefaultConfig as bx, SuppliersFeature as by, type SuppliersPluginConfig 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 AnalyticsPurchasePolicy as m, type AnalyticsStaticConfig as n, type AnalyticsUserData as o, type AnalyticsUtm as p, type AuthorValidation as q, type Block as r, type BlockBase as s, BlockType as t, type CalloutBlock as u, type Capability as v, CapabilityKind as w, type CardBlock$1 as x, type CardBrand as y, type CarrierServiceMode as z };
+export { type DomainEventName as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CarrierSettlement as D, type CatalogReader as E, FieldType as F, type ChartBlock as G, type ChartSeries as H, type CodConfig as I, type CodFeeConfig as J, CodFeeType as K, type CodPurchaseTrigger as L, type ConditionalBlock as M, type ConditionalEquals as N, type ConditionalWhen as O, type PluginConfigField as P, type ConfigurablePlugin as Q, ContentActionVariant as R, type SelectOption as S, type ContentBlock as T, ContentBlockType as U, type CopyFieldBlock$1 as V, type CreateShipmentParams as W, type DetailsBlock as X, type DispatchContext as Y, type DividerBlock$1 as Z, type DomainEventHandler as _, type AccordionBlock as a, type PluginActionResult as a$, type EmbedInit as a0, type FieldBlock as a1, type FieldOption as a2, FieldVariant as a3, type FilterBlock as a4, type FilterOption as a5, GatewayEnvironment as a6, type GatewayFeeConfig as a7, type GatewayStaticConfig as a8, type GridBlock as a9, type KeyValueRow$1 as aA, LayoutMode as aB, type LinkBlock as aC, type Logger as aD, type MarkdownBlock as aE, MessageVariant as aF, type PageParams as aG, type PaymentCard as aH, type PaymentConnect as aI, type PaymentConnectExchange as aJ, type PaymentConnectParams as aK, type PaymentCustomer as aL, type PaymentGatewayCode as aM, type PaymentMerchantPricing as aN, type PaymentPayload as aO, type PaymentPluginConfig as aP, type PaymentRenderMode as aQ, type PaymentResult as aR, type PaymentSessionFees as aS, type PaymentSessionPayload as aT, type PaymentSessionResult as aU, type PaymentSettlementFees as aV, type PaymentVerifyPayload as aW, type PaymentWebhookSettlement as aX, type PlaceSupplierOrderInput as aY, type Plugin as aZ, type PluginActionContext as a_, type GroupBlock as aa, type HostApi as ab, type HttpClient as ac, type HttpRequest as ad, type HttpResponse as ae, type IAnalyticsPlugin as af, type IInvoicingPlugin as ag, type IPaymentPlugin as ah, type IPlugin as ai, type IShippingPlugin as aj, type ISuppliersPlugin as ak, type IUiPlugin as al, type InlineRowBlock as am, InvoiceDocumentType as an, type InvoiceLine as ao, type InvoiceMoney as ap, type InvoiceParty as aq, type InvoiceRequest as ar, type InvoiceResult as as, InvoiceStatus as at, type InvoiceTax as au, type InvoicingDefaultConfig as av, InvoicingFeature as aw, type InvoicingPluginConfig as ax, type InvoicingStaticConfig as ay, type KeyValueBlock$1 as az, type AccordionSection as b, type UiContributionsValidation as b$, type PluginAuthor as b0, type PluginConfigFieldDependency as b1, type PluginFactory as b2, type PluginManifest as b3, type RepeaterBlock as b4, RepeaterSource as b5, type SearchBlock as b6, type SecretStore as b7, type SequenceStore as b8, type SetupAction as b9, type SupplierOrderAddressLevel as bA, type SupplierOrderCustomer as bB, type SupplierOrderLine as bC, type SupplierOrderResult as bD, type SupplierOrderStatus as bE, type SupplierShipTo as bF, type SupplierShippingQuote as bG, type SupplierShippingQuoteInput as bH, type SupplierStock as bI, type SuppliersDefaultConfig as bJ, SuppliersFeature as bK, type SuppliersPluginConfig as bL, type SuppliersStaticConfig as bM, type TabItem as bN, type TableBlock as bO, type TableCell as bP, type TableColumn as bQ, type TableColumnSort as bR, type TablePagination as bS, type TableRichCell as bT, type TableSort as bU, type TabsBlock as bV, type ToggleBlock as bW, type ToolbarBlock as bX, type TrackingEvent as bY, TransactionStatus as bZ, type UiContribution as b_, type SetupLayout as ba, type SetupLayoutValidation as bb, type SetupStep as bc, type ShipmentAddress as bd, type ShipmentParcel as be, type ShipmentResult as bf, type ShippingDefaultConfig as bg, ShippingFeature as bh, type ShippingPluginConfig as bi, type ShippingQuote as bj, type ShippingQuoteParams as bk, type ShippingStaticConfig as bl, type SourcedProduct as bm, type StatBlock as bn, StepStatusFrom as bo, type StepStatusFromAction as bp, type StepStatusFromFields as bq, type StepStatusSource as br, type StorageBroker as bs, type SupplierCatalogQuery as bt, type SupplierFulfillmentEvent as bu, type SupplierListing as bv, type SupplierListingAttribute as bw, type SupplierListingPage as bx, type SupplierListingVariant as by, type SupplierMoney as bz, type ActionBlock$1 as c, UiSlot as c0, type UiSlotContext as c1, type VoidInvoiceInput as c2, type WebhookSignatureResult as c3, analyticsCapability as c4, capability as c5, crossValidateSetupLayout as c6, definePlugin as c7, invoicingCapability as c8, isConfigurablePlugin as c9, isPluginFactory as ca, minorUnitDigits as cb, paymentCapability as cc, shippingCapability as cd, suppliersCapability as ce, toMajorUnits as cf, toMinorUnits as cg, uiCapability as ch, validatePluginAuthor as ci, validateSetupLayout as cj, validateUiContributions as ck, 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 AnalyticsPurchasePolicy as m, type AnalyticsStaticConfig as n, type AnalyticsUserData as o, type AnalyticsUtm as p, type AuthorValidation as q, type Block as r, type BlockBase as s, BlockType as t, type CalloutBlock as u, type Capability as v, CapabilityKind as w, type CardBlock$1 as x, type CardBrand as y, type CarrierServiceMode as z };

package/dist/{host-api-CuLAVsQ2.d.ts → host-api-C5EsRbsA.d.ts}

@@ -332,6 +332,13 @@ interface PluginManifest {
      * `developer` string first-party manifests used to carry.
      */
     author?: PluginAuthor;
+    /**
+     * Catalog access hint. `restricted` = the store asks the platform for an
+     * entitlement before ENABLING the app (paid/granted apps). Absent or
+     * `public` = no entitlement check. Informational for the host: the platform
+     * stays the authority on who is allowed.
+     */
+    access?: 'public' | 'restricted';
     /**
      * Declarative admin setup screen. When omitted, host renders the legacy
      * auto-form derived from the plugin's configSchema.
@@ -984,6 +991,12 @@ interface SupplierStock {
 interface SupplierListing {
     /** Native id in the supplier catalog (product or catalog-item id). */
     externalId: string;
+    /**
+     * When `externalId` is an item of the SELLER's catalog (e.g. Drop's
+     * catalogId), the id of the marketplace product it wraps: the one the
+     * supplier's public catalog uses. Absent when both are the same id.
+     */
+    catalogProductId?: string | null;
     title: string;
     description?: string | null;
     sku?: string | null;
@@ -1573,8 +1586,44 @@ declare enum ContentBlockType {
     Link = "link",
     Divider = "divider",
     Action = "action",
-    Card = "card"
+    Card = "card",
+    /** Headline metric (label + pre-formatted value). Pure JSON data. */
+    Stat = "stat",
+    /** Read-only table of scalar cells. Pure JSON data. */
+    Table = "table",
+    /** Simple bar/line chart over labelled series. Pure JSON data. */
+    Chart = "chart",
+    /**
+     * Segmented choice bound to a page param (e.g. `days`). Picking an option
+     * makes the host re-resolve the slot with `params[param] = value`. A VIEW
+     * control, not config input: it never writes plugin settings.
+     */
+    Filter = "filter",
+    /** Lays its child blocks side by side in N responsive columns. */
+    Grid = "grid",
+    /** Free-text box bound to a page param (debounced by the host). */
+    Search = "search",
+    /** Collapsible section (closed by default): "how to read this", details. */
+    Details = "details",
+    /** One row of view controls (search, filters, links) above a list. */
+    Toolbar = "toolbar"
 }
+/**
+ * A patch over the page params, for IN-PAGE navigation (links, table rows,
+ * stats): the host merges it into the current params; `null` removes one.
+ * It navigates (history entry, so "back" works); filters only replace.
+ */
+type PageParams = Record<string, string | null>;
+/**
+ * Host-owned slots the SDK knows by name. `slot` stays a free string on the
+ * wire (an older host ignores a slot it does not know); these constants only
+ * give first-party plugins one spelling.
+ */
+declare const UiSlot: {
+    /** Full-page surface of an app in the admin (the app owns the whole body). */
+    readonly AdminAppPage: "admin:app.page";
+};
+type UiSlot = (typeof UiSlot)[keyof typeof UiSlot];
 declare enum ContentActionVariant {
     Primary = "primary",
     Secondary = "secondary",
@@ -1624,6 +1673,8 @@ interface LinkBlock {
     href?: string;
     computedKey?: string;
     external?: boolean;
+    /** In-page navigation instead of `href` (see `PageParams`). */
+    params?: PageParams;
 }
 interface DividerBlock {
     type: ContentBlockType.Divider;
@@ -1646,7 +1697,158 @@ interface CardBlock {
     description?: string;
     blocks: ContentBlock[];
 }
-type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock;
+/**
+ * Headline metric. `value` is already formatted by the plugin (the host does
+ * not guess units/locale). `estimate: true` makes the host label it as an
+ * ESTIMATE next to the value, so a derived number is never shown as a fact.
+ */
+interface StatBlock {
+    type: ContentBlockType.Stat;
+    label: string;
+    value?: string;
+    computedKey?: string;
+    hint?: string;
+    variant?: MessageVariant;
+    estimate?: boolean;
+    /** Makes the stat a link to more detail on the same page (e.g. what the KPI means). */
+    params?: PageParams;
+}
+/**
+ * A cell with more than its text: a second line, a thumbnail, a tone. Still
+ * pure data; the host decides how each part looks.
+ */
+interface TableRichCell {
+    text: string;
+    /** Muted second line under the text (e.g. vendor, category). */
+    caption?: string;
+    /**
+     * Thumbnail URL shown before the text. `null` = this row has no picture: the
+     * host shows a placeholder so the column stays aligned.
+     */
+    image?: string | null;
+    /** Tints the text (e.g. `danger` for "sold out"). Never the only signal: say it in `text`. */
+    tone?: MessageVariant;
+}
+type TableCell = string | number | boolean | null | TableRichCell;
+/** Makes a column header sort the table: the value its param takes when clicked. */
+interface TableColumnSort {
+    value: string;
+    /** Direction that value sorts in, for the header arrow (default `desc`). */
+    dir?: 'asc' | 'desc';
+}
+interface TableColumn {
+    key: string;
+    label: string;
+    align?: 'left' | 'right';
+    /** Short explanation of the column, shown on demand next to its header. */
+    hint?: string;
+    sort?: TableColumnSort;
+}
+/** The page param the sortable headers write, and the value the plugin sorted by. */
+interface TableSort {
+    param: string;
+    value: string;
+    /** Params cleared when the sort changes (e.g. `page`). */
+    resets?: string[];
+}
+/**
+ * Paging through a page param (1-based; the host removes the param on page 1).
+ * The plugin already sliced `rows`: the host only shows the range and the pager.
+ */
+interface TablePagination {
+    param: string;
+    page: number;
+    pageSize: number;
+    total: number;
+}
+/** Read-only table. Cells are looked up by `columns[].key`. */
+interface TableBlock {
+    type: ContentBlockType.Table;
+    title?: string;
+    columns: TableColumn[];
+    rows: Array<Record<string, TableCell>>;
+    /** Shown instead of the body when `rows` is empty. */
+    emptyText?: string;
+    /** Aligned with `rows`: a row with params is clickable (in-page navigation). */
+    rowParams?: Array<PageParams | null>;
+    /** Columns with `sort` become clickable headers bound to this param. */
+    sort?: TableSort;
+    pagination?: TablePagination;
+}
+interface ChartSeries {
+    name: string;
+    /** One value per label; `null` = no observation (a gap, not a zero). */
+    data: Array<number | null>;
+}
+/**
+ * Simple chart: `labels` is the category axis, every series aligns to it.
+ * `hbar` = horizontal bars, one row per label (best for long category names).
+ */
+interface ChartBlock {
+    type: ContentBlockType.Chart;
+    kind: 'bar' | 'line' | 'hbar';
+    title?: string;
+    labels: string[];
+    series: ChartSeries[];
+    unit?: string;
+    emptyText?: string;
+}
+interface FilterOption {
+    value: string;
+    label: string;
+}
+/**
+ * Choice over one page param. `value` is the option the plugin rendered with
+ * (it read it from `UiSlotContext.params`, or chose a default).
+ */
+interface FilterBlock {
+    type: ContentBlockType.Filter;
+    param: string;
+    label?: string;
+    value: string;
+    options: FilterOption[];
+    /**
+     * `segmented` (default) for a few options; `select` for many (in a `select`
+     * an option with an empty value means "no filter"); `tabs` for the views of
+     * the page.
+     */
+    display?: 'segmented' | 'select' | 'tabs';
+    /** Params cleared when this one changes (e.g. `page`). */
+    resets?: string[];
+}
+/** Free-text box over one page param; the host debounces and replaces the URL. */
+interface SearchBlock {
+    type: ContentBlockType.Search;
+    param: string;
+    value: string;
+    label?: string;
+    placeholder?: string;
+    /** Params cleared when the text changes (e.g. `page`). */
+    resets?: string[];
+}
+/** Collapsible section, closed unless `open`. Recurses into child `blocks`. */
+interface DetailsBlock {
+    type: ContentBlockType.Details;
+    summary: string;
+    blocks: ContentBlock[];
+    open?: boolean;
+}
+/**
+ * One row of view controls above a list: search, filters, a "clear" link. It
+ * wraps on a narrow screen and a search box takes the free width. Use `grid`
+ * for content, this for controls.
+ */
+interface ToolbarBlock {
+    type: ContentBlockType.Toolbar;
+    blocks: ContentBlock[];
+}
+/** Child blocks in `columns` responsive columns (one column on narrow screens). */
+interface GridBlock {
+    type: ContentBlockType.Grid;
+    columns: 2 | 3 | 4;
+    blocks: ContentBlock[];
+}
+type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock | StatBlock | TableBlock | ChartBlock | FilterBlock | GridBlock | SearchBlock | DetailsBlock | ToolbarBlock;
 /**
  * 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
@@ -1658,9 +1860,22 @@ interface UiContribution {
     blocks: ContentBlock[];
     order?: number;
 }
+/** Runtime context the host hands to {@link IUiPlugin.resolveContributions}. */
+interface UiSlotContext {
+    /** Free-form, JSON-serializable params chosen by the page (e.g. country). */
+    params?: Record<string, unknown>;
+}
 /** Impl behind a `ui` capability — the static set a plugin declares up front. */
 interface IUiPlugin {
     readonly contributions: UiContribution[];
+    /**
+     * Optional dynamic counterpart: for slots whose blocks depend on live data
+     * (a full-page report), the host asks the plugin to build the block tree at
+     * request time. Absent => the host serves the static `contributions`.
+     * MUST resolve to pure-JSON blocks and SHOULD NOT throw: degrade to a
+     * banner block explaining what is missing.
+     */
+    resolveContributions?(slot: string, ctx: UiSlotContext): Promise<UiContribution[]>;
 }
 interface UiContributionsValidation {
     success: boolean;
@@ -1779,6 +1994,32 @@ interface StorageBroker {
 interface SequenceStore {
     next(scope: string): Promise<number>;
 }
+/**
+ * A product of THIS store that was imported from a supplier's catalog
+ * (dropshipping). `externalId` is the supplier's own product id, so a plugin
+ * can join it with that supplier's data without reading the host database.
+ */
+interface SourcedProduct {
+    /** Local product id in this store. */
+    productId: string;
+    /** Local product title (what the merchant named it). */
+    title: string;
+    /** The supplier's product id. */
+    externalId: string;
+    /**
+     * The supplier marketplace product this one comes from, when the host knows
+     * it (see `SupplierListing.catalogProductId`). `null` = not linked yet.
+     */
+    catalogProductId: string | null;
+}
+/**
+ * Read-only view of the store catalog, scoped by the host to the tenant of the
+ * current call.
+ */
+interface CatalogReader {
+    /** Products of this store sourced from `supplierCode` (e.g. `soydrop`). */
+    listSourcedProducts(supplierCode: string): Promise<SourcedProduct[]>;
+}
 type DomainEventName = string;
 type DomainEventHandler = (payload: unknown) => void | Promise<void>;
 /**
@@ -1794,10 +2035,15 @@ interface HostApi {
     readonly secrets: SecretStore;
     readonly storage: StorageBroker;
     readonly sequence: SequenceStore;
+    /**
+     * Store catalog reads. Optional: a host that does not offer it leaves it
+     * out, so a plugin must handle its absence (degrade, never assume).
+     */
+    readonly catalog?: CatalogReader;
     /** Subscribe to a host domain event (order.created, product.updated, ...). */
     on(event: DomainEventName, handler: DomainEventHandler): void;
     /** Expose a capability to the host's generic registry. */
     registerCapability<T = unknown>(cap: Capability<T>): void;
 }
 
-export { FieldVariant as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CarrierSettlement as D, type CodConfig as E, FieldType as F, type CodFeeConfig as G, CodFeeType as H, type CodPurchaseTrigger as I, type ConditionalBlock as J, type ConditionalEquals as K, type ConditionalWhen as L, type ConfigurablePlugin as M, ContentActionVariant as N, type ContentBlock as O, type PluginConfigField as P, ContentBlockType as Q, type CopyFieldBlock$1 as R, type SelectOption as S, type CreateShipmentParams as T, type DispatchContext as U, type DividerBlock$1 as V, type DomainEventHandler as W, type DomainEventName as X, type EmbedInit as Y, type FieldBlock as Z, type FieldOption as _, type AccordionBlock as a, type SetupAction as a$, GatewayEnvironment as a0, type GatewayFeeConfig as a1, type GatewayStaticConfig as a2, type GroupBlock as a3, type HostApi as a4, type HttpClient as a5, type HttpRequest as a6, type HttpResponse as a7, type IAnalyticsPlugin as a8, type IInvoicingPlugin as a9, type PaymentConnectExchange as aA, type PaymentConnectParams as aB, type PaymentCustomer as aC, type PaymentGatewayCode as aD, type PaymentMerchantPricing as aE, type PaymentPayload as aF, type PaymentPluginConfig as aG, type PaymentRenderMode as aH, type PaymentResult as aI, type PaymentSessionFees as aJ, type PaymentSessionPayload as aK, type PaymentSessionResult as aL, type PaymentSettlementFees as aM, type PaymentVerifyPayload as aN, type PaymentWebhookSettlement as aO, type PlaceSupplierOrderInput as aP, type Plugin as aQ, type PluginActionContext as aR, type PluginActionResult as aS, type PluginAuthor as aT, type PluginConfigFieldDependency as aU, type PluginFactory as aV, type PluginManifest as aW, type RepeaterBlock as aX, RepeaterSource as aY, type SecretStore as aZ, type SequenceStore as a_, type IPaymentPlugin as aa, type IPlugin as ab, type IShippingPlugin as ac, type ISuppliersPlugin as ad, type IUiPlugin as ae, type InlineRowBlock as af, InvoiceDocumentType as ag, type InvoiceLine as ah, type InvoiceMoney as ai, type InvoiceParty as aj, type InvoiceRequest as ak, type InvoiceResult as al, InvoiceStatus as am, type InvoiceTax as an, type InvoicingDefaultConfig as ao, InvoicingFeature as ap, type InvoicingPluginConfig as aq, type InvoicingStaticConfig as ar, type KeyValueBlock$1 as as, type KeyValueRow$1 as at, LayoutMode as au, type Logger as av, type MarkdownBlock as aw, MessageVariant as ax, type PaymentCard as ay, type PaymentConnect as az, type AccordionSection as b, type SetupLayout as b0, type SetupLayoutValidation as b1, type SetupStep as b2, type ShipmentAddress as b3, type ShipmentParcel as b4, type ShipmentResult as b5, type ShippingDefaultConfig as b6, ShippingFeature as b7, type ShippingPluginConfig as b8, type ShippingQuote as b9, type SuppliersStaticConfig as bA, type TabItem as bB, type TabsBlock as bC, type ToggleBlock as bD, type TrackingEvent as bE, TransactionStatus as bF, type UiContribution as bG, type UiContributionsValidation as bH, type VoidInvoiceInput as bI, type WebhookSignatureResult as bJ, analyticsCapability as bK, capability as bL, crossValidateSetupLayout as bM, definePlugin as bN, invoicingCapability as bO, isConfigurablePlugin as bP, isPluginFactory as bQ, minorUnitDigits as bR, paymentCapability as bS, shippingCapability as bT, suppliersCapability as bU, toMajorUnits as bV, toMinorUnits as bW, uiCapability as bX, validatePluginAuthor as bY, validateSetupLayout as bZ, validateUiContributions as b_, type ShippingQuoteParams as ba, type ShippingStaticConfig as bb, StepStatusFrom as bc, type StepStatusFromAction as bd, type StepStatusFromFields as be, type StepStatusSource as bf, type StorageBroker as bg, type SupplierCatalogQuery as bh, type SupplierFulfillmentEvent as bi, type SupplierListing as bj, type SupplierListingAttribute as bk, type SupplierListingPage as bl, type SupplierListingVariant as bm, type SupplierMoney as bn, type SupplierOrderAddressLevel as bo, type SupplierOrderCustomer as bp, type SupplierOrderLine as bq, type SupplierOrderResult as br, type SupplierOrderStatus as bs, type SupplierShipTo as bt, type SupplierShippingQuote as bu, type SupplierShippingQuoteInput as bv, type SupplierStock as bw, type SuppliersDefaultConfig as bx, SuppliersFeature as by, type SuppliersPluginConfig 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 AnalyticsPurchasePolicy as m, type AnalyticsStaticConfig as n, type AnalyticsUserData as o, type AnalyticsUtm as p, type AuthorValidation as q, type Block as r, type BlockBase as s, BlockType as t, type CalloutBlock as u, type Capability as v, CapabilityKind as w, type CardBlock$1 as x, type CardBrand as y, type CarrierServiceMode as z };
+export { type DomainEventName as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CarrierSettlement as D, type CatalogReader as E, FieldType as F, type ChartBlock as G, type ChartSeries as H, type CodConfig as I, type CodFeeConfig as J, CodFeeType as K, type CodPurchaseTrigger as L, type ConditionalBlock as M, type ConditionalEquals as N, type ConditionalWhen as O, type PluginConfigField as P, type ConfigurablePlugin as Q, ContentActionVariant as R, type SelectOption as S, type ContentBlock as T, ContentBlockType as U, type CopyFieldBlock$1 as V, type CreateShipmentParams as W, type DetailsBlock as X, type DispatchContext as Y, type DividerBlock$1 as Z, type DomainEventHandler as _, type AccordionBlock as a, type PluginActionResult as a$, type EmbedInit as a0, type FieldBlock as a1, type FieldOption as a2, FieldVariant as a3, type FilterBlock as a4, type FilterOption as a5, GatewayEnvironment as a6, type GatewayFeeConfig as a7, type GatewayStaticConfig as a8, type GridBlock as a9, type KeyValueRow$1 as aA, LayoutMode as aB, type LinkBlock as aC, type Logger as aD, type MarkdownBlock as aE, MessageVariant as aF, type PageParams as aG, type PaymentCard as aH, type PaymentConnect as aI, type PaymentConnectExchange as aJ, type PaymentConnectParams as aK, type PaymentCustomer as aL, type PaymentGatewayCode as aM, type PaymentMerchantPricing as aN, type PaymentPayload as aO, type PaymentPluginConfig as aP, type PaymentRenderMode as aQ, type PaymentResult as aR, type PaymentSessionFees as aS, type PaymentSessionPayload as aT, type PaymentSessionResult as aU, type PaymentSettlementFees as aV, type PaymentVerifyPayload as aW, type PaymentWebhookSettlement as aX, type PlaceSupplierOrderInput as aY, type Plugin as aZ, type PluginActionContext as a_, type GroupBlock as aa, type HostApi as ab, type HttpClient as ac, type HttpRequest as ad, type HttpResponse as ae, type IAnalyticsPlugin as af, type IInvoicingPlugin as ag, type IPaymentPlugin as ah, type IPlugin as ai, type IShippingPlugin as aj, type ISuppliersPlugin as ak, type IUiPlugin as al, type InlineRowBlock as am, InvoiceDocumentType as an, type InvoiceLine as ao, type InvoiceMoney as ap, type InvoiceParty as aq, type InvoiceRequest as ar, type InvoiceResult as as, InvoiceStatus as at, type InvoiceTax as au, type InvoicingDefaultConfig as av, InvoicingFeature as aw, type InvoicingPluginConfig as ax, type InvoicingStaticConfig as ay, type KeyValueBlock$1 as az, type AccordionSection as b, type UiContributionsValidation as b$, type PluginAuthor as b0, type PluginConfigFieldDependency as b1, type PluginFactory as b2, type PluginManifest as b3, type RepeaterBlock as b4, RepeaterSource as b5, type SearchBlock as b6, type SecretStore as b7, type SequenceStore as b8, type SetupAction as b9, type SupplierOrderAddressLevel as bA, type SupplierOrderCustomer as bB, type SupplierOrderLine as bC, type SupplierOrderResult as bD, type SupplierOrderStatus as bE, type SupplierShipTo as bF, type SupplierShippingQuote as bG, type SupplierShippingQuoteInput as bH, type SupplierStock as bI, type SuppliersDefaultConfig as bJ, SuppliersFeature as bK, type SuppliersPluginConfig as bL, type SuppliersStaticConfig as bM, type TabItem as bN, type TableBlock as bO, type TableCell as bP, type TableColumn as bQ, type TableColumnSort as bR, type TablePagination as bS, type TableRichCell as bT, type TableSort as bU, type TabsBlock as bV, type ToggleBlock as bW, type ToolbarBlock as bX, type TrackingEvent as bY, TransactionStatus as bZ, type UiContribution as b_, type SetupLayout as ba, type SetupLayoutValidation as bb, type SetupStep as bc, type ShipmentAddress as bd, type ShipmentParcel as be, type ShipmentResult as bf, type ShippingDefaultConfig as bg, ShippingFeature as bh, type ShippingPluginConfig as bi, type ShippingQuote as bj, type ShippingQuoteParams as bk, type ShippingStaticConfig as bl, type SourcedProduct as bm, type StatBlock as bn, StepStatusFrom as bo, type StepStatusFromAction as bp, type StepStatusFromFields as bq, type StepStatusSource as br, type StorageBroker as bs, type SupplierCatalogQuery as bt, type SupplierFulfillmentEvent as bu, type SupplierListing as bv, type SupplierListingAttribute as bw, type SupplierListingPage as bx, type SupplierListingVariant as by, type SupplierMoney as bz, type ActionBlock$1 as c, UiSlot as c0, type UiSlotContext as c1, type VoidInvoiceInput as c2, type WebhookSignatureResult as c3, analyticsCapability as c4, capability as c5, crossValidateSetupLayout as c6, definePlugin as c7, invoicingCapability as c8, isConfigurablePlugin as c9, isPluginFactory as ca, minorUnitDigits as cb, paymentCapability as cc, shippingCapability as cd, suppliersCapability as ce, toMajorUnits as cf, toMinorUnits as cg, uiCapability as ch, validatePluginAuthor as ci, validateSetupLayout as cj, validateUiContributions as ck, 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 AnalyticsPurchasePolicy as m, type AnalyticsStaticConfig as n, type AnalyticsUserData as o, type AnalyticsUtm as p, type AuthorValidation as q, type Block as r, type BlockBase as s, BlockType as t, type CalloutBlock as u, type Capability as v, CapabilityKind as w, type CardBlock$1 as x, type CardBrand as y, type CarrierServiceMode 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-CuLAVsQ2.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 AnalyticsPurchasePolicy, n as AnalyticsStaticConfig, o as AnalyticsUserData, p as AnalyticsUtm, q as AuthorValidation, B as BannerBlock, r as Block, s as BlockBase, t as BlockType, u as CalloutBlock, v as Capability, w as CapabilityKind, x as CardBlock, y as CardBrand, z as CarrierServiceMode, D as CarrierSettlement, E as CodConfig, G as CodFeeConfig, H as CodFeeType, I as CodPurchaseTrigger, J as ConditionalBlock, K as ConditionalEquals, L as ConditionalWhen, M as ConfigurablePlugin, N as ContentActionVariant, O as ContentBlock, Q as ContentBlockType, R as CopyFieldBlock, T as CreateShipmentParams, U as DispatchContext, V as DividerBlock, W as DomainEventHandler, X as DomainEventName, Y as EmbedInit, Z as FieldBlock, _ as FieldOption, $ as FieldVariant, a0 as GatewayEnvironment, a1 as GatewayFeeConfig, a2 as GatewayStaticConfig, a3 as GroupBlock, a4 as HostApi, a5 as HttpClient, a6 as HttpRequest, a7 as HttpResponse, a8 as IAnalyticsPlugin, a9 as IInvoicingPlugin, aa as IPaymentPlugin, ab as IPlugin, ac as IShippingPlugin, ad as ISuppliersPlugin, ae as IUiPlugin, af as InlineRowBlock, ag as InvoiceDocumentType, ah as InvoiceLine, ai as InvoiceMoney, aj as InvoiceParty, ak as InvoiceRequest, al as InvoiceResult, am as InvoiceStatus, an as InvoiceTax, ao as InvoicingDefaultConfig, ap as InvoicingFeature, aq as InvoicingPluginConfig, ar as InvoicingStaticConfig, as as KeyValueBlock, at as KeyValueRow, au as LayoutMode, av as Logger, aw as MarkdownBlock, ax as MessageVariant, ay as PaymentCard, az as PaymentConnect, aA as PaymentConnectExchange, aB as PaymentConnectParams, aC as PaymentCustomer, aD as PaymentGatewayCode, aE as PaymentMerchantPricing, aF as PaymentPayload, aG as PaymentPluginConfig, aH as PaymentRenderMode, aI as PaymentResult, aJ as PaymentSessionFees, aK as PaymentSessionPayload, aL as PaymentSessionResult, aM as PaymentSettlementFees, aN as PaymentVerifyPayload, aO as PaymentWebhookSettlement, aP as PlaceSupplierOrderInput, aQ as Plugin, aR as PluginActionContext, aS as PluginActionResult, aT as PluginAuthor, aU as PluginConfigFieldDependency, aV as PluginFactory, aW as PluginManifest, aX as RepeaterBlock, aY as RepeaterSource, aZ as SecretStore, a_ as SequenceStore, a$ as SetupAction, b0 as SetupLayout, b1 as SetupLayoutValidation, b2 as SetupStep, b3 as ShipmentAddress, b4 as ShipmentParcel, b5 as ShipmentResult, b6 as ShippingDefaultConfig, b7 as ShippingFeature, b8 as ShippingPluginConfig, b9 as ShippingQuote, ba as ShippingQuoteParams, bb as ShippingStaticConfig, bc as StepStatusFrom, bd as StepStatusFromAction, be as StepStatusFromFields, bf as StepStatusSource, bg as StorageBroker, bh as SupplierCatalogQuery, bi as SupplierFulfillmentEvent, bj as SupplierListing, bk as SupplierListingAttribute, bl as SupplierListingPage, bm as SupplierListingVariant, bn as SupplierMoney, bo as SupplierOrderAddressLevel, bp as SupplierOrderCustomer, bq as SupplierOrderLine, br as SupplierOrderResult, bs as SupplierOrderStatus, bt as SupplierShipTo, bu as SupplierShippingQuote, bv as SupplierShippingQuoteInput, bw as SupplierStock, bx as SuppliersDefaultConfig, by as SuppliersFeature, bz as SuppliersPluginConfig, bA as SuppliersStaticConfig, bB as TabItem, bC as TabsBlock, bD as ToggleBlock, bE as TrackingEvent, bF as TransactionStatus, bG as UiContribution, bH as UiContributionsValidation, bI as VoidInvoiceInput, bJ as WebhookSignatureResult, bK as analyticsCapability, bL as capability, bM as crossValidateSetupLayout, bN as definePlugin, bO as invoicingCapability, bP as isConfigurablePlugin, bQ as isPluginFactory, bR as minorUnitDigits, bS as paymentCapability, bT as shippingCapability, bU as suppliersCapability, bV as toMajorUnits, bW as toMinorUnits, bX as uiCapability, bY as validatePluginAuthor, bZ as validateSetupLayout, b_ as validateUiContributions } from './host-api-CuLAVsQ2.mjs';
+import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-C5EsRbsA.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 AnalyticsPurchasePolicy, n as AnalyticsStaticConfig, o as AnalyticsUserData, p as AnalyticsUtm, q as AuthorValidation, B as BannerBlock, r as Block, s as BlockBase, t as BlockType, u as CalloutBlock, v as Capability, w as CapabilityKind, x as CardBlock, y as CardBrand, z as CarrierServiceMode, D as CarrierSettlement, E as CatalogReader, G as ChartBlock, H as ChartSeries, I as CodConfig, J as CodFeeConfig, K as CodFeeType, L as CodPurchaseTrigger, M as ConditionalBlock, N as ConditionalEquals, O as ConditionalWhen, Q as ConfigurablePlugin, R as ContentActionVariant, T as ContentBlock, U as ContentBlockType, V as CopyFieldBlock, W as CreateShipmentParams, X as DetailsBlock, Y as DispatchContext, Z as DividerBlock, _ as DomainEventHandler, $ as DomainEventName, a0 as EmbedInit, a1 as FieldBlock, a2 as FieldOption, a3 as FieldVariant, a4 as FilterBlock, a5 as FilterOption, a6 as GatewayEnvironment, a7 as GatewayFeeConfig, a8 as GatewayStaticConfig, a9 as GridBlock, aa as GroupBlock, ab as HostApi, ac as HttpClient, ad as HttpRequest, ae as HttpResponse, af as IAnalyticsPlugin, ag as IInvoicingPlugin, ah as IPaymentPlugin, ai as IPlugin, aj as IShippingPlugin, ak as ISuppliersPlugin, al as IUiPlugin, am as InlineRowBlock, an as InvoiceDocumentType, ao as InvoiceLine, ap as InvoiceMoney, aq as InvoiceParty, ar as InvoiceRequest, as as InvoiceResult, at as InvoiceStatus, au as InvoiceTax, av as InvoicingDefaultConfig, aw as InvoicingFeature, ax as InvoicingPluginConfig, ay as InvoicingStaticConfig, az as KeyValueBlock, aA as KeyValueRow, aB as LayoutMode, aC as LinkBlock, aD as Logger, aE as MarkdownBlock, aF as MessageVariant, aG as PageParams, aH as PaymentCard, aI as PaymentConnect, aJ as PaymentConnectExchange, aK as PaymentConnectParams, aL as PaymentCustomer, aM as PaymentGatewayCode, aN as PaymentMerchantPricing, aO as PaymentPayload, aP as PaymentPluginConfig, aQ as PaymentRenderMode, aR as PaymentResult, aS as PaymentSessionFees, aT as PaymentSessionPayload, aU as PaymentSessionResult, aV as PaymentSettlementFees, aW as PaymentVerifyPayload, aX as PaymentWebhookSettlement, aY as PlaceSupplierOrderInput, aZ as Plugin, a_ as PluginActionContext, a$ as PluginActionResult, b0 as PluginAuthor, b1 as PluginConfigFieldDependency, b2 as PluginFactory, b3 as PluginManifest, b4 as RepeaterBlock, b5 as RepeaterSource, b6 as SearchBlock, b7 as SecretStore, b8 as SequenceStore, b9 as SetupAction, ba as SetupLayout, bb as SetupLayoutValidation, bc as SetupStep, bd as ShipmentAddress, be as ShipmentParcel, bf as ShipmentResult, bg as ShippingDefaultConfig, bh as ShippingFeature, bi as ShippingPluginConfig, bj as ShippingQuote, bk as ShippingQuoteParams, bl as ShippingStaticConfig, bm as SourcedProduct, bn as StatBlock, bo as StepStatusFrom, bp as StepStatusFromAction, bq as StepStatusFromFields, br as StepStatusSource, bs as StorageBroker, bt as SupplierCatalogQuery, bu as SupplierFulfillmentEvent, bv as SupplierListing, bw as SupplierListingAttribute, bx as SupplierListingPage, by as SupplierListingVariant, bz as SupplierMoney, bA as SupplierOrderAddressLevel, bB as SupplierOrderCustomer, bC as SupplierOrderLine, bD as SupplierOrderResult, bE as SupplierOrderStatus, bF as SupplierShipTo, bG as SupplierShippingQuote, bH as SupplierShippingQuoteInput, bI as SupplierStock, bJ as SuppliersDefaultConfig, bK as SuppliersFeature, bL as SuppliersPluginConfig, bM as SuppliersStaticConfig, bN as TabItem, bO as TableBlock, bP as TableCell, bQ as TableColumn, bR as TableColumnSort, bS as TablePagination, bT as TableRichCell, bU as TableSort, bV as TabsBlock, bW as ToggleBlock, bX as ToolbarBlock, bY as TrackingEvent, bZ as TransactionStatus, b_ as UiContribution, b$ as UiContributionsValidation, c0 as UiSlot, c1 as UiSlotContext, c2 as VoidInvoiceInput, c3 as WebhookSignatureResult, c4 as analyticsCapability, c5 as capability, c6 as crossValidateSetupLayout, c7 as definePlugin, c8 as invoicingCapability, c9 as isConfigurablePlugin, ca as isPluginFactory, cb as minorUnitDigits, cc as paymentCapability, cd as shippingCapability, ce as suppliersCapability, cf as toMajorUnits, cg as toMinorUnits, ch as uiCapability, ci as validatePluginAuthor, cj as validateSetupLayout, ck as validateUiContributions } from './host-api-C5EsRbsA.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.7.0";
+declare const SDK_VERSION = "0.7.2";
 /**
  * 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-CuLAVsQ2.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 AnalyticsPurchasePolicy, n as AnalyticsStaticConfig, o as AnalyticsUserData, p as AnalyticsUtm, q as AuthorValidation, B as BannerBlock, r as Block, s as BlockBase, t as BlockType, u as CalloutBlock, v as Capability, w as CapabilityKind, x as CardBlock, y as CardBrand, z as CarrierServiceMode, D as CarrierSettlement, E as CodConfig, G as CodFeeConfig, H as CodFeeType, I as CodPurchaseTrigger, J as ConditionalBlock, K as ConditionalEquals, L as ConditionalWhen, M as ConfigurablePlugin, N as ContentActionVariant, O as ContentBlock, Q as ContentBlockType, R as CopyFieldBlock, T as CreateShipmentParams, U as DispatchContext, V as DividerBlock, W as DomainEventHandler, X as DomainEventName, Y as EmbedInit, Z as FieldBlock, _ as FieldOption, $ as FieldVariant, a0 as GatewayEnvironment, a1 as GatewayFeeConfig, a2 as GatewayStaticConfig, a3 as GroupBlock, a4 as HostApi, a5 as HttpClient, a6 as HttpRequest, a7 as HttpResponse, a8 as IAnalyticsPlugin, a9 as IInvoicingPlugin, aa as IPaymentPlugin, ab as IPlugin, ac as IShippingPlugin, ad as ISuppliersPlugin, ae as IUiPlugin, af as InlineRowBlock, ag as InvoiceDocumentType, ah as InvoiceLine, ai as InvoiceMoney, aj as InvoiceParty, ak as InvoiceRequest, al as InvoiceResult, am as InvoiceStatus, an as InvoiceTax, ao as InvoicingDefaultConfig, ap as InvoicingFeature, aq as InvoicingPluginConfig, ar as InvoicingStaticConfig, as as KeyValueBlock, at as KeyValueRow, au as LayoutMode, av as Logger, aw as MarkdownBlock, ax as MessageVariant, ay as PaymentCard, az as PaymentConnect, aA as PaymentConnectExchange, aB as PaymentConnectParams, aC as PaymentCustomer, aD as PaymentGatewayCode, aE as PaymentMerchantPricing, aF as PaymentPayload, aG as PaymentPluginConfig, aH as PaymentRenderMode, aI as PaymentResult, aJ as PaymentSessionFees, aK as PaymentSessionPayload, aL as PaymentSessionResult, aM as PaymentSettlementFees, aN as PaymentVerifyPayload, aO as PaymentWebhookSettlement, aP as PlaceSupplierOrderInput, aQ as Plugin, aR as PluginActionContext, aS as PluginActionResult, aT as PluginAuthor, aU as PluginConfigFieldDependency, aV as PluginFactory, aW as PluginManifest, aX as RepeaterBlock, aY as RepeaterSource, aZ as SecretStore, a_ as SequenceStore, a$ as SetupAction, b0 as SetupLayout, b1 as SetupLayoutValidation, b2 as SetupStep, b3 as ShipmentAddress, b4 as ShipmentParcel, b5 as ShipmentResult, b6 as ShippingDefaultConfig, b7 as ShippingFeature, b8 as ShippingPluginConfig, b9 as ShippingQuote, ba as ShippingQuoteParams, bb as ShippingStaticConfig, bc as StepStatusFrom, bd as StepStatusFromAction, be as StepStatusFromFields, bf as StepStatusSource, bg as StorageBroker, bh as SupplierCatalogQuery, bi as SupplierFulfillmentEvent, bj as SupplierListing, bk as SupplierListingAttribute, bl as SupplierListingPage, bm as SupplierListingVariant, bn as SupplierMoney, bo as SupplierOrderAddressLevel, bp as SupplierOrderCustomer, bq as SupplierOrderLine, br as SupplierOrderResult, bs as SupplierOrderStatus, bt as SupplierShipTo, bu as SupplierShippingQuote, bv as SupplierShippingQuoteInput, bw as SupplierStock, bx as SuppliersDefaultConfig, by as SuppliersFeature, bz as SuppliersPluginConfig, bA as SuppliersStaticConfig, bB as TabItem, bC as TabsBlock, bD as ToggleBlock, bE as TrackingEvent, bF as TransactionStatus, bG as UiContribution, bH as UiContributionsValidation, bI as VoidInvoiceInput, bJ as WebhookSignatureResult, bK as analyticsCapability, bL as capability, bM as crossValidateSetupLayout, bN as definePlugin, bO as invoicingCapability, bP as isConfigurablePlugin, bQ as isPluginFactory, bR as minorUnitDigits, bS as paymentCapability, bT as shippingCapability, bU as suppliersCapability, bV as toMajorUnits, bW as toMinorUnits, bX as uiCapability, bY as validatePluginAuthor, bZ as validateSetupLayout, b_ as validateUiContributions } from './host-api-CuLAVsQ2.js';
+import { F as FieldType, C as ConfigScope, S as SelectOption, P as PluginConfigField } from './host-api-C5EsRbsA.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 AnalyticsPurchasePolicy, n as AnalyticsStaticConfig, o as AnalyticsUserData, p as AnalyticsUtm, q as AuthorValidation, B as BannerBlock, r as Block, s as BlockBase, t as BlockType, u as CalloutBlock, v as Capability, w as CapabilityKind, x as CardBlock, y as CardBrand, z as CarrierServiceMode, D as CarrierSettlement, E as CatalogReader, G as ChartBlock, H as ChartSeries, I as CodConfig, J as CodFeeConfig, K as CodFeeType, L as CodPurchaseTrigger, M as ConditionalBlock, N as ConditionalEquals, O as ConditionalWhen, Q as ConfigurablePlugin, R as ContentActionVariant, T as ContentBlock, U as ContentBlockType, V as CopyFieldBlock, W as CreateShipmentParams, X as DetailsBlock, Y as DispatchContext, Z as DividerBlock, _ as DomainEventHandler, $ as DomainEventName, a0 as EmbedInit, a1 as FieldBlock, a2 as FieldOption, a3 as FieldVariant, a4 as FilterBlock, a5 as FilterOption, a6 as GatewayEnvironment, a7 as GatewayFeeConfig, a8 as GatewayStaticConfig, a9 as GridBlock, aa as GroupBlock, ab as HostApi, ac as HttpClient, ad as HttpRequest, ae as HttpResponse, af as IAnalyticsPlugin, ag as IInvoicingPlugin, ah as IPaymentPlugin, ai as IPlugin, aj as IShippingPlugin, ak as ISuppliersPlugin, al as IUiPlugin, am as InlineRowBlock, an as InvoiceDocumentType, ao as InvoiceLine, ap as InvoiceMoney, aq as InvoiceParty, ar as InvoiceRequest, as as InvoiceResult, at as InvoiceStatus, au as InvoiceTax, av as InvoicingDefaultConfig, aw as InvoicingFeature, ax as InvoicingPluginConfig, ay as InvoicingStaticConfig, az as KeyValueBlock, aA as KeyValueRow, aB as LayoutMode, aC as LinkBlock, aD as Logger, aE as MarkdownBlock, aF as MessageVariant, aG as PageParams, aH as PaymentCard, aI as PaymentConnect, aJ as PaymentConnectExchange, aK as PaymentConnectParams, aL as PaymentCustomer, aM as PaymentGatewayCode, aN as PaymentMerchantPricing, aO as PaymentPayload, aP as PaymentPluginConfig, aQ as PaymentRenderMode, aR as PaymentResult, aS as PaymentSessionFees, aT as PaymentSessionPayload, aU as PaymentSessionResult, aV as PaymentSettlementFees, aW as PaymentVerifyPayload, aX as PaymentWebhookSettlement, aY as PlaceSupplierOrderInput, aZ as Plugin, a_ as PluginActionContext, a$ as PluginActionResult, b0 as PluginAuthor, b1 as PluginConfigFieldDependency, b2 as PluginFactory, b3 as PluginManifest, b4 as RepeaterBlock, b5 as RepeaterSource, b6 as SearchBlock, b7 as SecretStore, b8 as SequenceStore, b9 as SetupAction, ba as SetupLayout, bb as SetupLayoutValidation, bc as SetupStep, bd as ShipmentAddress, be as ShipmentParcel, bf as ShipmentResult, bg as ShippingDefaultConfig, bh as ShippingFeature, bi as ShippingPluginConfig, bj as ShippingQuote, bk as ShippingQuoteParams, bl as ShippingStaticConfig, bm as SourcedProduct, bn as StatBlock, bo as StepStatusFrom, bp as StepStatusFromAction, bq as StepStatusFromFields, br as StepStatusSource, bs as StorageBroker, bt as SupplierCatalogQuery, bu as SupplierFulfillmentEvent, bv as SupplierListing, bw as SupplierListingAttribute, bx as SupplierListingPage, by as SupplierListingVariant, bz as SupplierMoney, bA as SupplierOrderAddressLevel, bB as SupplierOrderCustomer, bC as SupplierOrderLine, bD as SupplierOrderResult, bE as SupplierOrderStatus, bF as SupplierShipTo, bG as SupplierShippingQuote, bH as SupplierShippingQuoteInput, bI as SupplierStock, bJ as SuppliersDefaultConfig, bK as SuppliersFeature, bL as SuppliersPluginConfig, bM as SuppliersStaticConfig, bN as TabItem, bO as TableBlock, bP as TableCell, bQ as TableColumn, bR as TableColumnSort, bS as TablePagination, bT as TableRichCell, bU as TableSort, bV as TabsBlock, bW as ToggleBlock, bX as ToolbarBlock, bY as TrackingEvent, bZ as TransactionStatus, b_ as UiContribution, b$ as UiContributionsValidation, c0 as UiSlot, c1 as UiSlotContext, c2 as VoidInvoiceInput, c3 as WebhookSignatureResult, c4 as analyticsCapability, c5 as capability, c6 as crossValidateSetupLayout, c7 as definePlugin, c8 as invoicingCapability, c9 as isConfigurablePlugin, ca as isPluginFactory, cb as minorUnitDigits, cc as paymentCapability, cd as shippingCapability, ce as suppliersCapability, cf as toMajorUnits, cg as toMinorUnits, ch as uiCapability, ci as validatePluginAuthor, cj as validateSetupLayout, ck as validateUiContributions } from './host-api-C5EsRbsA.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.7.0";
+declare const SDK_VERSION = "0.7.2";
 /**
  * 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

@@ -48,6 +48,7 @@ __export(index_exports, {
   StepStatusFrom: () => StepStatusFrom,
   SuppliersFeature: () => SuppliersFeature,
   TransactionStatus: () => TransactionStatus,
+  UiSlot: () => UiSlot,
   analyticsCapability: () => analyticsCapability,
   capability: () => capability,
   checkPermissions: () => checkPermissions,
@@ -568,8 +569,20 @@ var ContentBlockType = /* @__PURE__ */ ((ContentBlockType2) => {
   ContentBlockType2["Divider"] = "divider";
   ContentBlockType2["Action"] = "action";
   ContentBlockType2["Card"] = "card";
+  ContentBlockType2["Stat"] = "stat";
+  ContentBlockType2["Table"] = "table";
+  ContentBlockType2["Chart"] = "chart";
+  ContentBlockType2["Filter"] = "filter";
+  ContentBlockType2["Grid"] = "grid";
+  ContentBlockType2["Search"] = "search";
+  ContentBlockType2["Details"] = "details";
+  ContentBlockType2["Toolbar"] = "toolbar";
   return ContentBlockType2;
 })(ContentBlockType || {});
+var UiSlot = {
+  /** Full-page surface of an app in the admin (the app owns the whole body). */
+  AdminAppPage: "admin:app.page"
+};
 var ContentActionVariant = /* @__PURE__ */ ((ContentActionVariant2) => {
   ContentActionVariant2["Primary"] = "primary";
   ContentActionVariant2["Secondary"] = "secondary";
@@ -611,12 +624,14 @@ var sCopyFieldBlock2 = (0, import_superstruct3.object)({
   value: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
   computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)())
 });
+var sPageParams = (0, import_superstruct3.record)((0, import_superstruct3.string)(), (0, import_superstruct3.union)([(0, import_superstruct3.string)(), (0, import_superstruct3.literal)(null)]));
 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)())
+  external: (0, import_superstruct3.optional)((0, import_superstruct3.boolean)()),
+  params: (0, import_superstruct3.optional)(sPageParams)
 });
 var sDividerBlock2 = (0, import_superstruct3.object)({ type: (0, import_superstruct3.literal)("divider" /* Divider */) });
 var sActionBlock2 = (0, import_superstruct3.object)({
@@ -625,6 +640,110 @@ var sActionBlock2 = (0, import_superstruct3.object)({
   label: (0, import_superstruct3.string)(),
   variant: (0, import_superstruct3.optional)(sContentActionVariant)
 });
+var sTableCell = (0, import_superstruct3.union)([
+  (0, import_superstruct3.string)(),
+  (0, import_superstruct3.number)(),
+  (0, import_superstruct3.boolean)(),
+  (0, import_superstruct3.literal)(null),
+  (0, import_superstruct3.object)({
+    text: (0, import_superstruct3.string)(),
+    caption: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+    image: (0, import_superstruct3.optional)((0, import_superstruct3.union)([(0, import_superstruct3.string)(), (0, import_superstruct3.literal)(null)])),
+    tone: (0, import_superstruct3.optional)(sMessageVariant2)
+  })
+]);
+var sStatBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("stat" /* Stat */),
+  label: (0, import_superstruct3.string)(),
+  value: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  computedKey: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  hint: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  variant: (0, import_superstruct3.optional)(sMessageVariant2),
+  estimate: (0, import_superstruct3.optional)((0, import_superstruct3.boolean)()),
+  params: (0, import_superstruct3.optional)(sPageParams)
+});
+var sTableBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("table" /* Table */),
+  title: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  columns: (0, import_superstruct3.array)(
+    (0, import_superstruct3.object)({
+      key: (0, import_superstruct3.string)(),
+      label: (0, import_superstruct3.string)(),
+      align: (0, import_superstruct3.optional)((0, import_superstruct3.enums)(["left", "right"])),
+      hint: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+      sort: (0, import_superstruct3.optional)(
+        (0, import_superstruct3.object)({
+          value: (0, import_superstruct3.string)(),
+          dir: (0, import_superstruct3.optional)((0, import_superstruct3.enums)(["asc", "desc"]))
+        })
+      )
+    })
+  ),
+  rows: (0, import_superstruct3.array)((0, import_superstruct3.record)((0, import_superstruct3.string)(), sTableCell)),
+  emptyText: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  rowParams: (0, import_superstruct3.optional)((0, import_superstruct3.array)((0, import_superstruct3.union)([sPageParams, (0, import_superstruct3.literal)(null)]))),
+  sort: (0, import_superstruct3.optional)(
+    (0, import_superstruct3.object)({
+      param: (0, import_superstruct3.string)(),
+      value: (0, import_superstruct3.string)(),
+      resets: (0, import_superstruct3.optional)((0, import_superstruct3.array)((0, import_superstruct3.string)()))
+    })
+  ),
+  pagination: (0, import_superstruct3.optional)(
+    (0, import_superstruct3.object)({
+      param: (0, import_superstruct3.string)(),
+      page: (0, import_superstruct3.number)(),
+      pageSize: (0, import_superstruct3.number)(),
+      total: (0, import_superstruct3.number)()
+    })
+  )
+});
+var sChartBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("chart" /* Chart */),
+  kind: (0, import_superstruct3.enums)(["bar", "line", "hbar"]),
+  title: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  labels: (0, import_superstruct3.array)((0, import_superstruct3.string)()),
+  series: (0, import_superstruct3.array)(
+    (0, import_superstruct3.object)({
+      name: (0, import_superstruct3.string)(),
+      data: (0, import_superstruct3.array)((0, import_superstruct3.union)([(0, import_superstruct3.number)(), (0, import_superstruct3.literal)(null)]))
+    })
+  ),
+  unit: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  emptyText: (0, import_superstruct3.optional)((0, import_superstruct3.string)())
+});
+var sFilterBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("filter" /* Filter */),
+  param: (0, import_superstruct3.string)(),
+  label: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  value: (0, import_superstruct3.string)(),
+  options: (0, import_superstruct3.size)((0, import_superstruct3.array)((0, import_superstruct3.object)({ value: (0, import_superstruct3.string)(), label: (0, import_superstruct3.string)() })), 1, Infinity),
+  display: (0, import_superstruct3.optional)((0, import_superstruct3.enums)(["segmented", "select", "tabs"])),
+  resets: (0, import_superstruct3.optional)((0, import_superstruct3.array)((0, import_superstruct3.string)()))
+});
+var sSearchBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("search" /* Search */),
+  param: (0, import_superstruct3.string)(),
+  value: (0, import_superstruct3.string)(),
+  label: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  placeholder: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
+  resets: (0, import_superstruct3.optional)((0, import_superstruct3.array)((0, import_superstruct3.string)()))
+});
+var sToolbarBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("toolbar" /* Toolbar */),
+  blocks: (0, import_superstruct3.array)((0, import_superstruct3.lazy)(() => sContentBlock))
+});
+var sGridBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("grid" /* Grid */),
+  columns: (0, import_superstruct3.union)([(0, import_superstruct3.literal)(2), (0, import_superstruct3.literal)(3), (0, import_superstruct3.literal)(4)]),
+  blocks: (0, import_superstruct3.array)((0, import_superstruct3.lazy)(() => sContentBlock))
+});
+var sDetailsBlock = (0, import_superstruct3.object)({
+  type: (0, import_superstruct3.literal)("details" /* Details */),
+  summary: (0, import_superstruct3.string)(),
+  blocks: (0, import_superstruct3.array)((0, import_superstruct3.lazy)(() => sContentBlock)),
+  open: (0, import_superstruct3.optional)((0, import_superstruct3.boolean)())
+});
 var sCardBlock2 = (0, import_superstruct3.object)({
   type: (0, import_superstruct3.literal)("card" /* Card */),
   title: (0, import_superstruct3.optional)((0, import_superstruct3.string)()),
@@ -640,7 +759,15 @@ var sContentBlock = (0, import_superstruct3.union)([
   sLinkBlock,
   sDividerBlock2,
   sActionBlock2,
-  sCardBlock2
+  sCardBlock2,
+  sStatBlock,
+  sTableBlock,
+  sChartBlock,
+  sFilterBlock,
+  sGridBlock,
+  sSearchBlock,
+  sDetailsBlock,
+  sToolbarBlock
 ]);
 var sUiContribution = (0, import_superstruct3.object)({
   slot: (0, import_superstruct3.string)(),
@@ -741,7 +868,7 @@ function checkPermissions(required, grantedRaw) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.7.0";
+var SDK_VERSION = "0.7.2";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -786,6 +913,7 @@ function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   StepStatusFrom,
   SuppliersFeature,
   TransactionStatus,
+  UiSlot,
   analyticsCapability,
   capability,
   checkPermissions,

package/dist/index.mjs

@@ -517,6 +517,8 @@ import {
   number as number3,
   object as object2,
   optional as optional3,
+  record,
+  size,
   string as string3,
   union as union2,
   validate as validate3
@@ -531,8 +533,20 @@ var ContentBlockType = /* @__PURE__ */ ((ContentBlockType2) => {
   ContentBlockType2["Divider"] = "divider";
   ContentBlockType2["Action"] = "action";
   ContentBlockType2["Card"] = "card";
+  ContentBlockType2["Stat"] = "stat";
+  ContentBlockType2["Table"] = "table";
+  ContentBlockType2["Chart"] = "chart";
+  ContentBlockType2["Filter"] = "filter";
+  ContentBlockType2["Grid"] = "grid";
+  ContentBlockType2["Search"] = "search";
+  ContentBlockType2["Details"] = "details";
+  ContentBlockType2["Toolbar"] = "toolbar";
   return ContentBlockType2;
 })(ContentBlockType || {});
+var UiSlot = {
+  /** Full-page surface of an app in the admin (the app owns the whole body). */
+  AdminAppPage: "admin:app.page"
+};
 var ContentActionVariant = /* @__PURE__ */ ((ContentActionVariant2) => {
   ContentActionVariant2["Primary"] = "primary";
   ContentActionVariant2["Secondary"] = "secondary";
@@ -574,12 +588,14 @@ var sCopyFieldBlock2 = object2({
   value: optional3(string3()),
   computedKey: optional3(string3())
 });
+var sPageParams = record(string3(), union2([string3(), literal2(null)]));
 var sLinkBlock = object2({
   type: literal2("link" /* Link */),
   label: string3(),
   href: optional3(string3()),
   computedKey: optional3(string3()),
-  external: optional3(boolean3())
+  external: optional3(boolean3()),
+  params: optional3(sPageParams)
 });
 var sDividerBlock2 = object2({ type: literal2("divider" /* Divider */) });
 var sActionBlock2 = object2({
@@ -588,6 +604,110 @@ var sActionBlock2 = object2({
   label: string3(),
   variant: optional3(sContentActionVariant)
 });
+var sTableCell = union2([
+  string3(),
+  number3(),
+  boolean3(),
+  literal2(null),
+  object2({
+    text: string3(),
+    caption: optional3(string3()),
+    image: optional3(union2([string3(), literal2(null)])),
+    tone: optional3(sMessageVariant2)
+  })
+]);
+var sStatBlock = object2({
+  type: literal2("stat" /* Stat */),
+  label: string3(),
+  value: optional3(string3()),
+  computedKey: optional3(string3()),
+  hint: optional3(string3()),
+  variant: optional3(sMessageVariant2),
+  estimate: optional3(boolean3()),
+  params: optional3(sPageParams)
+});
+var sTableBlock = object2({
+  type: literal2("table" /* Table */),
+  title: optional3(string3()),
+  columns: array2(
+    object2({
+      key: string3(),
+      label: string3(),
+      align: optional3(enums3(["left", "right"])),
+      hint: optional3(string3()),
+      sort: optional3(
+        object2({
+          value: string3(),
+          dir: optional3(enums3(["asc", "desc"]))
+        })
+      )
+    })
+  ),
+  rows: array2(record(string3(), sTableCell)),
+  emptyText: optional3(string3()),
+  rowParams: optional3(array2(union2([sPageParams, literal2(null)]))),
+  sort: optional3(
+    object2({
+      param: string3(),
+      value: string3(),
+      resets: optional3(array2(string3()))
+    })
+  ),
+  pagination: optional3(
+    object2({
+      param: string3(),
+      page: number3(),
+      pageSize: number3(),
+      total: number3()
+    })
+  )
+});
+var sChartBlock = object2({
+  type: literal2("chart" /* Chart */),
+  kind: enums3(["bar", "line", "hbar"]),
+  title: optional3(string3()),
+  labels: array2(string3()),
+  series: array2(
+    object2({
+      name: string3(),
+      data: array2(union2([number3(), literal2(null)]))
+    })
+  ),
+  unit: optional3(string3()),
+  emptyText: optional3(string3())
+});
+var sFilterBlock = object2({
+  type: literal2("filter" /* Filter */),
+  param: string3(),
+  label: optional3(string3()),
+  value: string3(),
+  options: size(array2(object2({ value: string3(), label: string3() })), 1, Infinity),
+  display: optional3(enums3(["segmented", "select", "tabs"])),
+  resets: optional3(array2(string3()))
+});
+var sSearchBlock = object2({
+  type: literal2("search" /* Search */),
+  param: string3(),
+  value: string3(),
+  label: optional3(string3()),
+  placeholder: optional3(string3()),
+  resets: optional3(array2(string3()))
+});
+var sToolbarBlock = object2({
+  type: literal2("toolbar" /* Toolbar */),
+  blocks: array2(lazy2(() => sContentBlock))
+});
+var sGridBlock = object2({
+  type: literal2("grid" /* Grid */),
+  columns: union2([literal2(2), literal2(3), literal2(4)]),
+  blocks: array2(lazy2(() => sContentBlock))
+});
+var sDetailsBlock = object2({
+  type: literal2("details" /* Details */),
+  summary: string3(),
+  blocks: array2(lazy2(() => sContentBlock)),
+  open: optional3(boolean3())
+});
 var sCardBlock2 = object2({
   type: literal2("card" /* Card */),
   title: optional3(string3()),
@@ -603,7 +723,15 @@ var sContentBlock = union2([
   sLinkBlock,
   sDividerBlock2,
   sActionBlock2,
-  sCardBlock2
+  sCardBlock2,
+  sStatBlock,
+  sTableBlock,
+  sChartBlock,
+  sFilterBlock,
+  sGridBlock,
+  sSearchBlock,
+  sDetailsBlock,
+  sToolbarBlock
 ]);
 var sUiContribution = object2({
   slot: string3(),
@@ -672,7 +800,7 @@ function isPluginFactory(value) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.7.0";
+var SDK_VERSION = "0.7.2";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
@@ -716,6 +844,7 @@ export {
   StepStatusFrom,
   SuppliersFeature,
   TransactionStatus,
+  UiSlot,
   analyticsCapability,
   capability,
   checkPermissions,

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { a4 as HostApi, a6 as HttpRequest, X as DomainEventName, v as Capability, W as DomainEventHandler, a7 as HttpResponse, U as DispatchContext } from '../host-api-CuLAVsQ2.mjs';
+import { ab as HostApi, ad as HttpRequest, $ as DomainEventName, v as Capability, _ as DomainEventHandler, ae as HttpResponse, bm as SourcedProduct, Y as DispatchContext } from '../host-api-C5EsRbsA.mjs';
 
 /** Every recorded interaction, keyed by `"port.method"`. */
 interface MockHostCalls {
@@ -10,6 +10,7 @@ interface MockHostCalls {
         body: Uint8Array | string;
     }>;
     'sequence.next': string[];
+    'catalog.listSourcedProducts': string[];
     'host.on': DomainEventName[];
 }
 interface MockHostOptions {
@@ -29,6 +30,11 @@ interface MockHostOptions {
     httpResponses?: Record<string, HttpResponse>;
     /** Seed values for named sequence scopes (monotonic from here). */
     sequences?: Record<string, number>;
+    /**
+     * Canned store products by supplier code (sourced products). When set, the mock exposes
+     * `catalog`; omit it to test a plugin against a host without that port.
+     */
+    sourcedProducts?: Record<string, SourcedProduct[]>;
 }
 interface MockHostApi extends HostApi {
     /** Every port call recorded in order. */

package/dist/testing/index.d.ts

@@ -1,4 +1,4 @@
-import { a4 as HostApi, a6 as HttpRequest, X as DomainEventName, v as Capability, W as DomainEventHandler, a7 as HttpResponse, U as DispatchContext } from '../host-api-CuLAVsQ2.js';
+import { ab as HostApi, ad as HttpRequest, $ as DomainEventName, v as Capability, _ as DomainEventHandler, ae as HttpResponse, bm as SourcedProduct, Y as DispatchContext } from '../host-api-C5EsRbsA.js';
 
 /** Every recorded interaction, keyed by `"port.method"`. */
 interface MockHostCalls {
@@ -10,6 +10,7 @@ interface MockHostCalls {
         body: Uint8Array | string;
     }>;
     'sequence.next': string[];
+    'catalog.listSourcedProducts': string[];
     'host.on': DomainEventName[];
 }
 interface MockHostOptions {
@@ -29,6 +30,11 @@ interface MockHostOptions {
     httpResponses?: Record<string, HttpResponse>;
     /** Seed values for named sequence scopes (monotonic from here). */
     sequences?: Record<string, number>;
+    /**
+     * Canned store products by supplier code (sourced products). When set, the mock exposes
+     * `catalog`; omit it to test a plugin against a host without that port.
+     */
+    sourcedProducts?: Record<string, SourcedProduct[]>;
 }
 interface MockHostApi extends HostApi {
     /** Every port call recorded in order. */

package/dist/testing/index.js

@@ -66,6 +66,7 @@ function createMockHostApi(opts = {}) {
     "storage.getUrl": [],
     "storage.put": [],
     "sequence.next": [],
+    "catalog.listSourcedProducts": [],
     "host.on": []
   };
   const registered = [];
@@ -128,12 +129,20 @@ function createMockHostApi(opts = {}) {
       return Promise.resolve(next);
     }
   };
+  const listings = opts.sourcedProducts;
+  const catalog = listings ? {
+    listSourcedProducts: (code) => {
+      calls["catalog.listSourcedProducts"].push(code);
+      return Promise.resolve(listings[code] ?? []);
+    }
+  } : void 0;
   const host = {
     logger,
     http,
     secrets,
     storage,
     sequence,
+    ...catalog ? { catalog } : {},
     calls,
     registered,
     handlers,

package/dist/testing/index.mjs

@@ -11,6 +11,7 @@ function createMockHostApi(opts = {}) {
     "storage.getUrl": [],
     "storage.put": [],
     "sequence.next": [],
+    "catalog.listSourcedProducts": [],
     "host.on": []
   };
   const registered = [];
@@ -73,12 +74,20 @@ function createMockHostApi(opts = {}) {
       return Promise.resolve(next);
     }
   };
+  const listings = opts.sourcedProducts;
+  const catalog = listings ? {
+    listSourcedProducts: (code) => {
+      calls["catalog.listSourcedProducts"].push(code);
+      return Promise.resolve(listings[code] ?? []);
+    }
+  } : void 0;
   const host = {
     logger,
     http,
     secrets,
     storage,
     sequence,
+    ...catalog ? { catalog } : {},
     calls,
     registered,
     handlers,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vivoa/plugin-sdk",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Public contracts for Vivoa plugins (types, DI tokens, config + setup-layout validators)",
   "license": "MIT",
   "author": "Vivoa",