rune-lab 0.3.0 → 0.4.0

package/README.md

@@ -1,5 +1,5 @@
 <h1 align="center">
-  <img src="https://raw.githubusercontent.com/Yrrrrrf/rune-lab/main/static/img/rune.png" alt="Rune Lab Icon" width="128" height="128" description="Icon representing the Svelte Runes system">
+  <img src="https://raw.githubusercontent.com/Yrrrrrf/rune-lab/main/src/sdk/ui/static/img/rune.png" alt="Rune Lab Icon" width="128" height="128" descripti``on="Icon representing the Svelte Runes system">
   <div align="center">Rune Lab</div>
 </h1>
 

package/dist/core/design-tokens/props.d.ts

@@ -0,0 +1,52 @@
+/** Standard size scale used across all components. */
+export type SizeToken = "xs" | "sm" | "md" | "lg" | "xl";
+/** Mixin interface for components that accept a size prop. */
+export interface WithSizing {
+    /** Visual size variant. Defaults to "md" if omitted. */
+    size?: SizeToken;
+}
+/**
+ * Semantic variant tokens aligned with DaisyUI's theme system.
+ * Kept as a union type for TypeScript inference; consumers can extend via
+ * `string & {}` if they need custom variants.
+ */
+export type VariantToken = "primary" | "secondary" | "accent" | "neutral" | "ghost" | "info" | "success" | "warning" | "error";
+/** Mixin interface for components that accept a variant prop. */
+export interface WithVariant {
+    /** Semantic color variant. */
+    variant?: VariantToken;
+}
+/** Mixin interface for components that accept a custom CSS class. */
+export interface WithClass {
+    /** Additional CSS class string to merge with component classes. */
+    class?: string;
+}
+/**
+ * Convenience intersection of all design-token mixins.
+ * Use when a component supports size, variant, and custom class.
+ */
+export type WithDesignTokens = WithSizing & WithVariant & WithClass;
+/**
+ * Maps a size token to a CSS class string using a component-specific map.
+ * Returns the mapped class or an empty string for unknown tokens.
+ *
+ * @param size - The size token to resolve
+ * @param classMap - Component-specific mapping of tokens to CSS classes
+ * @param fallback - Fallback size if `size` is undefined (default: "md")
+ *
+ * @example
+ * ```ts
+ * const btnSizeMap = { xs: "btn-xs", sm: "btn-sm", md: "btn-md", lg: "btn-lg", xl: "btn-xl" };
+ * resolveSize("lg", btnSizeMap); // "btn-lg"
+ * resolveSize(undefined, btnSizeMap); // "btn-md"
+ * ```
+ */
+export declare function resolveSize(size: SizeToken | undefined, classMap: Partial<Record<SizeToken, string>>, fallback?: SizeToken): string;
+/**
+ * Maps a variant token to a CSS class string using a component-specific map.
+ *
+ * @param variant - The variant token to resolve
+ * @param classMap - Component-specific mapping of tokens to CSS classes
+ */
+export declare function resolveVariant(variant: VariantToken | undefined, classMap: Partial<Record<VariantToken, string>>): string;
+//# sourceMappingURL=props.d.ts.map

package/dist/core/design-tokens/props.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/design-tokens/props.ts"],"names":[],"mappings":"AAMA,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEzD,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAID;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,GACP,MAAM,GACN,SAAS,GACT,SAAS,GACT,OAAO,CAAC;AAEZ,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAID,qEAAqE;AACrE,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;AAIpE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EAC5C,QAAQ,GAAE,SAAgB,GACzB,MAAM,CAGR;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAC9C,MAAM,CAGR"}

package/dist/core/design-tokens/props.js

