@stripe/extensibility-sdk 0.22.4

package/dist/internal.cjs

@@ -0,0 +1,156 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/internal.ts
+var internal_exports = {};
+__export(internal_exports, {
+  BY_INTERFACE_ID: () => BY_INTERFACE_ID,
+  BY_SDK_FQN: () => BY_SDK_FQN
+});
+module.exports = __toCommonJS(internal_exports);
+
+// src/extensions/registry.ts
+var EXTENSION_INTERFACES = [
+  {
+    interfaceId: "billing.bill.discount_calculation",
+    sdkFqn: "billing/bill/discount_calculation.DiscountCalculation",
+    namespacePath: ["Billing", "Bill", "DiscountCalculation"],
+    methods: [
+      {
+        outputName: "computeDiscounts",
+        prepareArgsName: "prepareArgsComputeDiscounts",
+        prepareResultName: "prepareResultComputeDiscounts",
+        platformWrapName: "$platformWrapComputeDiscounts"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.customer_balance_application",
+    sdkFqn: "billing/customer_balance_application.CustomerBalanceApplication",
+    namespacePath: ["Billing", "CustomerBalanceApplication"],
+    methods: [
+      {
+        outputName: "computeAppliedCustomerBalance",
+        prepareArgsName: "prepareArgsComputeAppliedCustomerBalance",
+        prepareResultName: "prepareResultComputeAppliedCustomerBalance",
+        platformWrapName: "$platformWrapComputeAppliedCustomerBalance"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.invoice_collection_setting",
+    sdkFqn: "billing/invoice_collection_setting.InvoiceCollectionSetting",
+    namespacePath: ["Billing", "InvoiceCollectionSetting"],
+    methods: [
+      {
+        outputName: "collectionOverride",
+        prepareArgsName: "prepareArgsCollectionOverride",
+        prepareResultName: "prepareResultCollectionOverride",
+        platformWrapName: "$platformWrapCollectionOverride"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.prorations",
+    sdkFqn: "billing/prorations.Prorations",
+    namespacePath: ["Billing", "Prorations"],
+    methods: [
+      {
+        outputName: "prorateItems",
+        prepareArgsName: "prepareArgsProrateItems",
+        prepareResultName: "prepareResultProrateItems",
+        platformWrapName: "$platformWrapProrateItems"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.recurring_billing_item_handling",
+    sdkFqn: "billing/recurring_billing_item_handling.RecurringBillingItemHandling",
+    namespacePath: ["Billing", "RecurringBillingItemHandling"],
+    methods: [
+      {
+        outputName: "beforeItemCreation",
+        prepareArgsName: "prepareArgsBeforeItemCreation",
+        prepareResultName: "prepareResultBeforeItemCreation",
+        platformWrapName: "$platformWrapBeforeItemCreation"
+      },
+      {
+        outputName: "filterItems",
+        prepareArgsName: "prepareArgsFilterItems",
+        prepareResultName: "prepareResultFilterItems",
+        platformWrapName: "$platformWrapFilterItems"
+      },
+      {
+        outputName: "groupItems",
+        prepareArgsName: "prepareArgsGroupItems",
+        prepareResultName: "prepareResultGroupItems",
+        platformWrapName: "$platformWrapGroupItems"
+      }
+    ]
+  },
+  {
+    interfaceId: "core.workflows.custom_action",
+    sdkFqn: "core/workflows/custom_action.CustomAction",
+    namespacePath: ["Core", "Workflows", "CustomAction"],
+    methods: [
+      {
+        outputName: "execute",
+        prepareArgsName: "prepareArgsExecute",
+        prepareResultName: "prepareResultExecute",
+        platformWrapName: "$platformWrapExecute"
+      },
+      {
+        outputName: "getFormState",
+        prepareArgsName: "prepareArgsGetFormState",
+        prepareResultName: "prepareResultGetFormState",
+        platformWrapName: "$platformWrapGetFormState"
+      }
+    ]
+  },
+  {
+    interfaceId: "extend.workflows.custom_action",
+    sdkFqn: "extend/workflows/custom_action.CustomAction",
+    namespacePath: ["Extend", "Workflows", "CustomAction"],
+    methods: [
+      {
+        outputName: "execute",
+        prepareArgsName: "prepareArgsExecute",
+        prepareResultName: "prepareResultExecute",
+        platformWrapName: "$platformWrapExecute"
+      },
+      {
+        outputName: "getFormState",
+        prepareArgsName: "prepareArgsGetFormState",
+        prepareResultName: "prepareResultGetFormState",
+        platformWrapName: "$platformWrapGetFormState"
+      }
+    ]
+  }
+];
+var BY_SDK_FQN = new Map(
+  EXTENSION_INTERFACES.map((e) => [e.sdkFqn, e])
+);
+var BY_INTERFACE_ID = new Map(
+  EXTENSION_INTERFACES.map((e) => [e.interfaceId, e])
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BY_INTERFACE_ID,
+  BY_SDK_FQN
+});

package/dist/internal.d.ts

@@ -0,0 +1,3 @@
+export { BY_INTERFACE_ID, BY_SDK_FQN } from './extensions/registry.js';
+export type { ExtensionMethodEntry, ExtensionInterfaceEntry, } from './extensions/registry.js';
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EACV,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC"}

package/dist/internal.js

@@ -0,0 +1,128 @@
+// src/extensions/registry.ts
+var EXTENSION_INTERFACES = [
+  {
+    interfaceId: "billing.bill.discount_calculation",
+    sdkFqn: "billing/bill/discount_calculation.DiscountCalculation",
+    namespacePath: ["Billing", "Bill", "DiscountCalculation"],
+    methods: [
+      {
+        outputName: "computeDiscounts",
+        prepareArgsName: "prepareArgsComputeDiscounts",
+        prepareResultName: "prepareResultComputeDiscounts",
+        platformWrapName: "$platformWrapComputeDiscounts"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.customer_balance_application",
+    sdkFqn: "billing/customer_balance_application.CustomerBalanceApplication",
+    namespacePath: ["Billing", "CustomerBalanceApplication"],
+    methods: [
+      {
+        outputName: "computeAppliedCustomerBalance",
+        prepareArgsName: "prepareArgsComputeAppliedCustomerBalance",
+        prepareResultName: "prepareResultComputeAppliedCustomerBalance",
+        platformWrapName: "$platformWrapComputeAppliedCustomerBalance"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.invoice_collection_setting",
+    sdkFqn: "billing/invoice_collection_setting.InvoiceCollectionSetting",
+    namespacePath: ["Billing", "InvoiceCollectionSetting"],
+    methods: [
+      {
+        outputName: "collectionOverride",
+        prepareArgsName: "prepareArgsCollectionOverride",
+        prepareResultName: "prepareResultCollectionOverride",
+        platformWrapName: "$platformWrapCollectionOverride"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.prorations",
+    sdkFqn: "billing/prorations.Prorations",
+    namespacePath: ["Billing", "Prorations"],
+    methods: [
+      {
+        outputName: "prorateItems",
+        prepareArgsName: "prepareArgsProrateItems",
+        prepareResultName: "prepareResultProrateItems",
+        platformWrapName: "$platformWrapProrateItems"
+      }
+    ]
+  },
+  {
+    interfaceId: "billing.recurring_billing_item_handling",
+    sdkFqn: "billing/recurring_billing_item_handling.RecurringBillingItemHandling",
+    namespacePath: ["Billing", "RecurringBillingItemHandling"],
+    methods: [
+      {
+        outputName: "beforeItemCreation",
+        prepareArgsName: "prepareArgsBeforeItemCreation",
+        prepareResultName: "prepareResultBeforeItemCreation",
+        platformWrapName: "$platformWrapBeforeItemCreation"
+      },
+      {
+        outputName: "filterItems",
+        prepareArgsName: "prepareArgsFilterItems",
+        prepareResultName: "prepareResultFilterItems",
+        platformWrapName: "$platformWrapFilterItems"
+      },
+      {
+        outputName: "groupItems",
+        prepareArgsName: "prepareArgsGroupItems",
+        prepareResultName: "prepareResultGroupItems",
+        platformWrapName: "$platformWrapGroupItems"
+      }
+    ]
+  },
+  {
+    interfaceId: "core.workflows.custom_action",
+    sdkFqn: "core/workflows/custom_action.CustomAction",
+    namespacePath: ["Core", "Workflows", "CustomAction"],
+    methods: [
+      {
+        outputName: "execute",
+        prepareArgsName: "prepareArgsExecute",
+        prepareResultName: "prepareResultExecute",
+        platformWrapName: "$platformWrapExecute"
+      },
+      {
+        outputName: "getFormState",
+        prepareArgsName: "prepareArgsGetFormState",
+        prepareResultName: "prepareResultGetFormState",
+        platformWrapName: "$platformWrapGetFormState"
+      }
+    ]
+  },
+  {
+    interfaceId: "extend.workflows.custom_action",
+    sdkFqn: "extend/workflows/custom_action.CustomAction",
+    namespacePath: ["Extend", "Workflows", "CustomAction"],
+    methods: [
+      {
+        outputName: "execute",
+        prepareArgsName: "prepareArgsExecute",
+        prepareResultName: "prepareResultExecute",
+        platformWrapName: "$platformWrapExecute"
+      },
+      {
+        outputName: "getFormState",
+        prepareArgsName: "prepareArgsGetFormState",
+        prepareResultName: "prepareResultGetFormState",
+        platformWrapName: "$platformWrapGetFormState"
+      }
+    ]
+  }
+];
+var BY_SDK_FQN = new Map(
+  EXTENSION_INTERFACES.map((e) => [e.sdkFqn, e])
+);
+var BY_INTERFACE_ID = new Map(
+  EXTENSION_INTERFACES.map((e) => [e.interfaceId, e])
+);
+export {
+  BY_INTERFACE_ID,
+  BY_SDK_FQN
+};

package/dist/jsonschema.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/jsonschema.ts
+var jsonschema_exports = {};
+module.exports = __toCommonJS(jsonschema_exports);

package/dist/jsonschema.d.ts

@@ -0,0 +1,2 @@
+export * from '@stripe/extensibility-jsonschema';
+//# sourceMappingURL=jsonschema.d.ts.map

package/dist/jsonschema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonschema.d.ts","sourceRoot":"","sources":["../src/jsonschema.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC"}

package/dist/stdlib/brand.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Opaque brand symbol used as a property key in SDK branded types.
+ *
+ * @remarks
+ * You do not need to use this directly — it is already embedded in
+ * branded values returned by factory functions like {@link (Integer:type)}.create().
+ * The `unique symbol` key makes the brand non-enumerable and impossible
+ * to forge without access to this symbol.
+ *
+ * @public
+ */
+export declare const __brand: unique symbol;
+/**
+ * Opaque type-tag symbol used by SDK scalar types to carry Stripe type metadata.
+ *
+ * @remarks
+ * You do not need to use this directly — it is already embedded in
+ * branded values returned by factory functions like {@link (Integer:type)}.create().
+ *
+ * @public
+ */
+export declare const __stripeType: unique symbol;
+/** The type of the opaque brand symbol used as a property key in SDK branded types. @public */
+export type BrandSymbol = typeof __brand;
+/** The type of the opaque Stripe type-tag symbol used in SDK scalar types. @public */
+export type StripeTypeSymbol = typeof __stripeType;
+//# sourceMappingURL=brand.d.ts.map

package/dist/stdlib/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/stdlib/brand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAEjD,+FAA+F;AAC/F,MAAM,MAAM,WAAW,GAAG,OAAO,OAAO,CAAC;AAEzC,sFAAsF;AACtF,MAAM,MAAM,gBAAgB,GAAG,OAAO,YAAY,CAAC"}

package/dist/stdlib/decimal.d.ts

@@ -0,0 +1,324 @@
+import { type __brand, type __stripeType } from './brand.js';
+/**
+ * Unique brand symbol for the {@link Decimal} type.
+ *
+ * Using a dedicated symbol (rather than the shared `__brand`) lets formspec's
+ * structural brand-detection distinguish `Decimal` from other SDK branded
+ * types (e.g., `Ref`, `StreetAddress`) that also carry `[__brand]`.
+ *
+ * @internal
+ */
+declare const __decimalBrand: unique symbol;
+/**
+ * Rounding direction for Decimal operations.
+ *
+ * @remarks
+ * Seven modes corresponding to
+ * {@link https://standards.ieee.org/ieee/754/6210/ | IEEE 754-2019} §4.3
+ * rounding-direction attributes:
+ *
+ * | Direction      | IEEE 754 name           | Behavior                          | Examples (→ integer)                  |
+ * | -------------- | ----------------------- | --------------------------------- | ------------------------------------- |
+ * | `'ceil'`       | `roundTowardPositive`   | Toward +∞                         |  1.1→2, -1.1→-1                       |
+ * | `'floor'`      | `roundTowardNegative`   | Toward -∞                         |  1.9→1, -1.1→-2                       |
+ * | `'round-down'` | `roundTowardZero`       | Toward zero (truncate)            |  1.9→1, -1.9→-1                       |
+ * | `'round-up'`   | —                       | Away from zero                    |  1.1→2, -1.1→-2                       |
+ * | `'half-up'`    | `roundTiesToAway`       | Nearest; ties away from zero      |  0.5→1, -0.5→-1, 1.4→1               |
+ * | `'half-down'`  | —                       | Nearest; ties toward zero         |  0.5→0, -0.5→0, 1.6→2                |
+ * | `'half-even'`  | `roundTiesToEven`       | Nearest; ties to even (banker's)  |  0.5→0, 1.5→2, 2.5→2, 3.5→4          |
+ *
+ * @public
+ */
+export type RoundDirection = 'ceil' | 'floor' | 'round-down' | 'round-up' | 'half-up' | 'half-down' | 'half-even';
+/**
+ * Precision specification for `Decimal.round()`.
+ *
+ * @remarks
+ * Two modes are supported:
+ * - `"decimal-places"` — round to a fixed number of digits after the decimal point.
+ * - `"significant-figures"` — round to a fixed number of significant digits.
+ *
+ * @example
+ * ```ts
+ * // Round to 2 decimal places
+ * amount.round('half-even', { mode: 'decimal-places', value: 2 });
+ *
+ * // Round to 4 significant figures
+ * amount.round('half-up', { mode: 'significant-figures', value: 4 });
+ * ```
+ *
+ * @public
+ */
+export interface DecimalRoundingOptions {
+    /** Whether to count digits from the decimal point (`"decimal-places"`) or from the most significant digit (`"significant-figures"`). */
+    mode: 'decimal-places' | 'significant-figures';
+    /**
+     * The number of digits to retain. Interpreted as decimal places when
+     * `mode` is `"decimal-places"`, or as significant figures when `mode`
+     * is `"significant-figures"`.
+     * @public
+     */
+    value: number;
+}
+/**
+ * Built-in rounding presets keyed by semantic name.
+ *
+ * @remarks
+ * Stripe defines the full set of supported preset names accepted by
+ * `Decimal.round()`.
+ *
+ * | Preset              | Equivalent DecimalRoundingOptions                     |
+ * | ------------------- | ----------------------------------------------------- |
+ * | `"ubb-usage-count"` | `{ mode: "significant-figures", value: 15 }`         |
+ * | `"v1-api"`          | `{ mode: "decimal-places", value: 12 }`              |
+ *
+ * @public
+ */
+export declare const DecimalRoundingPresets: Readonly<{
+    'ubb-usage-count': Readonly<{
+        mode: "significant-figures";
+        value: number;
+    }>;
+    'v1-api': Readonly<{
+        mode: "decimal-places";
+        value: number;
+    }>;
+}>;
+/**
+ * The IEEE 754 decimal128 coefficient size (34 digits) — the recommended
+ * precision for `Decimal.div()` when full precision is desired.
+ *
+ * @remarks
+ * Pass this as the `precision` argument to `div()` when you want the
+ * maximum available precision. Division requires explicit precision —
+ * no invisible defaults in financial code.
+ *
+ * @example
+ * ```ts
+ * // Use the full decimal128 precision explicitly
+ * a.div(b, DEFAULT_DIV_PRECISION, 'half-even');
+ * ```
+ *
+ * @public
+ */
+export declare const DEFAULT_DIV_PRECISION = 34;
+/**
+ * Arbitrary-precision decimal type for billing calculations.
+ *
+ * @remarks
+ * `Decimal` values are created by the {@link (Decimal:variable) | Decimal companion object}
+ * and store values as `coefficient × 10^exponent` using `BigInt`. They avoid
+ * every common binary floating-point pitfall — `Decimal.from('0.1').add(Decimal.from('0.2'))`
+ * is exactly `0.3`.
+ *
+ * Instances are immutable (frozen) and all arithmetic returns a new
+ * `Decimal`. The public type carries two brand symbols so the type system
+ * prevents accidental assignment from plain `number`, `string`, or
+ * `bigint`.
+ *
+ * Create values via the companion object:
+ *
+ * @example
+ * ```ts
+ * import { Decimal, RoundDirection } from '@stripe/extensibility-sdk/stdlib';
+ *
+ * const price = Decimal.from('19.99');
+ * const tax   = price.mul(Decimal.from('0.0825'));
+ * const total = price.add(tax);
+ *
+ * console.log(total.toFixed(2, 'half-up'));   // "21.64"
+ * console.log(JSON.stringify({ total }));          // '{"total":"21.639175"}'
+ * console.log(total.toFixed(2, 'half-even')); // "21.64"
+ * ```
+ *
+ * @public
+ */
+export interface Decimal {
+    /**
+     * Nominal brand tag.
+     * @internal
+     */
+    readonly [__brand]: 'Decimal';
+    /** @internal */
+    readonly [__decimalBrand]: true;
+    /**
+     * Stripe type discriminator.
+     * @internal
+     */
+    readonly [__stripeType]: 'decimal';
+    /**
+     * Return the sum of this value and `other`.
+     * @public
+     */
+    add(other: Decimal): Decimal;
+    /**
+     * Return the difference of this value and `other`.
+     * @public
+     */
+    sub(other: Decimal): Decimal;
+    /**
+     * Return the product of this value and `other`.
+     * @public
+     */
+    mul(other: Decimal): Decimal;
+    /**
+     * Return the quotient of this value divided by `other`.
+     * @public
+     */
+    div(other: Decimal, precision: number, direction: RoundDirection): Decimal;
+    /**
+     * Three-way comparison: returns `-1`, `0`, or `1`.
+     * @public
+     */
+    cmp(other: Decimal): -1 | 0 | 1;
+    /**
+     * Return `true` if this value is numerically equal to `other`.
+     * @public
+     */
+    eq(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is strictly less than `other`.
+     * @public
+     */
+    lt(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is less than or equal to `other`.
+     * @public
+     */
+    lte(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is strictly greater than `other`.
+     * @public
+     */
+    gt(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is greater than or equal to `other`.
+     * @public
+     */
+    gte(other: Decimal): boolean;
+    /**
+     * Return `true` if this value is exactly zero.
+     * @public
+     */
+    isZero(): boolean;
+    /**
+     * Return `true` if this value is strictly less than zero.
+     * @public
+     */
+    isNegative(): boolean;
+    /**
+     * Return `true` if this value is strictly greater than zero.
+     * @public
+     */
+    isPositive(): boolean;
+    /**
+     * Return the additive inverse of this value.
+     * @public
+     */
+    neg(): Decimal;
+    /**
+     * Return the absolute value.
+     * @public
+     */
+    abs(): Decimal;
+    /**
+     * Round this value to the specified precision.
+     * @public
+     */
+    round(direction: RoundDirection, options: keyof typeof DecimalRoundingPresets | DecimalRoundingOptions): Decimal;
+    /**
+     * Return the canonical string representation.
+     * @public
+     */
+    toString(): string;
+    /**
+     * Return the JSON-serializable string representation.
+     * @public
+     */
+    toJSON(): string;
+    /**
+     * Convert to a JavaScript `number` (lossy).
+     * @public
+     */
+    toNumber(): number;
+    /**
+     * Format as a fixed-point string with exactly `decimalPlaces` digits.
+     * @public
+     */
+    toFixed(decimalPlaces: number, direction: RoundDirection): string;
+    /**
+     * Rejects implicit coercion; explicit `String(d)` and template literals still work.
+     * @public
+     */
+    [Symbol.toPrimitive](hint: 'string' | 'number' | 'default'): string;
+    /**
+     * Returns the string representation; invoked by the JavaScript engine as a fallback coercion path.
+     * @public
+     */
+    valueOf(): string;
+}
+/**
+ * Check whether a value is a `Decimal` instance.
+ *
+ * @remarks
+ * Use this instead of `instanceof` — the underlying class is not
+ * publicly exported, so `instanceof` checks are not available to
+ * consumers.
+ *
+ * @example
+ * ```ts
+ * if (isDecimal(value)) {
+ *   value.add(Decimal.from('1')); // value is Decimal
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare function isDecimal(value: unknown): value is Decimal;
+/**
+ * Companion object for creating `Decimal` instances.
+ *
+ * @public
+ */
+export declare const Decimal: {
+    /**
+     * Create a `Decimal` from a string, number, or bigint.
+     *
+     * @remarks
+     * - **string**: Parsed as a decimal literal. Accepts an optional sign,
+     *   integer digits, an optional fractional part, and an optional `e`/`E`
+     *   exponent. Leading/trailing whitespace is trimmed.
+     * - **number**: Must be finite. Converted via `Number.prototype.toString()`
+     *   then parsed, so `Decimal.from(0.1)` produces `"0.1"` (not the
+     *   53-bit binary approximation).
+     * - **bigint**: Treated as an integer with exponent 0.
+     *
+     * @example
+     * ```ts
+     * Decimal.from('1.23');   // string
+     * Decimal.from(42);       // number
+     * Decimal.from(100n);     // bigint
+     * Decimal.from('1.5e3');  // scientific notation → 1500
+     * ```
+     *
+     * @param value - The value to convert.
+     * @returns A new frozen `Decimal` instance.
+     * @throws Error if `value` is a non-finite number, an empty
+     *   string, or a string that does not match the decimal literal grammar.
+     *
+     * @public
+     */
+    from(value: string | number | bigint): Decimal;
+    /**
+     * The `Decimal` value representing zero.
+     *
+     * @remarks
+     * Pre-allocated singleton — prefer `Decimal.zero` over
+     * `Decimal.from(0)` to avoid an unnecessary allocation.
+     *
+     * @public
+     */
+    zero: Decimal;
+};
+export {};
+//# sourceMappingURL=decimal.d.ts.map

package/dist/stdlib/decimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decimal.d.ts","sourceRoot":"","sources":["../../src/stdlib/decimal.ts"],"names":[],"mappings":"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"}