@vivoa/plugin-sdk 0.7.1 → 0.7.2

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

@@ -991,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;
@@ -1586,8 +1592,28 @@ declare enum ContentBlockType {
     /** Read-only table of scalar cells. Pure JSON data. */
     Table = "table",
     /** Simple bar/line chart over labelled series. Pure JSON data. */
-    Chart = "chart"
+    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
@@ -1647,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;
@@ -1682,14 +1710,58 @@ interface StatBlock {
     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';
 }
-type TableCell = string | number | boolean | null;
 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[];
 }
-/** Read-only table. Cells are scalars looked up by `columns[].key`. */
+/**
+ * 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;
@@ -1697,23 +1769,86 @@ interface TableBlock {
     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 x axis, every series aligns to it. */
+/**
+ * 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';
+    kind: 'bar' | 'line' | 'hbar';
     title?: string;
     labels: string[];
     series: ChartSeries[];
     unit?: string;
     emptyText?: string;
 }
-type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock | StatBlock | TableBlock | ChartBlock;
+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
@@ -1859,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>;
 /**
@@ -1874,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 { type FieldBlock as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CarrierSettlement as D, type ChartBlock as E, FieldType as F, type ChartSeries as G, type CodConfig as H, type CodFeeConfig as I, CodFeeType as J, type CodPurchaseTrigger as K, type ConditionalBlock as L, type ConditionalEquals as M, type ConditionalWhen as N, type ConfigurablePlugin as O, type PluginConfigField as P, ContentActionVariant as Q, type ContentBlock as R, type SelectOption as S, ContentBlockType as T, type CopyFieldBlock$1 as U, type CreateShipmentParams as V, type DispatchContext as W, type DividerBlock$1 as X, type DomainEventHandler as Y, type DomainEventName as Z, type EmbedInit as _, type AccordionBlock as a, type SecretStore as a$, type FieldOption as a0, FieldVariant as a1, GatewayEnvironment as a2, type GatewayFeeConfig as a3, type GatewayStaticConfig as a4, type GroupBlock as a5, type HostApi as a6, type HttpClient as a7, type HttpRequest as a8, type HttpResponse as a9, type PaymentCard as aA, type PaymentConnect as aB, type PaymentConnectExchange as aC, type PaymentConnectParams as aD, type PaymentCustomer as aE, type PaymentGatewayCode as aF, type PaymentMerchantPricing as aG, type PaymentPayload as aH, type PaymentPluginConfig as aI, type PaymentRenderMode as aJ, type PaymentResult as aK, type PaymentSessionFees as aL, type PaymentSessionPayload as aM, type PaymentSessionResult as aN, type PaymentSettlementFees as aO, type PaymentVerifyPayload as aP, type PaymentWebhookSettlement as aQ, type PlaceSupplierOrderInput as aR, type Plugin as aS, type PluginActionContext as aT, type PluginActionResult as aU, type PluginAuthor as aV, type PluginConfigFieldDependency as aW, type PluginFactory as aX, type PluginManifest as aY, type RepeaterBlock as aZ, RepeaterSource as a_, type IAnalyticsPlugin as aa, type IInvoicingPlugin as ab, type IPaymentPlugin as ac, type IPlugin as ad, type IShippingPlugin as ae, type ISuppliersPlugin as af, type IUiPlugin as ag, type InlineRowBlock as ah, InvoiceDocumentType as ai, type InvoiceLine as aj, type InvoiceMoney as ak, type InvoiceParty as al, type InvoiceRequest as am, type InvoiceResult as an, InvoiceStatus as ao, type InvoiceTax as ap, type InvoicingDefaultConfig as aq, InvoicingFeature as ar, type InvoicingPluginConfig as as, type InvoicingStaticConfig as at, type KeyValueBlock$1 as au, type KeyValueRow$1 as av, LayoutMode as aw, type Logger as ax, type MarkdownBlock as ay, MessageVariant as az, type AccordionSection as b, shippingCapability as b$, type SequenceStore as b0, type SetupAction as b1, type SetupLayout as b2, type SetupLayoutValidation as b3, type SetupStep as b4, type ShipmentAddress as b5, type ShipmentParcel as b6, type ShipmentResult as b7, type ShippingDefaultConfig as b8, ShippingFeature as b9, type SuppliersDefaultConfig as bA, SuppliersFeature as bB, type SuppliersPluginConfig as bC, type SuppliersStaticConfig as bD, type TabItem as bE, type TableBlock as bF, type TableCell as bG, type TableColumn as bH, type TabsBlock as bI, type ToggleBlock as bJ, type TrackingEvent as bK, TransactionStatus as bL, type UiContribution as bM, type UiContributionsValidation as bN, UiSlot as bO, type UiSlotContext as bP, type VoidInvoiceInput as bQ, type WebhookSignatureResult as bR, analyticsCapability as bS, capability as bT, crossValidateSetupLayout as bU, definePlugin as bV, invoicingCapability as bW, isConfigurablePlugin as bX, isPluginFactory as bY, minorUnitDigits as bZ, paymentCapability as b_, type ShippingPluginConfig as ba, type ShippingQuote as bb, type ShippingQuoteParams as bc, type ShippingStaticConfig as bd, type StatBlock as be, StepStatusFrom as bf, type StepStatusFromAction as bg, type StepStatusFromFields as bh, type StepStatusSource as bi, type StorageBroker as bj, type SupplierCatalogQuery as bk, type SupplierFulfillmentEvent as bl, type SupplierListing as bm, type SupplierListingAttribute as bn, type SupplierListingPage as bo, type SupplierListingVariant as bp, type SupplierMoney as bq, type SupplierOrderAddressLevel as br, type SupplierOrderCustomer as bs, type SupplierOrderLine as bt, type SupplierOrderResult as bu, type SupplierOrderStatus as bv, type SupplierShipTo as bw, type SupplierShippingQuote as bx, type SupplierShippingQuoteInput as by, type SupplierStock as bz, type ActionBlock$1 as c, suppliersCapability as c0, toMajorUnits as c1, toMinorUnits as c2, uiCapability as c3, validatePluginAuthor as c4, validateSetupLayout as c5, validateUiContributions as c6, 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-DVbKGytN.d.ts → host-api-C5EsRbsA.d.ts}

@@ -991,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;
@@ -1586,8 +1592,28 @@ declare enum ContentBlockType {
     /** Read-only table of scalar cells. Pure JSON data. */
     Table = "table",
     /** Simple bar/line chart over labelled series. Pure JSON data. */