@@ -0,0 +1,34 @@
+// sdk/core/src/design-tokens/props.ts
+// Canonical shared prop interfaces for design tokens.
+// No CSS-framework-specific logic here — class maps live in sdk/ui.
+// ── Resolution Utilities ───────────────────────────────────────────────────────
+/**
+ * Maps a size token to a CSS class string using a component-specific map.
+ * Returns the mapped class or an empty string for unknown tokens.
+ *
+ * @param size - The size token to resolve
+ * @param classMap - Component-specific mapping of tokens to CSS classes
+ * @param fallback - Fallback size if `size` is undefined (default: "md")
+ *
+ * @example
+ * ```ts
+ * const btnSizeMap = { xs: "btn-xs", sm: "btn-sm", md: "btn-md", lg: "btn-lg", xl: "btn-xl" };
+ * resolveSize("lg", btnSizeMap); // "btn-lg"
+ * resolveSize(undefined, btnSizeMap); // "btn-md"
+ * ```
+ */
+export function resolveSize(size, classMap, fallback = "md") {
+    const token = size ?? fallback;
+    return classMap[token] ?? "";
+}
+/**
+ * Maps a variant token to a CSS class string using a component-specific map.
+ *
+ * @param variant - The variant token to resolve
+ * @param classMap - Component-specific mapping of tokens to CSS classes
+ */
+export function resolveVariant(variant, classMap) {
+    if (!variant)
+        return "";
+    return classMap[variant] ?? "";
+}

package/dist/core/exchange-rate/strategies.d.ts

@@ -0,0 +1,52 @@
+import type { ScaledRate } from "../money/money.ts";
+/**
+ * A pure function that converts a minor-unit amount using a rate.
+ * All strategy functions must be deterministic and side-effect-free.
+ */
+export type ConversionFn = (amount: number, ...rates: number[]) => number;
+/**
+ * Resolves a ScaledRate or plain number into a float rate value.
+ */
+export declare function resolveRate(rate: ScaledRate | number): number;
+/**
+ * Direct conversion: base currency → target currency.
+ * Multiplies the amount by the rate.
+ *
+ * @param amount - Minor-unit amount in the source currency
+ * @param rate - Conversion rate (1 source = `rate` target)
+ * @returns Minor-unit amount in the target currency
+ */
+export declare function directConversion(amount: number, rate: number): number;
+/**
+ * Inverse conversion: target currency → base currency.
+ * Divides the amount by the rate.
+ *
+ * @param amount - Minor-unit amount in the source currency
+ * @param rate - Conversion rate of source relative to base (1 base = `rate` source)
+ * @returns Minor-unit amount in the base currency
+ */
+export declare function inverseConversion(amount: number, rate: number): number;
+/**
+ * Triangular conversion: source → base → target (cross-rate).
+ * First divides by the source-to-base rate, then multiplies by the base-to-target rate.
+ *
+ * @param amount - Minor-unit amount in the source currency
+ * @param rateSourceToBase - Rate of source relative to base (1 base = `rate` source)
+ * @param rateBaseToTarget - Rate of base to target (1 base = `rate` target)
+ * @returns Minor-unit amount in the target currency
+ */
+export declare function triangularConversion(amount: number, rateSourceToBase: number, rateBaseToTarget: number): number;
+/**
+ * Named map of conversion strategies.
+ * Consumer code and the ExchangeRateStore can select a strategy by name.
+ * Extensible: register additional strategies before store initialization.
+ *
+ * @example
+ * ```ts
+ * CONVERSION_STRATEGIES["crypto"] = (amount, rate) => {
+ *   // 18-decimal precision logic
+ * };
+ * ```
+ */
+export declare const CONVERSION_STRATEGIES: Record<string, ConversionFn>;
+//# sourceMappingURL=strategies.d.ts.map

package/dist/core/exchange-rate/strategies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategies.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/exchange-rate/strategies.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,KAAK,MAAM,CAAC;AAE1E;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAG7D;AAID;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAQR;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAM9D,CAAC"}

package/dist/core/exchange-rate/strategies.js

