@es-joy/jsoe 0.6.0 → 0.7.0

package/CHANGES.md

@@ -1,5 +1,14 @@
 # CHANGES TO `@es-joy/jsoe`
 
+## 0.7.0
+
+- feat: add `file` type including video, audio, photo, and
+   screen sharing recording
+
+## 0.6.1
+
+- refactor: avoid problems for instrumenter
+
 ## 0.6.0
 
 - feat: add `set`, `map`, `error`, and special error types

package/README.md

@@ -32,6 +32,7 @@ Supported types include:
 - `Error`
 - `TypeError`, `RangeError`, `SyntaxError`, `ReferenceError`, `EvalError`,
     `URIError`, `AggregateError`, `InternalError`
+- `File`
 - `Map`
 - `null`
 - `Number` object
@@ -102,10 +103,21 @@ Supported supertypes include:
                     1. bigint64arrayconstructor
                     1. biguint64arrayconstructor
             1. Web/API types
-                1. blob (besides HTML), file, filelist
+                1. blob (besides HTML, including SVG), filelist
                 1. imagedata, imagebitmap
+            1. Our own custom derivative types (e.g., MIDI using TypedArray)
 1. Expand subtypes
-    1. As supported by Zod, JSON Schema, etc. (e.g., email addresses as
-        subtype of `string`, color as a subtype of string)
+    1. String
+        1. As supported by Zod, JSON Schema, etc. (e.g., email addresses as
+            subtype of `string`, color as a subtype of string)
+    1. `File`
+        1. Drawing image for `image/png`, etc. `File`'s
+        1. Drawing SVG program for `application/svg` `File`
+        1. JS/CSS/HTML/XML/Markdown/JSON/CSV/text text editor (including
+            syntax highlighting in view mode); with text-to-speech
+        1. OCR (`TextDetector` API if implemented) added as image pop-up
+            utility
 1. Might put views and data into separate repos
 1. Implement as Custom Elements?
+1. Add drag-and-drop support for `File` type
+1. Import CSV as array

package/demo/index.js

@@ -333,7 +333,11 @@ setTimeout(async function () {
           error2,
           error3,
           typeError,
-          errAggregate
+          errAggregate,
+          new File(['abc'], 'someName', {
+            lastModified: 1231231230,
+            type: 'text/plain'
+          })
         ],
         typeNamespace: 'demo-type-choices-only-initial-value'
       });
@@ -385,13 +389,24 @@ setTimeout(async function () {
         typeNamespace: 'demo-type-choices-only-initial-value-ErrorsAggregate'
       });
 
+      const typeSelectionFile = typeChoices({
+        format: 'structuredCloning',
+        setValue: true,
+        value: new File(['abc'], 'anotherName', {
+          lastModified: 1231231230,
+          type: 'text/plain'
+        }),
+        typeNamespace: 'demo-type-choices-only-initial-value'
+      });
+
       return ['form', [
         ...typeSelection.domArray,
         ...typeSelectionBlob.domArray,
         ...typeSelectionErrorWithCause.domArray,
         ...typeSelectionIndexedDBKey.domArray,
         ...typeSelectionTypeErrorWithCause.domArray,
-        ...typeSelectionTypeErrorWithAggregate.domArray
+        ...typeSelectionTypeErrorWithAggregate.domArray,
+        ...typeSelectionFile.domArray
       ]];
     })(),
 

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

@@ -1 +1 @@
-{"version":3,"file":"arrayType.d.ts","sourceRoot":"","sources":["../../src/fundamentalTypes/arrayType.js"],"names":[],"mappings":";sBAUa,MAAM;;oCAQN,MAAM,gBAAgB,EAAE;+BAGxB,MAAM,CAAC,iBAAiB,GAAG;IACvC,SAAa,EAAE,OAAO,mBAAmB,EAAE,QAAQ,CAAA;CAChD,CAAC,EAAE;6BAGM,MAAM,IAAI;sCAIV,gBAAgB,EAAE;qCAKlB,IAAI;4BAGJ,MAAM,cAAc,GAAG;IACnC,sBAA0B,EAAE,qBAAqB,CAAC;IAClD,kBAAsB,EAAE,iBAAiB,CAAC;IAC1C,iBAAqB,EAAE,gBAAgB,CAAC;IACxC,iBAAqB,EAAE,gBAAgB,CAAA;CACpC;uBAGS,MAAM,QAAQ,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,CAomDvE"}
+{"version":3,"file":"arrayType.d.ts","sourceRoot":"","sources":["../../src/fundamentalTypes/arrayType.js"],"names":[],"mappings":";sBAUa,MAAM;;oCAQN,MAAM,gBAAgB,EAAE;+BAGxB,MAAM,CAAC,iBAAiB,GAAG;IACvC,SAAa,EAAE,OAAO,mBAAmB,EAAE,QAAQ,CAAA;CAChD,CAAC,EAAE;6BAGM,MAAM,IAAI;sCAIV,gBAAgB,EAAE;qCAKlB,IAAI;4BAGJ,MAAM,cAAc,GAAG;IACnC,sBAA0B,EAAE,qBAAqB,CAAC;IAClD,kBAAsB,EAAE,iBAAiB,CAAC;IAC1C,iBAAqB,EAAE,gBAAgB,CAAC;IACxC,iBAAqB,EAAE,gBAAgB,CAAA;CACpC;uBAGS,MAAM,QAAQ,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,CAgmDvE"}