-    Chart = "chart"
+    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
@@ -1647,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;
@@ -1682,14 +1710,58 @@ interface StatBlock {
     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';
 }
-type TableCell = string | number | boolean | null;
 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[];
 }
-/** Read-only table. Cells are scalars looked up by `columns[].key`. */
+/**
+ * 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;
@@ -1697,23 +1769,86 @@ interface TableBlock {
     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 x axis, every series aligns to it. */
+/**
+ * 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';
+    kind: 'bar' | 'line' | 'hbar';
     title?: string;
     labels: string[];
     series: ChartSeries[];
     unit?: string;
     emptyText?: string;
 }
-type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock | StatBlock | TableBlock | ChartBlock;
+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
@@ -1859,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>;
 /**
@@ -1874,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 { type FieldBlock as $, AUTHOR_HANDLE_RE as A, type BannerBlock$1 as B, ConfigScope as C, type CarrierSettlement as D, type ChartBlock as E, FieldType as F, type ChartSeries as G, type CodConfig as H, type CodFeeConfig as I, CodFeeType as J, type CodPurchaseTrigger as K, type ConditionalBlock as L, type ConditionalEquals as M, type ConditionalWhen as N, type ConfigurablePlugin as O, type PluginConfigField as P, ContentActionVariant as Q, type ContentBlock as R, type SelectOption as S, ContentBlockType as T, type CopyFieldBlock$1 as U, type CreateShipmentParams as V, type DispatchContext as W, type DividerBlock$1 as X, type DomainEventHandler as Y, type DomainEventName as Z, type EmbedInit as _, type AccordionBlock as a, type SecretStore as a$, type FieldOption as a0, FieldVariant as a1, GatewayEnvironment as a2, type GatewayFeeConfig as a3, type GatewayStaticConfig as a4, type GroupBlock as a5, type HostApi as a6, type HttpClient as a7, type HttpRequest as a8, type HttpResponse as a9, type PaymentCard as aA, type PaymentConnect as aB, type PaymentConnectExchange as aC, type PaymentConnectParams as aD, type PaymentCustomer as aE, type PaymentGatewayCode as aF, type PaymentMerchantPricing as aG, type PaymentPayload as aH, type PaymentPluginConfig as aI, type PaymentRenderMode as aJ, type PaymentResult as aK, type PaymentSessionFees as aL, type PaymentSessionPayload as aM, type PaymentSessionResult as aN, type PaymentSettlementFees as aO, type PaymentVerifyPayload as aP, type PaymentWebhookSettlement as aQ, type PlaceSupplierOrderInput as aR, type Plugin as aS, type PluginActionContext as aT, type PluginActionResult as aU, type PluginAuthor as aV, type PluginConfigFieldDependency as aW, type PluginFactory as aX, type PluginManifest as aY, type RepeaterBlock as aZ, RepeaterSource as a_, type IAnalyticsPlugin as aa, type IInvoicingPlugin as ab, type IPaymentPlugin as ac, type IPlugin as ad, type IShippingPlugin as ae, type ISuppliersPlugin as af, type IUiPlugin as ag, type InlineRowBlock as ah, InvoiceDocumentType as ai, type InvoiceLine as aj, type InvoiceMoney as ak, type InvoiceParty as al, type InvoiceRequest as am, type InvoiceResult as an, InvoiceStatus as ao, type InvoiceTax as ap, type InvoicingDefaultConfig as aq, InvoicingFeature as ar, type InvoicingPluginConfig as as, type InvoicingStaticConfig as at, type KeyValueBlock$1 as au, type KeyValueRow$1 as av, LayoutMode as aw, type Logger as ax, type MarkdownBlock as ay, MessageVariant as az, type AccordionSection as b, shippingCapability as b$, type SequenceStore as b0, type SetupAction as b1, type SetupLayout as b2, type SetupLayoutValidation as b3, type SetupStep as b4, type ShipmentAddress as b5, type ShipmentParcel as b6, type ShipmentResult as b7, type ShippingDefaultConfig as b8, ShippingFeature as b9, type SuppliersDefaultConfig as bA, SuppliersFeature as bB, type SuppliersPluginConfig as bC, type SuppliersStaticConfig as bD, type TabItem as bE, type TableBlock as bF, type TableCell as bG, type TableColumn as bH, type TabsBlock as bI, type ToggleBlock as bJ, type TrackingEvent as bK, TransactionStatus as bL, type UiContribution as bM, type UiContributionsValidation as bN, UiSlot as bO, type UiSlotContext as bP, type VoidInvoiceInput as bQ, type WebhookSignatureResult as bR, analyticsCapability as bS, capability as bT, crossValidateSetupLayout as bU, definePlugin as bV, invoicingCapability as bW, isConfigurablePlugin as bX, isPluginFactory as bY, minorUnitDigits as bZ, paymentCapability as b_, type ShippingPluginConfig as ba, type ShippingQuote as bb, type ShippingQuoteParams as bc, type ShippingStaticConfig as bd, type StatBlock as be, StepStatusFrom as bf, type StepStatusFromAction as bg, type StepStatusFromFields as bh, type StepStatusSource as bi, type StorageBroker as bj, type SupplierCatalogQuery as bk, type SupplierFulfillmentEvent as bl, type SupplierListing as bm, type SupplierListingAttribute as bn, type SupplierListingPage as bo, type SupplierListingVariant as bp, type SupplierMoney as bq, type SupplierOrderAddressLevel as br, type SupplierOrderCustomer as bs, type SupplierOrderLine as bt, type SupplierOrderResult as bu, type SupplierOrderStatus as bv, type SupplierShipTo as bw, type SupplierShippingQuote as bx, type SupplierShippingQuoteInput as by, type SupplierStock as bz, type ActionBlock$1 as c, suppliersCapability as c0, toMajorUnits as c1, toMinorUnits as c2, uiCapability as c3, validatePluginAuthor as c4, validateSetupLayout as c5, validateUiContributions as c6, 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-DVbKGytN.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 ChartBlock, G as ChartSeries, H as CodConfig, I as CodFeeConfig, J as CodFeeType, K as CodPurchaseTrigger, L as ConditionalBlock, M as ConditionalEquals, N as ConditionalWhen, O as ConfigurablePlugin, Q as ContentActionVariant, R as ContentBlock, T as ContentBlockType, U as CopyFieldBlock, V as CreateShipmentParams, W as DispatchContext, X as DividerBlock, Y as DomainEventHandler, Z as DomainEventName, _ as EmbedInit, $ as FieldBlock, a0 as FieldOption, a1 as FieldVariant, a2 as GatewayEnvironment, a3 as GatewayFeeConfig, a4 as GatewayStaticConfig, a5 as GroupBlock, a6 as HostApi, a7 as HttpClient, a8 as HttpRequest, a9 as HttpResponse, aa as IAnalyticsPlugin, ab as IInvoicingPlugin, ac as IPaymentPlugin, ad as IPlugin, ae as IShippingPlugin, af as ISuppliersPlugin, ag as IUiPlugin, ah as InlineRowBlock, ai as InvoiceDocumentType, aj as InvoiceLine, ak as InvoiceMoney, al as InvoiceParty, am as InvoiceRequest, an as InvoiceResult, ao as InvoiceStatus, ap as InvoiceTax, aq as InvoicingDefaultConfig, ar as InvoicingFeature, as as InvoicingPluginConfig, at as InvoicingStaticConfig, au as KeyValueBlock, av as KeyValueRow, aw as LayoutMode, ax as Logger, ay as MarkdownBlock, az as MessageVariant, aA as PaymentCard, aB as PaymentConnect, aC as PaymentConnectExchange, aD as PaymentConnectParams, aE as PaymentCustomer, aF as PaymentGatewayCode, aG as PaymentMerchantPricing, aH as PaymentPayload, aI as PaymentPluginConfig, aJ as PaymentRenderMode, aK as PaymentResult, aL as PaymentSessionFees, aM as PaymentSessionPayload, aN as PaymentSessionResult, aO as PaymentSettlementFees, aP as PaymentVerifyPayload, aQ as PaymentWebhookSettlement, aR as PlaceSupplierOrderInput, aS as Plugin, aT as PluginActionContext, aU as PluginActionResult, aV as PluginAuthor, aW as PluginConfigFieldDependency, aX as PluginFactory, aY as PluginManifest, aZ as RepeaterBlock, a_ as RepeaterSource, a$ as SecretStore, b0 as SequenceStore, b1 as SetupAction, b2 as SetupLayout, b3 as SetupLayoutValidation, b4 as SetupStep, b5 as ShipmentAddress, b6 as ShipmentParcel, b7 as ShipmentResult, b8 as ShippingDefaultConfig, b9 as ShippingFeature, ba as ShippingPluginConfig, bb as ShippingQuote, bc as ShippingQuoteParams, bd as ShippingStaticConfig, be as StatBlock, bf as StepStatusFrom, bg as StepStatusFromAction, bh as StepStatusFromFields, bi as StepStatusSource, bj as StorageBroker, bk as SupplierCatalogQuery, bl as SupplierFulfillmentEvent, bm as SupplierListing, bn as SupplierListingAttribute, bo as SupplierListingPage, bp as SupplierListingVariant, bq as SupplierMoney, br as SupplierOrderAddressLevel, bs as SupplierOrderCustomer, bt as SupplierOrderLine, bu as SupplierOrderResult, bv as SupplierOrderStatus, bw as SupplierShipTo, bx as SupplierShippingQuote, by as SupplierShippingQuoteInput, bz as SupplierStock, bA as SuppliersDefaultConfig, bB as SuppliersFeature, bC as SuppliersPluginConfig, bD as SuppliersStaticConfig, bE as TabItem, bF as TableBlock, bG as TableCell, bH as TableColumn, bI as TabsBlock, bJ as ToggleBlock, bK as TrackingEvent, bL as TransactionStatus, bM as UiContribution, bN as UiContributionsValidation, bO as UiSlot, bP as UiSlotContext, bQ as VoidInvoiceInput, bR as WebhookSignatureResult, bS as analyticsCapability, bT as capability, bU as crossValidateSetupLayout, bV as definePlugin, bW as invoicingCapability, bX as isConfigurablePlugin, bY as isPluginFactory, bZ as minorUnitDigits, b_ as paymentCapability, b$ as shippingCapability, c0 as suppliersCapability, c1 as toMajorUnits, c2 as toMinorUnits, c3 as uiCapability, c4 as validatePluginAuthor, c5 as validateSetupLayout, c6 as validateUiContributions } from './host-api-DVbKGytN.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.1";
+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-DVbKGytN.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 ChartBlock, G as ChartSeries, H as CodConfig, I as CodFeeConfig, J as CodFeeType, K as CodPurchaseTrigger, L as ConditionalBlock, M as ConditionalEquals, N as ConditionalWhen, O as ConfigurablePlugin, Q as ContentActionVariant, R as ContentBlock, T as ContentBlockType, U as CopyFieldBlock, V as CreateShipmentParams, W as DispatchContext, X as DividerBlock, Y as DomainEventHandler, Z as DomainEventName, _ as EmbedInit, $ as FieldBlock, a0 as FieldOption, a1 as FieldVariant, a2 as GatewayEnvironment, a3 as GatewayFeeConfig, a4 as GatewayStaticConfig, a5 as GroupBlock, a6 as HostApi, a7 as HttpClient, a8 as HttpRequest, a9 as HttpResponse, aa as IAnalyticsPlugin, ab as IInvoicingPlugin, ac as IPaymentPlugin, ad as IPlugin, ae as IShippingPlugin, af as ISuppliersPlugin, ag as IUiPlugin, ah as InlineRowBlock, ai as InvoiceDocumentType, aj as InvoiceLine, ak as InvoiceMoney, al as InvoiceParty, am as InvoiceRequest, an as InvoiceResult, ao as InvoiceStatus, ap as InvoiceTax, aq as InvoicingDefaultConfig, ar as InvoicingFeature, as as InvoicingPluginConfig, at as InvoicingStaticConfig, au as KeyValueBlock, av as KeyValueRow, aw as LayoutMode, ax as Logger, ay as MarkdownBlock, az as MessageVariant, aA as PaymentCard, aB as PaymentConnect, aC as PaymentConnectExchange, aD as PaymentConnectParams, aE as PaymentCustomer, aF as PaymentGatewayCode, aG as PaymentMerchantPricing, aH as PaymentPayload, aI as PaymentPluginConfig, aJ as PaymentRenderMode, aK as PaymentResult, aL as PaymentSessionFees, aM as PaymentSessionPayload, aN as PaymentSessionResult, aO as PaymentSettlementFees, aP as PaymentVerifyPayload, aQ as PaymentWebhookSettlement, aR as PlaceSupplierOrderInput, aS as Plugin, aT as PluginActionContext, aU as PluginActionResult, aV as PluginAuthor, aW as PluginConfigFieldDependency, aX as PluginFactory, aY as PluginManifest, aZ as RepeaterBlock, a_ as RepeaterSource, a$ as SecretStore, b0 as SequenceStore, b1 as SetupAction, b2 as SetupLayout, b3 as SetupLayoutValidation, b4 as SetupStep, b5 as ShipmentAddress, b6 as ShipmentParcel, b7 as ShipmentResult, b8 as ShippingDefaultConfig, b9 as ShippingFeature, ba as ShippingPluginConfig, bb as ShippingQuote, bc as ShippingQuoteParams, bd as ShippingStaticConfig, be as StatBlock, bf as StepStatusFrom, bg as StepStatusFromAction, bh as StepStatusFromFields, bi as StepStatusSource, bj as StorageBroker, bk as SupplierCatalogQuery, bl as SupplierFulfillmentEvent, bm as SupplierListing, bn as SupplierListingAttribute, bo as SupplierListingPage, bp as SupplierListingVariant, bq as SupplierMoney, br as SupplierOrderAddressLevel, bs as SupplierOrderCustomer, bt as SupplierOrderLine, bu as SupplierOrderResult, bv as SupplierOrderStatus, bw as SupplierShipTo, bx as SupplierShippingQuote, by as SupplierShippingQuoteInput, bz as SupplierStock, bA as SuppliersDefaultConfig, bB as SuppliersFeature, bC as SuppliersPluginConfig, bD as SuppliersStaticConfig, bE as TabItem, bF as TableBlock, bG as TableCell, bH as TableColumn, bI as TabsBlock, bJ as ToggleBlock, bK as TrackingEvent, bL as TransactionStatus, bM as UiContribution, bN as UiContributionsValidation, bO as UiSlot, bP as UiSlotContext, bQ as VoidInvoiceInput, bR as WebhookSignatureResult, bS as analyticsCapability, bT as capability, bU as crossValidateSetupLayout, bV as definePlugin, bW as invoicingCapability, bX as isConfigurablePlugin, bY as isPluginFactory, bZ as minorUnitDigits, b_ as paymentCapability, b$ as shippingCapability, c0 as suppliersCapability, c1 as toMajorUnits, c2 as toMinorUnits, c3 as uiCapability, c4 as validatePluginAuthor, c5 as validateSetupLayout, c6 as validateUiContributions } from './host-api-DVbKGytN.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.1";
+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

@@ -572,6 +572,11 @@ var ContentBlockType = /* @__PURE__ */ ((ContentBlockType2) => {
   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 = {
@@ -619,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)({
@@ -633,7 +640,18 @@ 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)]);
+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)(),
@@ -641,7 +659,8 @@ var sStatBlock = (0, import_superstruct3.object)({
   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)())