@@ -0,0 +1,72 @@
+// sdk/core/src/exchange-rate/strategies.ts
+// Pure conversion strategy functions — no store or context dependencies.
+// Extracted from ExchangeRateStore to enable independent testing and extensibility.
+/**
+ * Resolves a ScaledRate or plain number into a float rate value.
+ */
+export function resolveRate(rate) {
+    if (typeof rate === "number")
+        return rate;
+    return rate.amount / Math.pow(10, rate.scale);
+}
+// ── Strategy Functions ─────────────────────────────────────────────────────────
+/**
+ * Direct conversion: base currency → target currency.
+ * Multiplies the amount by the rate.
+ *
+ * @param amount - Minor-unit amount in the source currency
+ * @param rate - Conversion rate (1 source = `rate` target)
+ * @returns Minor-unit amount in the target currency
+ */
+export function directConversion(amount, rate) {
+    return Math.round(amount * rate);
+}
+/**
+ * Inverse conversion: target currency → base currency.
+ * Divides the amount by the rate.
+ *
+ * @param amount - Minor-unit amount in the source currency
+ * @param rate - Conversion rate of source relative to base (1 base = `rate` source)
+ * @returns Minor-unit amount in the base currency
+ */
+export function inverseConversion(amount, rate) {
+    if (rate === 0) {
+        throw new Error("Cannot perform inverse conversion with a rate of zero.");
+    }
+    return Math.round(amount / rate);
+}
+/**
+ * Triangular conversion: source → base → target (cross-rate).
+ * First divides by the source-to-base rate, then multiplies by the base-to-target rate.
+ *
+ * @param amount - Minor-unit amount in the source currency
+ * @param rateSourceToBase - Rate of source relative to base (1 base = `rate` source)
+ * @param rateBaseToTarget - Rate of base to target (1 base = `rate` target)
+ * @returns Minor-unit amount in the target currency
+ */
+export function triangularConversion(amount, rateSourceToBase, rateBaseToTarget) {
+    if (rateSourceToBase === 0) {
+        throw new Error("Cannot perform triangular conversion: source-to-base rate is zero.");
+    }
+    const amountInBase = amount / rateSourceToBase;
+    return Math.round(amountInBase * rateBaseToTarget);
+}
+// ── Strategy Registry ──────────────────────────────────────────────────────────
+/**
+ * Named map of conversion strategies.
+ * Consumer code and the ExchangeRateStore can select a strategy by name.
+ * Extensible: register additional strategies before store initialization.
+ *
+ * @example
+ * ```ts
+ * CONVERSION_STRATEGIES["crypto"] = (amount, rate) => {
+ *   // 18-decimal precision logic
+ * };
+ * ```
+ */
+export const CONVERSION_STRATEGIES = {
+    direct: directConversion,
+    inverse: inverseConversion,
+    // triangularConversion takes 2 rates — wrapped for the registry signature
+    triangular: (amount, ...rates) => triangularConversion(amount, rates[0], rates[1]),
+};

package/dist/core/index.d.ts

@@ -1,4 +1,9 @@
-export * from "./internal/message-resolver";
-export * from "./persistence/types";
-export * from "./money/index";
+export * from "./internal/message-resolver.ts";
+export * from "./persistence/types.ts";
+export * from "./money/index.ts";
+export { type MoneyJSON, MoneyPrimitive } from "./money/money-primitive.ts";
+export * from "./exchange-rate/strategies.ts";
+export * from "./design-tokens/props.ts";
+export * from "./layout/types.ts";
+export * from "./shortcuts/types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC;AAE5C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAE/C,cAAc,wBAAwB,CAAC;AAEvC,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,KAAK,SAAS,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5E,cAAc,+BAA+B,CAAC;AAE9C,cAAc,0BAA0B,CAAC;AAEzC,cAAc,mBAAmB,CAAC;AAElC,cAAc,sBAAsB,CAAC"}

package/dist/core/index.js

@@ -1,3 +1,8 @@
-export * from "./internal/message-resolver";
-export * from "./persistence/types";
-export * from "./money/index";
+export * from "./internal/message-resolver.js";
+export * from "./persistence/types.js";
+export * from "./money/index.js";
+export { MoneyPrimitive } from "./money/money-primitive.js";
+export * from "./exchange-rate/strategies.js";
+export * from "./design-tokens/props.js";
+export * from "./layout/types.js";
+export * from "./shortcuts/types.js";

package/dist/core/internal/message-resolver.d.ts

@@ -4,7 +4,7 @@
  * Enables dynamic message function calls for config selectors.
  * Creates a resolver that dynamically looks up and calls message functions.
  */
