@adhd/apigen-base-logical 0.1.0 → 0.1.2

package/index.mjs

@@ -1,333 +1,465 @@
-const l = "$apigen";
-class g extends Error {
-  constructor(o) {
-    super(o), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
+const D = "$apigen";
+class N extends Error {
+  constructor(t) {
+    super(t), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
   }
 }
-function z(e) {
+function de(e) {
   e == null || e.wellKnown;
-  const o = /* @__PURE__ */ new Map();
+  const t = /* @__PURE__ */ new Map();
   return {
-    register(n, r) {
-      if (o.has(n.id) && !(r != null && r.override))
-        throw new g(
+    register(n, o) {
+      if (t.has(n.id) && !(o != null && o.override))
+        throw new N(
           `E_DUP_CODEC: a codec is already registered for id "${n.id}"`
         );
-      o.set(n.id, n);
+      t.set(n.id, n);
     },
     resolve(n) {
-      for (const r of o.values())
-        if (r.matches(n))
-          return r;
+      for (const o of t.values())
+        if (o.matches(n))
+          return o;
     },
     get(n) {
-      return o.get(n);
+      return t.get(n);
     },
     ids() {
-      return [...o.keys()];
+      return [...t.keys()];
     },
     freeze() {
-      const n = new Map(o), r = {
+      const n = new Map(t), o = {
         register() {
-          throw new g(
+          throw new N(
             "E_DUP_CODEC: registry is frozen and cannot accept new codecs"
           );
         },
-        resolve(d) {
+        resolve(i) {
           for (const a of n.values())
-            if (a.matches(d))
+            if (a.matches(i))
               return a;
         },
-        get(d) {
-          return n.get(d);
+        get(i) {
+          return n.get(i);
         },
         ids() {
           return [...n.keys()];
         },
         freeze() {
-          return r;
+          return o;
         }
       };
-      return r;
+      return o;
     }
   };
 }
-const v = "x-apigen-logical", U = "x-apigen-codec", W = "x-apigen-ctor", K = "x-apigen-tojson", X = "0.1.0", j = [
+const z = "x-apigen-logical", J = "x-apigen-codec", ae = "x-apigen-ctor", fe = "x-apigen-tojson", ue = "0.1.0", V = [
   "scalar",
   "nominal",
   "union",
   "map",
   "set"
 ];
-function H(e) {
-  const o = e[v];
-  return typeof o == "string" && j.includes(o) ? o : void 0;
+function pe(e) {
+  const t = e[z];
+  return typeof t == "string" && V.includes(t) ? t : void 0;
 }
-function Z(e) {
-  const o = e[U];
-  return typeof o == "string" ? o : void 0;
+function me(e) {
+  const t = e[J];
+  return typeof t == "string" ? t : void 0;
 }
-function h(e, o) {
+function v(e, t) {
   return {
     registry: e,
-    resolve: (t) => {
+    resolve: (r) => {
       throw new Error(
-        `[apigen-logical] $ref "${t}" cannot be resolved in run-mode without a descriptor root. Supply a resolve() in the ctx override to handle $ref.`
+        `[apigen-logical] $ref "${r}" cannot be resolved in run-mode without a descriptor root. Supply a resolve() in the ctx override to handle $ref.`
       );
     },
     seen: /* @__PURE__ */ new WeakSet(),
     path: "",
     mode: "strict",
-    ...o
+    ...t
   };
 }
-function p(e, o, t) {
-  const n = t.registry.resolve(o);
+function l(e, t, r) {
+  const n = r.registry.resolve(t);
   if (n)
-    return n.encode(e, o, t);
-  const r = o.$ref;
-  if (typeof r == "string") {
-    const i = t.resolve(r);
-    return p(e, i, t);
-  }
-  const d = o.oneOf;
-  if (Array.isArray(d)) {
-    const i = S(e, d, o);
-    return p(e, i, t);
-  }
-  const a = o.type;
+    return n.encode(e, t, r);
+  const o = t.$ref;
+  if (typeof o == "string") {
+    const c = r.resolve(o);
+    return l(e, c, r);
+  }
+  const i = t.oneOf;
+  if (Array.isArray(i)) {
+    const c = L(e, i, t, r);
+    return l(e, c, r);
+  }
+  const a = t.type;
   if (a === "array") {
     if (!Array.isArray(e))
-      return D(e, o, t);
-    const i = o.items;
-    if (!i)
-      return e.map((c) => u(c));
-    const f = t.path;
-    return Array.isArray(i) ? e.map((c, _) => {
-      const s = i[_];
-      return s === void 0 ? u(c) : p(c, s, { ...t, path: `${f}/${_}` });
+      return b(e, t, r);
+    const c = t.items;
+    if (!c)
+      return e.map((f) => _(f));
+    const u = r.path;
+    return Array.isArray(c) ? e.map((f, s) => {
+      const d = c[s];
+      return d === void 0 ? _(f) : l(f, d, { ...r, path: `${u}/${s}` });
     }) : e.map(
-      (c, _) => p(c, i, { ...t, path: `${f}/${_}` })
+      (f, s) => l(f, c, { ...r, path: `${u}/${s}` })
     );
   }
   if (a === "object") {
     if (e === null || typeof e != "object" || Array.isArray(e))
-      return D(e, o, t);
-    const i = o.properties;
-    if (!i)
-      return u(e);
-    const f = t.path, c = {};
-    for (const [_, s] of Object.entries(i)) {
-      const m = e[_];
-      m !== void 0 && (c[_] = p(m, s, {
-        ...t,
-        path: `${f}/${_}`
+      return b(e, t, r);
+    const c = t.properties;
+    if (!c)
+      return _(e);
+    const u = r.path, f = {};
+    for (const [s, d] of Object.entries(c)) {
+      const p = e[s];
+      p !== void 0 && (f[s] = l(p, d, {
+        ...r,
+        path: `${u}/${s}`
       }));
     }
-    return c;
+    return f;
   }
-  return a == null ? D(e, o, t) : u(e);
+  return a == null ? b(e, t, r) : _(e);
 }
-function E(e, o, t) {
-  const n = t.registry.resolve(o);
+function y(e, t, r) {
+  const n = r.registry.resolve(t);
   if (n)
-    return n.decode(e, o, t);
-  const r = o.$ref;
-  if (typeof r == "string") {
-    const i = t.resolve(r);
-    return E(e, i, t);
-  }
-  const d = o.oneOf;
-  if (Array.isArray(d)) {
-    const i = S(e, d, o);
-    return E(e, i, t);
-  }
-  const a = o.type;
+    return n.decode(e, t, r);
+  const o = t.$ref;
+  if (typeof o == "string") {
+    const c = r.resolve(o);
+    return y(e, c, r);
+  }
+  const i = t.oneOf;
+  if (Array.isArray(i)) {
+    const c = L(e, i, t, r);
+    return y(e, c, r);
+  }
+  const a = t.type;
   if (a === "array") {
     if (!Array.isArray(e))
       return e;
-    const i = o.items;
-    if (!i)
+    const c = t.items;
+    if (!c)
       return e;
-    const f = t.path;
-    return Array.isArray(i) ? e.map((c, _) => {
-      const s = i[_];
-      return s === void 0 ? c : E(c, s, { ...t, path: `${f}/${_}` });
+    const u = r.path;
+    return Array.isArray(c) ? e.map((f, s) => {
+      const d = c[s];
+      return d === void 0 ? f : y(f, d, { ...r, path: `${u}/${s}` });
     }) : e.map(
-      (c, _) => E(c, i, { ...t, path: `${f}/${_}` })
+      (f, s) => y(f, c, { ...r, path: `${u}/${s}` })
     );
   }
   if (a === "object") {
     if (e === null || typeof e != "object" || Array.isArray(e))
       return e;
-    const i = o.properties;
-    if (!i)
+    const c = t.properties;
+    if (!c)
       return e;
-    const f = t.path, c = {};
-    for (const [_, s] of Object.entries(i)) {
-      const m = e[_];
-      m !== void 0 && (c[_] = E(m, s, {
-        ...t,
-        path: `${f}/${_}`
+    const u = r.path, f = {};
+    for (const [s, d] of Object.entries(c)) {
+      const p = e[s];
+      p !== void 0 && (f[s] = y(p, d, {
+        ...r,
+        path: `${u}/${s}`
       }));
     }
-    return c;
-  }
-  return a == null ? M(e, t) : e;
-}
-function S(e, o, t, n) {
-  const r = t.discriminator;
-  if (r != null && r.propertyName) {
-    const d = e !== null && typeof e == "object" ? e[r.propertyName] : void 0;
-    if (typeof d == "string" && r.mapping) {
-      const a = r.mapping[d];
-      if (a) {
-        const i = o.find((f) => f.$ref === a);
-        if (i)
-          return i;
+    for (const [s, d] of Object.entries(e))
+      !(s in c) && d !== void 0 && (f[s] = d);
+    return f;
+  }
+  return a == null ? S(e, r) : e;
+}
+function L(e, t, r, n) {
+  var u;
+  const o = r.discriminator;
+  if (o != null && o.propertyName) {
+    const f = o.propertyName, s = e !== null && typeof e == "object" ? e[f] : void 0;
+    if (typeof s == "string") {
+      if (o.mapping) {
+        const d = o.mapping[s];
+        if (d) {
+          const p = t.find((m) => m.$ref === d);
+          if (p)
+            return p;
+        }
+      }
+      for (const d of t) {
+        const m = (u = O(d, n).properties) == null ? void 0 : u[f];
+        if (!m)
+          continue;
+        const g = m.enum;
+        if (m.const === s || Array.isArray(g) && g.includes(s))
+          return d;
       }
     }
   }
-  return o[0] ?? {};
+  const i = Y(e, t, n);
+  if (i)
+    return i;
+  let a, c = -1;
+  for (const f of t) {
+    const s = O(f, n), d = U(e, s, n);
+    d !== null && d > c && (c = d, a = f);
+  }
+  return a !== void 0 ? a : t[0] ?? {};
 }
-function D(e, o, t) {
-  for (const n of t.registry.ids()) {
-    const r = t.registry.get(n);
-    if (r)
-      try {
-        const d = r.encode(e, r.schema, t);
-        return { [l]: n, v: d };
-      } catch {
+function O(e, t) {
+  const r = e.$ref;
+  return typeof r == "string" ? t.resolve(r) : e;
+}
+function I(e) {
+  if ("const" in e)
+    return e.const;
+  const t = e.enum;
+  if (Array.isArray(t) && t.length === 1)
+    return t[0];
+}
+function Y(e, t, r) {
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    return;
+  const n = e, o = t.map((a) => O(a, r)), i = /* @__PURE__ */ new Set();
+  for (const a of o) {
+    const c = a.properties;
+    if (c)
+      for (const [u, f] of Object.entries(c))
+        I(f) !== void 0 && i.add(u);
+  }
+  for (const a of i) {
+    const c = o.map((p) => {
+      const m = p.properties, g = m == null ? void 0 : m[a];
+      return g ? I(g) : void 0;
+    }), u = c.filter((p) => p !== void 0), f = new Set(u);
+    if (u.length < 2 || f.size !== u.length)
+      continue;
+    const s = n[a];
+    if (s === void 0)
+      continue;
+    const d = c.findIndex((p) => p === s);
+    if (d !== -1)
+      return t[d];
+  }
+}
+function W(e) {
+  if (e === null)
+    return "null";
+  if (Array.isArray(e))
+    return "array";
+  const t = typeof e;
+  return t === "number" ? Number.isInteger(e) ? "integer" : "number" : t;
+}
+function U(e, t, r) {
+  const n = t.oneOf;
+  if (Array.isArray(n)) {
+    let s = null;
+    for (const d of n) {
+      const p = U(e, O(d, r), r);
+      p !== null && (s === null || p > s) && (s = p);
+    }
+    return s;
+  }
+  const o = t.type, i = W(e);
+  if (typeof o == "string") {
+    if (!(o === i || o === "number" && i === "integer"))
+      return null;
+  } else if (Array.isArray(o) && !o.some(
+    (d) => d === i || d === "number" && i === "integer"
+  ))
+    return null;
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    return typeof o == "string" ? 1 : 0;
+  const a = e, c = t.required;
+  let u = 0;
+  if (Array.isArray(c)) {
+    for (const s of c)
+      if (typeof s == "string") {
+        if (a[s] === void 0)
+          return null;
+        u += 2;
       }
   }
-  return u(e);
+  const f = t.properties;
+  if (f) {
+    for (const s of Object.keys(f))
+      a[s] !== void 0 && (u += 1);
+    for (const s of Object.keys(a))
+      f[s] === void 0 && (u -= 1);
+  }
+  return u;
+}
+function b(e, t, r) {
+  var n;
+  for (const o of r.registry.ids()) {
+    const i = r.registry.get(o);
+    if ((n = i == null ? void 0 : i.ownsValue) != null && n.call(i, e))
+      return {
+        [D]: o,
+        v: i.encode(e, i.schema, r)
+      };
+  }
+  if (Array.isArray(e))
+    return e.map((o) => b(o, {}, r));
+  if (j(e)) {
+    const o = {};
+    for (const [i, a] of Object.entries(e))
+      a !== void 0 && (o[i] = b(a, {}, r));
+    return o;
+  }
+  return _(e);
 }
-function M(e, o) {
-  if (e !== null && typeof e == "object" && !Array.isArray(e) && l in e) {
-    const t = e, n = t[l], r = o.registry.get(n);
-    if (r)
-      return r.decode(t.v, r.schema, o);
+function j(e) {
+  if (e === null || typeof e != "object" || Array.isArray(e))
+    return !1;
+  const t = Object.getPrototypeOf(e);
+  return t === Object.prototype || t === null;
+}
+function S(e, t) {
+  if (e !== null && typeof e == "object" && !Array.isArray(e) && D in e) {
+    const r = e, n = r[D], o = t.registry.get(n);
+    if (o)
+      return o.decode(r.v, o.schema, t);
+  }
+  if (Array.isArray(e))
+    return e.map((r) => S(r, t));
+  if (j(e)) {
+    const r = {};
+    for (const [n, o] of Object.entries(e))
+      r[n] = S(o, t);
+    return r;
   }
   return e;
 }
-function u(e) {
+function _(e) {
   if (e === null || typeof e == "string" || typeof e == "number" || typeof e == "boolean")
     return e;
   if (Array.isArray(e))
-    return e.map(u);
+    return e.map(_);
   if (typeof e == "object") {
-    const o = {};
-    for (const [t, n] of Object.entries(e))
-      n !== void 0 && (o[t] = u(n));
-    return o;
+    const t = {};
+    for (const [r, n] of Object.entries(e))
+      n !== void 0 && (t[r] = _(n));
+    return t;
   }
   return null;
 }
-function q(e, o) {
-  const t = /* @__PURE__ */ new Set(), n = [e];
+function _e(e, t) {
+  const r = /* @__PURE__ */ new Set(), n = [e];
   for (; n.length > 0; ) {
-    const r = n.pop();
-    if (!r || t.has(r))
+    const o = n.pop();
+    if (!o || r.has(o))
       continue;
-    t.add(r);
-    const d = r.$ref;
-    if (typeof d == "string") {
-      if (o) {
-        const s = o[d];
-        if (!s) {
-          const m = Object.keys(o).join(", ") || "(none)";
+    r.add(o);
+    const i = o.$ref;
+    if (typeof i == "string") {
+      if (t) {
+        const d = t[i];
+        if (!d) {
+          const p = Object.keys(t).join(", ") || "(none)";
           throw new Error(
-            `[apigen-logical] $ref "${d}" cannot be resolved. Available $defs: ${m}`
+            `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${p}`
           );
         }
-        n.push(s);
+        n.push(d);
       }
       continue;
     }
-    const a = r.oneOf;
+    const a = o.oneOf;
     if (Array.isArray(a))
-      for (const s of a)
-        typeof s == "object" && s !== null && n.push(s);
-    const i = r.properties;
-    if (i)
-      for (const s of Object.values(i))
-        n.push(s);
-    const f = r.items;
-    if (Array.isArray(f))
-      for (const s of f)
-        typeof s == "object" && s !== null && n.push(s);
+      for (const d of a)
+        typeof d == "object" && d !== null && n.push(d);
+    const c = o.properties;
+    if (c)
+      for (const d of Object.values(c))
+        n.push(d);
+    const u = o.items;
+    if (Array.isArray(u))
+      for (const d of u)
+        typeof d == "object" && d !== null && n.push(d);
     else
-      typeof f == "object" && f !== null && n.push(f);
-    const c = r.additionalProperties;
-    typeof c == "object" && c !== null && n.push(c);
-    const _ = r.propertyNames;
-    typeof _ == "object" && _ !== null && n.push(_);
+      typeof u == "object" && u !== null && n.push(u);
+    const f = o.additionalProperties;
+    typeof f == "object" && f !== null && n.push(f);
+    const s = o.propertyNames;
+    typeof s == "object" && s !== null && n.push(s);
   }
 }
-function Q(e) {
+function le(e) {
   return {
-    encode(o, t, n) {
-      const r = h(e, n);
-      return p(o, t, r);
+    encode(t, r, n) {
+      const o = v(e, n);
+      return l(t, r, o);
     },
-    decode(o, t, n) {
-      const r = h(e, n);
-      return E(o, t, r);
+    decode(t, r, n) {
+      const o = v(e, n);
+      return y(t, r, o);
     }
   };
 }
-function x(e, o, t) {
+function ye(e, t, r) {
   try {
-    const n = t();
+    const n = r();
     e.register(n);
   } catch (n) {
-    if (P(n))
+    if (q(n))
       return;
     throw n;
   }
 }
-function P(e) {
+function q(e) {
   return e === null || typeof e != "object" ? !1 : e.code === "MODULE_NOT_FOUND";
 }
-const b = {
+const k = {
   id: "date-time",
   kind: "scalar",
   schema: { type: "string", format: "date-time" },
   matches(e) {
     return e.type === "string" && e.format === "date-time";
   },
-  encode(e, o, t) {
+  ownsValue(e) {
+    return e instanceof Date;
+  },
+  encode(e, t, r) {
     return e.toISOString();
   },
-  decode(e, o, t) {
+  decode(e, t, r) {
     if (typeof e != "string") {
-      if (t.mode === "strict")
+      if (r.mode === "strict")
         throw new TypeError(
-          `[date-time] expected a string on the wire at "${t.path}", got ${typeof e}`
+          `[date-time] expected a string on the wire at "${r.path}", got ${typeof e}`
         );
       return new Date(String(e));
     }
-    if (t.mode === "strict" && Number.isNaN(new Date(e).getTime()))
+    if (r.mode === "strict" && Number.isNaN(new Date(e).getTime()))
       throw new TypeError(
-        `[date-time] invalid date-time string at "${t.path}": ${JSON.stringify(e)}`
+        `[date-time] invalid date-time string at "${r.path}": ${JSON.stringify(e)}`
       );
     return new Date(e);
   }
-}, N = {
+}, R = {
   id: "int64",
   kind: "scalar",
   schema: { type: "string", format: "int64" },
   matches(e) {
     return e.type === "string" && e.format === "int64";
   },
-  encode(e, o, t) {
+  ownsValue(e) {
+    return typeof e == "bigint";
+  },
+  encode(e, t, r) {
     return String(e);
   },
-  decode(e, o, t) {
+  decode(e, t, r) {
     if (typeof e != "string") {
-      if (t.mode === "strict")
+      if (r.mode === "strict")
         throw new TypeError(
-          `[int64] expected a string on the wire at "${t.path}", got ${typeof e}`
+          `[int64] expected a string on the wire at "${r.path}", got ${typeof e}`
         );
       try {
         return BigInt(Math.trunc(Number(e)));
@@ -335,7 +467,7 @@ const b = {
         return BigInt(0);
       }
     }
-    if (t.mode === "strict")
+    if (r.mode === "strict")
       return BigInt(e);
     if (/^-?\d+$/.test(e))
       try {
@@ -346,141 +478,261 @@ const b = {
     return BigInt(0);
   }
 };
-function ee(e) {
+function ge(e) {
   return e;
 }
-const F = {
+const P = {
   id: "decimal",
   kind: "scalar",
   schema: { type: "string", format: "decimal" },
   matches(e) {
     return e.type === "string" && e.format === "decimal";
   },
-  encode(e, o, t) {
+  encode(e, t, r) {
     return e;
   },
-  decode(e, o, t) {
+  decode(e, t, r) {
     if (typeof e != "string") {
-      if (t.mode === "strict")
+      if (r.mode === "strict")
         throw new TypeError(
-          `[decimal] expected a string on the wire at "${t.path}", got ${typeof e}`
+          `[decimal] expected a string on the wire at "${r.path}", got ${typeof e}`
         );
       return String(e);
     }
-    if (t.mode === "strict" && !/^-?\d+(\.\d+)?$/.test(e))
+    if (r.mode === "strict" && !/^-?\d+(\.\d+)?$/.test(e))
       throw new TypeError(
-        `[decimal] wire value "${e}" at "${t.path}" is not a valid decimal string`
+        `[decimal] wire value "${e}" at "${r.path}" is not a valid decimal string`
       );
     return e;
   }
-}, $ = {
+}, B = {
   id: "byte",
   kind: "scalar",
   schema: { type: "string", format: "byte" },
   matches(e) {
     return e.type === "string" && e.format === "byte";
   },
-  encode(e, o, t) {
+  ownsValue(e) {
+    return e instanceof Uint8Array;
+  },
+  encode(e, t, r) {
     return Buffer.from(e).toString("base64");
   },
-  decode(e, o, t) {
+  decode(e, t, r) {
     if (typeof e != "string") {
-      if (t.mode === "strict")
+      if (r.mode === "strict")
         throw new TypeError(
-          `[byte] expected a base64 string on the wire at "${t.path}", got ${typeof e}`
+          `[byte] expected a base64 string on the wire at "${r.path}", got ${typeof e}`
         );
       return new Uint8Array(0);
     }
-    if (t.mode === "strict" && !/^[A-Za-z0-9+/]*={0,2}$/.test(e))
+    if (r.mode === "strict" && !/^[A-Za-z0-9+/]*={0,2}$/.test(e))
       throw new TypeError(
-        `[byte] wire value at "${t.path}" is not standard base64 (format:byte): "${e}"`
+        `[byte] wire value at "${r.path}" is not standard base64 (format:byte): "${e}"`
       );
     return new Uint8Array(Buffer.from(e, "base64"));
   }
-}, R = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, L = {
+}, K = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, w = {
   id: "uuid",
   kind: "scalar",
   schema: { type: "string", format: "uuid" },
   matches(e) {
     return e.type === "string" && e.format === "uuid";
   },
-  encode(e, o, t) {
+  encode(e, t, r) {
     return e.toLowerCase();
   },
-  decode(e, o, t) {
+  decode(e, t, r) {
     if (typeof e != "string") {
-      if (t.mode === "strict")
+      if (r.mode === "strict")
         throw new TypeError(
-          `[uuid] expected a string on the wire at "${t.path}", got ${typeof e}`
+          `[uuid] expected a string on the wire at "${r.path}", got ${typeof e}`
         );
       return String(e).toLowerCase();
     }
-    if (t.mode === "strict" && !R.test(e))
+    if (r.mode === "strict" && !K.test(e))
       throw new TypeError(
-        `[uuid] wire value "${e}" at "${t.path}" is not a lowercase-hyphenated RFC 4122 UUID`
+        `[uuid] wire value "${e}" at "${r.path}" is not a lowercase-hyphenated RFC 4122 UUID`
       );
     return e;
   }
-}, O = "NaN", C = "Infinity", A = "-Infinity", G = /* @__PURE__ */ new Set([
-  O,
+}, h = "NaN", C = "Infinity", $ = "-Infinity", X = /* @__PURE__ */ new Set([
+  h,
   C,
-  A
-]), I = {
+  $
+]), M = {
   id: "number-special",
   kind: "scalar",
   schema: { type: "number" },
   matches(e) {
     return e.type === "number" && e.format === void 0;
   },
-  encode(e, o, t) {
-    return Number.isNaN(e) ? O : e === 1 / 0 ? C : e === -1 / 0 ? A : e;
+  ownsValue(e) {
+    return typeof e == "number" && !Number.isFinite(e);
+  },
+  encode(e, t, r) {
+    return Number.isNaN(e) ? h : e === 1 / 0 ? C : e === -1 / 0 ? $ : e;
   },
-  decode(e, o, t) {
+  decode(e, t, r) {
     if (typeof e == "number")
       return e;
     if (typeof e == "string") {
-      if (e === O)
+      if (e === h)
         return NaN;
       if (e === C)
         return 1 / 0;
-      if (e === A)
+      if (e === $)
         return -1 / 0;
       const n = Number(e);
       if (!Number.isNaN(n))
         return n;
     }
-    if (t.mode === "strict")
+    if (r.mode === "strict")
       throw new TypeError(
-        `[number-special] unrecognized wire value at "${t.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...G].join(", ")}.`
+        `[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...X].join(", ")}.`
       );
     return NaN;
   }
-}, w = [
-  b,
-  N,
-  F,
-  $,
-  L,
-  I
+}, Z = [
+  k,
+  R,
+  P,
+  B,
+  w,
+  M
 ];
-function te(e, o = {}) {
-  for (const t of w)
-    e.register(t, { override: o.override ?? !1 });
+function be(e, t = {}) {
+  for (const r of Z)
+    e.register(r, { override: t.override ?? !1 });
+}
+const H = 12;
+function Q(e, t) {
+  const r = /^#\/(definitions|\$defs)\/(.+)$/.exec(e);
+  if (!r)
+    return;
+  const [, n, o] = r, i = n === "$defs" ? t.$defs : t.definitions;
+  return i == null ? void 0 : i[decodeURIComponent(o)];
+}
+function T(e) {
+  return Array.isArray(e) && e.length > 0 ? e[0] : void 0;
+}
+function x(e) {
+  if (Array.isArray(e.type))
+    return e.type.find((t) => t !== "null") ?? e.type[0];
+  if (typeof e.type == "string")
+    return e.type;
+  if (e.properties)
+    return "object";
+}
+function ee(e) {
+  switch (e.format) {
+    case "date-time":
+      return "1970-01-01T00:00:00.000Z";
+    case "date":
+      return "1970-01-01";
+    case "time":
+      return "00:00:00Z";
+    case "uuid":
+      return "00000000-0000-0000-0000-000000000000";
+    case "email":
+      return "user@example.com";
+    case "uri":
+    case "url":
+    case "uri-reference":
+      return "https://example.com";
+    case "hostname":
+      return "example.com";
+    case "ipv4":
+      return "127.0.0.1";
+    case "ipv6":
+      return "::1";
+    case "decimal":
+      return "0";
+    case "int64":
+      return "0";
+    case "byte":
+      return "";
+    default:
+      return "<string>";
+  }
+}
+function F(e, t, r) {
+  const n = e.properties ?? {}, o = e.required ?? [], i = {};
+  for (const a of o) {
+    const c = n[a];
+    i[a] = c !== void 0 ? E(c, t, r + 1) : `<${a}>`;
+  }
+  return i;
+}
+function te(e, t, r) {
+  const n = Array.isArray(e.items) ? e.items[0] : e.items;
+  return n ? [E(n, t, r + 1)] : [];
 }
-const T = [
-  b.id,
+function E(e, t = e ?? {}, r = 0) {
+  if (!e || r > H)
+    return null;
+  if (typeof e.$ref == "string") {
+    const i = Q(e.$ref, t);
+    return i !== void 0 ? E(i, t, r + 1) : null;
+  }
+  if (e.const !== void 0)
+    return e.const;
+  if (Array.isArray(e.enum) && e.enum.length > 0)
+    return e.enum[0];
+  if (Array.isArray(e.allOf) && e.allOf.length > 0) {
+    const i = {}, a = [];
+    for (const c of e.allOf) {
+      Object.assign(i, c.properties ?? {});
+      for (const u of c.required ?? [])
+        a.includes(u) || a.push(u);
+    }
+    return F(
+      { ...e, properties: i, required: a },
+      t,
+      r
+    );
+  }
+  const n = T(e.oneOf) ?? T(e.anyOf);
+  if (n)
+    return E(n, t, r + 1);
+  switch (x(e)) {
+    case "object":
+      return F(e, t, r);
+    case "array":
+      return te(e, t, r);
+    case "string":
+      return ee(e);
+    case "integer":
+    case "number":
+      return 0;
+    case "boolean":
+      return !1;
+    case "null":
+      return null;
+    default:
+      return null;
+  }
+}
+function Ee(e) {
+  if (!e)
+    return;
+  const t = E(e);
+  return `Example: ${JSON.stringify(t)}`;
+}
+const G = [
+  k.id,
   // 'date-time'
-  N.id,
+  R.id,
   // 'int64'
-  F.id,
+  P.id,
   // 'decimal'
-  $.id,
+  B.id,
   // 'byte'
-  L.id,
+  w.id,
   // 'uuid'
-  I.id
+  M.id
   // 'number-special'
-], B = {
+], re = {
   "date-time": {
     encode: "$.toISOString()",
     decode: "new Date($)",
@@ -519,7 +771,7 @@ const T = [
     decode: "wireToNum($)",
     mode: "native"
   }
-}, k = {
+}, ne = {
   "date-time": {
     encode: "$.isoformat()",
     decode: "datetime.fromisoformat($)",
@@ -556,7 +808,7 @@ const T = [
     decode: "wire_to_num($)",
     mode: "native"
   }
-}, J = {
+}, oe = {
   "date-time": {
     // chrono::DateTime<Utc> serialises as RFC3339 via serde.
     encode: "__SCAFFOLD_RUST_DATETIME_ENCODE__",
@@ -600,7 +852,7 @@ const T = [
     decode: "__SCAFFOLD_RUST_NUMSPECIAL_DECODE__",
     mode: "native"
   }
-}, V = {
+}, ie = {
   "date-time": {
     // time.Time serialises as RFC3339Nano via MarshalJSON.
     encode: "__SCAFFOLD_GO_DATETIME_ENCODE__",
@@ -641,78 +893,104 @@ const T = [
     decode: "__SCAFFOLD_GO_NUMSPECIAL_DECODE__",
     mode: "native"
   }
-}, Y = {
+}, se = {
   "date-time": {
-    // Instant.toString() / Instant.parse() via jackson-datatype-jsr310.
-    encode: "__SCAFFOLD_JAVA_DATETIME_ENCODE__",
-    decode: "__SCAFFOLD_JAVA_DATETIME_DECODE__",
+    // Instant.toString() (RFC-3339/ISO-8601, UTC) / Instant.parse($) — the
+    // jackson-datatype-jsr310 module is registered on the shared ObjectMapper
+    // so java.time.Instant fields round-trip automatically, but the
+    // dispatcher-woven glue (which builds/reads JsonNode by hand rather than
+    // going through a field-annotated POJO) uses these expressions directly.
+    encode: "$.toString()",
+    decode: "Instant.parse($)",
     imports: ["import java.time.Instant;"],
     dep: { name: "jackson-datatype-jsr310", version: "2.x" },
     mode: "lib"
   },
   int64: {
-    // @JsonFormat(shape=STRING) on Long / BigInteger — stdlib Jackson.
-    encode: "__SCAFFOLD_JAVA_INT64_ENCODE__",
-    decode: "__SCAFFOLD_JAVA_INT64_DECODE__",
+    // Declarative, not expression-shaped: Jackson field annotation forces
+    // Long/long to serialise as a JSON string (avoids precision loss in
+    // JS/JSON-number consumers). mode:'native' — the "encode"/"decode"
+    // values below ARE the annotation text (identical on both sides; Jackson
+    // applies it symmetrically), not a `$`-substituted call expression.
+    encode: "@JsonFormat(shape = JsonFormat.Shape.STRING)",
+    decode: "@JsonFormat(shape = JsonFormat.Shape.STRING)",
     imports: ["import com.fasterxml.jackson.annotation.JsonFormat;"],
     mode: "native"
   },
   decimal: {
-    // @JsonSerialize(using=ToStringSerializer) on BigDecimal — stdlib Jackson.
-    encode: "__SCAFFOLD_JAVA_DECIMAL_ENCODE__",
-    decode: "__SCAFFOLD_JAVA_DECIMAL_DECODE__",
-    imports: ["import java.math.BigDecimal;"],
+    // Encode is declarative (field annotation forces BigDecimal -> JSON
+    // string via Jackson's stdlib ToStringSerializer, so scale/precision
+    // survive the wire); decode is a plain expression since BigDecimal has
+    // no matching stdlib deserializer-by-annotation for "parse from string".
+    encode: "@JsonSerialize(using = ToStringSerializer.class)",
+    decode: "new BigDecimal($)",
+    imports: [
+      "import java.math.BigDecimal;",
+      "import com.fasterxml.jackson.databind.annotation.JsonSerialize;",
+      "import com.fasterxml.jackson.databind.ser.std.ToStringSerializer;"
+    ],
     mode: "native"
   },
   byte: {
-    // byte[] serialises as base64 by default in Jackson.
-    encode: "__SCAFFOLD_JAVA_BYTE_ENCODE__",
-    decode: "__SCAFFOLD_JAVA_BYTE_DECODE__",
+    // byte[] <-> base64 String is Jackson's built-in default codec — no
+    // annotation, no wrapping expression. The dispatcher glue passes the
+    // value through unchanged; Jackson's ObjectMapper performs the base64
+    // transcoding when the JsonNode tree is built/read.
+    encode: "$",
+    decode: "$",
     mode: "native"
   },
   uuid: {
-    // UUID.toString() / UUID.fromString() — stdlib Java.
-    encode: "__SCAFFOLD_JAVA_UUID_ENCODE__",
-    decode: "__SCAFFOLD_JAVA_UUID_DECODE__",
+    // UUID.toString() / UUID.fromString($) — stdlib Java, no Jackson module.
+    encode: "$.toString()",
+    decode: "UUID.fromString($)",
     imports: ["import java.util.UUID;"],
     mode: "native"
   },
   "number-special": {
-    // Custom StdSerializer — stdlib Jackson.
-    encode: "__SCAFFOLD_JAVA_NUMSPECIAL_ENCODE__",
-    decode: "__SCAFFOLD_JAVA_NUMSPECIAL_DECODE__",
+    // NaN/Infinity/-Infinity have no native JSON representation; mirrors the
+    // TS numToWire/wireToNum inline helpers with a small custom Jackson
+    // StdSerializer/StdDeserializer pair, generated inline by
+    // renderDispatcherJava (class names below are the fixed contract the
+    // generator emits — apigen-plugin-java-javalin/src/lib/dispatcher-template.ts).
+    encode: "@JsonSerialize(using = NumberSpecialSerializer.class)",
+    decode: "@JsonDeserialize(using = NumberSpecialDeserializer.class)",
+    imports: [
+      "import com.fasterxml.jackson.databind.annotation.JsonSerialize;",
+      "import com.fasterxml.jackson.databind.annotation.JsonDeserialize;"
+    ],
     mode: "native"
   }
-}, y = Object.freeze({
-  typescript: B,
-  python: k,
-  rust: J,
-  go: V,
-  java: Y
+}, A = Object.freeze({
+  typescript: re,
+  python: ne,
+  rust: oe,
+  go: ie,
+  java: se
 });
-function oe(e) {
-  return y[e];
+function Oe(e) {
+  return A[e];
 }
-function ne(e, o) {
-  const t = y[o], n = [];
-  for (const r of e) {
-    const d = t[r];
-    d != null && d.dep && n.push({ id: r, dep: d.dep });
+function Ae(e, t) {
+  const r = A[t], n = [];
+  for (const o of e) {
+    const i = r[o];
+    i != null && i.dep && n.push({ id: o, dep: i.dep });
   }
   return n;
 }
-function re() {
-  const e = y.typescript, o = {};
-  for (const t of T) {
-    const n = e[t].dep;
-    n && (o[t] = n);
+function De() {
+  const e = A.typescript, t = {};
+  for (const r of G) {
+    const n = e[r].dep;
+    n && (t[r] = n);
   }
-  return Object.freeze(o);
+  return Object.freeze(t);
 }
-function ie(e, o) {
-  const t = o ?? y[e], n = [];
-  for (const r of T)
-    t[r] || n.push(r);
+function Se(e, t) {
+  const r = t ?? A[e], n = [];
+  for (const o of G)
+    r[o] || n.push(o);
   if (n.length > 0)
     throw new Error(
       `[hints] assertNoEmptyCells: language "${e}" is missing cells for: ${n.join(
@@ -721,31 +999,33 @@ function ie(e, o) {
     );
 }
 export {
-  T as CANONICAL_LOGICAL_TYPE_IDS,
-  g as CodecRegistryError,
-  l as ENVELOPE_KEY,
-  X as LOGICAL_TYPE_VERSION,
-  y as TEMPLATE_CELLS,
-  U as X_APIGEN_CODEC,
-  W as X_APIGEN_CTOR,
-  v as X_APIGEN_LOGICAL,
-  K as X_APIGEN_TOJSON,
-  ie as assertNoEmptyCells,
-  Q as buildTranscoder,
-  $ as byteCodec,
-  oe as cellsFor,
-  Z as codecIdOf,
-  z as createRegistry,
-  b as dateTimeCodec,
-  F as decimalCodec,
-  ne as depsForLogicalTypes,
-  N as int64Codec,
-  H as logicalKindOf,
-  ee as makeDecimal,
-  I as numberSpecialCodec,
-  te as registerWellKnown,
-  x as tryRegister,
-  re as tsDepMap,
-  L as uuidCodec,
-  q as validateSchemaRefs
+  G as CANONICAL_LOGICAL_TYPE_IDS,
+  N as CodecRegistryError,
+  D as ENVELOPE_KEY,
+  ue as LOGICAL_TYPE_VERSION,
+  A as TEMPLATE_CELLS,
+  J as X_APIGEN_CODEC,
+  ae as X_APIGEN_CTOR,
+  z as X_APIGEN_LOGICAL,
+  fe as X_APIGEN_TOJSON,
+  Se as assertNoEmptyCells,
+  le as buildTranscoder,
+  B as byteCodec,
+  Oe as cellsFor,
+  me as codecIdOf,
+  de as createRegistry,
+  k as dateTimeCodec,
+  P as decimalCodec,
+  Ae as depsForLogicalTypes,
+  R as int64Codec,
+  pe as logicalKindOf,
+  ge as makeDecimal,
+  M as numberSpecialCodec,
+  be as registerWellKnown,
+  Ee as renderExampleNote,
+  E as synthesizeExample,
+  ye as tryRegister,
+  De as tsDepMap,
+  w as uuidCodec,
+  _e as validateSchemaRefs
 };