@es-joy/jsoe 0.26.1 → 0.28.0

package/.gitignore

@@ -0,0 +1,10 @@
+node_modules
+ignore
+proj.json
+coverage
+cypress/downloads
+cypress/screenshots
+# instrumented # Disable for now for Cypress Cloud
+/dist
+.agents
+skills-lock.json

package/.npmignore

@@ -0,0 +1,9 @@
+cypress
+coverage
+instrumented
+.nyc_output
+.github
+cypress.config.ts
+demo
+.agents
+skills-lock.json

package/CHANGES.md

@@ -1,5 +1,81 @@
 # CHANGES TO `@es-joy/jsoe`
 
+## 0.28.0
+
+- feat: add raw Typeson/JSON6 "View raw"/"Edit raw" buttons to every
+    object/array-family control (`object`, `array`, `set`, `map`, `record`,
+    `tuple`, `filelist`), including the root control
+    - New `Types` constructor options: `showRawTypesonControls` (default
+        `true`) shows or hides the buttons entirely; `allowUnsafeEval`
+        (default `false`) additionally offers editing/seeding the same value
+        as literal, `eval`'d JS source instead of Typeson/JSON6
+    - New `src/utils/rawTypesonEditor.js` opens a dialog with a
+        syntax-highlighted (CodeMirror 6) editor; Save re-populates the
+        control's children via the same walk `structuredCloning`'s `iterate`
+        already uses for building them, then re-validates. A schema-driven
+        control's raw edit is also checked against its own schema before
+        being accepted
+    - New dependencies `json-6` (parsing only — its own `stringify` has a
+        string-value-quoting bug, worked around locally) and CodeMirror 6,
+        vendored for the bundler-less demo pages
+    - Eval-mode source reconstruction covers `Date`/`RegExp`/`Map`/`Set`/
+        `Symbol`/boxed primitives/the `Error` family (including `cause` and
+        `AggregateError`'s nested errors)/`DOMException`/`DOMRect`/`DOMPoint`/
+        `DOMMatrix`/`ArrayBuffer`/`DataView`/typed arrays (including
+        `Float16Array`)/`Blob`/`File`/`FileList`/`-0`; a `Promise` or an
+        unrecognized class instance throws a clear error instead of silently
+        producing a same-shaped-but-wrong value
+    - New demo: `demo/index-unsafe-eval.html`
+- fix: resetting an object/array-family control's legend numbering
+    (`$resetItemIndex`, used after a raw-value replace) now resets to the
+    container's own true starting baseline instead of an array-specific
+    `-1`, so replacing a container's content without changing its property
+    count keeps each unchanged property's legend number the same as before
+    the edit
+
+## 0.27.0
+
+- feat: add `properties` schema support: a zodexy `{type: 'properties'}` node
+    (Zod 4.5+ `z.properties()`) is now edited, viewed, and preloaded through the
+    same `object` UI, differing from `object` in that it has no `catchall` and
+    does not strip properties outside its declared shape.
+    - `{type: 'properties'}` maps to the fundamental `object` type
+        (`zodexToStructuredCloningTypeMap`), so it reuses the object editor;
+        `getTypesForSchema` handles it alongside `object`.
+    - A preloaded key that is *not* in the declared shape is kept (not
+        stripped) and rendered as a free property offered the unconstrained
+        type choice, the same treatment a `looseRecord`'s non-conforming entry
+        gets. `convertFromTypeson` (`formats/schema.js`) and `getChildSchema`
+        (`fundamentalTypes/arrayType.js`) return `{type: 'unknown'}` for such a
+        key. See the related `fix:` below for why.
+    - Because it renders as an `object`, a `properties` node would otherwise be
+        an indistinguishable "Object" in the type pull-down (`types.js`
+        `getOptionForType`) and the edit-mode container-heading tooltip
+        (`arrayType.js`); it is now named "Properties" when the schema carries
+        no `meta` label of its own. `xor`-branch labels
+        (`typeChoices.js` `deriveXorBranchLabel`) likewise treat it as a
+        property bag.
+    - A new `isPropertyBagType` helper (`object` or `properties`) lets
+        `mergeSchema` merge the declared property schemas of two intersected
+        `properties` nodes — the previous `type !== 'object'` guard returned
+        early and silently dropped the right branch's properties — and lets
+        `isValueValidationRequired` treat `properties` like `object` (its
+        per-property controls already carry their own schemas, so no
+        value-level reparse is needed).
+- fix: a preloaded property outside an `object` schema's declared shape, when
+    the schema has no `catchall`, is now edited through the unconstrained type
+    choice (`{type: 'unknown'}`) instead of an "unschema'd" control. Previously
+    `convertFromTypeson` returned the value's bare runtime type while
+    `getChildSchema` returned `undefined`, so the type-chooser was built with
+    no `schemaContent` and could render an extra, stray control (e.g. a number
+    widget beside the string input). `{type: 'unknown'}` expands to the full
+    candidate-type set, so the lossless-match pass picks the single control
+    matching the value and still offers the `<select>` to change it — the same
+    handling `properties` and a `looseRecord`'s non-conforming entry get. A
+    strict `object` still strips the key on parse; this governs only how it is
+    edited.
+- feat: add `iban` string kind
+
 ## 0.26.1
 
 - fix: validate invalid regexp source edits

package/README.md

@@ -1,5 +1,7 @@
 [![Licenses badge](https://raw.githubusercontent.com/es-joy/jsoe/main/badges/licenses-badge.svg?sanitize=true)](badges/licenses-badge.svg)
-[![coverage badge](https://raw.githubusercontent.com/es-joy/jsoe/main/badges/coverage-badge.svg?sanitize=true)](badges/coverage-badge.svg)
+
+[![Tests badge](./badges/tests-badge.svg)](badges/tests-badge.svg)
+[![coverage badge](./badges/coverage-badge.svg)](badges/coverage-badge.svg)
 
 # @es-joy/jsoe
 
@@ -119,7 +121,7 @@ Supported supertypes include:
 
 ## To-dos
 
-1. Ability to replace content with raw JSON/Typeson/Safe Eval (no functions in default mode, etc.)/AI (including speech-to-text) if it validates
+1. Ability to replace content with raw [JSON6](https://github.com/d3x0r/JSON6)/Typeson/Safe Eval (no functions in default mode, etc.)/AI (including speech-to-text) if it validates
 1. Expand fundamental types
     1. Not in typeson-registry
         1. Structured Cloning
@@ -129,11 +131,11 @@ Supported supertypes include:
         1. Structured Cloning
             1. (JavaScript types already complete)
             1. Web/API types
+                1. quotaexceedederror
+                1. webtransporterror
                 1. imagedata
                 1. imagebitmap
                 1. domquad
-                1. quotaexceedederror
-                1. webtransporterror
                 1. cryptokey
                 1. audiodata
                 1. encodedaudiochunk

package/badges/coverage-badge.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="414" height="20"><defs><style>text{font-size:11px;font-family:Verdana,DejaVu Sans,Geneva,sans-serif}text.shadow{fill:#010101;fill-opacity:.3}text.high{fill:#fff}</style><linearGradient id="smooth" x2="0" y2="100%"><stop offset="0" stop-color="#aaa" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><mask id="round"><rect width="100%" height="100%" rx="3" fill="#fff"/></mask></defs><g id="bg" mask="url(#round)"><path fill="orange" stroke="#000" d="M0 0h120v20H0zM120 0h109v20H120zM229 0h80v20h-80zM309 0h105v20H309z"/><path fill="url(#smooth)" d="M0 0h414v20H0z"/></g><g id="fg"><text class="shadow" x="5.5" y="15">Statements 37.92%</text><text class="high" x="5" y="14">Statements 37.92%</text><text class="shadow" x="125.5" y="15">Branches 19.93%</text><text class="high" x="125" y="14">Branches 19.93%</text><text class="shadow" x="234.5" y="15">Lines 37.3%</text><text class="high" x="234" y="14">Lines 37.3%</text><text class="shadow" x="314.5" y="15">Functions 29.5%</text><text class="high" x="314" y="14">Functions 29.5%</text></g></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="421" height="20"><defs><style>text{font-size:11px;font-family:Verdana,DejaVu Sans,Geneva,sans-serif}text.shadow{fill:#010101;fill-opacity:.3}text.high{fill:#fff}</style><linearGradient id="smooth" x2="0" y2="100%"><stop offset="0" stop-color="#aaa" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><mask id="round"><rect width="100%" height="100%" rx="3" fill="#fff"/></mask></defs><g id="bg" mask="url(#round)"><path fill="orange" stroke="#000" d="M0 0h113v20H0zM113 0h109v20H113zM222 0h87v20h-87zM309 0h112v20H309z"/><path fill="url(#smooth)" d="M0 0h421v20H0z"/></g><g id="fg"><text class="shadow" x="5.5" y="15">Statements 96.7%</text><text class="high" x="5" y="14">Statements 96.7%</text><text class="shadow" x="118.5" y="15">Branches 93.41%</text><text class="high" x="118" y="14">Branches 93.41%</text><text class="shadow" x="227.5" y="15">Lines 96.76%</text><text class="high" x="227" y="14">Lines 96.76%</text><text class="shadow" x="314.5" y="15">Functions 97.57%</text><text class="high" x="314" y="14">Functions 97.57%</text></g></svg>

package/badges/tests-badge.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="97" height="20"><defs><style>text{font-size:11px;font-family:Verdana,DejaVu Sans,Geneva,sans-serif}text.shadow{fill:#010101;fill-opacity:.3}text.high{fill:#fff}</style><linearGradient id="smooth" x2="0" y2="100%"><stop offset="0" stop-color="#aaa" stop-opacity=".1"/><stop offset="1" stop-opacity=".1"/></linearGradient><mask id="round"><rect width="100%" height="100%" fill="#fff" rx="3"/></mask></defs><g id="bg" mask="url(#round)"><path fill="#696969" d="M0 0h41v20H0z"/><path fill="#e05d44" d="M41 0h56v20H41z"/><path fill="url(#smooth)" d="M0 0h97v20H0z"/></g><g id="fg"><text x="5.5" y="15" class="shadow">Tests</text><text x="5" y="14" class="high">Tests</text><text x="46.5" y="15" class="shadow">795/797</text><text x="46" y="14" class="high">795/797</text></g></svg>

package/dist/formats/schema.d.ts

@@ -1,3 +1,13 @@
+/**
+ * Exported for reuse by `src/utils/rawTypesonEditor.js`, which must enforce
+ *   the same schema conformance check before accepting a raw-edited value.
+ * @param {InstanceType<typeof import('../types.js').default>} types
+ * @param {ZodexSchema} schemaObject
+ * @param {ZodexSchema} originalShape
+ * @param {unknown} value
+ * @returns {ReturnType<ReturnType<typeof dezerialize>['safeParse']>}
+ */
+export function parseValue(types: InstanceType<typeof import("../types.js").default>, schemaObject: ZodexSchema, originalShape: ZodexSchema, value: unknown): ReturnType<ReturnType<typeof dezerialize>["safeParse"]>;
 /**
  * Checks whether a record property name satisfies the record's `key` schema.
  *
@@ -55,6 +65,7 @@ export type ValueOf<T> = T[keyof T];
 export type AvailableZodexType = ValueOf<Pick<import("zodexy").SzType, "type">>;
 export type ZodexSchema = import("zodexy").SzType;
 export type NestedObject = import("../utils/objects.js").NestedObject;
+import { dezerialize } from 'zodexy';
 /** @type {import('../formats.js').Format} */
 declare const schema: import("../formats.js").Format;
 //# sourceMappingURL=schema.d.ts.map

package/dist/formats/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/formats/schema.js"],"names":[],"mappings":"AAqOA;;;;;;;;;;;;;GAaG;AACH,yCALW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,aAClD,WAAW,GAAC,SAAS,OACrB,MAAM,GAAC,MAAM,GAAC,SAAS,GACrB,OAAO,CAenB;AAED;;;;;;;;GAQG;AACH,6CALW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,aAClD,OAAO,QAAQ,EAAE,OAAO,SACxB,OAAO,GACL;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAW5C;AAED;;;;;;;;GAQG;AACH,0CALW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,UAClD,WAAW,SACX,OAAO,GACL,OAAO,CAInB;AAiDD;;;GAGG;AACH,kDAHW,WAAW,GACT,WAAW,CAIvB;AAyND;;;;GAIG;AACH,gDAJW,WAAW,gBACX,WAAW,GACT,GAAG,CAAC,WAAW,CAAC,CA6R5B;;;;;oBAp0BY,CAAC,IADD,CAAC,CAAC,MAAM,CAAC,CAAC;iCAKV,OAAO,CACf,IAAI,CAAC,OAAO,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CACtC;0BAwSS,OAAO,QAAQ,EAAE,MAAM;2BAGvB,OAAO,qBAAqB,EAAE,YAAY;AAqhBvD,6CAA6C;AAC7C,sBADW,OAAO,eAAe,EAAE,MAAM,CA+SvC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/formats/schema.js"],"names":[],"mappings":"AAmMA;;;;;;;;GAQG;AACH,kCANW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,gBAClD,WAAW,iBACX,WAAW,SACX,OAAO,GACL,UAAU,CAAC,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,CAAC,CAAC,CASnE;AAwBD;;;;;;;;;;;;;GAaG;AACH,yCALW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,aAClD,WAAW,GAAC,SAAS,OACrB,MAAM,GAAC,MAAM,GAAC,SAAS,GACrB,OAAO,CAenB;AAED;;;;;;;;GAQG;AACH,6CALW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,aAClD,OAAO,QAAQ,EAAE,OAAO,SACxB,OAAO,GACL;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAW5C;AAED;;;;;;;;GAQG;AACH,0CALW,YAAY,CAAC,cAAc,aAAa,EAAE,OAAO,CAAC,UAClD,WAAW,SACX,OAAO,GACL,OAAO,CAInB;AAiDD;;;GAGG;AACH,kDAHW,WAAW,GACT,WAAW,CAIvB;AAsOD;;;;GAIG;AACH,gDAJW,WAAW,gBACX,WAAW,GACT,GAAG,CAAC,WAAW,CAAC,CA8R5B;;;;;oBAx1BY,CAAC,IADD,CAAC,CAAC,MAAM,CAAC,CAAC;iCAKV,OAAO,CACf,IAAI,CAAC,OAAO,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CACtC;0BA8SS,OAAO,QAAQ,EAAE,MAAM;2BAGvB,OAAO,qBAAqB,EAAE,YAAY;4BAnU7B,QAAQ;AAs2BlC,6CAA6C;AAC7C,sBADW,OAAO,eAAe,EAAE,MAAM,CA0TvC"}

package/dist/formats/structuredCloning.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"structuredCloning.d.ts","sourceRoot":"","sources":["../../src/formats/structuredCloning.js"],"names":[],"mappings":"AAaA,4CAA4C;AAC5C,2BADW,OAAO,SAAS,EAAE,WAAW,CActC;AAEF,iGAkBE;;;;;;oCA0BW,CAAC,IAAI,EAAE;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,aAAa,EAAE,sBAAsB,CAAC;IACnD,KAAK,EAAE,OAAO,eAAe,EAAE,oBAAoB,CAAC;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAK,WAAW,GAAC,IAAI;kCAIZ,OAAO,kBAAkB,EAAE,mBAAmB;AAsgB3D,6CAA6C;AAC7C,iCADW,OAAO,eAAe,EAAE,MAAM,CA2JvC"}
+{"version":3,"file":"structuredCloning.d.ts","sourceRoot":"","sources":["../../src/formats/structuredCloning.js"],"names":[],"mappings":"AAaA,4CAA4C;AAC5C,2BADW,OAAO,SAAS,EAAE,WAAW,CActC;AAEF,iGAkBE;;;;;;oCA0BW,CAAC,IAAI,EAAE;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,aAAa,EAAE,sBAAsB,CAAC;IACnD,KAAK,EAAE,OAAO,eAAe,EAAE,oBAAoB,CAAC;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;IAC3D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,KAAK,WAAW,GAAC,IAAI;kCAIZ,OAAO,kBAAkB,EAAE,mBAAmB;AA6gB3D,6CAA6C;AAC7C,iCADW,OAAO,eAAe,EAAE,MAAM,CA2JvC"}

package/dist/fundamentalTypes/arrayType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"arrayType.d.ts","sourceRoot":"","sources":["../../src/fundamentalTypes/arrayType.js"],"names":[],"mappings":";0CAoBW;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,aAAa,EAAE,aAAa,CAAC;IAC1C,KAAK,EAAE,OAAO,eAAe,EAAE,oBAAoB,CAAC;IACpD,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;CAC3D,KACS,OAAO;sBAIP,MAAM;mDAKN,KAAK,GAAC,OAAO;oCAGb,MAAM,gBAAgB,EAAE;+BAGxB,MAAM,CAAC,iBAAiB,GAAG;IACnC,SAAS,EAAE,OAAO,mBAAmB,EAAE,QAAQ,CAAA;CAChD,CAAC,EAAE;6BAGM,MAAM,IAAI;sCAIV,gBAAgB,EAAE;qCAKlB,IAAI;4BAGJ,MAAM,cAAc,GAAG;IAC/B,sBAAsB,EAAE,qBAAqB,CAAC;IAC9C,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,iBAAiB,EAAE,gBAAgB,CAAA;CACpC;uBAGS,MAAM,OAAO,CAAC,IAAI,CAAC;2BAKrB;IAAC,WAAW,CAAC,EAAE,IAAI,CAAA;CAAC,KAClB,IAAI;+BAIJ,MAAM,gBAAgB,GAAC,SAAS;uBAIhC,GAAG;AAmBhB;;GAEG;AACH,yBAFU,OAAO,aAAa,EAAE,UAAU,GAAG;IAAC,MAAM,CAAC,EAAE,OAAO,GAAC,SAAS,CAAA;CAAC,CAmlFvE"}
+{"version":3,"file":"arrayType.d.ts","sourceRoot":"","sources":["../../src/fundamentalTypes/arrayType.js"],"names":[],"mappings":";0CAqBW;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,aAAa,EAAE,aAAa,CAAC;IAC1C,KAAK,EAAE,OAAO,eAAe,EAAE,oBAAoB,CAAC;IACpD,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,sBAAsB,EAAE,WAAW,CAAC;CAC3D,KACS,OAAO;sBAIP,MAAM;mDAKN,KAAK,GAAC,OAAO;oCAGb,MAAM,gBAAgB,EAAE;+BAGxB,MAAM,CAAC,iBAAiB,GAAG;IACnC,SAAS,EAAE,OAAO,mBAAmB,EAAE,QAAQ,CAAA;CAChD,CAAC,EAAE;6BAGM,MAAM,IAAI;sCAIV,gBAAgB,EAAE;qCAKlB,IAAI;4BAGJ,MAAM,cAAc,GAAG;IAC/B,sBAAsB,EAAE,qBAAqB,CAAC;IAC9C,kBAAkB,EAAE,iBAAiB,CAAC;IACtC,iBAAiB,EAAE,gBAAgB,CAAC;IACpC,iBAAiB,EAAE,gBAAgB,CAAA;CACpC;uBAGS,MAAM,OAAO,CAAC,IAAI,CAAC;2BAKrB;IAAC,WAAW,CAAC,EAAE,IAAI,CAAA;CAAC,KAClB,IAAI;+BAIJ,MAAM,gBAAgB,GAAC,SAAS;uBAIhC,GAAG;AAmBhB;;GAEG;AACH,yBAFU,OAAO,aAAa,EAAE,UAAU,GAAG;IAAC,MAAM,CAAC,EAAE,OAAO,GAAC,SAAS,CAAA;CAAC,CAktFvE"}

package/dist/fundamentalTypes/stringType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stringType.d.ts","sourceRoot":"","sources":["../../src/fundamentalTypes/stringType.js"],"names":[],"mappings":";AAMA;;GAEG;AACH,0BAFU,OAAO,aAAa,EAAE,UAAU,CAgVxC"}
+{"version":3,"file":"stringType.d.ts","sourceRoot":"","sources":["../../src/fundamentalTypes/stringType.js"],"names":[],"mappings":";AAMA;;GAEG;AACH,0BAFU,OAAO,aAAa,EAAE,UAAU,CAqVxC"}