-type MessageBundle = Record<string, (...args: any[]) => string>;
+type MessageBundle = Record<string, (...args: unknown[]) => string>;
 interface MessageResolverConfig<T> {
     /**
      * Function to extract the message key from an option

package/dist/core/internal/message-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-resolver.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/internal/message-resolver.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,CAAC;AAEhE,UAAU,qBAAqB,CAAC,CAAC;IAC/B;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IAEpC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAExB,QAAQ,CAAC,KAAG,MAAM,CAmB3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}
+{"version":3,"file":"message-resolver.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/internal/message-resolver.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,CAAC,CAAC;AAEpE,UAAU,qBAAqB,CAAC,CAAC;IAC/B;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IAEpC;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CAC1C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAExB,QAAQ,CAAC,KAAG,MAAM,CAmB3B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAExE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,CAAC,EAAE,EACZ,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxB"}

package/dist/core/layout/types.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Describes a single zone within a workspace layout.
+ * Zones are rendered in array order by the LayoutEngine in sdk/ui.
+ */
+export interface LayoutZone {
+    /** Unique identifier for this zone (e.g., "navigation", "content", "detail"). */
+    id: string;
+    /**
+     * Component reference to render in this zone.
+     * Typed as `unknown` at the core level — the UI layer resolves this
+     * to a concrete Svelte component reference.
+     */
+    component?: unknown;
+    /**
+     * Store binding key. When set, the LayoutEngine will pass the corresponding
+     * store from the registry as a prop to the component.
+     */
+    storeKey?: string;
+    /**
+     * CSS width value for this zone (e.g., "280px", "1fr", "auto").
+     * @default "auto"
+     */
+    width?: string;
+    /**
+     * Whether the zone can be collapsed by the user.
+     * @default false
+     */
+    collapsible?: boolean;
+    /**
+     * Store boolean path that controls whether this zone is visible.
+     * When set, the zone is only rendered when the referenced boolean is `true`.
+     * @example "layout.showNavigation"
+     */
+    conditional?: string;
+    /**
+     * Minimum width before the zone collapses automatically.
+     * Only relevant when `collapsible` is `true`.
+     */
+    minWidth?: string;
+    /**
+     * Position of the zone relative to the content area.
+     * @default "start"
+     */
+    position?: "start" | "end";
+}
+/**
+ * Complete layout configuration — an ordered array of zones.
+ * The LayoutEngine renders zones in array order (left-to-right by default).
+ *
+ * @example
+ * ```ts
+ * const dashboardLayout: LayoutConfig = [
+ *   { id: "navigation", width: "280px", collapsible: true },
+ *   { id: "content", width: "1fr" },
+ *   { id: "detail", width: "320px", collapsible: true, conditional: "layout.showDetail" },
+ * ];
+ * ```
+ */
+export type LayoutConfig = LayoutZone[];
+//# sourceMappingURL=types.d.ts.map

package/dist/core/layout/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/layout/types.ts"],"names":[],"mappings":"AAMA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IAEX;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;CAC5B;AAID;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC"}

package/dist/core/layout/types.js

@@ -0,0 +1,4 @@
+// sdk/core/src/layout/types.ts
+// Framework-agnostic layout configuration types.
+// No Svelte dependency — `component` is typed as `unknown` (resolved by sdk/ui).
+export {};

package/dist/core/money/index.d.ts

@@ -1,2 +1,2 @@
-export { addMoney, createMoney, CURRENCY_MAP, type Dinero, type DineroCurrency, formatAmount, formatMoney, type ISO4217Code, multiplyMoney, registerCurrency, safeAmount, subtractMoney, toMinorUnit, } from "./money";
+export { addMoney, convertAmount, convertMoney, createMoney, CURRENCY_MAP, type Dinero, type DineroCurrency, type DineroSnapshot, formatAmount, formatMoney, fromMoneySnapshot, type ISO4217Code, multiplyMoney, type RateMap, registerCurrency, safeAmount, type ScaledRate, scaledRate, subtractMoney, toAdyenMoney, toMinorUnit, toMoneySnapshot, toPaypalMoney, toSquareMoney, toStripeMoney, } from "./money.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/money/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,YAAY,EACZ,WAAW,EACX,KAAK,WAAW,EAChB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,QAAQ,EACR,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,KAAK,WAAW,EAChB,aAAa,EACb,KAAK,OAAO,EACZ,gBAAgB,EAChB,UAAU,EACV,KAAK,UAAU,EACf,UAAU,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,YAAY,CAAC"}

