@shoplix-ai/block-kit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rastova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,49 @@
+# @shoplix-ai/block-kit
+
+The renderer contract. Every Block Type renderer, platform or Shop-owned, is
+written against this package and nothing else from the runtime. It holds:
+
+- **The contract.** A renderer is a React component that receives
+  `BlockRenderProps`: the block's settings, its Binding resolved into display
+  shapes (`BindingData | null`), the envelope's asset display entries for the
+  screen in hand, the Shop's tokens and resolved theme style,
+  the buyer's language and text direction with the Shop's default language as
+  fallback, and a capability object holding only
+  the capabilities the Block Type declared.
+- **The registry.** `createBlockRegistry()` keyed by Block Type, one owner per
+  type. A second owner is refused; the same owner may register again. Packages
+  outside the app register through it. `defineBlock()` is the typed authoring
+  helper: settings and capabilities are inferred from the definition.
+- **The capability set.** `addToCart`, `openCart`, `beginCheckout`. Closed, and
+  the same list the schema package lets a Block Definition declare.
+- **The authoring shape of a Code Block.** `defineSettings()` and
+  `defineBinding()` type a block's settings and binding files; `SettingsValues`
+  derives the renderer's settings type from the settings file;
+  `defineCodeBlock()` holds the renderer with its renderer version, the
+  capabilities it reaches for and a height hint for the canvas card; and
+  `shopBlocks()` turns a Shop package's blocks into registrations under the
+  Shop's namespaced type ids. A component file names no Shop and no type: the
+  package stamps both.
+- **The contract version.** `CONTRACT_VERSION` and `CONTRACT_MAJOR`, pinned to
+  this package's own version by a test. A Shop package is built against one
+  major; the api's package registry records it at push, and taking a version
+  refuses a major other than the runtime's before anything is built.
+- **Helpers.** `resolveToken` (follow an alias to its value), `formatMoney`
+  (amount plus currency code, formatted in the buyer's language), `pickLocale`
+  (the buyer's language from the Shop's languages with default fallback),
+  `localize` (one string out of a locale object), `textDirection`,
+  `imageSourceFor` (the rendition to paint at a given display width).
+
+No renderers live here. The package depends on `@shoplix-ai/sdui-schema` and on
+React types only. Its runtime export list is pinned by a test; it is imported by
+code outside this repo, so growing it is a reviewed change. The package follows
+semver and is publishable: a change a Shop package would have to follow is a
+major bump, announced with a migration note, and the runtime moves to the new
+major before any Shop package may.
+
+```sh
+pnpm build
+pnpm typecheck
+pnpm test
+pnpm lint
+```

package/dist/authoring.d.ts

@@ -0,0 +1,55 @@
+import type { Action, BlockBindingDeclaration, BlockPlacement, BlockSetting, ColorChoice, LocalizedText, RowFieldSetting } from '@shoplix-ai/sdui-schema';
+/** The settings file of a block: its label and what a merchant can set on it. */
+export interface SettingsFile {
+    readonly label: string;
+    readonly settings: readonly BlockSetting[];
+}
+/** The binding file of a block: what it binds, and where a merchant may place it. */
+export type BindingFile = BlockBindingDeclaration & {
+    readonly placement: BlockPlacement;
+};
+/**
+ * The settings file's one export. It hands the literal back unchanged, typed
+ * so an editor checks every setting and keeps each key and option for the
+ * renderer's own props type.
+ */
+export declare function defineSettings<const S extends SettingsFile>(file: S): S;
+/** The binding file's one export, typed the same way. */
+export declare function defineBinding<const B extends BindingFile>(file: B): B;
+type LeafValue<S> = S extends {
+    type: 'text';
+} ? LocalizedText : S extends {
+    type: 'toggle';
+} ? boolean : S extends {
+    type: 'select';
+    options: ReadonlyArray<{
+        value: infer V;
+    }>;
+} ? V : S extends {
+    type: 'number';
+} ? number : S extends {
+    type: 'color';
+} ? ColorChoice : S extends {
+    type: 'image';
+} ? string | null : S extends {
+    type: 'action';
+} ? Action : never;
+type RowValue<F extends readonly RowFieldSetting[]> = {
+    readonly [K in F[number] as K['key']]: LeafValue<K>;
+};
+type SettingValue<S> = S extends {
+    type: 'rows';
+    fields: infer F extends readonly RowFieldSetting[];
+} ? ReadonlyArray<RowValue<F>> : LeafValue<S>;
+/**
+ * What a renderer receives as its settings, derived from the settings file:
+ * one key per setting that carries a value, each in the shape the merchant's
+ * panel writes it. A section header names a group and carries nothing.
+ */
+export type SettingsValues<S extends SettingsFile> = {
+    readonly [K in Exclude<S['settings'][number], {
+        type: 'section';
+    }> as K['key']]: SettingValue<K>;
+};
+export {};
+//# sourceMappingURL=authoring.d.ts.map

package/dist/authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.d.ts","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,iFAAiF;AACjF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AAED,qFAAqF;AACrF,MAAM,MAAM,WAAW,GAAG,uBAAuB,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;CAAE,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,YAAY,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAEvE;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAErE;AAED,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C,aAAa,GACb,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC1B,OAAO,GACP,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC,CAAA;CAAE,GACtE,CAAC,GACD,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC1B,MAAM,GACN,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACzB,WAAW,GACX,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACzB,MAAM,GAAG,IAAI,GACb,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC1B,MAAM,GACN,KAAK,CAAC;AAEtB,KAAK,QAAQ,CAAC,CAAC,SAAS,SAAS,eAAe,EAAE,IAAI;IACpD,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC;CACpD,CAAC;AAEF,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,SAAS;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,SAAS,SAAS,eAAe,EAAE,CAAC;CACpD,GACG,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAC1B,SAAS,CAAC,CAAC,CAAC,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,YAAY,IAAI;IACnD,QAAQ,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;CACjG,CAAC"}

package/dist/authoring.js

@@ -0,0 +1,13 @@
+/**
+ * The settings file's one export. It hands the literal back unchanged, typed
+ * so an editor checks every setting and keeps each key and option for the
+ * renderer's own props type.
+ */
+export function defineSettings(file) {
+    return file;
+}
+/** The binding file's one export, typed the same way. */
+export function defineBinding(file) {
+    return file;
+}
+//# sourceMappingURL=authoring.js.map

package/dist/authoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring.js","sourceRoot":"","sources":["../src/authoring.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAA+B,IAAO;IAClE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAA8B,IAAO;IAChE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/capabilities.d.ts

@@ -0,0 +1,22 @@
+import { type BlockCapabilityName } from '@shoplix-ai/sdui-schema';
+/**
+ * The closed capability set. A renderer reaches commerce only through these
+ * three; the Storefront token, the cart id and navigation never cross the
+ * contract. The set is code, never document content, and it does not grow
+ * without a new contract major. The schema package names the same list, so a
+ * Block Definition can declare only what a renderer can be handed.
+ */
+export declare const CAPABILITY_NAMES: readonly ["addToCart", "openCart", "beginCheckout"];
+export type CapabilityName = BlockCapabilityName;
+export interface CartLineInput {
+    readonly variantId: string;
+    readonly quantity: number;
+}
+export interface Capabilities {
+    readonly addToCart: (line: CartLineInput) => Promise<void>;
+    readonly openCart: () => void;
+    readonly beginCheckout: () => Promise<void>;
+}
+/** What a renderer sees: exactly the capabilities its Block Type declared. */
+export type CapabilityObject<K extends CapabilityName = never> = Pick<Capabilities, K>;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE3F;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,qDAAyB,CAAC;AAEvD,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7C;AAED,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,cAAc,GAAG,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC"}

package/dist/capabilities.js

@@ -0,0 +1,10 @@
+import { BLOCK_CAPABILITY_NAMES } from '@shoplix-ai/sdui-schema';
+/**
+ * The closed capability set. A renderer reaches commerce only through these
+ * three; the Storefront token, the cart id and navigation never cross the
+ * contract. The set is code, never document content, and it does not grow
+ * without a new contract major. The schema package names the same list, so a
+ * Block Definition can declare only what a renderer can be handed.
+ */
+export const CAPABILITY_NAMES = BLOCK_CAPABILITY_NAMES;
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAA4B,MAAM,yBAAyB,CAAC;AAE3F;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC"}

package/dist/code-block.d.ts

@@ -0,0 +1,31 @@
+import type { CapabilityName } from './capabilities.js';
+import type { BlockRegistration, BlockRenderer, BlockSettings } from './contract.js';
+/**
+ * What a Code Block's component file exports: the renderer, the capabilities
+ * it reaches for, the version of this renderer, and how tall the canvas card
+ * should stand in for it. The block's type and owner are not here: the
+ * package that ships it stamps both, so a component never names a Shop.
+ */
+export interface CodeBlockModule<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> {
+    readonly rendererVersion: number;
+    readonly capabilities?: readonly K[];
+    readonly heightHint?: number;
+    readonly render: BlockRenderer<TSettings, K>;
+}
+/** The stored shape: every field present, the renderer widened as `defineBlock` widens it. */
+export interface CodeBlock {
+    readonly rendererVersion: number;
+    readonly capabilities: readonly CapabilityName[];
+    readonly heightHint: number | undefined;
+    readonly render: BlockRenderer;
+}
+/** The typed authoring shape of a Code Block: settings and capabilities are inferred. */
+export declare function defineCodeBlock<TSettings extends BlockSettings = BlockSettings, const K extends CapabilityName = never>(module: CodeBlockModule<TSettings, K>): CodeBlock;
+/**
+ * A Shop package's blocks as the registry takes them: each Code Block under
+ * its namespaced type id, owned by the Shop. The name is the block folder's
+ * name and the key the Block Definition was pushed under, so the two sides
+ * meet on one id by construction.
+ */
+export declare function shopBlocks(shopSlug: string, blocks: Readonly<Record<string, CodeBlock>>): readonly BlockRegistration[];
+//# sourceMappingURL=code-block.d.ts.map

package/dist/code-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block.d.ts","sourceRoot":"","sources":["../src/code-block.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAErF;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,CAAC,SAAS,cAAc,GAAG,KAAK;IAEhC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;CAC9C;AAED,8FAA8F;AAC9F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAC7B,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,KAAK,CAAC,CAAC,SAAS,cAAc,GAAG,KAAK,EACtC,MAAM,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,SAAS,CAOlD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,GAC1C,SAAS,iBAAiB,EAAE,CAQ9B"}

package/dist/code-block.js

@@ -0,0 +1,26 @@
+import { privateBlockTypeId } from '@shoplix-ai/sdui-schema';
+/** The typed authoring shape of a Code Block: settings and capabilities are inferred. */
+export function defineCodeBlock(module) {
+    return {
+        rendererVersion: module.rendererVersion,
+        capabilities: module.capabilities ?? [],
+        heightHint: module.heightHint,
+        render: module.render,
+    };
+}
+/**
+ * A Shop package's blocks as the registry takes them: each Code Block under
+ * its namespaced type id, owned by the Shop. The name is the block folder's
+ * name and the key the Block Definition was pushed under, so the two sides
+ * meet on one id by construction.
+ */
+export function shopBlocks(shopSlug, blocks) {
+    return Object.entries(blocks).map(([name, block]) => ({
+        type: privateBlockTypeId(shopSlug, name),
+        owner: shopSlug,
+        capabilities: block.capabilities,
+        rendererVersion: block.rendererVersion,
+        render: block.render,
+    }));
+}
+//# sourceMappingURL=code-block.js.map

package/dist/code-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block.js","sourceRoot":"","sources":["../src/code-block.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AA4B7D,yFAAyF;AACzF,MAAM,UAAU,eAAe,CAG7B,MAAqC;IACrC,OAAO;QACL,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;QACvC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,MAAM,EAAE,MAAM,CAAC,MAAkC;KAClD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CACxB,QAAgB,EAChB,MAA2C;IAE3C,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC;QACxC,KAAK,EAAE,QAAQ;QACf,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,60 @@
+import type { ComponentType } from 'react';
+import type { BindingData, EnvelopeAssets, LocaleCode, ThemeStyle, ThemeTokens } from '@shoplix-ai/sdui-schema';
+import type { CapabilityName, CapabilityObject } from './capabilities.js';
+import type { BlockNavigation } from './navigation.js';
+export type TextDirection = 'ltr' | 'rtl';
+export type BlockSettings = Readonly<Record<string, unknown>>;
+/**
+ * Everything a renderer receives, and all it may know. Settings are the
+ * block's props from the document; data is its Binding resolved into display
+ * shapes, null when the block carries no Binding; assets are the envelope's
+ * display entries for the screen in hand, keyed by asset id; tokens and theme
+ * are the Shop's; language and direction are the buyer's, with the Shop's default
+ * language as the fallback every locale object resolves through; navigate is the
+ * closed way to move the buyer; capabilities hold only what the Block Type
+ * declared.
+ */
+export interface BlockRenderProps<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> {
+    readonly blockId: string;
+    readonly settings: TSettings;
+    readonly data: BindingData | null;
+    readonly assets: EnvelopeAssets;
+    readonly tokens: ThemeTokens;
+    readonly theme: ThemeStyle;
+    readonly language: LocaleCode;
+    readonly defaultLanguage: LocaleCode;
+    readonly direction: TextDirection;
+    readonly navigate: BlockNavigation;
+    readonly capabilities: CapabilityObject<K>;
+}
+export type BlockRenderer<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> = ComponentType<BlockRenderProps<TSettings, K>>;
+/** Who answers for a Block Type: the platform, or the Shop whose package registered it. */
+export type BlockOwner = string;
+/** The typed authoring shape: settings and capabilities are inferred from the definition. */
+export interface BlockDefinition<TSettings extends BlockSettings = BlockSettings, K extends CapabilityName = never> {
+    readonly type: string;
+    readonly owner: BlockOwner;
+    readonly capabilities?: readonly K[];
+    readonly render: BlockRenderer<TSettings, K>;
+}
+/**
+ * The shape a registry stores and a host renders: one entry per Block Type.
+ * The host hands each renderer the capabilities its entry declares, so the
+ * stored renderer type promises none and the definition's type promises the
+ * declared ones.
+ */
+export interface BlockRegistration {
+    readonly type: string;
+    readonly owner: BlockOwner;
+    readonly capabilities: readonly CapabilityName[];
+    /** A Code Block's renderer version, the one its Block Definition names; a platform block has none. */
+    readonly rendererVersion?: number;
+    readonly render: BlockRenderer;
+}
+/**
+ * Turns a typed definition into a registration. The settings a renderer
+ * receives come from a document parsed against the schema for its type, so
+ * the widening to the stored shape happens here, once, and nowhere else.
+ */
+export declare function defineBlock<TSettings extends BlockSettings = BlockSettings, const K extends CapabilityName = never>(definition: BlockDefinition<TSettings, K>): BlockRegistration;
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,WAAW,EACZ,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB,CAC/B,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,CAAC,SAAS,cAAc,GAAG,KAAK;IAEhC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,UAAU,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,aAAa,CACvB,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,CAAC,SAAS,cAAc,GAAG,KAAK,IAC9B,aAAa,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;AAElD,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,6FAA6F;AAC7F,MAAM,WAAW,eAAe,CAC9B,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,CAAC,SAAS,cAAc,GAAG,KAAK;IAEhC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;CAC9C;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAC;IACjD,sGAAsG;IACtG,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,SAAS,SAAS,aAAa,GAAG,aAAa,EAC/C,KAAK,CAAC,CAAC,SAAS,cAAc,GAAG,KAAK,EACtC,UAAU,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,iBAAiB,CAO9D"}

package/dist/contract.js

@@ -0,0 +1,14 @@
+/**
+ * Turns a typed definition into a registration. The settings a renderer
+ * receives come from a document parsed against the schema for its type, so
+ * the widening to the stored shape happens here, once, and nowhere else.
+ */
+export function defineBlock(definition) {
+    return {
+        type: definition.type,
+        owner: definition.owner,
+        capabilities: definition.capabilities ?? [],
+        render: definition.render,
+    };
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AA4EA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAGzB,UAAyC;IACzC,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,IAAI;QACrB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,EAAE;QAC3C,MAAM,EAAE,UAAU,CAAC,MAAkC;KACtD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export { CAPABILITY_NAMES } from './capabilities.js';
+export type { Capabilities, CapabilityName, CapabilityObject, CartLineInput, } from './capabilities.js';
+export { defineBlock } from './contract.js';
+export type { BlockDefinition, BlockOwner, BlockRegistration, BlockRenderProps, BlockRenderer, BlockSettings, TextDirection, } from './contract.js';
+export type { BlockNavigation } from './navigation.js';
+export { createBlockRegistry } from './registry.js';
+export type { BlockRegistry } from './registry.js';
+export { defineBinding, defineSettings } from './authoring.js';
+export type { BindingFile, SettingsFile, SettingsValues } from './authoring.js';
+export { defineCodeBlock, shopBlocks } from './code-block.js';
+export type { CodeBlock, CodeBlockModule } from './code-block.js';
+export { CONTRACT_MAJOR, CONTRACT_VERSION } from './version.js';
+export { resolveToken } from './tokens.js';
+export { formatMoney } from './money.js';
+export { imageSourceFor } from './renditions.js';
+export type { ImageSource } from './renditions.js';
+export { localize, pickLocale, textDirection } from './locale.js';
+export type { ShopLanguages } from './locale.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { CAPABILITY_NAMES } from './capabilities.js';
+export { defineBlock } from './contract.js';
+export { createBlockRegistry } from './registry.js';
+export { defineBinding, defineSettings } from './authoring.js';
+export { defineCodeBlock, shopBlocks } from './code-block.js';
+export { CONTRACT_MAJOR, CONTRACT_VERSION } from './version.js';
+export { resolveToken } from './tokens.js';
+export { formatMoney } from './money.js';
+export { imageSourceFor } from './renditions.js';
+export { localize, pickLocale, textDirection } from './locale.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAa5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG9D,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}

package/dist/locale.d.ts

@@ -0,0 +1,19 @@
+import type { LocaleCode, LocalizedText } from '@shoplix-ai/sdui-schema';
+import type { TextDirection } from './contract.js';
+export interface ShopLanguages {
+    readonly default: LocaleCode;
+    readonly supported: readonly LocaleCode[];
+}
+/**
+ * The buyer's language: the first preferred locale the Shop supports, by
+ * exact code, then by base language either way round; the Shop's default
+ * when nothing matches.
+ */
+export declare function pickLocale(languages: ShopLanguages, preferred: readonly string[]): LocaleCode;
+/**
+ * One string out of a full locale object: the buyer's language, its base
+ * language, the default language, then whatever the text carries first.
+ */
+export declare function localize(text: LocalizedText, language: LocaleCode, fallback: LocaleCode): string;
+export declare function textDirection(language: LocaleCode): TextDirection;
+//# sourceMappingURL=locale.d.ts.map

package/dist/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,UAAU,EAAE,CAAC;CAC3C;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,UAAU,CAQ7F;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAShG;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,aAAa,CAEjE"}

package/dist/locale.js

@@ -0,0 +1,36 @@
+const RTL_LANGUAGES = new Set(['ar', 'he', 'fa', 'ur']);
+function baseOf(locale) {
+    return locale.split('-')[0].toLowerCase();
+}
+/**
+ * The buyer's language: the first preferred locale the Shop supports, by
+ * exact code, then by base language either way round; the Shop's default
+ * when nothing matches.
+ */
+export function pickLocale(languages, preferred) {
+    for (const candidate of preferred) {
+        if (languages.supported.includes(candidate))
+            return candidate;
+        const base = baseOf(candidate);
+        const match = languages.supported.find((code) => baseOf(code) === base);
+        if (match !== undefined)
+            return match;
+    }
+    return languages.default;
+}
+/**
+ * One string out of a full locale object: the buyer's language, its base
+ * language, the default language, then whatever the text carries first.
+ */
+export function localize(text, language, fallback) {
+    return (text[language] ??
+        text[baseOf(language)] ??
+        text[fallback] ??
+        text[baseOf(fallback)] ??
+        Object.values(text)[0] ??
+        '');
+}
+export function textDirection(language) {
+    return RTL_LANGUAGES.has(baseOf(language)) ? 'rtl' : 'ltr';
+}
+//# sourceMappingURL=locale.js.map

package/dist/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../src/locale.ts"],"names":[],"mappings":"AAQA,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAExD,SAAS,MAAM,CAAC,MAAc;IAC5B,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,SAAwB,EAAE,SAA4B;IAC/E,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;QACxE,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;IACxC,CAAC;IACD,OAAO,SAAS,CAAC,OAAO,CAAC;AAC3B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAmB,EAAE,QAAoB,EAAE,QAAoB;IACtF,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC;QACd,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,EAAE,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAoB;IAChD,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7D,CAAC"}

package/dist/money.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Display-only money, formatted on the device in the buyer's language. The
+ * charged price always comes from Shopify checkout, never from this string.
+ */
+export declare function formatMoney(amount: string | number, currencyCode: string, language: string): string | null;
+//# sourceMappingURL=money.d.ts.map

package/dist/money.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.d.ts","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAUf"}

package/dist/money.js

@@ -0,0 +1,17 @@
+const CURRENCY_CODE = /^[A-Z]{3}$/;
+/**
+ * Display-only money, formatted on the device in the buyer's language. The
+ * charged price always comes from Shopify checkout, never from this string.
+ */
+export function formatMoney(amount, currencyCode, language) {
+    const value = typeof amount === 'number' ? amount : Number(amount);
+    if (!Number.isFinite(value) || !CURRENCY_CODE.test(currencyCode))
+        return null;
+    try {
+        return new Intl.NumberFormat(language, { style: 'currency', currency: currencyCode }).format(value);
+    }
+    catch {
+        return `${amount} ${currencyCode}`;
+    }
+}
+//# sourceMappingURL=money.js.map

package/dist/money.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money.js","sourceRoot":"","sources":["../src/money.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,YAAY,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,WAAW,CACzB,MAAuB,EACvB,YAAoB,EACpB,QAAgB;IAEhB,MAAM,KAAK,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACnE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9E,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,CAC1F,KAAK,CACN,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,MAAM,IAAI,YAAY,EAAE,CAAC;IACrC,CAAC;AACH,CAAC"}

package/dist/navigation.d.ts

@@ -0,0 +1,15 @@
+import type { Action } from '@shoplix-ai/sdui-schema';
+/**
+ * The only way a renderer moves the buyer, and it is as closed as the
+ * capability set: the action the document itself carries, and the implicit
+ * taps a block owns by its own kind — a card opening its entity, a search bar
+ * opening search. A renderer never sees a route, never a screen the document
+ * did not name, and never the router that owns them.
+ */
+export interface BlockNavigation {
+    readonly run: (action: Action) => void;
+    readonly openProduct: (productId: string) => void;
+    readonly openCollection: (collectionId: string) => void;
+    readonly openSearch: () => void;
+}
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC"}

package/dist/navigation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.js","sourceRoot":"","sources":["../src/navigation.ts"],"names":[],"mappings":""}

package/dist/registry.d.ts

@@ -0,0 +1,14 @@
+import type { BlockOwner, BlockRegistration } from './contract.js';
+/**
+ * The registry keyed by Block Type. One owner per type: a second owner is
+ * refused, the same owner may register again (module reloads do). Hosts
+ * create one and hand it to every package that registers renderers.
+ */
+export interface BlockRegistry {
+    register(registration: BlockRegistration): void;
+    resolve(type: string): BlockRegistration | undefined;
+    ownerOf(type: string): BlockOwner | undefined;
+    types(): readonly string[];
+}
+export declare function createBlockRegistry(): BlockRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEnE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAChD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACrD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC9C,KAAK,IAAI,SAAS,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,mBAAmB,IAAI,aAAa,CAsBnD"}

package/dist/registry.js

@@ -0,0 +1,22 @@
+export function createBlockRegistry() {
+    const entries = new Map();
+    return {
+        register(registration) {
+            const current = entries.get(registration.type);
+            if (current !== undefined && current.owner !== registration.owner) {
+                throw new Error(`Block Type "${registration.type}" is owned by "${current.owner}"; "${registration.owner}" cannot register it`);
+            }
+            entries.set(registration.type, registration);
+        },
+        resolve(type) {
+            return entries.get(type);
+        },
+        ownerOf(type) {
+            return entries.get(type)?.owner;
+        },
+        types() {
+            return [...entries.keys()];
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;IACrD,OAAO;QACL,QAAQ,CAAC,YAAY;YACnB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,YAAY,CAAC,KAAK,EAAE,CAAC;gBAClE,MAAM,IAAI,KAAK,CACb,eAAe,YAAY,CAAC,IAAI,kBAAkB,OAAO,CAAC,KAAK,OAAO,YAAY,CAAC,KAAK,sBAAsB,CAC/G,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,IAAI;YACV,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,CAAC,IAAI;YACV,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;QAClC,CAAC;QACD,KAAK;YACH,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/renditions.d.ts

@@ -0,0 +1,13 @@
+import type { AssetDisplay } from '@shoplix-ai/sdui-schema';
+export interface ImageSource {
+    readonly uri: string;
+    readonly width?: number;
+    readonly height?: number;
+}
+/**
+ * The source to paint at a given display width in device pixels: the
+ * narrowest rendition at least that wide, the widest one when none reaches
+ * it, the asset's base url when it carries no renditions.
+ */
+export declare function imageSourceFor(display: AssetDisplay, targetWidth: number): ImageSource;
+//# sourceMappingURL=renditions.d.ts.map

package/dist/renditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renditions.d.ts","sourceRoot":"","sources":["../src/renditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAWtF"}

package/dist/renditions.js

@@ -0,0 +1,18 @@
+/**
+ * The source to paint at a given display width in device pixels: the
+ * narrowest rendition at least that wide, the widest one when none reaches
+ * it, the asset's base url when it carries no renditions.
+ */
+export function imageSourceFor(display, targetWidth) {
+    const byWidth = [...display.renditions].sort((a, b) => a.width - b.width);
+    const rendition = byWidth.find((entry) => entry.width >= targetWidth) ?? byWidth.at(-1);
+    if (rendition !== undefined) {
+        return { uri: rendition.url, width: rendition.width, height: rendition.height };
+    }
+    return {
+        uri: display.url,
+        ...(display.width !== undefined ? { width: display.width } : {}),
+        ...(display.height !== undefined ? { height: display.height } : {}),
+    };
+}
+//# sourceMappingURL=renditions.js.map

package/dist/renditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renditions.js","sourceRoot":"","sources":["../src/renditions.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAqB,EAAE,WAAmB;IACvE,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1E,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,EAAE,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IAClF,CAAC;IACD,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpE,CAAC;AACJ,CAAC"}

package/dist/tokens.d.ts

@@ -0,0 +1,8 @@
+import type { ThemeTokens, TokenValue } from '@shoplix-ai/sdui-schema';
+/**
+ * The value at the end of a token's alias chain. Takes the alias form a
+ * document carries (`{semantic.action}`) or a bare dotted path; answers
+ * undefined when the path names no token.
+ */
+export declare function resolveToken(tokens: ThemeTokens, reference: string): TokenValue | undefined;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAa,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAclF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAK3F"}

package/dist/tokens.js

@@ -0,0 +1,26 @@
+import { terminalTokenPath } from '@shoplix-ai/sdui-schema';
+const ALIAS_BRACES = /^\{(.+)\}$/;
+function leafAt(tokens, path) {
+    let node = tokens;
+    for (const key of path.split('.')) {
+        if (typeof node !== 'object' || node === null)
+            return undefined;
+        node = node[key];
+    }
+    if (typeof node !== 'object' || node === null || !('$value' in node))
+        return undefined;
+    return node;
+}
+/**
+ * The value at the end of a token's alias chain. Takes the alias form a
+ * document carries (`{semantic.action}`) or a bare dotted path; answers
+ * undefined when the path names no token.
+ */
+export function resolveToken(tokens, reference) {
+    const path = ALIAS_BRACES.exec(reference)?.[1] ?? reference;
+    const terminal = terminalTokenPath(tokens, path);
+    if (terminal === null)
+        return undefined;
+    return leafAt(tokens, terminal)?.$value;
+}
+//# sourceMappingURL=tokens.js.map

package/dist/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../src/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,YAAY,GAAG,YAAY,CAAC;AAElC,SAAS,MAAM,CAAC,MAAmB,EAAE,IAAY;IAC/C,IAAI,IAAI,GAAY,MAAM,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAChE,IAAI,GAAI,IAAgC,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,OAAO,IAAiB,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,SAAiB;IACjE,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;IAC5D,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;AAC1C,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The contract's own version, pinned here so a runtime and a Shop package can
+ * both read it without a package file. A test holds it equal to package.json.
+ * The major is the compatibility line: a Shop package built against another
+ * major never meets this runtime, and a major bump is an announced event.
+ */
+export declare const CONTRACT_VERSION = "1.0.0";
+export declare const CONTRACT_MAJOR = 1;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,UAAU,CAAC;AAExC,eAAO,MAAM,cAAc,IAAI,CAAC"}

package/dist/version.js

@@ -0,0 +1,9 @@
+/**
+ * The contract's own version, pinned here so a runtime and a Shop package can
+ * both read it without a package file. A test holds it equal to package.json.
+ * The major is the compatibility line: a Shop package built against another
+ * major never meets this runtime, and a major bump is an announced event.
+ */
+export const CONTRACT_VERSION = '1.0.0';
+export const CONTRACT_MAJOR = 1;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@shoplix-ai/block-kit",
+  "version": "1.0.0",
+  "description": "The renderer contract every Block Type renderer is written against: what a renderer receives, how a Block Type is registered with its owner, the closed capability set, and the small helpers renderers share. Contract only, no renderers.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Rastova/shoplix.git",
+    "directory": "packages/block-kit"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=22.13"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@shoplix-ai/sdui-schema": "1.0.0"
+  },
+  "peerDependencies": {
+    "react": ">=19.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/react": "~19.2.2",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "^10.1.1",
+    "globals": "^16.5.0",
+    "typescript": "5.9.2",
+    "typescript-eslint": "^8.50.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src/ tests/"
+  }
+}