+  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 */),
@@ -650,15 +669,38 @@ var sTableBlock = (0, import_superstruct3.object)({
     (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"]))
+      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)())
+  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"]),
+  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)(
@@ -670,6 +712,38 @@ var sChartBlock = (0, import_superstruct3.object)({
   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)()),
@@ -688,7 +762,12 @@ var sContentBlock = (0, import_superstruct3.union)([
   sCardBlock2,
   sStatBlock,
   sTableBlock,
-  sChartBlock
+  sChartBlock,
+  sFilterBlock,
+  sGridBlock,
+  sSearchBlock,
+  sDetailsBlock,
+  sToolbarBlock
 ]);
 var sUiContribution = (0, import_superstruct3.object)({
   slot: (0, import_superstruct3.string)(),
@@ -789,7 +868,7 @@ function checkPermissions(required, grantedRaw) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.7.1";
+var SDK_VERSION = "0.7.2";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);

package/dist/index.mjs

@@ -518,6 +518,7 @@ import {
   object as object2,
   optional as optional3,
   record,
+  size,
   string as string3,
   union as union2,
   validate as validate3
@@ -535,6 +536,11 @@ var ContentBlockType = /* @__PURE__ */ ((ContentBlockType2) => {
   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 = {
@@ -582,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({
@@ -596,7 +604,18 @@ var sActionBlock2 = object2({
   label: string3(),
   variant: optional3(sContentActionVariant)
 });
-var sTableCell = union2([string3(), number3(), boolean3(), literal2(null)]);
+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(),
@@ -604,7 +623,8 @@ var sStatBlock = object2({
   computedKey: optional3(string3()),
   hint: optional3(string3()),
   variant: optional3(sMessageVariant2),
-  estimate: optional3(boolean3())
+  estimate: optional3(boolean3()),
+  params: optional3(sPageParams)
 });
 var sTableBlock = object2({
   type: literal2("table" /* Table */),
@@ -613,15 +633,38 @@ var sTableBlock = object2({
     object2({
       key: string3(),
       label: string3(),
-      align: optional3(enums3(["left", "right"]))
+      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())
+  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"]),
+  kind: enums3(["bar", "line", "hbar"]),
   title: optional3(string3()),
   labels: array2(string3()),
   series: array2(
@@ -633,6 +676,38 @@ var sChartBlock = object2({
   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()),
@@ -651,7 +726,12 @@ var sContentBlock = union2([
   sCardBlock2,
   sStatBlock,
   sTableBlock,
-  sChartBlock
+  sChartBlock,
+  sFilterBlock,
+  sGridBlock,
+  sSearchBlock,
+  sDetailsBlock,
+  sToolbarBlock
 ]);
 var sUiContribution = object2({
   slot: string3(),
@@ -720,7 +800,7 @@ function isPluginFactory(value) {
 }
 
 // src/version.ts
-var SDK_VERSION = "0.7.1";
+var SDK_VERSION = "0.7.2";
 function isSdkCompatible(pluginSdkVersion, hostSdkVersion) {
   const parse = (v) => {
     const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);

package/dist/testing/index.d.mts

@@ -1,4 +1,4 @@
-import { a6 as HostApi, a8 as HttpRequest, Z as DomainEventName, v as Capability, Y as DomainEventHandler, a9 as HttpResponse, W as DispatchContext } from '../host-api-DVbKGytN.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 { a6 as HostApi, a8 as HttpRequest, Z as DomainEventName, v as Capability, Y as DomainEventHandler, a9 as HttpResponse, W as DispatchContext } from '../host-api-DVbKGytN.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.1",
+  "version": "0.7.2",
   "description": "Public contracts for Vivoa plugins (types, DI tokens, config + setup-layout validators)",
   "license": "MIT",
   "author": "Vivoa",