@payabli/component-contracts 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,7 +1,7 @@
 const MESSAGE_SOURCE = 'payabli';
 const MESSAGE_VERSION = 1;
 
-var _a;
+var _a$1;
 function $constructor(name, initializer, params) {
     function init(inst, def) {
         if (!inst._zod) {
@@ -60,7 +60,7 @@ class $ZodAsyncError extends Error {
         super(`Encountered Promise during synchronous parse. Use .parseAsync() instead.`);
     }
 }
-(_a = globalThis).__zod_globalConfig ?? (_a.__zod_globalConfig = {});
+(_a$1 = globalThis).__zod_globalConfig ?? (_a$1.__zod_globalConfig = {});
 const globalConfig = globalThis.__zod_globalConfig;
 function config(newConfig) {
     return globalConfig;
@@ -337,6 +337,14 @@ const string$1 = (params) => {
 const number$1 = /^-?\d+(?:\.\d+)?$/;
 const boolean$1 = /^(?:true|false)$/i;
 
+// import { $ZodType } from "./schemas.js";
+const $ZodCheck = /*@__PURE__*/ $constructor("$ZodCheck", (inst, def) => {
+    var _a;
+    inst._zod ?? (inst._zod = {});
+    inst._zod.def = def;
+    (_a = inst._zod).onattach ?? (_a.onattach = []);
+});
+
 const version = {
     major: 4,
     minor: 4,
@@ -1201,6 +1209,56 @@ function en () {
     };
 }
 
+var _a;
+class $ZodRegistry {
+    constructor() {
+        this._map = new WeakMap();
+        this._idmap = new Map();
+    }
+    add(schema, ..._meta) {
+        const meta = _meta[0];
+        this._map.set(schema, meta);
+        if (meta && typeof meta === "object" && "id" in meta) {
+            this._idmap.set(meta.id, schema);
+        }
+        return this;
+    }
+    clear() {
+        this._map = new WeakMap();
+        this._idmap = new Map();
+        return this;
+    }
+    remove(schema) {
+        const meta = this._map.get(schema);
+        if (meta && typeof meta === "object" && "id" in meta) {
+            this._idmap.delete(meta.id);
+        }
+        this._map.delete(schema);
+        return this;
+    }
+    get(schema) {
+        // return this._map.get(schema) as any;
+        // inherit metadata
+        const p = schema._zod.parent;
+        if (p) {
+            const pm = { ...(this.get(p) ?? {}) };
+            delete pm.id; // do not inherit id
+            const f = { ...pm, ...this._map.get(schema) };
+            return Object.keys(f).length ? f : undefined;
+        }
+        return this._map.get(schema);
+    }
+    has(schema) {
+        return this._map.has(schema);
+    }
+}
+// registries
+function registry() {
+    return new $ZodRegistry();
+}
+(_a = globalThis).__zod_globalRegistry ?? (_a.__zod_globalRegistry = registry());
+const globalRegistry = globalThis.__zod_globalRegistry;
+
 // @__NO_SIDE_EFFECTS__
 function _string(Class, params) {
     return new Class({
@@ -1229,6 +1287,18 @@ function _unknown(Class) {
         type: "unknown",
     });
 }
+// @__NO_SIDE_EFFECTS__
+function describe$1(description) {
+    const ch = new $ZodCheck({ check: "describe" });
+    ch._zod.onattach = [
+        (inst) => {
+            const existing = globalRegistry.get(inst) ?? {};
+            globalRegistry.add(inst, { ...existing, description });
+        },
+    ];
+    ch._zod.check = () => { }; // no-op check
+    return ch;
+}
 
 const ZodMiniType = /*@__PURE__*/ $constructor("ZodMiniType", (inst, def) => {
     if (!inst._zod)
@@ -1392,6 +1462,8 @@ function optional(innerType) {
         innerType: innerType,
     });
 }
+// Re-export describe and meta from core
+const describe = describe$1;
 
 // zod/mini ships with a minimal error map ("Invalid input"). The English
 // locale restores messages like "expected number, received string", which is
@@ -1506,9 +1578,11 @@ const appearanceSchema = object({
      * Independent of `layoutVariant`, which controls density.
      * Defaults to `tabs`. A single-method session renders the bare form.
      */
-    layout: optional(_enum(['tabs', 'accordion', 'stacked', 'minimal'])),
+    layout: optional(_enum(['tabs', 'accordion', 'stacked', 'minimal'])
+        .check(describe('How the buyer moves between payment methods. Defaults to tabs. A single-method session renders the bare form.'))),
     /** Density: how much room the component takes. */
-    layoutVariant: optional(_enum(['compact', 'standard', 'wide'])),
+    layoutVariant: optional(_enum(['compact', 'standard', 'wide'])
+        .check(describe('Density: how much room the component takes.'))),
     /**
      * Field appearance: where a field's label sits.
      * `above` puts the label over the input. The other two start it inside the
@@ -1516,10 +1590,14 @@ const appearanceSchema = object({
      * has focus or a value: `floating` to the top of the box, `outlined` onto
      * the border, cutting a notch in the line. Defaults to `above`.
      */
-    labelStyle: optional(_enum(['above', 'floating', 'outlined'])),
-    mode: optional(_enum(['light', 'dark', 'system'])),
-    tokens: optional(record$1(string(), string())),
-    labels: optional(record$1(string(), string())),
+    labelStyle: optional(_enum(['above', 'floating', 'outlined'])
+        .check(describe('Where a field label sits. above: over the input. floating: inside the field, lifts to the top of the box. outlined: inside the field, lifts onto the border. Defaults to above.'))),
+    colorScheme: optional(_enum(['light', 'dark', 'system'])
+        .check(describe('Color scheme. system follows the buyer device setting.'))),
+    tokens: optional(record$1(string(), string())
+        .check(describe('CSS custom properties the component honors, for example --primary and --background.'))),
+    labels: optional(record$1(string(), string())
+        .check(describe('Text overrides keyed by label id.'))),
 });
 /**
  * Inbound wire messages: iframe → parent SDK. One schema per wire type, and
@@ -1629,7 +1707,8 @@ const CARD_BRANDS = [
  * object (via the descriptor's `optionsSchema`).
  */
 const payinOptionsSchema = object({
-    showSubmitButton: optional(boolean()),
+    showSubmitButton: optional(boolean()
+        .check(describe('Render the submit button inside the component. Set false when the host page owns the button and calls submit().'))),
 });
 /** PayIn's own inbound events, beyond the base set every component shares. */
 const payinEvents = {

package/dist/protocol/base.d.ts

@@ -29,7 +29,7 @@ export declare const appearanceSchema: z.ZodMiniObject<{
         floating: "floating";
         outlined: "outlined";
     }>>;
-    mode: z.ZodMiniOptional<z.ZodMiniEnum<{
+    colorScheme: z.ZodMiniOptional<z.ZodMiniEnum<{
         light: "light";
         dark: "dark";
         system: "system";
@@ -116,7 +116,7 @@ export declare const outboundMessages: {
                 floating: "floating";
                 outlined: "outlined";
             }>>;
-            mode: z.ZodMiniOptional<z.ZodMiniEnum<{
+            colorScheme: z.ZodMiniOptional<z.ZodMiniEnum<{
                 light: "light";
                 dark: "dark";
                 system: "system";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payabli/component-contracts",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Wire schemas, component registry, and partner-facing types shared by the Payabli embedded components SDK and payhub.",
   "private": false,
   "license": "UNLICENSED",