@vivoa/plugin-sdk 0.7.1 → 0.8.0

package/dist/{host-api-DVbKGytN.d.ts → host-api-D9g2w27d.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;
@@ -1667,6 +1695,12 @@ interface CardBlock {
     type: ContentBlockType.Card;
     title?: string;
     description?: string;
+    /**
+     * Picture shown before the title, for a card that heads a record (a
+     * product). `null` = the record has no picture: the host shows a
+     * placeholder. Absent = no picture slot.
+     */
+    image?: string | null;
     blocks: ContentBlock[];
 }
 /**
@@ -1682,14 +1716,60 @@ 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;
+    /** Small trend line inside the stat, oldest first; `null` = a gap, never a zero. */
+    trend?: Array<number | null>;
+}
+/**
+ * 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 +1777,155 @@ 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;
+}
+/** How a chart value is written in axes and tooltips. */
+type ChartFormat = 'number' | 'currency' | 'percent';
 interface ChartSeries {
     name: string;
     /** One value per label; `null` = no observation (a gap, not a zero). */
     data: Array<number | null>;
+    /** Shown in the tooltip only, never drawn (keeps the chart on ONE axis). */
+    tooltipOnly?: boolean;
+    /** Overrides the chart's `format` for this series. */
+    format?: ChartFormat;
+}
+/** A horizontal line at a value (an average, a median, the previous period). */
+interface ChartReference {
+    value: number;
+    label: string;
+}
+/** A note pinned to one label (a sold-out day, an averaged day). */
+interface ChartMarker {
+    /** One of `labels`. */
+    label: string;
+    text: string;
+    tone?: MessageVariant;
+}
+/** A point of a `scatter`: one entity placed by two measures. */
+interface ChartPoint {
+    x: number;
+    y: number;
+    label: string;
+    /** Second line in the tooltip. */
+    caption?: string;
+    /** Clicking the point navigates (in-page, push). */
+    params?: PageParams;
+    /** Drawn in the de-emphasis gray (e.g. a thin sample). */
+    muted?: boolean;
+}
+interface ChartAxis {
+    label: string;
+    format?: ChartFormat;
+    /** `log` spreads a long tail (a few huge values among many small): ticks at powers of ten. Default `linear`. */
+    scale?: 'linear' | 'log';
 }
-/** Simple chart: `labels` is the x axis, every series aligns to it. */
+/** Splits a scatter in four at (x, y); names go top-left, top-right, bottom-left, bottom-right. */
+interface ChartQuadrants {
+    x: number;
+    y: number;
+    names?: [string, string, string, string];
+}
+/**
+ * Chart: `labels` is the category axis, every series aligns to it.
+ * `hbar` = horizontal bars, one row per label (best for long names). `scatter`
+ * ignores labels/series and plots `points`. Everything past the first four
+ * fields is optional: an older host draws the basics and ignores the rest.
+ */
 interface ChartBlock {
     type: ContentBlockType.Chart;
-    kind: 'bar' | 'line';
+    kind: 'bar' | 'line' | 'hbar' | 'area' | 'scatter';
     title?: string;
+    /** One line that says what to see in the chart; the plugin computes it. */
+    summary?: string;
     labels: string[];
     series: ChartSeries[];
     unit?: string;
+    format?: ChartFormat;
+    /** Currency code for `format: 'currency'`. */
+    currency?: string;
     emptyText?: string;
+    /** Aligned with `labels`: a label with params is clickable (in-page, push). */
+    labelParams?: Array<PageParams | null>;
+    /** Index of the label to emphasise; the others turn gray. */
+    highlight?: number;
+    references?: ChartReference[];
+    markers?: ChartMarker[];
+    /** Stack the series (bar, hbar). */
+    stacked?: boolean;
+    points?: ChartPoint[];
+    xAxis?: ChartAxis;
+    yAxis?: ChartAxis;
+    quadrants?: ChartQuadrants;
+}
+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;
 }