package/dist/core/money/index.js

@@ -1,2 +1,2 @@
 // sdk/core/src/money/index.ts
-export { addMoney, createMoney, CURRENCY_MAP, formatAmount, formatMoney, multiplyMoney, registerCurrency, safeAmount, subtractMoney, toMinorUnit, } from "./money";
+export { addMoney, convertAmount, convertMoney, createMoney, CURRENCY_MAP, formatAmount, formatMoney, fromMoneySnapshot, multiplyMoney, registerCurrency, safeAmount, scaledRate, subtractMoney, toAdyenMoney, toMinorUnit, toMoneySnapshot, toPaypalMoney, toSquareMoney, toStripeMoney, } from "./money.js";

package/dist/core/money/money-primitive.d.ts

@@ -0,0 +1,101 @@
+import { type ISO4217Code } from "./money.ts";
+/**
+ * Serializable representation of a MoneyPrimitive.
+ * Used for persistence drivers and JSON round-trips.
+ */
+export interface MoneyJSON {
+    amount: number;
+    currencyCode: string;
+    scale: number;
+}
+/**
+ * Immutable Value Object that encapsulates a monetary amount, its currency,
+ * and the scale (number of decimal places).
+ *
+ * Amounts are always stored in minor units (e.g., cents for USD, centavos for MXN).
+ * The scale is derived from the currency's exponent in CURRENCY_MAP.
+ *
+ * @example
+ * ```ts
+ * const price = MoneyPrimitive.fromMajor(12.99, "USD");
+ * price.minor;           // 1299
+ * price.major;           // 12.99
+ * price.format("en-US"); // "$12.99"
+ *
+ * const json = price.toJSON();
+ * const restored = MoneyPrimitive.fromJSON(json);
+ * ```
+ */
+export declare class MoneyPrimitive {
+    /** Raw amount in minor units (e.g., cents). */
+    readonly amount: number;
+    /** ISO 4217 currency code. */
+    readonly currencyCode: string;
+    /** Number of decimal places for this currency (e.g., 2 for USD, 0 for JPY). */
+    readonly scale: number;
+    private constructor();
+    /**
+     * Create a MoneyPrimitive from a minor-unit integer amount.
+     * @param amount - Amount in minor units (e.g., 1299 for $12.99)
+     * @param currencyCode - ISO 4217 currency code
+     */
+    static fromMinor(amount: number, currencyCode: ISO4217Code | string): MoneyPrimitive;
+    /**
+     * Create a MoneyPrimitive from a major-unit float amount.
+     * @param amount - Amount in major units (e.g., 12.99 for $12.99)
+     * @param currencyCode - ISO 4217 currency code
+     */
+    static fromMajor(amount: number, currencyCode: ISO4217Code | string): MoneyPrimitive;
+    /**
+     * Restore a MoneyPrimitive from its JSON representation.
+     */
+    static fromJSON(json: MoneyJSON): MoneyPrimitive;
+    /** Amount in minor units (alias for `amount`). */
+    get minor(): number;
+    /** Amount in major units (e.g., 12.99 for 1299 cents). */
+    get major(): number;
+    /**
+     * Format this monetary value as a locale-aware currency string.
+     * @param locale - BCP 47 locale string (default: "en-US")
+     */
+    format(locale?: string): string;
+    /**
+     * Add another MoneyPrimitive (must be same currency).
+     * Returns a new MoneyPrimitive.
+     */
+    add(other: MoneyPrimitive): MoneyPrimitive;
+    /**
+     * Subtract another MoneyPrimitive (must be same currency).
+     * Returns a new MoneyPrimitive.
+     */
+    subtract(other: MoneyPrimitive): MoneyPrimitive;
+    /**
+     * Multiply by a scalar factor. Returns a new MoneyPrimitive.
+     */
+    multiply(factor: number): MoneyPrimitive;
+    /**
+     * Value equality — two MoneyPrimitives are equal if they have the same
+     * amount, currency code, and scale.
+     */
+    equals(other: MoneyPrimitive): boolean;
+    /**
+     * Returns true if this amount is zero.
+     */
+    isZero(): boolean;
+    /**
+     * Returns true if this amount is negative.
+     */
+    isNegative(): boolean;
+    /**
+     * Serialize to a plain JSON-compatible object.
+     */
+    toJSON(): MoneyJSON;
+    toString(): string;
+    private assertSameCurrency;
+    /**
+     * Resolves the scale (exponent) for a currency code from CURRENCY_MAP.
+     * Throws if the currency is not registered.
+     */
+    private static resolveScale;
+}
+//# sourceMappingURL=money-primitive.d.ts.map

