@adhd/apigen-base-logical 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## 0.1.2 (2026-09-24)
+
+
+### 🚀 Features
+
+- **backlog:** INTERFACE_v2 consolidation — six-verb surface, web UI (search/stats/batch/edit), stats API (citationCount, closedAt, summary scope + window)
+
+- **backlog:** 1.0.0 — one surface, one identity, no predecessor left behind
+
+
+### 🩹 Fixes
+
+- **apigen-base-logical:** pick union branches structurally and stop codecs claiming foreign values
+
+- **apigen-base-logical:** discriminated-union branch selection is inert after $ref inlining
+
+- **apigen-cli:** batch nested-input CLI/HTTP wiring, sandbox isolation leaks, morph-walk index-signature regression
+
+- **apigen:** audit fixes — S-18/S-19/C-20/C-21/S-20, java mvn race, union-encoder envelope, lazy heavy-dep loading
+
+
+### ❤️  Thank You
+
+- parity-harness-self-test
+- pseudosky
+- Sky
+
 ## 0.1.1 (2026-08-07)
 
 

package/index.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g="$apigen";class C extends Error{constructor(r){super(r),this.code="E_DUP_CODEC",this.name="CodecRegistryError"}}function G(e){e==null||e.wellKnown;const r=new Map;return{register(n,o){if(r.has(n.id)&&!(o!=null&&o.override))throw new C(`E_DUP_CODEC: a codec is already registered for id "${n.id}"`);r.set(n.id,n)},resolve(n){for(const o of r.values())if(o.matches(n))return o},get(n){return r.get(n)},ids(){return[...r.keys()]},freeze(){const n=new Map(r),o={register(){throw new C("E_DUP_CODEC: registry is frozen and cannot accept new codecs")},resolve(i){for(const c of n.values())if(c.matches(i))return c},get(i){return n.get(i)},ids(){return[...n.keys()]},freeze(){return o}};return o}}}const j="x-apigen-logical",R="x-apigen-codec",M="x-apigen-ctor",k="x-apigen-tojson",w="0.1.0",z=["scalar","nominal","union","map","set"];function B(e){const r=e[j];return typeof r=="string"&&z.includes(r)?r:void 0}function J(e){const r=e[R];return typeof r=="string"?r:void 0}function L(e,r){return{registry:e,resolve:t=>{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.`)},seen:new WeakSet,path:"",mode:"strict",...r}}function m(e,r,t){const n=t.registry.resolve(r);if(n)return n.encode(e,r,t);const o=r.$ref;if(typeof o=="string"){const s=t.resolve(o);return m(e,s,t)}const i=r.oneOf;if(Array.isArray(i)){const s=P(e,i,r);return m(e,s,t)}const c=r.type;if(c==="array"){if(!Array.isArray(e))return O(e,r,t);const s=r.items;if(!s)return e.map(a=>_(a));const u=t.path;return Array.isArray(s)?e.map((a,f)=>{const d=s[f];return d===void 0?_(a):m(a,d,{...t,path:`${u}/${f}`})}):e.map((a,f)=>m(a,s,{...t,path:`${u}/${f}`}))}if(c==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return O(e,r,t);const s=r.properties;if(!s)return _(e);const u=t.path,a={};for(const[f,d]of Object.entries(s)){const p=e[f];p!==void 0&&(a[f]=m(p,d,{...t,path:`${u}/${f}`}))}return a}return c==null?O(e,r,t):_(e)}function l(e,r,t){const n=t.registry.resolve(r);if(n)return n.decode(e,r,t);const o=r.$ref;if(typeof o=="string"){const s=t.resolve(o);return l(e,s,t)}const i=r.oneOf;if(Array.isArray(i)){const s=P(e,i,r);return l(e,s,t)}const c=r.type;if(c==="array"){if(!Array.isArray(e))return e;const s=r.items;if(!s)return e;const u=t.path;return Array.isArray(s)?e.map((a,f)=>{const d=s[f];return d===void 0?a:l(a,d,{...t,path:`${u}/${f}`})}):e.map((a,f)=>l(a,s,{...t,path:`${u}/${f}`}))}if(c==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return e;const s=r.properties;if(!s)return e;const u=t.path,a={};for(const[f,d]of Object.entries(s)){const p=e[f];p!==void 0&&(a[f]=l(p,d,{...t,path:`${u}/${f}`}))}return a}return c==null?Y(e,t):e}function P(e,r,t,n){const o=t.discriminator;if(o!=null&&o.propertyName){const i=e!==null&&typeof e=="object"?e[o.propertyName]:void 0;if(typeof i=="string"&&o.mapping){const c=o.mapping[i];if(c){const s=r.find(u=>u.$ref===c);if(s)return s}}}return r[0]??{}}function O(e,r,t){for(const n of t.registry.ids()){const o=t.registry.get(n);if(o)try{const i=o.encode(e,o.schema,t);return{[g]:n,v:i}}catch{}}return _(e)}function Y(e,r){if(e!==null&&typeof e=="object"&&!Array.isArray(e)&&g in e){const t=e,n=t[g],o=r.registry.get(n);if(o)return o.decode(t.v,o.schema,r)}return e}function _(e){if(e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean")return e;if(Array.isArray(e))return e.map(_);if(typeof e=="object"){const r={};for(const[t,n]of Object.entries(e))n!==void 0&&(r[t]=_(n));return r}return null}function K(e,r){const t=new Set,n=[e];for(;n.length>0;){const o=n.pop();if(!o||t.has(o))continue;t.add(o);const i=o.$ref;if(typeof i=="string"){if(r){const d=r[i];if(!d){const p=Object.keys(r).join(", ")||"(none)";throw new Error(`[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${p}`)}n.push(d)}continue}const c=o.oneOf;if(Array.isArray(c))for(const d of c)typeof d=="object"&&d!==null&&n.push(d);const s=o.properties;if(s)for(const d of Object.values(s))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 u=="object"&&u!==null&&n.push(u);const a=o.additionalProperties;typeof a=="object"&&a!==null&&n.push(a);const f=o.propertyNames;typeof f=="object"&&f!==null&&n.push(f)}}function W(e){return{encode(r,t,n){const o=L(e,n);return m(r,t,o)},decode(r,t,n){const o=L(e,n);return l(r,t,o)}}}function X(e,r,t){try{const n=t();e.register(n)}catch(n){if(q(n))return;throw n}}function q(e){return e===null||typeof e!="object"?!1:e.code==="MODULE_NOT_FOUND"}const A={id:"date-time",kind:"scalar",schema:{type:"string",format:"date-time"},matches(e){return e.type==="string"&&e.format==="date-time"},encode(e,r,t){return e.toISOString()},decode(e,r,t){if(typeof e!="string"){if(t.mode==="strict")throw new TypeError(`[date-time] expected a string on the wire at "${t.path}", got ${typeof e}`);return new Date(String(e))}if(t.mode==="strict"&&Number.isNaN(new Date(e).getTime()))throw new TypeError(`[date-time] invalid date-time string at "${t.path}": ${JSON.stringify(e)}`);return new Date(e)}},h={id:"int64",kind:"scalar",schema:{type:"string",format:"int64"},matches(e){return e.type==="string"&&e.format==="int64"},encode(e,r,t){return String(e)},decode(e,r,t){if(typeof e!="string"){if(t.mode==="strict")throw new TypeError(`[int64] expected a string on the wire at "${t.path}", got ${typeof e}`);try{return BigInt(Math.trunc(Number(e)))}catch{return BigInt(0)}}if(t.mode==="strict")return BigInt(e);if(/^-?\d+$/.test(e))try{return BigInt(e)}catch{return BigInt(0)}return BigInt(0)}};function V(e){return e}const N={id:"decimal",kind:"scalar",schema:{type:"string",format:"decimal"},matches(e){return e.type==="string"&&e.format==="decimal"},encode(e,r,t){return e},decode(e,r,t){if(typeof e!="string"){if(t.mode==="strict")throw new TypeError(`[decimal] expected a string on the wire at "${t.path}", got ${typeof e}`);return String(e)}if(t.mode==="strict"&&!/^-?\d+(\.\d+)?$/.test(e))throw new TypeError(`[decimal] wire value "${e}" at "${t.path}" is not a valid decimal string`);return e}},$={id:"byte",kind:"scalar",schema:{type:"string",format:"byte"},matches(e){return e.type==="string"&&e.format==="byte"},encode(e,r,t){return Buffer.from(e).toString("base64")},decode(e,r,t){if(typeof e!="string"){if(t.mode==="strict")throw new TypeError(`[byte] expected a base64 string on the wire at "${t.path}", got ${typeof e}`);return new Uint8Array(0)}if(t.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}"`);return new Uint8Array(Buffer.from(e,"base64"))}},Z=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/,I={id:"uuid",kind:"scalar",schema:{type:"string",format:"uuid"},matches(e){return e.type==="string"&&e.format==="uuid"},encode(e,r,t){return e.toLowerCase()},decode(e,r,t){if(typeof e!="string"){if(t.mode==="strict")throw new TypeError(`[uuid] expected a string on the wire at "${t.path}", got ${typeof e}`);return String(e).toLowerCase()}if(t.mode==="strict"&&!Z.test(e))throw new TypeError(`[uuid] wire value "${e}" at "${t.path}" is not a lowercase-hyphenated RFC 4122 UUID`);return e}},D="NaN",b="Infinity",S="-Infinity",H=new Set([D,b,S]),T={id:"number-special",kind:"scalar",schema:{type:"number"},matches(e){return e.type==="number"&&e.format===void 0},encode(e,r,t){return Number.isNaN(e)?D:e===1/0?b:e===-1/0?S:e},decode(e,r,t){if(typeof e=="number")return e;if(typeof e=="string"){if(e===D)return NaN;if(e===b)return 1/0;if(e===S)return-1/0;const n=Number(e);if(!Number.isNaN(n))return n}if(t.mode==="strict")throw new TypeError(`[number-special] unrecognized wire value at "${t.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...H].join(", ")}.`);return NaN}},Q=[A,h,N,$,I,T];function x(e,r={}){for(const t of Q)e.register(t,{override:r.override??!1})}const ee=12;function te(e,r){const t=/^#\/(definitions|\$defs)\/(.+)$/.exec(e);if(!t)return;const[,n,o]=t,i=n==="$defs"?r.$defs:r.definitions;return i==null?void 0:i[decodeURIComponent(o)]}function F(e){return Array.isArray(e)&&e.length>0?e[0]:void 0}function re(e){if(Array.isArray(e.type))return e.type.find(r=>r!=="null")??e.type[0];if(typeof e.type=="string")return e.type;if(e.properties)return"object"}function ne(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 U(e,r,t){const n=e.properties??{},o=e.required??[],i={};for(const c of o){const s=n[c];i[c]=s!==void 0?y(s,r,t+1):`<${c}>`}return i}function oe(e,r,t){const n=Array.isArray(e.items)?e.items[0]:e.items;return n?[y(n,r,t+1)]:[]}function y(e,r=e??{},t=0){if(!e||t>ee)return null;if(typeof e.$ref=="string"){const i=te(e.$ref,r);return i!==void 0?y(i,r,t+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={},c=[];for(const s of e.allOf){Object.assign(i,s.properties??{});for(const u of s.required??[])c.includes(u)||c.push(u)}return U({...e,properties:i,required:c},r,t)}const n=F(e.oneOf)??F(e.anyOf);if(n)return y(n,r,t+1);switch(re(e)){case"object":return U(e,r,t);case"array":return oe(e,r,t);case"string":return ne(e);case"integer":case"number":return 0;case"boolean":return!1;case"null":return null;default:return null}}function ie(e){if(!e)return;const r=y(e);return`Example: ${JSON.stringify(r)}`}const v=[A.id,h.id,N.id,$.id,I.id,T.id],se={"date-time":{encode:"$.toISOString()",decode:"new Date($)",mode:"native"},int64:{encode:"String($)",decode:"BigInt($)",mode:"native"},decimal:{encode:"$.toString()",decode:"new Decimal($)",imports:[],dep:{name:"decimal.js",version:"^10"},mode:"branded"},byte:{encode:"Buffer.from($).toString('base64')",decode:"new Uint8Array(Buffer.from($, 'base64'))",mode:"native"},uuid:{encode:"$.toLowerCase()",decode:"$",mode:"native"},"number-special":{encode:"numToWire($)",decode:"wireToNum($)",mode:"native"}},ce={"date-time":{encode:"$.isoformat()",decode:"datetime.fromisoformat($)",imports:["from datetime import datetime"],mode:"native"},int64:{encode:"str($)",decode:"int($)",mode:"native"},decimal:{encode:"str($)",decode:"Decimal($)",imports:["from decimal import Decimal"],mode:"native"},byte:{encode:"b64encode($).decode()",decode:"b64decode($)",imports:["from base64 import b64encode, b64decode"],mode:"native"},uuid:{encode:"str($)",decode:"UUID($)",imports:["from uuid import UUID"],mode:"native"},"number-special":{encode:"num_to_wire($)",decode:"wire_to_num($)",mode:"native"}},de={"date-time":{encode:"__SCAFFOLD_RUST_DATETIME_ENCODE__",decode:"__SCAFFOLD_RUST_DATETIME_DECODE__",imports:["use chrono::{DateTime, Utc};"],dep:{name:"chrono",version:"^0.4"},mode:"lib"},int64:{encode:"__SCAFFOLD_RUST_INT64_ENCODE__",decode:"__SCAFFOLD_RUST_INT64_DECODE__",imports:["use serde_with::DisplayFromStr;"],dep:{name:"serde_with",version:"^3"},mode:"lib"},decimal:{encode:"__SCAFFOLD_RUST_DECIMAL_ENCODE__",decode:"__SCAFFOLD_RUST_DECIMAL_DECODE__",imports:["use rust_decimal::Decimal;"],dep:{name:"rust_decimal",version:"^1"},mode:"lib"},byte:{encode:"__SCAFFOLD_RUST_BYTE_ENCODE__",decode:"__SCAFFOLD_RUST_BYTE_DECODE__",imports:["use serde_with::base64::Base64;"],dep:{name:"serde_with",version:"^3"},mode:"lib"},uuid:{encode:"__SCAFFOLD_RUST_UUID_ENCODE__",decode:"__SCAFFOLD_RUST_UUID_DECODE__",imports:["use uuid::Uuid;"],dep:{name:"uuid",version:"^1"},mode:"lib"},"number-special":{encode:"__SCAFFOLD_RUST_NUMSPECIAL_ENCODE__",decode:"__SCAFFOLD_RUST_NUMSPECIAL_DECODE__",mode:"native"}},ae={"date-time":{encode:"__SCAFFOLD_GO_DATETIME_ENCODE__",decode:"__SCAFFOLD_GO_DATETIME_DECODE__",imports:['"time"'],mode:"native"},int64:{encode:"__SCAFFOLD_GO_INT64_ENCODE__",decode:"__SCAFFOLD_GO_INT64_DECODE__",imports:['"strconv"'],mode:"native"},decimal:{encode:"__SCAFFOLD_GO_DECIMAL_ENCODE__",decode:"__SCAFFOLD_GO_DECIMAL_DECODE__",imports:['"github.com/shopspring/decimal"'],dep:{name:"github.com/shopspring/decimal",version:"v1"},mode:"lib"},byte:{encode:"__SCAFFOLD_GO_BYTE_ENCODE__",decode:"__SCAFFOLD_GO_BYTE_DECODE__",imports:['"encoding/base64"'],mode:"native"},uuid:{encode:"__SCAFFOLD_GO_UUID_ENCODE__",decode:"__SCAFFOLD_GO_UUID_DECODE__",imports:['"github.com/google/uuid"'],dep:{name:"github.com/google/uuid",version:"v1"},mode:"lib"},"number-special":{encode:"__SCAFFOLD_GO_NUMSPECIAL_ENCODE__",decode:"__SCAFFOLD_GO_NUMSPECIAL_DECODE__",mode:"native"}},fe={"date-time":{encode:"$.toString()",decode:"Instant.parse($)",imports:["import java.time.Instant;"],dep:{name:"jackson-datatype-jsr310",version:"2.x"},mode:"lib"},int64:{encode:"@JsonFormat(shape = JsonFormat.Shape.STRING)",decode:"@JsonFormat(shape = JsonFormat.Shape.STRING)",imports:["import com.fasterxml.jackson.annotation.JsonFormat;"],mode:"native"},decimal:{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:{encode:"$",decode:"$",mode:"native"},uuid:{encode:"$.toString()",decode:"UUID.fromString($)",imports:["import java.util.UUID;"],mode:"native"},"number-special":{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"}},E=Object.freeze({typescript:se,python:ce,rust:de,go:ae,java:fe});function ue(e){return E[e]}function pe(e,r){const t=E[r],n=[];for(const o of e){const i=t[o];i!=null&&i.dep&&n.push({id:o,dep:i.dep})}return n}function _e(){const e=E.typescript,r={};for(const t of v){const n=e[t].dep;n&&(r[t]=n)}return Object.freeze(r)}function me(e,r){const t=r??E[e],n=[];for(const o of v)t[o]||n.push(o);if(n.length>0)throw new Error(`[hints] assertNoEmptyCells: language "${e}" is missing cells for: ${n.join(", ")}`)}exports.CANONICAL_LOGICAL_TYPE_IDS=v;exports.CodecRegistryError=C;exports.ENVELOPE_KEY=g;exports.LOGICAL_TYPE_VERSION=w;exports.TEMPLATE_CELLS=E;exports.X_APIGEN_CODEC=R;exports.X_APIGEN_CTOR=M;exports.X_APIGEN_LOGICAL=j;exports.X_APIGEN_TOJSON=k;exports.assertNoEmptyCells=me;exports.buildTranscoder=W;exports.byteCodec=$;exports.cellsFor=ue;exports.codecIdOf=J;exports.createRegistry=G;exports.dateTimeCodec=A;exports.decimalCodec=N;exports.depsForLogicalTypes=pe;exports.int64Codec=h;exports.logicalKindOf=B;exports.makeDecimal=V;exports.numberSpecialCodec=T;exports.registerWellKnown=x;exports.renderExampleNote=ie;exports.synthesizeExample=y;exports.tryRegister=X;exports.tsDepMap=_e;exports.uuidCodec=I;exports.validateSchemaRefs=K;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const A="$apigen";class C extends Error{constructor(t){super(t),this.code="E_DUP_CODEC",this.name="CodecRegistryError"}}function V(e){e==null||e.wellKnown;const t=new Map;return{register(n,o){if(t.has(n.id)&&!(o!=null&&o.override))throw new C(`E_DUP_CODEC: a codec is already registered for id "${n.id}"`);t.set(n.id,n)},resolve(n){for(const o of t.values())if(o.matches(n))return o},get(n){return t.get(n)},ids(){return[...t.keys()]},freeze(){const n=new Map(t),o={register(){throw new C("E_DUP_CODEC: registry is frozen and cannot accept new codecs")},resolve(i){for(const a of n.values())if(a.matches(i))return a},get(i){return n.get(i)},ids(){return[...n.keys()]},freeze(){return o}};return o}}}const M="x-apigen-logical",w="x-apigen-codec",Y="x-apigen-ctor",K="x-apigen-tojson",W="0.1.0",X=["scalar","nominal","union","map","set"];function q(e){const t=e[M];return typeof t=="string"&&X.includes(t)?t:void 0}function Z(e){const t=e[w];return typeof t=="string"?t:void 0}function P(e,t){return{registry:e,resolve:r=>{throw new Error(`[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:new WeakSet,path:"",mode:"strict",...t}}function l(e,t,r){const n=r.registry.resolve(t);if(n)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=B(e,i,t,r);return l(e,c,r)}const a=t.type;if(a==="array"){if(!Array.isArray(e))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((f,s)=>l(f,c,{...r,path:`${u}/${s}`}))}if(a==="object"){if(e===null||typeof e!="object"||Array.isArray(e))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 f}return a==null?b(e,t,r):_(e)}function y(e,t,r){const n=r.registry.resolve(t);if(n)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=B(e,i,t,r);return y(e,c,r)}const a=t.type;if(a==="array"){if(!Array.isArray(e))return e;const c=t.items;if(!c)return e;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((f,s)=>y(f,c,{...r,path:`${u}/${s}`}))}if(a==="object"){if(e===null||typeof e!="object"||Array.isArray(e))return e;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]=y(p,d,{...r,path:`${u}/${s}`}))}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 B(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=D(d,n).properties)==null?void 0:u[f];if(!m)continue;const E=m.enum;if(m.const===s||Array.isArray(E)&&E.includes(s))return d}}}const i=H(e,t,n);if(i)return i;let a,c=-1;for(const f of t){const s=D(f,n),d=z(e,s,n);d!==null&&d>c&&(c=d,a=f)}return a!==void 0?a:t[0]??{}}function D(e,t){const r=e.$ref;return typeof r=="string"?t.resolve(r):e}function k(e){if("const"in e)return e.const;const t=e.enum;if(Array.isArray(t)&&t.length===1)return t[0]}function H(e,t,r){if(e===null||typeof e!="object"||Array.isArray(e))return;const n=e,o=t.map(a=>D(a,r)),i=new Set;for(const a of o){const c=a.properties;if(c)for(const[u,f]of Object.entries(c))k(f)!==void 0&&i.add(u)}for(const a of i){const c=o.map(p=>{const m=p.properties,E=m==null?void 0:m[a];return E?k(E):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 Q(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 z(e,t,r){const n=t.oneOf;if(Array.isArray(n)){let s=null;for(const d of n){const p=z(e,D(d,r),r);p!==null&&(s===null||p>s)&&(s=p)}return s}const o=t.type,i=Q(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}}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{[A]: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 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)&&A in e){const r=e,n=r[A],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 _(e){if(e===null||typeof e=="string"||typeof e=="number"||typeof e=="boolean")return e;if(Array.isArray(e))return e.map(_);if(typeof e=="object"){const t={};for(const[r,n]of Object.entries(e))n!==void 0&&(t[r]=_(n));return t}return null}function x(e,t){const r=new Set,n=[e];for(;n.length>0;){const o=n.pop();if(!o||r.has(o))continue;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 "${i}" cannot be resolved. Available $defs: ${p}`)}n.push(d)}continue}const a=o.oneOf;if(Array.isArray(a))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 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 ee(e){return{encode(t,r,n){const o=P(e,n);return l(t,r,o)},decode(t,r,n){const o=P(e,n);return y(t,r,o)}}}function te(e,t,r){try{const n=r();e.register(n)}catch(n){if(re(n))return;throw n}}function re(e){return e===null||typeof e!="object"?!1:e.code==="MODULE_NOT_FOUND"}const I={id:"date-time",kind:"scalar",schema:{type:"string",format:"date-time"},matches(e){return e.type==="string"&&e.format==="date-time"},ownsValue(e){return e instanceof Date},encode(e,t,r){return e.toISOString()},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[date-time] expected a string on the wire at "${r.path}", got ${typeof e}`);return new Date(String(e))}if(r.mode==="strict"&&Number.isNaN(new Date(e).getTime()))throw new TypeError(`[date-time] invalid date-time string at "${r.path}": ${JSON.stringify(e)}`);return new Date(e)}},T={id:"int64",kind:"scalar",schema:{type:"string",format:"int64"},matches(e){return e.type==="string"&&e.format==="int64"},ownsValue(e){return typeof e=="bigint"},encode(e,t,r){return String(e)},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[int64] expected a string on the wire at "${r.path}", got ${typeof e}`);try{return BigInt(Math.trunc(Number(e)))}catch{return BigInt(0)}}if(r.mode==="strict")return BigInt(e);if(/^-?\d+$/.test(e))try{return BigInt(e)}catch{return BigInt(0)}return BigInt(0)}};function ne(e){return e}const v={id:"decimal",kind:"scalar",schema:{type:"string",format:"decimal"},matches(e){return e.type==="string"&&e.format==="decimal"},encode(e,t,r){return e},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[decimal] expected a string on the wire at "${r.path}", got ${typeof e}`);return String(e)}if(r.mode==="strict"&&!/^-?\d+(\.\d+)?$/.test(e))throw new TypeError(`[decimal] wire value "${e}" at "${r.path}" is not a valid decimal string`);return e}},L={id:"byte",kind:"scalar",schema:{type:"string",format:"byte"},matches(e){return e.type==="string"&&e.format==="byte"},ownsValue(e){return e instanceof Uint8Array},encode(e,t,r){return Buffer.from(e).toString("base64")},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[byte] expected a base64 string on the wire at "${r.path}", got ${typeof e}`);return new Uint8Array(0)}if(r.mode==="strict"&&!/^[A-Za-z0-9+/]*={0,2}$/.test(e))throw new TypeError(`[byte] wire value at "${r.path}" is not standard base64 (format:byte): "${e}"`);return new Uint8Array(Buffer.from(e,"base64"))}},oe=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/,F={id:"uuid",kind:"scalar",schema:{type:"string",format:"uuid"},matches(e){return e.type==="string"&&e.format==="uuid"},encode(e,t,r){return e.toLowerCase()},decode(e,t,r){if(typeof e!="string"){if(r.mode==="strict")throw new TypeError(`[uuid] expected a string on the wire at "${r.path}", got ${typeof e}`);return String(e).toLowerCase()}if(r.mode==="strict"&&!oe.test(e))throw new TypeError(`[uuid] wire value "${e}" at "${r.path}" is not a lowercase-hyphenated RFC 4122 UUID`);return e}},h="NaN",N="Infinity",$="-Infinity",ie=new Set([h,N,$]),U={id:"number-special",kind:"scalar",schema:{type:"number"},matches(e){return e.type==="number"&&e.format===void 0},ownsValue(e){return typeof e=="number"&&!Number.isFinite(e)},encode(e,t,r){return Number.isNaN(e)?h:e===1/0?N:e===-1/0?$:e},decode(e,t,r){if(typeof e=="number")return e;if(typeof e=="string"){if(e===h)return NaN;if(e===N)return 1/0;if(e===$)return-1/0;const n=Number(e);if(!Number.isNaN(n))return n}if(r.mode==="strict")throw new TypeError(`[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...ie].join(", ")}.`);return NaN}},se=[I,T,v,L,F,U];function ce(e,t={}){for(const r of se)e.register(r,{override:t.override??!1})}const de=12;function ae(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 R(e){return Array.isArray(e)&&e.length>0?e[0]:void 0}function fe(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 ue(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 G(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?g(c,t,r+1):`<${a}>`}return i}function pe(e,t,r){const n=Array.isArray(e.items)?e.items[0]:e.items;return n?[g(n,t,r+1)]:[]}function g(e,t=e??{},r=0){if(!e||r>de)return null;if(typeof e.$ref=="string"){const i=ae(e.$ref,t);return i!==void 0?g(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 G({...e,properties:i,required:a},t,r)}const n=R(e.oneOf)??R(e.anyOf);if(n)return g(n,t,r+1);switch(fe(e)){case"object":return G(e,t,r);case"array":return pe(e,t,r);case"string":return ue(e);case"integer":case"number":return 0;case"boolean":return!1;case"null":return null;default:return null}}function me(e){if(!e)return;const t=g(e);return`Example: ${JSON.stringify(t)}`}const j=[I.id,T.id,v.id,L.id,F.id,U.id],_e={"date-time":{encode:"$.toISOString()",decode:"new Date($)",mode:"native"},int64:{encode:"String($)",decode:"BigInt($)",mode:"native"},decimal:{encode:"$.toString()",decode:"new Decimal($)",imports:[],dep:{name:"decimal.js",version:"^10"},mode:"branded"},byte:{encode:"Buffer.from($).toString('base64')",decode:"new Uint8Array(Buffer.from($, 'base64'))",mode:"native"},uuid:{encode:"$.toLowerCase()",decode:"$",mode:"native"},"number-special":{encode:"numToWire($)",decode:"wireToNum($)",mode:"native"}},le={"date-time":{encode:"$.isoformat()",decode:"datetime.fromisoformat($)",imports:["from datetime import datetime"],mode:"native"},int64:{encode:"str($)",decode:"int($)",mode:"native"},decimal:{encode:"str($)",decode:"Decimal($)",imports:["from decimal import Decimal"],mode:"native"},byte:{encode:"b64encode($).decode()",decode:"b64decode($)",imports:["from base64 import b64encode, b64decode"],mode:"native"},uuid:{encode:"str($)",decode:"UUID($)",imports:["from uuid import UUID"],mode:"native"},"number-special":{encode:"num_to_wire($)",decode:"wire_to_num($)",mode:"native"}},ye={"date-time":{encode:"__SCAFFOLD_RUST_DATETIME_ENCODE__",decode:"__SCAFFOLD_RUST_DATETIME_DECODE__",imports:["use chrono::{DateTime, Utc};"],dep:{name:"chrono",version:"^0.4"},mode:"lib"},int64:{encode:"__SCAFFOLD_RUST_INT64_ENCODE__",decode:"__SCAFFOLD_RUST_INT64_DECODE__",imports:["use serde_with::DisplayFromStr;"],dep:{name:"serde_with",version:"^3"},mode:"lib"},decimal:{encode:"__SCAFFOLD_RUST_DECIMAL_ENCODE__",decode:"__SCAFFOLD_RUST_DECIMAL_DECODE__",imports:["use rust_decimal::Decimal;"],dep:{name:"rust_decimal",version:"^1"},mode:"lib"},byte:{encode:"__SCAFFOLD_RUST_BYTE_ENCODE__",decode:"__SCAFFOLD_RUST_BYTE_DECODE__",imports:["use serde_with::base64::Base64;"],dep:{name:"serde_with",version:"^3"},mode:"lib"},uuid:{encode:"__SCAFFOLD_RUST_UUID_ENCODE__",decode:"__SCAFFOLD_RUST_UUID_DECODE__",imports:["use uuid::Uuid;"],dep:{name:"uuid",version:"^1"},mode:"lib"},"number-special":{encode:"__SCAFFOLD_RUST_NUMSPECIAL_ENCODE__",decode:"__SCAFFOLD_RUST_NUMSPECIAL_DECODE__",mode:"native"}},ge={"date-time":{encode:"__SCAFFOLD_GO_DATETIME_ENCODE__",decode:"__SCAFFOLD_GO_DATETIME_DECODE__",imports:['"time"'],mode:"native"},int64:{encode:"__SCAFFOLD_GO_INT64_ENCODE__",decode:"__SCAFFOLD_GO_INT64_DECODE__",imports:['"strconv"'],mode:"native"},decimal:{encode:"__SCAFFOLD_GO_DECIMAL_ENCODE__",decode:"__SCAFFOLD_GO_DECIMAL_DECODE__",imports:['"github.com/shopspring/decimal"'],dep:{name:"github.com/shopspring/decimal",version:"v1"},mode:"lib"},byte:{encode:"__SCAFFOLD_GO_BYTE_ENCODE__",decode:"__SCAFFOLD_GO_BYTE_DECODE__",imports:['"encoding/base64"'],mode:"native"},uuid:{encode:"__SCAFFOLD_GO_UUID_ENCODE__",decode:"__SCAFFOLD_GO_UUID_DECODE__",imports:['"github.com/google/uuid"'],dep:{name:"github.com/google/uuid",version:"v1"},mode:"lib"},"number-special":{encode:"__SCAFFOLD_GO_NUMSPECIAL_ENCODE__",decode:"__SCAFFOLD_GO_NUMSPECIAL_DECODE__",mode:"native"}},Ee={"date-time":{encode:"$.toString()",decode:"Instant.parse($)",imports:["import java.time.Instant;"],dep:{name:"jackson-datatype-jsr310",version:"2.x"},mode:"lib"},int64:{encode:"@JsonFormat(shape = JsonFormat.Shape.STRING)",decode:"@JsonFormat(shape = JsonFormat.Shape.STRING)",imports:["import com.fasterxml.jackson.annotation.JsonFormat;"],mode:"native"},decimal:{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:{encode:"$",decode:"$",mode:"native"},uuid:{encode:"$.toString()",decode:"UUID.fromString($)",imports:["import java.util.UUID;"],mode:"native"},"number-special":{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"}},O=Object.freeze({typescript:_e,python:le,rust:ye,go:ge,java:Ee});function be(e){return O[e]}function Oe(e,t){const r=O[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 Ae(){const e=O.typescript,t={};for(const r of j){const n=e[r].dep;n&&(t[r]=n)}return Object.freeze(t)}function De(e,t){const r=t??O[e],n=[];for(const o of j)r[o]||n.push(o);if(n.length>0)throw new Error(`[hints] assertNoEmptyCells: language "${e}" is missing cells for: ${n.join(", ")}`)}exports.CANONICAL_LOGICAL_TYPE_IDS=j;exports.CodecRegistryError=C;exports.ENVELOPE_KEY=A;exports.LOGICAL_TYPE_VERSION=W;exports.TEMPLATE_CELLS=O;exports.X_APIGEN_CODEC=w;exports.X_APIGEN_CTOR=Y;exports.X_APIGEN_LOGICAL=M;exports.X_APIGEN_TOJSON=K;exports.assertNoEmptyCells=De;exports.buildTranscoder=ee;exports.byteCodec=L;exports.cellsFor=be;exports.codecIdOf=Z;exports.createRegistry=V;exports.dateTimeCodec=I;exports.decimalCodec=v;exports.depsForLogicalTypes=Oe;exports.int64Codec=T;exports.logicalKindOf=q;exports.makeDecimal=ne;exports.numberSpecialCodec=U;exports.registerWellKnown=ce;exports.renderExampleNote=me;exports.synthesizeExample=g;exports.tryRegister=te;exports.tsDepMap=Ae;exports.uuidCodec=F;exports.validateSchemaRefs=x;

package/index.mjs

@@ -1,42 +1,42 @@
 const D = "$apigen";
-class C extends Error {
-  constructor(r) {
-    super(r), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
+class N extends Error {
+  constructor(t) {
+    super(t), this.code = "E_DUP_CODEC", this.name = "CodecRegistryError";
   }
 }
-function x(e) {
+function de(e) {
   e == null || e.wellKnown;
-  const r = /* @__PURE__ */ new Map();
+  const t = /* @__PURE__ */ new Map();
   return {
     register(n, o) {
-      if (r.has(n.id) && !(o != null && o.override))
-        throw new C(
+      if (t.has(n.id) && !(o != null && o.override))
+        throw new N(
           `E_DUP_CODEC: a codec is already registered for id "${n.id}"`
         );
-      r.set(n.id, n);
+      t.set(n.id, n);
     },
     resolve(n) {
-      for (const o of r.values())
+      for (const o of t.values())
         if (o.matches(n))
           return o;
     },
     get(n) {
-      return r.get(n);
+      return t.get(n);
     },
     ids() {
-      return [...r.keys()];
+      return [...t.keys()];
     },
     freeze() {
-      const n = new Map(r), o = {
+      const n = new Map(t), o = {
         register() {
-          throw new C(
+          throw new N(
             "E_DUP_CODEC: registry is frozen and cannot accept new codecs"
           );
         },
         resolve(i) {
-          for (const c of n.values())
-            if (c.matches(i))
-              return c;
+          for (const a of n.values())
+            if (a.matches(i))
+              return a;
         },
         get(i) {
           return n.get(i);
@@ -52,190 +52,316 @@ function x(e) {
     }
   };
 }
-const R = "x-apigen-logical", P = "x-apigen-codec", ee = "x-apigen-ctor", te = "x-apigen-tojson", re = "0.1.0", M = [
+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 ne(e) {
-  const r = e[R];
-  return typeof r == "string" && M.includes(r) ? r : void 0;
+function pe(e) {
+  const t = e[z];
+  return typeof t == "string" && V.includes(t) ? t : void 0;
 }
-function oe(e) {
-  const r = e[P];
-  return typeof r == "string" ? r : void 0;
+function me(e) {
+  const t = e[J];
+  return typeof t == "string" ? t : void 0;
 }
-function h(e, r) {
+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",
-    ...r
+    ...t
   };
 }
-function _(e, r, t) {
-  const n = t.registry.resolve(r);
+function l(e, t, r) {
+  const n = r.registry.resolve(t);
   if (n)
-    return n.encode(e, r, t);
-  const o = r.$ref;
+    return n.encode(e, t, r);
+  const o = t.$ref;
   if (typeof o == "string") {
-    const s = t.resolve(o);
-    return _(e, s, t);
+    const c = r.resolve(o);
+    return l(e, c, r);
   }
-  const i = r.oneOf;
+  const i = t.oneOf;
   if (Array.isArray(i)) {
-    const s = N(e, i, r);
-    return _(e, s, t);
+    const c = L(e, i, t, r);
+    return l(e, c, r);
   }
-  const c = r.type;
-  if (c === "array") {
+  const a = t.type;
+  if (a === "array") {
     if (!Array.isArray(e))
-      return E(e, r, t);
-    const s = r.items;
-    if (!s)
-      return e.map((a) => m(a));
-    const u = t.path;
-    return Array.isArray(s) ? e.map((a, f) => {
-      const d = s[f];
-      return d === void 0 ? m(a) : _(a, d, { ...t, path: `${u}/${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(
-      (a, f) => _(a, s, { ...t, path: `${u}/${f}` })
+      (f, s) => l(f, c, { ...r, path: `${u}/${s}` })
     );
   }
-  if (c === "object") {
+  if (a === "object") {
     if (e === null || typeof e != "object" || Array.isArray(e))
-      return E(e, r, t);
-    const s = r.properties;
-    if (!s)
-      return m(e);
-    const u = t.path, a = {};
-    for (const [f, d] of Object.entries(s)) {
-      const p = e[f];
-      p !== void 0 && (a[f] = _(p, d, {
-        ...t,
-        path: `${u}/${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 a;
+    return f;
   }
-  return c == null ? E(e, r, t) : m(e);
+  return a == null ? b(e, t, r) : _(e);
 }
-function l(e, r, t) {
-  const n = t.registry.resolve(r);
+function y(e, t, r) {
+  const n = r.registry.resolve(t);
   if (n)
-    return n.decode(e, r, t);
-  const o = r.$ref;
+    return n.decode(e, t, r);
+  const o = t.$ref;
   if (typeof o == "string") {
-    const s = t.resolve(o);
-    return l(e, s, t);
+    const c = r.resolve(o);
+    return y(e, c, r);
   }
-  const i = r.oneOf;
+  const i = t.oneOf;
   if (Array.isArray(i)) {
-    const s = N(e, i, r);
-    return l(e, s, t);
+    const c = L(e, i, t, r);
+    return y(e, c, r);
   }
-  const c = r.type;
-  if (c === "array") {
+  const a = t.type;
+  if (a === "array") {
     if (!Array.isArray(e))
       return e;
-    const s = r.items;
-    if (!s)
+    const c = t.items;
+    if (!c)
       return e;
-    const u = t.path;
-    return Array.isArray(s) ? e.map((a, f) => {
-      const d = s[f];
-      return d === void 0 ? a : l(a, d, { ...t, path: `${u}/${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(
-      (a, f) => l(a, s, { ...t, path: `${u}/${f}` })
+      (f, s) => y(f, c, { ...r, path: `${u}/${s}` })
     );
   }
-  if (c === "object") {
+  if (a === "object") {
     if (e === null || typeof e != "object" || Array.isArray(e))
       return e;
-    const s = r.properties;
-    if (!s)
+    const c = t.properties;
+    if (!c)
       return e;
-    const u = t.path, a = {};
-    for (const [f, d] of Object.entries(s)) {
-      const p = e[f];
-      p !== void 0 && (a[f] = l(p, d, {
-        ...t,
-        path: `${u}/${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 a;
+    for (const [s, d] of Object.entries(e))
+      !(s in c) && d !== void 0 && (f[s] = d);
+    return f;
   }
-  return c == null ? k(e, t) : e;
+  return a == null ? S(e, r) : e;
 }
-function N(e, r, t, n) {
-  const o = t.discriminator;
+function L(e, t, r, n) {
+  var u;
+  const o = r.discriminator;
   if (o != null && o.propertyName) {
-    const i = e !== null && typeof e == "object" ? e[o.propertyName] : void 0;
-    if (typeof i == "string" && o.mapping) {
-      const c = o.mapping[i];
-      if (c) {
-        const s = r.find((u) => u.$ref === c);
-        if (s)
-          return s;
+    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 r[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 E(e, r, t) {
-  for (const n of t.registry.ids()) {
-    const o = t.registry.get(n);
-    if (o)
-      try {
-        const i = o.encode(e, o.schema, t);
-        return { [D]: n, v: i };
-      } 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 m(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 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 k(e, r) {
+function S(e, t) {
   if (e !== null && typeof e == "object" && !Array.isArray(e) && D in e) {
-    const t = e, n = t[D], o = r.registry.get(n);
+    const r = e, n = r[D], o = t.registry.get(n);
     if (o)
-      return o.decode(t.v, o.schema, r);
+      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 m(e) {
+function _(e) {
   if (e === null || typeof e == "string" || typeof e == "number" || typeof e == "boolean")
     return e;
   if (Array.isArray(e))
-    return e.map(m);
+    return e.map(_);
   if (typeof e == "object") {
-    const r = {};
-    for (const [t, n] of Object.entries(e))
-      n !== void 0 && (r[t] = m(n));
-    return r;
+    const t = {};
+    for (const [r, n] of Object.entries(e))
+      n !== void 0 && (t[r] = _(n));
+    return t;
   }
   return null;
 }
-function ie(e, r) {
-  const t = /* @__PURE__ */ new Set(), n = [e];
+function _e(e, t) {
+  const r = /* @__PURE__ */ new Set(), n = [e];
   for (; n.length > 0; ) {
     const o = n.pop();
-    if (!o || t.has(o))
+    if (!o || r.has(o))
       continue;
-    t.add(o);
+    r.add(o);
     const i = o.$ref;
     if (typeof i == "string") {
-      if (r) {
-        const d = r[i];
+      if (t) {
+        const d = t[i];
         if (!d) {
-          const p = Object.keys(r).join(", ") || "(none)";
+          const p = Object.keys(t).join(", ") || "(none)";
           throw new Error(
             `[apigen-logical] $ref "${i}" cannot be resolved. Available $defs: ${p}`
           );
@@ -244,13 +370,13 @@ function ie(e, r) {
       }
       continue;
     }
-    const c = o.oneOf;
-    if (Array.isArray(c))
-      for (const d of c)
+    const a = o.oneOf;
+    if (Array.isArray(a))
+      for (const d of a)
         typeof d == "object" && d !== null && n.push(d);
-    const s = o.properties;
-    if (s)
-      for (const d of Object.values(s))
+    const c = o.properties;
+    if (c)
+      for (const d of Object.values(c))
         n.push(d);
     const u = o.items;
     if (Array.isArray(u))
@@ -258,76 +384,82 @@ function ie(e, r) {
         typeof d == "object" && d !== null && n.push(d);
     else
       typeof u == "object" && u !== null && n.push(u);
-    const a = o.additionalProperties;
-    typeof a == "object" && a !== null && n.push(a);
-    const f = o.propertyNames;
+    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 se(e) {
+function le(e) {
   return {
-    encode(r, t, n) {
-      const o = h(e, n);
-      return _(r, t, o);
+    encode(t, r, n) {
+      const o = v(e, n);
+      return l(t, r, o);
     },
-    decode(r, t, n) {
-      const o = h(e, n);
-      return l(r, t, o);
+    decode(t, r, n) {
+      const o = v(e, n);
+      return y(t, r, o);
     }
   };
 }
-function ce(e, r, t) {
+function ye(e, t, r) {
   try {
-    const n = t();
+    const n = r();
     e.register(n);
   } catch (n) {
-    if (G(n))
+    if (q(n))
       return;
     throw n;
   }
 }
-function G(e) {
+function q(e) {
   return e === null || typeof e != "object" ? !1 : e.code === "MODULE_NOT_FOUND";
 }
-const v = {
+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, r, t) {
+  ownsValue(e) {
+    return e instanceof Date;
+  },
+  encode(e, t, r) {
     return e.toISOString();
   },
-  decode(e, r, 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);
   }
-}, I = {
+}, R = {
   id: "int64",
   kind: "scalar",
   schema: { type: "string", format: "int64" },
   matches(e) {
     return e.type === "string" && e.format === "int64";
   },
-  encode(e, r, t) {
+  ownsValue(e) {
+    return typeof e == "bigint";
+  },
+  encode(e, t, r) {
     return String(e);
   },
-  decode(e, r, 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 v = {
         return BigInt(0);
       }
     }
-    if (t.mode === "strict")
+    if (r.mode === "strict")
       return BigInt(e);
     if (/^-?\d+$/.test(e))
       try {
@@ -346,147 +478,153 @@ const v = {
     return BigInt(0);
   }
 };
-function de(e) {
+function ge(e) {
   return e;
 }
-const T = {
+const P = {
   id: "decimal",
   kind: "scalar",
   schema: { type: "string", format: "decimal" },
   matches(e) {
     return e.type === "string" && e.format === "decimal";
   },
-  encode(e, r, t) {
+  encode(e, t, r) {
     return e;
   },
-  decode(e, r, 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;
   }
-}, F = {
+}, B = {
   id: "byte",
   kind: "scalar",
   schema: { type: "string", format: "byte" },
   matches(e) {
     return e.type === "string" && e.format === "byte";
   },
-  encode(e, r, t) {
+  ownsValue(e) {
+    return e instanceof Uint8Array;
+  },
+  encode(e, t, r) {
     return Buffer.from(e).toString("base64");
   },
-  decode(e, r, 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"));
   }
-}, w = /^[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, r, t) {
+  encode(e, t, r) {
     return e.toLowerCase();
   },
-  decode(e, r, 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" && !w.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", b = "Infinity", S = "-Infinity", z = /* @__PURE__ */ new Set([
-  O,
-  b,
-  S
-]), U = {
+}, h = "NaN", C = "Infinity", $ = "-Infinity", X = /* @__PURE__ */ new Set([
+  h,
+  C,
+  $
+]), M = {
   id: "number-special",
   kind: "scalar",
   schema: { type: "number" },
   matches(e) {
     return e.type === "number" && e.format === void 0;
   },
-  encode(e, r, t) {
-    return Number.isNaN(e) ? O : e === 1 / 0 ? b : e === -1 / 0 ? S : 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, r, 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 === b)
+      if (e === C)
         return 1 / 0;
-      if (e === S)
+      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 ${[...z].join(", ")}.`
+        `[number-special] unrecognized wire value at "${r.path}": ${JSON.stringify(e)}. Expected a number or one of ${[...X].join(", ")}.`
       );
     return NaN;
   }
-}, B = [
-  v,
-  I,
-  T,
-  F,
-  L,
-  U
+}, Z = [
+  k,
+  R,
+  P,
+  B,
+  w,
+  M
 ];
-function ae(e, r = {}) {
-  for (const t of B)
-    e.register(t, { override: r.override ?? !1 });
-}
-const J = 12;
-function Y(e, r) {
-  const t = /^#\/(definitions|\$defs)\/(.+)$/.exec(e);
-  if (!t)
+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] = t, i = n === "$defs" ? r.$defs : r.definitions;
+  const [, n, o] = r, i = n === "$defs" ? t.$defs : t.definitions;
   return i == null ? void 0 : i[decodeURIComponent(o)];
 }
-function A(e) {
+function T(e) {
   return Array.isArray(e) && e.length > 0 ? e[0] : void 0;
 }
-function W(e) {
+function x(e) {
   if (Array.isArray(e.type))
-    return e.type.find((r) => r !== "null") ?? e.type[0];
+    return e.type.find((t) => t !== "null") ?? e.type[0];
   if (typeof e.type == "string")
     return e.type;
   if (e.properties)
     return "object";
 }
-function K(e) {
+function ee(e) {
   switch (e.format) {
     case "date-time":
       return "1970-01-01T00:00:00.000Z";
@@ -518,52 +656,52 @@ function K(e) {
       return "<string>";
   }
 }
-function $(e, r, t) {
+function F(e, t, r) {
   const n = e.properties ?? {}, o = e.required ?? [], i = {};
-  for (const c of o) {
-    const s = n[c];
-    i[c] = s !== void 0 ? y(s, r, t + 1) : `<${c}>`;
+  for (const a of o) {
+    const c = n[a];
+    i[a] = c !== void 0 ? E(c, t, r + 1) : `<${a}>`;
   }
   return i;
 }
-function q(e, r, t) {
+function te(e, t, r) {
   const n = Array.isArray(e.items) ? e.items[0] : e.items;
-  return n ? [y(n, r, t + 1)] : [];
+  return n ? [E(n, t, r + 1)] : [];
 }
-function y(e, r = e ?? {}, t = 0) {
-  if (!e || t > J)
+function E(e, t = e ?? {}, r = 0) {
+  if (!e || r > H)
     return null;
   if (typeof e.$ref == "string") {
-    const i = Y(e.$ref, r);
-    return i !== void 0 ? y(i, r, t + 1) : null;
+    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 = {}, c = [];
-    for (const s of e.allOf) {
-      Object.assign(i, s.properties ?? {});
-      for (const u of s.required ?? [])
-        c.includes(u) || c.push(u);
+    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 $(
-      { ...e, properties: i, required: c },
-      r,
-      t
+    return F(
+      { ...e, properties: i, required: a },
+      t,
+      r
     );
   }
-  const n = A(e.oneOf) ?? A(e.anyOf);
+  const n = T(e.oneOf) ?? T(e.anyOf);
   if (n)
-    return y(n, r, t + 1);
-  switch (W(e)) {
+    return E(n, t, r + 1);
+  switch (x(e)) {
     case "object":
-      return $(e, r, t);
+      return F(e, t, r);
     case "array":
-      return q(e, r, t);
+      return te(e, t, r);
     case "string":
-      return K(e);
+      return ee(e);
     case "integer":
     case "number":
       return 0;
@@ -575,26 +713,26 @@ function y(e, r = e ?? {}, t = 0) {
       return null;
   }
 }
-function fe(e) {
+function Ee(e) {
   if (!e)
     return;
-  const r = y(e);
-  return `Example: ${JSON.stringify(r)}`;
+  const t = E(e);
+  return `Example: ${JSON.stringify(t)}`;
 }
-const j = [
-  v.id,
+const G = [
+  k.id,
   // 'date-time'
-  I.id,
+  R.id,
   // 'int64'
-  T.id,
+  P.id,
   // 'decimal'
-  F.id,
+  B.id,
   // 'byte'
-  L.id,
+  w.id,
   // 'uuid'
-  U.id
+  M.id
   // 'number-special'
-], X = {
+], re = {
   "date-time": {
     encode: "$.toISOString()",
     decode: "new Date($)",
@@ -633,7 +771,7 @@ const j = [
     decode: "wireToNum($)",
     mode: "native"
   }
-}, V = {
+}, ne = {
   "date-time": {
     encode: "$.isoformat()",
     decode: "datetime.fromisoformat($)",
@@ -670,7 +808,7 @@ const j = [
     decode: "wire_to_num($)",
     mode: "native"
   }
-}, Z = {
+}, oe = {
   "date-time": {
     // chrono::DateTime<Utc> serialises as RFC3339 via serde.
     encode: "__SCAFFOLD_RUST_DATETIME_ENCODE__",
@@ -714,7 +852,7 @@ const j = [
     decode: "__SCAFFOLD_RUST_NUMSPECIAL_DECODE__",
     mode: "native"
   }
-}, H = {
+}, ie = {
   "date-time": {
     // time.Time serialises as RFC3339Nano via MarshalJSON.
     encode: "__SCAFFOLD_GO_DATETIME_ENCODE__",
@@ -755,7 +893,7 @@ const j = [
     decode: "__SCAFFOLD_GO_NUMSPECIAL_DECODE__",
     mode: "native"
   }
-}, Q = {
+}, se = {
   "date-time": {
     // Instant.toString() (RFC-3339/ISO-8601, UTC) / Instant.parse($) — the
     // jackson-datatype-jsr310 module is registered on the shared ObjectMapper
@@ -823,36 +961,36 @@ const j = [
     ],
     mode: "native"
   }
-}, g = Object.freeze({
-  typescript: X,
-  python: V,
-  rust: Z,
-  go: H,
-  java: Q
+}, A = Object.freeze({
+  typescript: re,
+  python: ne,
+  rust: oe,
+  go: ie,
+  java: se
 });
-function ue(e) {
-  return g[e];
+function Oe(e) {
+  return A[e];
 }
-function pe(e, r) {
-  const t = g[r], n = [];
+function Ae(e, t) {
+  const r = A[t], n = [];
   for (const o of e) {
-    const i = t[o];
+    const i = r[o];
     i != null && i.dep && n.push({ id: o, dep: i.dep });
   }
   return n;
 }
-function me() {
-  const e = g.typescript, r = {};
-  for (const t of j) {
-    const n = e[t].dep;
-    n && (r[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(r);
+  return Object.freeze(t);
 }
-function _e(e, r) {
-  const t = r ?? g[e], n = [];
-  for (const o of j)
-    t[o] || n.push(o);
+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(
@@ -861,33 +999,33 @@ function _e(e, r) {
     );
 }
 export {
-  j as CANONICAL_LOGICAL_TYPE_IDS,
-  C as CodecRegistryError,
+  G as CANONICAL_LOGICAL_TYPE_IDS,
+  N as CodecRegistryError,
   D as ENVELOPE_KEY,
-  re as LOGICAL_TYPE_VERSION,
-  g as TEMPLATE_CELLS,
-  P as X_APIGEN_CODEC,
-  ee as X_APIGEN_CTOR,
-  R as X_APIGEN_LOGICAL,
-  te as X_APIGEN_TOJSON,
-  _e as assertNoEmptyCells,
-  se as buildTranscoder,
-  F as byteCodec,
-  ue as cellsFor,
-  oe as codecIdOf,
-  x as createRegistry,
-  v as dateTimeCodec,
-  T as decimalCodec,
-  pe as depsForLogicalTypes,
-  I as int64Codec,
-  ne as logicalKindOf,
-  de as makeDecimal,
-  U as numberSpecialCodec,
-  ae as registerWellKnown,
-  fe as renderExampleNote,
-  y as synthesizeExample,
-  ce as tryRegister,
-  me as tsDepMap,
-  L as uuidCodec,
-  ie as validateSchemaRefs
+  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
 };

package/lib/contracts.d.ts

@@ -28,6 +28,25 @@ export interface LogicalTypeCodec<Host = unknown> {
     readonly schema: SchemaNode;
     /** Structural, cheap test: does this codec own `node`? (format match, or x-apigen-codec===id). */
     matches(node: SchemaNode): boolean;
+    /**
+     * Value-side claim test, used ONLY on the schemaless path (a `{}` / `any`
+     * schema node, where `matches(node)` cannot decide anything).
+     *
+     * Implement this on — and only on — codecs whose HOST type is not
+     * JSON-native (`Date`, `bigint`, `Uint8Array`, non-finite `number`). Those
+     * are the values that genuinely need the `{$apigen,v}` envelope to survive
+     * a JSON round-trip. A codec whose host type IS JSON-native (`uuid` and
+     * `decimal` are both branded strings) must NOT implement it: a plain string
+     * already round-trips, and claiming it would rewrite a consumer's payload
+     * for no gain.
+     *
+     * A codec that omits `ownsValue` is never eligible for schemaless claiming.
+     * That is the safe default — passthrough loses nothing, whereas a wrong
+     * claim silently destroys data.
+     *
+     * MUST be pure and side-effect free.
+     */
+    ownsValue?(value: unknown): boolean;
     /** Host -> wire. MUST NOT mutate `value`; MUST be deterministic. */
     encode(value: Host, node: SchemaNode, ctx: TranscodeCtx): Wire;
     /** Wire -> host. MUST validate-then-construct; MUST be the inverse of `encode` across the vectors. */

package/package.json

@@ -1,7 +1,25 @@
 {
   "name": "@adhd/apigen-base-logical",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "main": "./index.js",
   "module": "./index.mjs",
-  "typings": "./index.d.ts"
+  "typings": "./index.d.ts",
+  "description": "Logical-type transcoding contracts for apigen",
+  "keywords": [
+    "api",
+    "codegen",
+    "logical-types",
+    "schema",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PseudoSky/adhd.git",
+    "directory": "packages/apigen/apigen-base-logical"
+  },
+  "homepage": "https://github.com/PseudoSky/adhd/tree/main/packages/apigen/apigen-base-logical#readme",
+  "bugs": {
+    "url": "https://github.com/PseudoSky/adhd/issues"
+  }
 }