package/dist/superTypes/errorsSpecialType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errorsSpecialType.d.ts","sourceRoot":"","sources":["../../src/superTypes/errorsSpecialType.js"],"names":[],"mappings":";sBAOa,MAAM;+BAaN,gBAAgB,GAAC,yBAAyB;AAyBvD;;GAEG;AACH,iCAFU,OAAO,wBAAwB,EAAE,eAAe,CAuvBxD"}
+{"version":3,"file":"errorsSpecialType.d.ts","sourceRoot":"","sources":["../../src/superTypes/errorsSpecialType.js"],"names":[],"mappings":";sBAOa,MAAM;+BAaN,gBAAgB,GAAC,yBAAyB;AAyBvD;;GAEG;AACH,iCAFU,OAAO,wBAAwB,EAAE,eAAe,CA+sBxD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@es-joy/jsoe",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "type": "module",
   "types": "./dist/index.d.ts",
   "main": "./src/index.js",
@@ -95,7 +95,8 @@
     "rollup": "4.5.0",
     "rollup-plugin-istanbul": "^5.0.0",
     "rollup-plugin-node-builtins": "^2.1.2",
-    "typescript": "^5.2.2"
+    "typescript": "^5.2.2",
+    "webappfind-demos-samples": "^0.7.0"
   },
   "repository": {
     "type": "git",

package/src/formats/structuredCloning.js

@@ -245,9 +245,6 @@ const encapsulateObserver = (stateObj) => {
       }
 
       if (!readonly) {
-        // Todo: Redundant with `typeObj.setValue`? Ensure `idb-manager`
-        //    does not need both; this write-only would seem preferable
-        //    to the block in `arrayType.js` if readonly indeed not needed
         Types.setValue({
           type: newType,
           // eslint-disable-next-line object-shorthand -- TS
@@ -461,10 +458,11 @@ const structuredCloning = {
       'error',
       'errors',
       'blobHTML',
+      'file',
       'set',
       'map'
       // Ok, but will need some work
-      //     'blob', 'file', 'filelist',
+      //     'blob', 'filelist',
       //     'arraybuffer',
       //     'dataview', 'imagedata', 'imagebitmap',
       /*

package/src/fundamentalTypes/arrayType.js

@@ -1389,16 +1389,15 @@ const arrayType = {
            * @this {HTMLDivElement}
            */
           $getArrayItems () {
-            return (/**
-               * @type {HTMLDivElement & {
-               *   $inputsExceedingLength: InputsExceedingLength,
-               *   $getPropertyInputs: GetPropertyInputs,
-               *   $redrawMoveArrows: RedrawMoveArrows,
-               *   $getMapKeySelects: GetMapKeySelects
-               * }}
-               */
-              (this.previousElementSibling)
-            );
+            const prevSibling = /**
+             * @type {HTMLDivElement & {
+             *   $inputsExceedingLength: InputsExceedingLength,
+             *   $getPropertyInputs: GetPropertyInputs,
+             *   $redrawMoveArrows: RedrawMoveArrows,
+             *   $getMapKeySelects: GetMapKeySelects
+             * }}
+             */ (this.previousElementSibling);
+            return prevSibling;
           }
         },
         $on: {click () {
@@ -1627,9 +1626,8 @@ const arrayType = {
             const typeChoices = this.$getTypeChoices();
             typeChoices.$setType({type, baseValue: value, bringIntoFocus});
             const root = typeChoices.$getTypeRoot();
-            // Reapply this repeated setting of value if setting within the
-            //   array is not enough for `idb-manager`! But causes problems
-            //   with running `Error.cause` type twice and is inefficient;
+            // If run for all, causes problems with running `Error.cause`
+            //   type twice and is inefficient;
             //   currently put behind `setAValue` as we need to set a value
             //   from `errorsSpecialType`
             if (setAValue) {

package/src/fundamentalTypes/errorType.js

@@ -173,6 +173,7 @@ const errorType = {
   ) {
     return /** @type {import('jamilih').JamilihArray} */ ([
       'div', {dataset: {type: 'error'}}, [
+        ['b', {class: 'emphasis'}, ['Error']],
         typeof o.message === 'string'
           ? ['div', [['b', ['Message: ']], ['span', [o.message]]]]
           : [],