package/dist/core/money/money-primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-primitive.d.ts","sourceRoot":"","sources":["../../../src/sdk/core/src/money/money-primitive.ts"],"names":[],"mappings":"AAIA,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,cAAc;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,OAAO;IAQP;;;;OAIG;IACH,MAAM,CAAC,SAAS,CACd,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,WAAW,GAAG,MAAM,GACjC,cAAc;IAKjB;;;;OAIG;IACH,MAAM,CAAC,SAAS,CACd,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,WAAW,GAAG,MAAM,GACjC,cAAc;IAMjB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,cAAc;IAMhD,kDAAkD;IAClD,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0DAA0D;IAC1D,IAAI,KAAK,IAAI,MAAM,CAGlB;IAID;;;OAGG;IACH,MAAM,CAAC,MAAM,GAAE,MAAgB,GAAG,MAAM;IAWxC;;;OAGG;IACH,GAAG,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc;IAS1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc;IAS/C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc;IAUxC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAQtC;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,UAAU,IAAI,OAAO;IAMrB;;OAEG;IACH,MAAM,IAAI,SAAS;IAQnB,QAAQ,IAAI,MAAM;IAMlB,OAAO,CAAC,kBAAkB;IAQ1B;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAS5B"}

package/dist/core/money/money-primitive.js

