arcane-os 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.4.1
+
+- Preserved complete DirectoryPicker titles, paths, caller options, and
+  provider result fields without application clipping, trimming, freezing, or
+  generic path-character policy while retaining selected/cancelled semantics
+  and provider-owned path failures.
+
 ## 0.4.0
 
 - Preserved complete finite provider progress values and units as

package/README.md

@@ -19,7 +19,7 @@ version-locked SDK runtime, while an integrated Arcane checkout uses its live
 `arcane/` runtime. Both profiles preserve the same app URLs, theme, packaging,
 event, cancellation, and browser run contracts.
 
-This checkout defines the `0.4.0` SDK contract. Applications pin one exact npm
+This checkout defines the `0.4.1` SDK contract. Applications pin one exact npm
 version and lockfile; registry state is deliberately not baked into application
 artifacts.
 
@@ -126,7 +126,7 @@ uses the same controller for automatic memory extraction.
 Create a new repository-shaped Arcane application with the exact stable SDK:
 
 ```bash
-npx arcane-os@0.4.0 new my-app --path ./my-app --target portable --git
+npx arcane-os@0.4.1 new my-app --path ./my-app --target portable --git
 cd my-app
 npm install
 npm run check
@@ -137,7 +137,7 @@ To enroll an existing repository, install the exact SDK and initialize only
 missing Arcane files:
 
 ```bash
-npm install --save-dev --save-exact arcane-os@0.4.0
+npm install --save-dev --save-exact arcane-os@0.4.1
 npm exec -- arcane init my-app --target portable
 ```
 
@@ -153,7 +153,7 @@ npm exec -- arcane-os targets
 No global SDK install or standalone Arcane CLI is required. The application
 repository's exact npm dependency and lockfile own the CLI and toolchain version.
 
-Use `npx arcane-os@0.4.0` for the initial bootstrap because it names this npm
+Use `npx arcane-os@0.4.1` for the initial bootstrap because it names this npm
 package explicitly; bare `npx arcane` outside an installed project could resolve
 a different package. Both installed commands invoke the same headless toolchain.
 Project-local npm scripts use the SDK pinned by that app's `package-lock.json`,
@@ -174,7 +174,7 @@ node ./bin/arcane.mjs new local-app --path ../local-app --target portable --git
 
 # From the generated app repository
 cd ../local-app
-npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.4.0.tgz
+npm install --save-dev --save-exact ../arcane-os-sdk/arcane-os-0.4.1.tgz
 npm run check
 npm ci
 ```
@@ -184,7 +184,7 @@ same location. The lockfile retains the selected package dependency while
 Arcane uses the installed package name and version. Local directory `file:` dependencies are not
 accepted because npm may install them as links; use a packed `.tgz`. A GitHub
 runner also needs that tarball at the locked path. After publication, replace
-the local declaration with the exact `arcane-os@0.4.0` registry package and
+the local declaration with the exact `arcane-os@0.4.1` registry package and
 commit the regenerated lock.
 
 Generated repositories use `npm ci --ignore-scripts` in CI. Run dependency
@@ -322,7 +322,7 @@ package installation, or assertions.
 
 ## Current target support
 
-Version `0.4.0` exposes one browser target and five explicitly paired
+Version `0.4.1` exposes one browser target and five explicitly paired
 native development targets: a non-runnable portable directory, a
 Windows x64 unsigned-local-test EXE bundle, Linux x64 and Linux ARM64
 unsigned-local-test DEBs, and an Android development-signed APK. The

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",

package/runtime/arcane/components/directory-picker.html