-type ContentBlock = TextBlock | BannerBlock | BadgeBlock | KeyValueBlock | CopyFieldBlock | LinkBlock | DividerBlock | ActionBlock | CardBlock | StatBlock | TableBlock | ChartBlock;
+/**
+ * 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[];
+}
+/**
+ * How a grid shares the width. `even` (default): `columns` equal columns.
+ * `main-aside`: the first block is a wide main column and the rest stack in a
+ * narrow side column (a record page: charts left, facts right); `columns` is
+ * ignored.
+ */
+type GridLayout = 'even' | 'main-aside';
+/** Child blocks in `columns` responsive columns (one column on narrow screens). */
+interface GridBlock {
+    type: ContentBlockType.Grid;
+    columns: 2 | 3 | 4;
+    layout?: GridLayout;
+    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 +2071,39 @@ 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;
+    /**
+     * `true` when the product is priced under what its supplier charges TODAY
+     * (cost + supplier fee), and the owner has not accepted selling that way.
+     * The host owns the margin rules, so a plugin shows this instead of redoing
+     * the math. Absent = this host does not say.
+     */
+    belowFloor?: boolean;
+}
+/**
+ * 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 +2119,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 CopyFieldBlock$1 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 ChartAxis as G, type ChartBlock as H, type ChartFormat as I, type ChartMarker as J, type ChartPoint as K, type ChartQuadrants as L, type ChartReference as M, type ChartSeries as N, type CodConfig as O, type PluginConfigField as P, type CodFeeConfig as Q, CodFeeType as R, type SelectOption as S, type CodPurchaseTrigger as T, type ConditionalBlock as U, type ConditionalEquals as V, type ConditionalWhen as W, type ConfigurablePlugin as X, ContentActionVariant as Y, type ContentBlock as Z, ContentBlockType as _, type AccordionBlock as a, type PaymentSessionResult as a$, type CreateShipmentParams as a0, type DetailsBlock as a1, type DispatchContext as a2, type DividerBlock$1 as a3, type DomainEventHandler as a4, type DomainEventName as a5, type EmbedInit as a6, type FieldBlock as a7, type FieldOption as a8, FieldVariant as a9, InvoiceStatus as aA, type InvoiceTax as aB, type InvoicingDefaultConfig as aC, InvoicingFeature as aD, type InvoicingPluginConfig as aE, type InvoicingStaticConfig as aF, type KeyValueBlock$1 as aG, type KeyValueRow$1 as aH, LayoutMode as aI, type LinkBlock as aJ, type Logger as aK, type MarkdownBlock as aL, MessageVariant as aM, type PageParams as aN, type PaymentCard as aO, type PaymentConnect as aP, type PaymentConnectExchange as aQ, type PaymentConnectParams as aR, type PaymentCustomer as aS, type PaymentGatewayCode as aT, type PaymentMerchantPricing as aU, type PaymentPayload as aV, type PaymentPluginConfig as aW, type PaymentRenderMode as aX, type PaymentResult as aY, type PaymentSessionFees as aZ, type PaymentSessionPayload as a_, type FilterBlock as aa, type FilterOption as ab, GatewayEnvironment as ac, type GatewayFeeConfig as ad, type GatewayStaticConfig as ae, type GridBlock as af, type GridLayout as ag, type GroupBlock as ah, type HostApi as ai, type HttpClient as aj, type HttpRequest as ak, type HttpResponse as al, type IAnalyticsPlugin as am, type IInvoicingPlugin as an, type IPaymentPlugin as ao, type IPlugin as ap, type IShippingPlugin as aq, type ISuppliersPlugin as ar, type IUiPlugin as as, type InlineRowBlock as at, InvoiceDocumentType as au, type InvoiceLine as av, type InvoiceMoney as aw, type InvoiceParty as ax, type InvoiceRequest as ay, type InvoiceResult as az, type AccordionSection as b, type TableSort as b$, type PaymentSettlementFees as b0, type PaymentVerifyPayload as b1, type PaymentWebhookSettlement as b2, type PlaceSupplierOrderInput as b3, type Plugin as b4, type PluginActionContext as b5, type PluginActionResult as b6, type PluginAuthor as b7, type PluginConfigFieldDependency as b8, type PluginFactory as b9, type SupplierCatalogQuery as bA, type SupplierFulfillmentEvent as bB, type SupplierListing as bC, type SupplierListingAttribute as bD, type SupplierListingPage as bE, type SupplierListingVariant as bF, type SupplierMoney as bG, type SupplierOrderAddressLevel as bH, type SupplierOrderCustomer as bI, type SupplierOrderLine as bJ, type SupplierOrderResult as bK, type SupplierOrderStatus as bL, type SupplierShipTo as bM, type SupplierShippingQuote as bN, type SupplierShippingQuoteInput as bO, type SupplierStock as bP, type SuppliersDefaultConfig as bQ, SuppliersFeature as bR, type SuppliersPluginConfig as bS, type SuppliersStaticConfig as bT, type TabItem as bU, type TableBlock as bV, type TableCell as bW, type TableColumn as bX, type TableColumnSort as bY, type TablePagination as bZ, type TableRichCell as b_, type PluginManifest as ba, type RepeaterBlock as bb, RepeaterSource as bc, type SearchBlock as bd, type SecretStore as be, type SequenceStore as bf, type SetupAction as bg, type SetupLayout as bh, type SetupLayoutValidation as bi, type SetupStep as bj, type ShipmentAddress as bk, type ShipmentParcel as bl, type ShipmentResult as bm, type ShippingDefaultConfig as bn, ShippingFeature as bo, type ShippingPluginConfig as bp, type ShippingQuote as bq, type ShippingQuoteParams as br, type ShippingStaticConfig as bs, type SourcedProduct as bt, type StatBlock as bu, StepStatusFrom as bv, type StepStatusFromAction as bw, type StepStatusFromFields as bx, type StepStatusSource as by, type StorageBroker as bz, type ActionBlock$1 as c, type TabsBlock as c0, type ToggleBlock as c1, type ToolbarBlock as c2, type TrackingEvent as c3, TransactionStatus as c4, type UiContribution as c5, type UiContributionsValidation as c6, UiSlot as c7, type UiSlotContext as c8, type VoidInvoiceInput as c9, type WebhookSignatureResult as ca, analyticsCapability as cb, capability as cc, crossValidateSetupLayout as cd, definePlugin as ce, invoicingCapability as cf, isConfigurablePlugin as cg, isPluginFactory as ch, minorUnitDigits as ci, paymentCapability as cj, shippingCapability as ck, suppliersCapability as cl, toMajorUnits as cm, toMinorUnits as cn, uiCapability as co, validatePluginAuthor as cp, validateSetupLayout as cq, validateUiContributions as cr, 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-D9g2w27d.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 ChartAxis, H as ChartBlock, I as ChartFormat, J as ChartMarker, K as ChartPoint, L as ChartQuadrants, M as ChartReference, N as ChartSeries, O as CodConfig, Q as CodFeeConfig, R as CodFeeType, T as CodPurchaseTrigger, U as ConditionalBlock, V as ConditionalEquals, W as ConditionalWhen, X as ConfigurablePlugin, Y as ContentActionVariant, Z as ContentBlock, _ as ContentBlockType, $ as CopyFieldBlock, a0 as CreateShipmentParams, a1 as DetailsBlock, a2 as DispatchContext, a3 as DividerBlock, a4 as DomainEventHandler, a5 as DomainEventName, a6 as EmbedInit, a7 as FieldBlock, a8 as FieldOption, a9 as FieldVariant, aa as FilterBlock, ab as FilterOption, ac as GatewayEnvironment, ad as GatewayFeeConfig, ae as GatewayStaticConfig, af as GridBlock, ag as GridLayout, ah as GroupBlock, ai as HostApi, aj as HttpClient, ak as HttpRequest, al as HttpResponse, am as IAnalyticsPlugin, an as IInvoicingPlugin, ao as IPaymentPlugin, ap as IPlugin, aq as IShippingPlugin, ar as ISuppliersPlugin, as as IUiPlugin, at as InlineRowBlock, au as InvoiceDocumentType, av as InvoiceLine, aw as InvoiceMoney, ax as InvoiceParty, ay as InvoiceRequest, az as InvoiceResult, aA as InvoiceStatus, aB as InvoiceTax, aC as InvoicingDefaultConfig, aD as InvoicingFeature, aE as InvoicingPluginConfig, aF as InvoicingStaticConfig, aG as KeyValueBlock, aH as KeyValueRow, aI as LayoutMode, aJ as LinkBlock, aK as Logger, aL as MarkdownBlock, aM as MessageVariant, aN as PageParams, aO as PaymentCard, aP as PaymentConnect, aQ as PaymentConnectExchange, aR as PaymentConnectParams, aS as PaymentCustomer, aT as PaymentGatewayCode, aU as PaymentMerchantPricing, aV as PaymentPayload, aW as PaymentPluginConfig, aX as PaymentRenderMode, aY as PaymentResult, aZ as PaymentSessionFees, a_ as PaymentSessionPayload, a$ as PaymentSessionResult, b0 as PaymentSettlementFees, b1 as PaymentVerifyPayload, b2 as PaymentWebhookSettlement, b3 as PlaceSupplierOrderInput, b4 as Plugin, b5 as PluginActionContext, b6 as PluginActionResult, b7 as PluginAuthor, b8 as PluginConfigFieldDependency, b9 as PluginFactory, ba as PluginManifest, bb as RepeaterBlock, bc as RepeaterSource, bd as SearchBlock, be as SecretStore, bf as SequenceStore, bg as SetupAction, bh as SetupLayout, bi as SetupLayoutValidation, bj as SetupStep, bk as ShipmentAddress, bl as ShipmentParcel, bm as ShipmentResult, bn as ShippingDefaultConfig, bo as ShippingFeature, bp as ShippingPluginConfig, bq as ShippingQuote, br as ShippingQuoteParams, bs as ShippingStaticConfig, bt as SourcedProduct, bu as StatBlock, bv as StepStatusFrom, bw as StepStatusFromAction, bx as StepStatusFromFields, by as StepStatusSource, bz as StorageBroker, bA as SupplierCatalogQuery, bB as SupplierFulfillmentEvent, bC as SupplierListing, bD as SupplierListingAttribute, bE as SupplierListingPage, bF as SupplierListingVariant, bG as SupplierMoney, bH as SupplierOrderAddressLevel, bI as SupplierOrderCustomer, bJ as SupplierOrderLine, bK as SupplierOrderResult, bL as SupplierOrderStatus, bM as SupplierShipTo, bN as SupplierShippingQuote, bO as SupplierShippingQuoteInput, bP as SupplierStock, bQ as SuppliersDefaultConfig, bR as SuppliersFeature, bS as SuppliersPluginConfig, bT as SuppliersStaticConfig, bU as TabItem, bV as TableBlock, bW as TableCell, bX as TableColumn, bY as TableColumnSort, bZ as TablePagination, b_ as TableRichCell, b$ as TableSort, c0 as TabsBlock, c1 as ToggleBlock, c2 as ToolbarBlock, c3 as TrackingEvent, c4 as TransactionStatus, c5 as UiContribution, c6 as UiContributionsValidation, c7 as UiSlot, c8 as UiSlotContext, c9 as VoidInvoiceInput, ca as WebhookSignatureResult, cb as analyticsCapability, cc as capability, cd as crossValidateSetupLayout, ce as definePlugin, cf as invoicingCapability, cg as isConfigurablePlugin, ch as isPluginFactory, ci as minorUnitDigits, cj as paymentCapability, ck as shippingCapability, cl as suppliersCapability, cm as toMajorUnits, cn as toMinorUnits, co as uiCapability, cp as validatePluginAuthor, cq as validateSetupLayout, cr as validateUiContributions } from './host-api-D9g2w27d.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.8.0";
 /**
  * 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-D9g2w27d.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 ChartAxis, H as ChartBlock, I as ChartFormat, J as ChartMarker, K as ChartPoint, L as ChartQuadrants, M as ChartReference, N as ChartSeries, O as CodConfig, Q as CodFeeConfig, R as CodFeeType, T as CodPurchaseTrigger, U as ConditionalBlock, V as ConditionalEquals, W as ConditionalWhen, X as ConfigurablePlugin, Y as ContentActionVariant, Z as ContentBlock, _ as ContentBlockType, $ as CopyFieldBlock, a0 as CreateShipmentParams, a1 as DetailsBlock, a2 as DispatchContext, a3 as DividerBlock, a4 as DomainEventHandler, a5 as DomainEventName, a6 as EmbedInit, a7 as FieldBlock, a8 as FieldOption, a9 as FieldVariant, aa as FilterBlock, ab as FilterOption, ac as GatewayEnvironment, ad as GatewayFeeConfig, ae as GatewayStaticConfig, af as GridBlock, ag as GridLayout, ah as GroupBlock, ai as HostApi, aj as HttpClient, ak as HttpRequest, al as HttpResponse, am as IAnalyticsPlugin, an as IInvoicingPlugin, ao as IPaymentPlugin, ap as IPlugin, aq as IShippingPlugin, ar as ISuppliersPlugin, as as IUiPlugin, at as InlineRowBlock, au as InvoiceDocumentType, av as InvoiceLine, aw as InvoiceMoney, ax as InvoiceParty, ay as InvoiceRequest, az as InvoiceResult, aA as InvoiceStatus, aB as InvoiceTax, aC as InvoicingDefaultConfig, aD as InvoicingFeature, aE as InvoicingPluginConfig, aF as InvoicingStaticConfig, aG as KeyValueBlock, aH as KeyValueRow, aI as LayoutMode, aJ as LinkBlock, aK as Logger, aL as MarkdownBlock, aM as MessageVariant, aN as PageParams, aO as PaymentCard, aP as PaymentConnect, aQ as PaymentConnectExchange, aR as PaymentConnectParams, aS as PaymentCustomer, aT as PaymentGatewayCode, aU as PaymentMerchantPricing, aV as PaymentPayload, aW as PaymentPluginConfig, aX as PaymentRenderMode, aY as PaymentResult, aZ as PaymentSessionFees, a_ as PaymentSessionPayload, a$ as PaymentSessionResult, b0 as PaymentSettlementFees, b1 as PaymentVerifyPayload, b2 as PaymentWebhookSettlement, b3 as PlaceSupplierOrderInput, b4 as Plugin, b5 as PluginActionContext, b6 as PluginActionResult, b7 as PluginAuthor, b8 as PluginConfigFieldDependency, b9 as PluginFactory, ba as PluginManifest, bb as RepeaterBlock, bc as RepeaterSource, bd as SearchBlock, be as SecretStore, bf as SequenceStore, bg as SetupAction, bh as SetupLayout, bi as SetupLayoutValidation, bj as SetupStep, bk as ShipmentAddress, bl as ShipmentParcel, bm as ShipmentResult, bn as ShippingDefaultConfig, bo as ShippingFeature, bp as ShippingPluginConfig, bq as ShippingQuote, br as ShippingQuoteParams, bs as ShippingStaticConfig, bt as SourcedProduct, bu as StatBlock, bv as StepStatusFrom, bw as StepStatusFromAction, bx as StepStatusFromFields, by as StepStatusSource, bz as StorageBroker, bA as SupplierCatalogQuery, bB as SupplierFulfillmentEvent, bC as SupplierListing, bD as SupplierListingAttribute, bE as SupplierListingPage, bF as SupplierListingVariant, bG as SupplierMoney, bH as SupplierOrderAddressLevel, bI as SupplierOrderCustomer, bJ as SupplierOrderLine, bK as SupplierOrderResult, bL as SupplierOrderStatus, bM as SupplierShipTo, bN as SupplierShippingQuote, bO as SupplierShippingQuoteInput, bP as SupplierStock, bQ as SuppliersDefaultConfig, bR as SuppliersFeature, bS as SuppliersPluginConfig, bT as SuppliersStaticConfig, bU as TabItem, bV as TableBlock, bW as TableCell, bX as TableColumn, bY as TableColumnSort, bZ as TablePagination, b_ as TableRichCell, b$ as TableSort, c0 as TabsBlock, c1 as ToggleBlock, c2 as ToolbarBlock, c3 as TrackingEvent, c4 as TransactionStatus, c5 as UiContribution, c6 as UiContributionsValidation, c7 as UiSlot, c8 as UiSlotContext, c9 as VoidInvoiceInput, ca as WebhookSignatureResult, cb as analyticsCapability, cc as capability, cd as crossValidateSetupLayout, ce as definePlugin, cf as invoicingCapability, cg as isConfigurablePlugin, ch as isPluginFactory, ci as minorUnitDigits, cj as paymentCapability, ck as shippingCapability, cl as suppliersCapability, cm as toMajorUnits, cn as toMinorUnits, co as uiCapability, cp as validatePluginAuthor, cq as validateSetupLayout, cr as validateUiContributions } from './host-api-D9g2w27d.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.8.0";
 /**
  * True when a plugin built against `pluginSdkVersion` can run on a host that
  * ships `hostSdkVersion`. Rule: same major, host minor >= plugin minor.