@@ -0,0 +1,161 @@
+// sdk/core/src/money/money-primitive.ts
+// Immutable Value Object for monetary amounts.
+// Zero Svelte dependencies — pure TypeScript class.
+import { CURRENCY_MAP } from "./money.js";
+/**
+ * Immutable Value Object that encapsulates a monetary amount, its currency,
+ * and the scale (number of decimal places).
+ *
+ * Amounts are always stored in minor units (e.g., cents for USD, centavos for MXN).
+ * The scale is derived from the currency's exponent in CURRENCY_MAP.
+ *
+ * @example
+ * ```ts
+ * const price = MoneyPrimitive.fromMajor(12.99, "USD");
+ * price.minor;           // 1299
+ * price.major;           // 12.99
+ * price.format("en-US"); // "$12.99"
+ *
+ * const json = price.toJSON();
+ * const restored = MoneyPrimitive.fromJSON(json);
+ * ```
+ */
+export class MoneyPrimitive {
+    /** Raw amount in minor units (e.g., cents). */
+    amount;
+    /** ISO 4217 currency code. */
+    currencyCode;
+    /** Number of decimal places for this currency (e.g., 2 for USD, 0 for JPY). */
+    scale;
+    constructor(amount, currencyCode, scale) {
+        this.amount = Math.round(amount);
+        this.currencyCode = currencyCode;
+        this.scale = scale;
+    }
+    // ── Factories ────────────────────────────────────────────────────────────
+    /**
+     * Create a MoneyPrimitive from a minor-unit integer amount.
+     * @param amount - Amount in minor units (e.g., 1299 for $12.99)
+     * @param currencyCode - ISO 4217 currency code
+     */
+    static fromMinor(amount, currencyCode) {
+        const scale = MoneyPrimitive.resolveScale(currencyCode);
+        return new MoneyPrimitive(amount, currencyCode, scale);
+    }
+    /**
+     * Create a MoneyPrimitive from a major-unit float amount.
+     * @param amount - Amount in major units (e.g., 12.99 for $12.99)
+     * @param currencyCode - ISO 4217 currency code
+     */
+    static fromMajor(amount, currencyCode) {
+        const scale = MoneyPrimitive.resolveScale(currencyCode);
+        const factor = Math.pow(10, scale);
+        return new MoneyPrimitive(Math.round(amount * factor), currencyCode, scale);
+    }
+    /**
+     * Restore a MoneyPrimitive from its JSON representation.
+     */
+    static fromJSON(json) {
+        return new MoneyPrimitive(json.amount, json.currencyCode, json.scale);
+    }
+    // ── Computed Getters ─────────────────────────────────────────────────────
+    /** Amount in minor units (alias for `amount`). */
+    get minor() {
+        return this.amount;
+    }
+    /** Amount in major units (e.g., 12.99 for 1299 cents). */
+    get major() {
+        if (this.scale === 0)
+            return this.amount;
+        return this.amount / Math.pow(10, this.scale);
+    }
+    // ── Formatting ───────────────────────────────────────────────────────────
+    /**
+     * Format this monetary value as a locale-aware currency string.
+     * @param locale - BCP 47 locale string (default: "en-US")
+     */
+    format(locale = "en-US") {
+        return new Intl.NumberFormat(locale, {
+            style: "currency",
+            currency: this.currencyCode,
+            minimumFractionDigits: this.scale,
+            maximumFractionDigits: this.scale,
+        }).format(this.major);
+    }
+    // ── Arithmetic (returns new instances — immutability) ────────────────────
+    /**
+     * Add another MoneyPrimitive (must be same currency).
+     * Returns a new MoneyPrimitive.
+     */
+    add(other) {
+        this.assertSameCurrency(other);
+        return new MoneyPrimitive(this.amount + other.amount, this.currencyCode, this.scale);
+    }
+    /**
+     * Subtract another MoneyPrimitive (must be same currency).
+     * Returns a new MoneyPrimitive.
+     */
+    subtract(other) {
+        this.assertSameCurrency(other);
+        return new MoneyPrimitive(this.amount - other.amount, this.currencyCode, this.scale);
+    }
+    /**
+     * Multiply by a scalar factor. Returns a new MoneyPrimitive.
+     */
+    multiply(factor) {
+        return new MoneyPrimitive(Math.round(this.amount * factor), this.currencyCode, this.scale);
+    }
+    // ── Comparison ───────────────────────────────────────────────────────────
+    /**
+     * Value equality — two MoneyPrimitives are equal if they have the same
+     * amount, currency code, and scale.
+     */
+    equals(other) {
+        return (this.amount === other.amount &&
+            this.currencyCode === other.currencyCode &&
+            this.scale === other.scale);
+    }
+    /**
+     * Returns true if this amount is zero.
+     */
+    isZero() {
+        return this.amount === 0;
+    }
+    /**
+     * Returns true if this amount is negative.
+     */
+    isNegative() {
+        return this.amount < 0;
+    }
+    // ── Serialization ────────────────────────────────────────────────────────
+    /**
+     * Serialize to a plain JSON-compatible object.
+     */
+    toJSON() {
+        return {
+            amount: this.amount,
+            currencyCode: this.currencyCode,
+            scale: this.scale,
+        };
+    }
+    toString() {
+        return `MoneyPrimitive(${this.amount} ${this.currencyCode} scale=${this.scale})`;
+    }
+    // ── Private Helpers ──────────────────────────────────────────────────────
+    assertSameCurrency(other) {
+        if (this.currencyCode !== other.currencyCode) {
+            throw new Error(`Currency mismatch: cannot operate on ${this.currencyCode} and ${other.currencyCode}`);
+        }
+    }
+    /**
+     * Resolves the scale (exponent) for a currency code from CURRENCY_MAP.
+     * Throws if the currency is not registered.
+     */
+    static resolveScale(currencyCode) {
+        const currency = CURRENCY_MAP[currencyCode];
+        if (!currency) {
+            throw new Error(`Unknown currency code: ${currencyCode}. Register it first via registerCurrency().`);
+        }
+        return currency.exponent;
+    }
+}