@@ -165,11 +165,7 @@
     }
 
     function normalizeValue(value=''){
-        const next=`${value??''}`.trim();
-        if(/[\u0000-\u001f\u007f]/.test(next)){
-            throw new TypeError('The directory path must be plain text.');
-        }
-        return next;
+        return `${value??''}`;
     }
 
     function setDisabled(value=false){

package/runtime/arcane/modules/DirectoryPicker.js

@@ -1,12 +1,7 @@
-const TITLE_MAX_LENGTH=160;
-const PATH_MAX_LENGTH=4096;
-const CONTROL_CHARACTERS=/[\u0000-\u001f\u007f]/;
-
-function isPlainRecord(value){
+function isRecord(value){
     return Boolean(value)
         &&typeof value==='object'
-        &&!Array.isArray(value)
-        &&Object.getPrototypeOf(value)===Object.prototype;
+        &&!Array.isArray(value);
 }
 
 function coded(error,code){
@@ -14,37 +9,27 @@ function coded(error,code){
     return error;
 }
 
-function optionalText(value,label,maximum){
-    if(value===undefined||value===null||value==='') return null;
+function optionalText(value,label){
+    if(value===undefined||value===null) return value;
     if(typeof value!=='string') throw new TypeError(`${label} must be a string when provided.`);
-    const normalized=value.trim();
-    if(!normalized) return null;
-    if(normalized.length>maximum) throw new RangeError(`${label} exceeds ${maximum} characters.`);
-    if(CONTROL_CHARACTERS.test(normalized)) throw new TypeError(`${label} cannot contain control characters.`);
-    return normalized;
+    return value;
 }
 
 function normalizeDirectoryPickerOptions(input={}){
-    if(!isPlainRecord(input)) throw new TypeError('Directory picker options must be a plain object.');
-    const allowed=new Set(['initialPath','title']);
-    const unsupported=Object.keys(input).find(key=>!allowed.has(key));
-    if(unsupported) throw new TypeError(`Unsupported directory picker option: ${unsupported}`);
-
-    const title=optionalText(input.title,'title',TITLE_MAX_LENGTH);
-    const initialPath=optionalText(input.initialPath,'initialPath',PATH_MAX_LENGTH);
-    return Object.freeze({
-        ...(title?{title}:{}),
-        ...(initialPath?{initialPath}:{}),
-    });
+    if(!isRecord(input)) throw new TypeError('Directory picker options must be an object.');
+    const normalized={...input};
+    if(Object.prototype.hasOwnProperty.call(input,'title')){
+        normalized.title=optionalText(input.title,'title');
+    }
+    if(Object.prototype.hasOwnProperty.call(input,'initialPath')){
+        normalized.initialPath=optionalText(input.initialPath,'initialPath');
+    }
+    return normalized;
 }
 
 function normalizeDirectorySelection(input){
-    const keys=isPlainRecord(input)?Object.keys(input):[];
     if(
-        !isPlainRecord(input)
-        ||keys.length!==2
-        ||!keys.includes('cancelled')
-        ||!keys.includes('path')
+        !isRecord(input)
         ||typeof input.cancelled!=='boolean'
     ){
         throw coded(
@@ -53,17 +38,15 @@ function normalizeDirectorySelection(input){
         );
     }
     if(input.cancelled){
-        if(input.path!==null){
-            throw coded(
-                new TypeError('A canceled directory selection must return a null path.'),
-                'DIRECTORY_PICKER_INVALID_RESULT',
-            );
-        }
-        return Object.freeze({cancelled:true,path:null});
+        return {
+            ...input,
+            cancelled:true,
+            path:input.path===undefined?null:input.path,
+        };
     }
     let path;
     try{
-        path=optionalText(input.path,'The selected directory path',PATH_MAX_LENGTH);
+        path=optionalText(input.path,'The selected directory path');
     }catch(error){
         throw coded(error,'DIRECTORY_PICKER_INVALID_RESULT');
     }
@@ -73,7 +56,7 @@ function normalizeDirectorySelection(input){
             'DIRECTORY_PICKER_INVALID_RESULT',
         );
     }
-    return Object.freeze({cancelled:false,path});
+    return {...input,cancelled:false,path};
 }
 
 /**
@@ -81,7 +64,8 @@ function normalizeDirectorySelection(input){
  *
  * This wrapper does not enumerate directories, persist a selected path, or use
  * a browser file picker. The injected provider must expose
- * `selectDirectory(options)` and return `{cancelled, path}`.
+ * `selectDirectory(options)` and return a record with `cancelled` and `path`.
+ * Caller options and additional provider result fields pass through unchanged.
  */
 export default class DirectoryPicker{
     constructor(provider=globalThis.Arcane?.filesystem){