taon-storage 21.0.18 → 21.0.20

package/browser/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage/browser",
-  "version": "21.0.18",
+  "version": "21.0.20",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/browser-prod/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage/browser-prod",
-  "version": "21.0.18",
+  "version": "21.0.20",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/lib/build-info._auto-generated_.d.ts

@@ -21,4 +21,4 @@ export declare const CURRENT_PACKAGE_TAON_VERSION = "v21";
 /**
  *  Autogenerated by current cli tool. Use *tnp release* to bump version.
  */
-export declare const CURRENT_PACKAGE_VERSION = "21.0.18";
+export declare const CURRENT_PACKAGE_VERSION = "21.0.20";

package/lib/build-info._auto-generated_.js

@@ -25,6 +25,6 @@ exports.CURRENT_PACKAGE_TAON_VERSION = 'v21';
 /**
  *  Autogenerated by current cli tool. Use *tnp release* to bump version.
  */
-exports.CURRENT_PACKAGE_VERSION = '21.0.18';
+exports.CURRENT_PACKAGE_VERSION = '21.0.20';
 // THIS FILE IS GENERATED - DO NOT MODIFY
 //# sourceMappingURL=build-info._auto-generated_.js.map

package/lib/package.json

@@ -1,4 +1,4 @@
 {
   "name": "taon-storage/lib",
-  "version": "21.0.18"
+  "version": "21.0.20"
 }

package/lib-prod/{build-info._auto-generated_.ts → build-info._auto-generated_.js}

@@ -22,6 +22,5 @@ export const CURRENT_PACKAGE_TAON_VERSION = 'v21';
 /**
  *  Autogenerated by current cli tool. Use *tnp release* to bump version.
  */
-export const CURRENT_PACKAGE_VERSION = '21.0.18';
+export const CURRENT_PACKAGE_VERSION = '21.0.20';
 // THIS FILE IS GENERATED - DO NOT MODIFY
-      

package/lib-prod/env/{env.angular-node-app.ts → env.angular-node-app.js}

@@ -63,4 +63,4 @@ export const ENV_ANGULAR_NODE_APP_IS_CI_PROCESS = undefined;
 export const ENV_ANGULAR_NODE_APP_DOCKER_ADDITIONAL_CONTAINER = undefined;
 export const ENV_ANGULAR_NODE_APP_DOCKER_SKIP_START_IN_ORDER = undefined;
 export const ENV_ANGULAR_NODE_APP_DOCKER_SKIP_USING_MYSQL_DB = undefined;
-// THIS FILE IS GENERATED - DO NOT MODIFY
+// THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/env/{env.docs-webapp.ts → env.docs-webapp.js}

@@ -63,4 +63,4 @@ export const ENV_DOCS_WEBAPP_IS_CI_PROCESS = undefined;
 export const ENV_DOCS_WEBAPP_DOCKER_ADDITIONAL_CONTAINER = undefined;
 export const ENV_DOCS_WEBAPP_DOCKER_SKIP_START_IN_ORDER = undefined;
 export const ENV_DOCS_WEBAPP_DOCKER_SKIP_USING_MYSQL_DB = undefined;
-// THIS FILE IS GENERATED - DO NOT MODIFY
+// THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/env/{env.electron-app.ts → env.electron-app.js}

@@ -63,4 +63,4 @@ export const ENV_ELECTRON_APP_IS_CI_PROCESS = undefined;
 export const ENV_ELECTRON_APP_DOCKER_ADDITIONAL_CONTAINER = undefined;
 export const ENV_ELECTRON_APP_DOCKER_SKIP_START_IN_ORDER = undefined;
 export const ENV_ELECTRON_APP_DOCKER_SKIP_USING_MYSQL_DB = undefined;
-// THIS FILE IS GENERATED - DO NOT MODIFY
+// THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/env/{env.mobile-app.ts → env.mobile-app.js}

@@ -63,4 +63,4 @@ export const ENV_MOBILE_APP_IS_CI_PROCESS = undefined;
 export const ENV_MOBILE_APP_DOCKER_ADDITIONAL_CONTAINER = undefined;
 export const ENV_MOBILE_APP_DOCKER_SKIP_START_IN_ORDER = undefined;
 export const ENV_MOBILE_APP_DOCKER_SKIP_USING_MYSQL_DB = undefined;
-// THIS FILE IS GENERATED - DO NOT MODIFY
+// THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/env/{env.npm-lib-and-cli-tool.ts → env.npm-lib-and-cli-tool.js}

@@ -63,4 +63,4 @@ export const ENV_NPM_LIB_AND_CLI_TOOL_IS_CI_PROCESS = undefined;
 export const ENV_NPM_LIB_AND_CLI_TOOL_DOCKER_ADDITIONAL_CONTAINER = undefined;
 export const ENV_NPM_LIB_AND_CLI_TOOL_DOCKER_SKIP_START_IN_ORDER = undefined;
 export const ENV_NPM_LIB_AND_CLI_TOOL_DOCKER_SKIP_USING_MYSQL_DB = undefined;
-// THIS FILE IS GENERATED - DO NOT MODIFY
+// THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/env/{env.vscode-plugin.ts → env.vscode-plugin.js}

@@ -63,4 +63,4 @@ export const ENV_VSCODE_PLUGIN_IS_CI_PROCESS = undefined;
 export const ENV_VSCODE_PLUGIN_DOCKER_ADDITIONAL_CONTAINER = undefined;
 export const ENV_VSCODE_PLUGIN_DOCKER_SKIP_START_IN_ORDER = undefined;
 export const ENV_VSCODE_PLUGIN_DOCKER_SKIP_USING_MYSQL_DB = undefined;
-// THIS FILE IS GENERATED - DO NOT MODIFY
+// THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/{index._auto-generated_.ts → index._auto-generated_.js}

@@ -2,4 +2,4 @@
 // This file is auto-generated during init process. Do not modify.
 // This is only placeholder.
 // Use property "shouldGenerateAutogenIndexFile: true" 
-// in taon.jsonc to enable ts exports auto generation. 
+// in taon.jsonc to enable ts exports auto generation.

package/lib-prod/index.js

@@ -0,0 +1,3 @@
+/* */
+/* */
+export * from './storage';

package/lib-prod/migrations/index.js

@@ -0,0 +1,2 @@
+//@ts-nocheck
+export * from './migrations_index._auto-generated_';

package/lib-prod/migrations/{migrations_index._auto-generated_.ts → migrations_index._auto-generated_.js}

@@ -1,5 +1,3 @@
 // THIS FILE IS GENERATED - DO NOT MODIFY
-
 // THIS FILE IS GENERATED - DO NOT MODIFY
-
 // THIS FILE IS GENERATED - DO NOT MODIFY

package/lib-prod/package.json

@@ -1,4 +1,4 @@
 {
   "name": "taon-storage/lib-prod",
-  "version": "21.0.18"
+  "version": "21.0.20"
 }

package/lib-prod/storage.js

@@ -0,0 +1,491 @@
+/* taon-storage (native, SSR-safe) */
+import { ___NS__kebabCase, UtilsOs__NS__isNode } from 'tnp-core/lib-prod';
+const isBrowser = typeof window !== 'undefined' &&
+    typeof document !== 'undefined' &&
+    typeof navigator !== 'undefined';
+function safeLocationPort() {
+    try {
+        return globalThis?.location?.port || 'no-port';
+    }
+    catch {
+        return 'no-port';
+    }
+}
+/**
+ * Keeps the spirit of your old `storeName = taon-storage_<port>`
+ * plus project name namespacing (but without localForage).
+ */
+export const storeName = `taon-storage_${safeLocationPort()}`;
+function defaultNamespace() {
+    const project = ___NS__kebabCase(globalThis['CURRENT_PROJECT_GENERIC_NAME'] ?? '');
+    return project ? `${storeName}_${project}` : storeName;
+}
+/**
+ * Central config (optional).
+ * You can set it once at app bootstrap if you want a stable namespace.
+ */
+export const StorConfig = {
+    namespace: defaultNamespace(),
+    indexedDb: {
+        dbName: `${defaultNamespace()}_INDEXEDDB`,
+        storeName: 'keyvaluepairs',
+    },
+};
+function normalizeScopeClass(cls) {
+    if (!cls)
+        return { name: '__GLOBAL_NAMESPACE__' };
+    // if it's a function/class
+    if (typeof cls === 'function')
+        return { name: cls.name || '__ANON__' };
+    // if it's already object with name
+    return { name: cls.name || '__ANON__' };
+}
+export function keyValue(scopeClass, memberName) {
+    const c = normalizeScopeClass(scopeClass);
+    return `${StorConfig.namespace}::taon.storage.class.${c.name}.prop.${memberName}`;
+}
+export function keyDefaultValueAlreadySet(scopeClass, memberName) {
+    return `${keyValue(scopeClass, memberName)}::defaultvalueisset`;
+}
+/** Back-compat alias (your old typo) */
+export const keyDefaultValueAreadySet = keyDefaultValueAlreadySet;
+class NoopStore {
+    async getItem(_key) {
+        return undefined;
+    }
+    async setItem(_key, _value) {
+        // noop
+    }
+    async removeItem(_key) {
+        // noop
+    }
+}
+class BrowserLocalStorageStore {
+    ls() {
+        if (!isBrowser)
+            return undefined;
+        try {
+            return window.localStorage;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async getItem(key) {
+        const ls = this.ls();
+        if (!ls)
+            return undefined;
+        const raw = ls.getItem(key);
+        if (raw === null)
+            return undefined;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // if something stored plain string by older versions
+            return raw;
+        }
+    }
+    async setItem(key, value) {
+        const ls = this.ls();
+        if (!ls)
+            return;
+        try {
+            ls.setItem(key, JSON.stringify(value));
+        }
+        catch {
+            // last resort: try as string
+            try {
+                ls.setItem(key, String(value));
+            }
+            catch {
+                // ignore (quota/private mode)
+            }
+        }
+    }
+    async removeItem(key) {
+        const ls = this.ls();
+        if (!ls)
+            return;
+        try {
+            ls.removeItem(key);
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+class BrowserIndexedDbStore {
+    constructor() {
+        this.dbPromise = null;
+    }
+    openDb() {
+        if (!isBrowser || !window.indexedDB) {
+            return Promise.reject(new Error('IndexedDB not available'));
+        }
+        if (this.dbPromise)
+            return this.dbPromise;
+        const { dbName, storeName } = StorConfig.indexedDb;
+        this.dbPromise = new Promise((resolve, reject) => {
+            const req = indexedDB.open(dbName, 1);
+            req.onupgradeneeded = () => {
+                const db = req.result;
+                if (!db.objectStoreNames.contains(storeName)) {
+                    db.createObjectStore(storeName);
+                }
+            };
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+        });
+        return this.dbPromise;
+    }
+    async withStore(mode, fn) {
+        const db = await this.openDb();
+        const { storeName } = StorConfig.indexedDb;
+        return await new Promise((resolve, reject) => {
+            const tx = db.transaction(storeName, mode);
+            const store = tx.objectStore(storeName);
+            const req = fn(store);
+            req.onsuccess = () => resolve(req.result);
+            req.onerror = () => reject(req.error);
+            tx.onabort = () => reject(tx.error);
+            // tx.oncomplete => nothing
+        });
+    }
+    async getItem(key) {
+        try {
+            const result = await this.withStore('readonly', s => s.get(key));
+            return result === undefined ? undefined : result;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async setItem(key, value) {
+        try {
+            await this.withStore('readwrite', s => s.put(value, key));
+        }
+        catch {
+            // ignore
+        }
+    }
+    async removeItem(key) {
+        try {
+            await this.withStore('readwrite', s => s.delete(key));
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+/**
+ * Node-side file storage (optional). No top-level node imports (Angular-safe).
+ * Works only when executed in Node.
+ */
+class FileStor {
+    constructor(filePath, useJSON = false) {
+        this.filePath = filePath;
+        this.useJSON = useJSON;
+    }
+    isNodeRuntime() {
+        return UtilsOs__NS__isNode;
+        // return (
+        //   typeof process !== 'undefined' &&
+        //   !!(process as any).versions?.node &&
+        //   typeof (globalThis as any).window === 'undefined'
+        // );
+    }
+    async setItem(_key, value) {
+        if (!this.isNodeRuntime())
+            return;
+        //#region @backendFunc
+        const fs = await import('node:fs/promises');
+        const data = this.useJSON ? JSON.stringify(value, null, 2) : value;
+        if (this.useJSON) {
+            await fs.writeFile(this.filePath, String(data), 'utf8');
+        }
+        else {
+            await fs.writeFile(this.filePath, String(data), 'utf8');
+        }
+        //#endregion
+    }
+    async getItem(_key) {
+        if (!this.isNodeRuntime())
+            return undefined;
+        //#region @backendFunc
+        const fs = await import('node:fs/promises');
+        try {
+            const buf = await fs.readFile(this.filePath, 'utf8');
+            if (!this.useJSON)
+                return buf;
+            return JSON.parse(buf);
+        }
+        catch {
+            return undefined;
+        }
+        //#endregion
+    }
+    async removeItem(_key) {
+        if (!this.isNodeRuntime())
+            return;
+        //#region @backendFunc
+        const fs = await import('node:fs/promises');
+        try {
+            await fs.rm(this.filePath, { force: true });
+        }
+        catch {
+            // ignore
+        }
+        //#endregion
+    }
+}
+/* ---------------------------
+ * Pending ops (so you can still await)
+ * -------------------------- */
+class StorPending {
+    static { this.pending = []; }
+    static { this.id = 0; }
+    static { this.AWAITING_INTERVAL_TIME = 200; }
+    static async awaitPendingOperations(id = StorPending.id++) {
+        if (id > Number.MAX_SAFE_INTEGER - 2) {
+            StorPending.id = 0;
+            id = StorPending.id++;
+        }
+        const pending = StorPending.pending;
+        for (const op of pending) {
+            if (!op.isDone) {
+                await new Promise(resolve => {
+                    setTimeout(async () => {
+                        await StorPending.awaitPendingOperations(id);
+                        resolve();
+                    }, StorPending.AWAITING_INTERVAL_TIME);
+                });
+                return;
+            }
+        }
+        // cleanup
+        StorPending.pending = pending.filter(p => !p.isDone);
+    }
+    static start(engine, id) {
+        const op = { engine, id, isDone: false };
+        StorPending.pending.push(op);
+        return op;
+    }
+    static done(op) {
+        op.isDone = true;
+    }
+}
+/* ---------------------------
+ * Decorator builder
+ * -------------------------- */
+class StorPropertyBuilder {
+    constructor(engine, store) {
+        this.useJsonFile = false;
+        this.engine = engine;
+        this.store = store;
+    }
+    for(scopeClass) {
+        this.scopeClass = scopeClass;
+        return this;
+    }
+    withDefaultValue(defaultValue) {
+        return this.withOptions({ defaultValue });
+    }
+    withOptions(options) {
+        const scopeClass = this.scopeClass;
+        // per-instance state (fixes prototype-closure sharing)
+        const values = new WeakMap();
+        const initStarted = new WeakMap();
+        const ensureInit = (instance) => {
+            if (initStarted.has(instance))
+                return;
+            const op = StorPending.start(this.engine, 'init');
+            const p = (async () => {
+                const memberName = ensureInit.__memberName;
+                const kVal = keyValue(scopeClass, memberName);
+                const kDef = keyDefaultValueAlreadySet(scopeClass, memberName);
+                const defProvided = options.defaultValue !== undefined;
+                if (!isBrowser &&
+                    (this.engine === 'localstorage' || this.engine === 'indexeddb')) {
+                    // SSR: just set defaults, no storage
+                    if (defProvided)
+                        values.set(instance, options.defaultValue);
+                    return;
+                }
+                // Browser (or node file/json)
+                if (defProvided) {
+                    const already = await this.store.getItem(kDef);
+                    if (already) {
+                        const stored = await this.store.getItem(kVal);
+                        const v = options.transformFrom
+                            ? options.transformFrom(stored)
+                            : stored;
+                        if (v !== undefined)
+                            values.set(instance, v);
+                        else
+                            values.set(instance, options.defaultValue);
+                    }
+                    else {
+                        await this.store.setItem(kDef, true);
+                        const toDb = options.transformTo
+                            ? options.transformTo(options.defaultValue)
+                            : options.defaultValue;
+                        await this.store.setItem(kVal, toDb);
+                        values.set(instance, options.defaultValue);
+                    }
+                }
+                else {
+                    const stored = await this.store.getItem(kVal);
+                    const v = options.transformFrom
+                        ? options.transformFrom(stored)
+                        : stored;
+                    if (v !== undefined)
+                        values.set(instance, v);
+                }
+            })()
+                .catch(() => {
+                // swallow, keep app alive
+            })
+                .finally(() => StorPending.done(op));
+            initStarted.set(instance, p);
+        };
+        return (target, memberName) => {
+            ensureInit.__memberName = memberName;
+            Object.defineProperty(target, memberName, {
+                configurable: true,
+                enumerable: true,
+                get: function () {
+                    ensureInit(this);
+                    if (values.has(this))
+                        return values.get(this);
+                    if (options.defaultValue !== undefined)
+                        return options.defaultValue;
+                    return undefined;
+                },
+                set: function (newValue) {
+                    values.set(this, newValue);
+                    // if this is the first interaction, init will happen anyway
+                    ensureInit(this);
+                    const op = StorPending.start(target?.engine ?? 'localstorage', 'set');
+                    const scope = scopeClass;
+                    const kVal = keyValue(scope, memberName);
+                    const toDb = options.transformTo
+                        ? options.transformTo(newValue)
+                        : newValue;
+                    Promise.resolve()
+                        .then(() => target)
+                        .then(() => this)
+                        .then(() => this)
+                        .then(async () => {
+                        // If we are SSR + browser engine => no-op
+                        if (!isBrowser && options)
+                            return;
+                        await options; // no-op line to keep TS happy about chaining in some builds
+                    })
+                        .catch(() => {
+                        // ignore
+                    });
+                    // do real store write (async)
+                    Promise.resolve()
+                        .then(async () => {
+                        // SSR guard for browser engines
+                        if (!isBrowser && StorPropertyInLocalStorage) {
+                            return;
+                        }
+                        await thisStoreForEngineWrite(this, kVal, toDb);
+                    })
+                        .catch(() => {
+                        // ignore
+                    })
+                        .finally(() => StorPending.done(op));
+                },
+            });
+            // small helper to keep closure clean
+            const builderStore = this.store;
+            const builderEngine = this.engine;
+            async function thisStoreForEngineWrite(_instance, key, value) {
+                // If browser engines but not browser, skip.
+                if (!isBrowser &&
+                    (builderEngine === 'localstorage' || builderEngine === 'indexeddb'))
+                    return;
+                await builderStore.setItem(key, value);
+            }
+        };
+    }
+    /* optional node-only engines (same builder) */
+    file(filePath) {
+        this.engine = 'file';
+        this.filePath = filePath;
+        this.useJsonFile = false;
+        this.store = new FileStor(filePath, false);
+        return this;
+    }
+    jsonFile(filePath) {
+        this.engine = 'json';
+        this.filePath = filePath;
+        this.useJsonFile = true;
+        this.store = new FileStor(filePath, true);
+        return this;
+    }
+}
+/* ---------------------------
+ * Public: clean API exports
+ * -------------------------- */
+const localStorageStore = isBrowser
+    ? new BrowserLocalStorageStore()
+    : new NoopStore();
+const indexedDbStore = isBrowser
+    ? new BrowserIndexedDbStore()
+    : new NoopStore();
+export class StorPropertyInLocalStorage {
+    static for(scopeClass) {
+        return new StorPropertyBuilder('localstorage', localStorageStore).for(scopeClass);
+    }
+}
+export class StorPropertyInIndexedDb {
+    static for(scopeClass) {
+        return new StorPropertyBuilder('indexeddb', indexedDbStore).for(scopeClass);
+    }
+}
+/**
+ * Helpers
+ */
+export async function uncache(onlyInThisComponentClass, propertyValueToDeleteFromCache) {
+    const scope = onlyInThisComponentClass || { name: '__GLOBAL_NAMESPACE__' };
+    const prop = String(propertyValueToDeleteFromCache);
+    await Promise.all([
+        localStorageStore.removeItem(keyValue(scope, prop)),
+        localStorageStore.removeItem(keyDefaultValueAlreadySet(scope, prop)),
+        indexedDbStore.removeItem(keyValue(scope, prop)),
+        indexedDbStore.removeItem(keyDefaultValueAlreadySet(scope, prop)),
+    ]);
+}
+/**
+ * Backwards-compatible facade:
+ * Stor.property.in.localstorage.for(...).withDefaultValue(...)
+ */
+class TaonStorageFacade {
+    static async awaitPendingOperatios() {
+        await StorPending.awaitPendingOperations();
+    }
+    static get property() {
+        return {
+            in: {
+                get localstorage() {
+                    return new StorPropertyBuilder('localstorage', localStorageStore);
+                },
+                get indexedb() {
+                    return new StorPropertyBuilder('indexeddb', indexedDbStore);
+                },
+                // node-only (safe: dynamic import inside FileStor)
+                file(filePath) {
+                    return new StorPropertyBuilder('file', new FileStor(filePath, false));
+                },
+                jsonFile(filePath) {
+                    return new StorPropertyBuilder('json', new FileStor(filePath, true));
+                },
+            },
+        };
+    }
+}
+export const Stor = TaonStorageFacade;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage",
-  "version": "21.0.18",
+  "version": "21.0.20",
   "scripts": {
     "taon init": "taon init",
     "taon start": "taon start",

package/websql/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage/websql",
-  "version": "21.0.18",
+  "version": "21.0.20",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/websql-prod/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taon-storage/websql-prod",
-  "version": "21.0.18",
+  "version": "21.0.20",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0"

package/lib-prod/index.ts

@@ -1,4 +0,0 @@
-/* */
-/* */
-  
-export * from './storage';

package/lib-prod/lib-info.md

@@ -1,8 +0,0 @@
-THIS FILE IS GENERATED - DO NOT MODIFY
-
-This folder is an entry point for npm Angular/NodeJS library
-
-DON'T USE STUFF FROM PARENT FOLDER app.* FILES HERE (except src/migrations/** files).
-
-THIS FILE IS GENERATED - DO NOT MODIFY
-          

package/lib-prod/migrations/index.ts

@@ -1,2 +0,0 @@
-//@ts-nocheck
-export * from './migrations_index._auto-generated_';

package/lib-prod/migrations/migrations-info.md

@@ -1,6 +0,0 @@
-THIS FILE IS GENERATED - DO NOT MODIFY
-
-This folder is only for storing migration files with auto-generated names.
-
-THIS FILE IS GENERATED - DO NOT MODIFY
-          

package/lib-prod/storage.ts

@@ -1,591 +0,0 @@
-/* taon-storage (native, SSR-safe) */
-import { ___NS__add, ___NS__after, ___NS__ary, ___NS__assign, ___NS__assignIn, ___NS__assignInWith, ___NS__assignWith, ___NS__at, ___NS__attempt, ___NS__before, ___NS__bind, ___NS__bindAll, ___NS__bindKey, ___NS__camelCase, ___NS__capitalize, ___NS__castArray, ___NS__ceil, ___NS__chain, ___NS__chunk, ___NS__clamp, ___NS__clone, ___NS__cloneDeep, ___NS__cloneDeepWith, ___NS__cloneWith, ___NS__compact, ___NS__concat, ___NS__cond, ___NS__conforms, ___NS__conformsTo, ___NS__constant, ___NS__countBy, ___NS__create, ___NS__curry, ___NS__curryRight, ___NS__debounce, ___NS__deburr, ___NS__defaults, ___NS__defaultsDeep, ___NS__defaultTo, ___NS__defer, ___NS__delay, ___NS__difference, ___NS__differenceBy, ___NS__differenceWith, ___NS__divide, ___NS__drop, ___NS__dropRight, ___NS__dropRightWhile, ___NS__dropWhile, ___NS__each, ___NS__eachRight, ___NS__endsWith, ___NS__entries, ___NS__entriesIn, ___NS__eq, ___NS__escape, ___NS__escapeRegExp, ___NS__every, ___NS__extend, ___NS__extendWith, ___NS__fill, ___NS__filter, ___NS__find, ___NS__findIndex, ___NS__findKey, ___NS__findLast, ___NS__findLastIndex, ___NS__findLastKey, ___NS__first, ___NS__flatMap, ___NS__flatMapDeep, ___NS__flatMapDepth, ___NS__flatten, ___NS__flattenDeep, ___NS__flattenDepth, ___NS__flip, ___NS__floor, ___NS__flow, ___NS__flowRight, ___NS__forEach, ___NS__forEachRight, ___NS__forIn, ___NS__forInRight, ___NS__forOwn, ___NS__forOwnRight, ___NS__fromPairs, ___NS__functions, ___NS__functionsIn, ___NS__get, ___NS__groupBy, ___NS__gt, ___NS__gte, ___NS__has, ___NS__hasIn, ___NS__head, ___NS__identity, ___NS__includes, ___NS__indexOf, ___NS__initial, ___NS__inRange, ___NS__intersection, ___NS__intersectionBy, ___NS__intersectionWith, ___NS__invert, ___NS__invertBy, ___NS__invoke, ___NS__invokeMap, ___NS__isArguments, ___NS__isArray, ___NS__isArrayBuffer, ___NS__isArrayLike, ___NS__isArrayLikeObject, ___NS__isBoolean, ___NS__isBuffer, ___NS__isDate, ___NS__isElement, ___NS__isEmpty, ___NS__isEqual, ___NS__isEqualWith, ___NS__isError, ___NS__isFinite, ___NS__isFunction, ___NS__isInteger, ___NS__isLength, ___NS__isMap, ___NS__isMatch, ___NS__isMatchWith, ___NS__isNaN, ___NS__isNative, ___NS__isNil, ___NS__isNull, ___NS__isNumber, ___NS__isObject, ___NS__isObjectLike, ___NS__isPlainObject, ___NS__isRegExp, ___NS__isSafeInteger, ___NS__isSet, ___NS__isString, ___NS__isSymbol, ___NS__isTypedArray, ___NS__isUndefined, ___NS__isWeakMap, ___NS__isWeakSet, ___NS__iteratee, ___NS__join, ___NS__kebabCase, ___NS__keyBy, ___NS__keys, ___NS__keysIn, ___NS__last, ___NS__lastIndexOf, ___NS__lowerCase, ___NS__lowerFirst, ___NS__lt, ___NS__lte, ___NS__map, ___NS__mapKeys, ___NS__mapValues, ___NS__matches, ___NS__matchesProperty, ___NS__max, ___NS__maxBy, ___NS__mean, ___NS__meanBy, ___NS__memoize, ___NS__merge, ___NS__mergeWith, ___NS__method, ___NS__methodOf, ___NS__min, ___NS__minBy, ___NS__mixin, ___NS__multiply, ___NS__negate, ___NS__noop, ___NS__now, ___NS__nth, ___NS__nthArg, ___NS__omit, ___NS__omitBy, ___NS__once, ___NS__orderBy, ___NS__over, ___NS__overArgs, ___NS__overEvery, ___NS__overSome, ___NS__pad, ___NS__padEnd, ___NS__padStart, ___NS__parseInt, ___NS__partial, ___NS__partialRight, ___NS__partition, ___NS__pick, ___NS__pickBy, ___NS__property, ___NS__propertyOf, ___NS__pull, ___NS__pullAll, ___NS__pullAllBy, ___NS__pullAllWith, ___NS__pullAt, ___NS__random, ___NS__range, ___NS__rangeRight, ___NS__rearg, ___NS__reduce, ___NS__reduceRight, ___NS__reject, ___NS__remove, ___NS__repeat, ___NS__replace, ___NS__rest, ___NS__result, ___NS__reverse, ___NS__round, ___NS__sample, ___NS__sampleSize, ___NS__set, ___NS__setWith, ___NS__shuffle, ___NS__size, ___NS__slice, ___NS__snakeCase, ___NS__some, ___NS__sortBy, ___NS__sortedIndex, ___NS__sortedIndexBy, ___NS__sortedIndexOf, ___NS__sortedLastIndex, ___NS__sortedLastIndexBy, ___NS__sortedLastIndexOf, ___NS__sortedUniq, ___NS__sortedUniqBy, ___NS__split, ___NS__spread, ___NS__startCase, ___NS__startsWith, ___NS__stubArray, ___NS__stubFalse, ___NS__stubObject, ___NS__stubString, ___NS__stubTrue, ___NS__subtract, ___NS__sum, ___NS__sumBy, ___NS__tail, ___NS__take, ___NS__takeRight, ___NS__takeRightWhile, ___NS__takeWhile, ___NS__tap, ___NS__template, ___NS__templateSettings, ___NS__throttle, ___NS__thru, ___NS__times, ___NS__toArray, ___NS__toFinite, ___NS__toInteger, ___NS__toLength, ___NS__toLower, ___NS__toNumber, ___NS__toPairs, ___NS__toPairsIn, ___NS__toPath, ___NS__toPlainObject, ___NS__toSafeInteger, ___NS__toString, ___NS__toUpper, ___NS__transform, ___NS__trim, ___NS__trimEnd, ___NS__trimStart, ___NS__truncate, ___NS__unary, ___NS__unescape, ___NS__union, ___NS__unionBy, ___NS__unionWith, ___NS__uniq, ___NS__uniqBy, ___NS__uniqueId, ___NS__uniqWith, ___NS__unset, ___NS__unzip, ___NS__unzipWith, ___NS__update, ___NS__updateWith, ___NS__upperCase, ___NS__upperFirst, ___NS__values, ___NS__valuesIn, ___NS__without, ___NS__words, ___NS__wrap, ___NS__xor, ___NS__xorBy, ___NS__xorWith, ___NS__zip, ___NS__zipObject, ___NS__zipObjectDeep, ___NS__zipWith, UtilsOs__NS__commandExistsAsync, UtilsOs__NS__commandExistsSync, UtilsOs__NS__detectEditor, UtilsOs__NS__Editor, UtilsOs__NS__EDITOR_PROCESSES, UtilsOs__NS__EditorArr, UtilsOs__NS__EditorProcess, UtilsOs__NS__getEditorSettingsJsonPath, UtilsOs__NS__getRealHomeDir, UtilsOs__NS__isBrowser, UtilsOs__NS__isDockerAvailable, UtilsOs__NS__isElectron, UtilsOs__NS__isNode, UtilsOs__NS__isNodeVersionOk, UtilsOs__NS__isPortInUse, UtilsOs__NS__isRunningInBrowser, UtilsOs__NS__isRunningInCliMode, UtilsOs__NS__isRunningInDocker, UtilsOs__NS__isRunningInElectron, UtilsOs__NS__isRunningInLinuxGraphicsCapableEnvironment, UtilsOs__NS__isRunningInMochaTest, UtilsOs__NS__isRunningInNode, UtilsOs__NS__isRunningInOsWithGraphicsCapableEnvironment, UtilsOs__NS__isRunningInSSRMode, UtilsOs__NS__isRunningInVscodeExtension, UtilsOs__NS__isRunningInWebSQL, UtilsOs__NS__isRunningInWindows, UtilsOs__NS__isRunningInWindowsCmd, UtilsOs__NS__isRunningInWindowsPowerShell, UtilsOs__NS__isRunningInWsl, UtilsOs__NS__isRunningNodeDebugger, UtilsOs__NS__isSSRMode, UtilsOs__NS__isVscodeExtension, UtilsOs__NS__isWebSQL, UtilsOs__NS__killAllEditor, UtilsOs__NS__openFolderInFileExplorer, UtilsOs__NS__openFolderInVSCode, UtilsOs__NS__pipxNestedPackageExists, UtilsOs__NS__pipxPackageExists, UtilsOs__NS__pythonModuleExists, UtilsOs__NS__UnknownEditor } from 'tnp-core/lib-prod';
-export type StorageEngine = 'localstorage' | 'indexeddb' | 'file' | 'json';
-
-export interface StorOptions<T = any> {
-  defaultValue?: T;
-  transformFrom?: (valueFromDb: any) => T;
-  transformTo?: (valueToDb: T) => any;
-}
-
-export interface PendingOperation {
-  engine: StorageEngine;
-  id: string;
-  isDone: boolean;
-}
-
-type ClassLike = Function | { name: string } | undefined;
-
-const isBrowser =
-  typeof window !== 'undefined' &&
-  typeof document !== 'undefined' &&
-  typeof navigator !== 'undefined';
-
-function safeLocationPort(): string {
-  try {
-    return (globalThis as any)?.location?.port || 'no-port';
-  } catch {
-    return 'no-port';
-  }
-}
-
-/**
- * Keeps the spirit of your old `storeName = taon-storage_<port>`
- * plus project name namespacing (but without localForage).
- */
-export const storeName = `taon-storage_${safeLocationPort()}`;
-
-function defaultNamespace(): string {
-  const project = ___NS__kebabCase(globalThis['CURRENT_PROJECT_GENERIC_NAME'] ?? '');
-  return project ? `${storeName}_${project}` : storeName;
-}
-
-/**
- * Central config (optional).
- * You can set it once at app bootstrap if you want a stable namespace.
- */
-export const StorConfig = {
-  namespace: defaultNamespace(),
-  indexedDb: {
-    dbName: `${defaultNamespace()}_INDEXEDDB`,
-    storeName: 'keyvaluepairs',
-  },
-};
-
-function normalizeScopeClass(cls: ClassLike): { name: string } {
-  if (!cls) return { name: '__GLOBAL_NAMESPACE__' };
-  // if it's a function/class
-  if (typeof cls === 'function')
-    return { name: (cls as any).name || '__ANON__' };
-  // if it's already object with name
-  return { name: (cls as any).name || '__ANON__' };
-}
-
-export function keyValue(scopeClass: ClassLike, memberName: string) {
-  const c = normalizeScopeClass(scopeClass);
-  return `${StorConfig.namespace}::taon.storage.class.${c.name}.prop.${memberName}`;
-}
-
-export function keyDefaultValueAlreadySet(
-  scopeClass: ClassLike,
-  memberName: string,
-) {
-  return `${keyValue(scopeClass, memberName)}::defaultvalueisset`;
-}
-
-/** Back-compat alias (your old typo) */
-export const keyDefaultValueAreadySet = keyDefaultValueAlreadySet;
-
-/* ---------------------------
- * Stores
- * -------------------------- */
-
-interface AsyncKVStore {
-  getItem<T = any>(key: string): Promise<T | undefined>;
-  setItem<T = any>(key: string, value: T): Promise<void>;
-  removeItem(key: string): Promise<void>;
-}
-
-class NoopStore implements AsyncKVStore {
-  async getItem<T>(_key: string): Promise<T | undefined> {
-    return undefined;
-  }
-  async setItem<T>(_key: string, _value: T): Promise<void> {
-    // noop
-  }
-  async removeItem(_key: string): Promise<void> {
-    // noop
-  }
-}
-
-class BrowserLocalStorageStore implements AsyncKVStore {
-  private ls(): Storage | undefined {
-    if (!isBrowser) return undefined;
-    try {
-      return window.localStorage;
-    } catch {
-      return undefined;
-    }
-  }
-
-  async getItem<T>(key: string): Promise<T | undefined> {
-    const ls = this.ls();
-    if (!ls) return undefined;
-
-    const raw = ls.getItem(key);
-    if (raw === null) return undefined;
-
-    try {
-      return JSON.parse(raw) as T;
-    } catch {
-      // if something stored plain string by older versions
-      return raw as unknown as T;
-    }
-  }
-
-  async setItem<T>(key: string, value: T): Promise<void> {
-    const ls = this.ls();
-    if (!ls) return;
-
-    try {
-      ls.setItem(key, JSON.stringify(value));
-    } catch {
-      // last resort: try as string
-      try {
-        ls.setItem(key, String(value));
-      } catch {
-        // ignore (quota/private mode)
-      }
-    }
-  }
-
-  async removeItem(key: string): Promise<void> {
-    const ls = this.ls();
-    if (!ls) return;
-    try {
-      ls.removeItem(key);
-    } catch {
-      // ignore
-    }
-  }
-}
-
-class BrowserIndexedDbStore implements AsyncKVStore {
-  private dbPromise: Promise<IDBDatabase> | null = null;
-
-  private openDb(): Promise<IDBDatabase> {
-    if (!isBrowser || !(window as any).indexedDB) {
-      return Promise.reject(new Error('IndexedDB not available'));
-    }
-    if (this.dbPromise) return this.dbPromise;
-
-    const { dbName, storeName } = StorConfig.indexedDb;
-
-    this.dbPromise = new Promise<IDBDatabase>((resolve, reject) => {
-      const req = indexedDB.open(dbName, 1);
-
-      req.onupgradeneeded = () => {
-        const db = req.result;
-        if (!db.objectStoreNames.contains(storeName)) {
-          db.createObjectStore(storeName);
-        }
-      };
-
-      req.onsuccess = () => resolve(req.result);
-      req.onerror = () => reject(req.error);
-    });
-
-    return this.dbPromise;
-  }
-
-  private async withStore<T>(
-    mode: IDBTransactionMode,
-    fn: (store: IDBObjectStore) => IDBRequest<T>,
-  ): Promise<T> {
-    const db = await this.openDb();
-    const { storeName } = StorConfig.indexedDb;
-
-    return await new Promise<T>((resolve, reject) => {
-      const tx = db.transaction(storeName, mode);
-      const store = tx.objectStore(storeName);
-      const req = fn(store);
-
-      req.onsuccess = () => resolve(req.result);
-      req.onerror = () => reject(req.error);
-
-      tx.onabort = () => reject(tx.error);
-      // tx.oncomplete => nothing
-    });
-  }
-
-  async getItem<T>(key: string): Promise<T | undefined> {
-    try {
-      const result = await this.withStore('readonly', s => s.get(key));
-      return (result as any) === undefined ? undefined : (result as any);
-    } catch {
-      return undefined;
-    }
-  }
-
-  async setItem<T>(key: string, value: T): Promise<void> {
-    try {
-      await this.withStore('readwrite', s => s.put(value as any, key));
-    } catch {
-      // ignore
-    }
-  }
-
-  async removeItem(key: string): Promise<void> {
-    try {
-      await this.withStore('readwrite', s => s.delete(key) as any);
-    } catch {
-      // ignore
-    }
-  }
-}
-
-/**
- * Node-side file storage (optional). No top-level node imports (Angular-safe).
- * Works only when executed in Node.
- */
-class FileStor implements AsyncKVStore {
-  constructor(
-    private filePath: string,
-    private useJSON = false,
-  ) {}
-
-  private isNodeRuntime() {
-    return UtilsOs__NS__isNode;
-    // return (
-    //   typeof process !== 'undefined' &&
-    //   !!(process as any).versions?.node &&
-    //   typeof (globalThis as any).window === 'undefined'
-    // );
-  }
-
-  async setItem<T>(_key: string, value: T): Promise<void> {
-    if (!this.isNodeRuntime()) return;
-    //#region @backendFunc
-    const fs = await import('node:fs/promises');
-    const data = this.useJSON ? JSON.stringify(value, null, 2) : (value as any);
-
-    if (this.useJSON) {
-      await fs.writeFile(this.filePath, String(data), 'utf8');
-    } else {
-      await fs.writeFile(this.filePath, String(data), 'utf8');
-    }
-    //#endregion
-  }
-
-  async getItem<T>(_key: string): Promise<T | undefined> {
-    if (!this.isNodeRuntime()) return undefined;
-    //#region @backendFunc
-    const fs = await import('node:fs/promises');
-
-    try {
-      const buf = await fs.readFile(this.filePath, 'utf8');
-      if (!this.useJSON) return buf as any as T;
-      return JSON.parse(buf) as T;
-    } catch {
-      return undefined;
-    }
-    //#endregion
-  }
-
-  async removeItem(_key: string): Promise<void> {
-    if (!this.isNodeRuntime()) return;
-    //#region @backendFunc
-    const fs = await import('node:fs/promises');
-    try {
-      await fs.rm(this.filePath, { force: true });
-    } catch {
-      // ignore
-    }
-    //#endregion
-  }
-}
-
-/* ---------------------------
- * Pending ops (so you can still await)
- * -------------------------- */
-
-class StorPending {
-  static pending: PendingOperation[] = [];
-  static id = 0;
-  static AWAITING_INTERVAL_TIME = 200;
-
-  static async awaitPendingOperations(id = StorPending.id++): Promise<void> {
-    if (id > Number.MAX_SAFE_INTEGER - 2) {
-      StorPending.id = 0;
-      id = StorPending.id++;
-    }
-
-    const pending = StorPending.pending;
-
-    for (const op of pending) {
-      if (!op.isDone) {
-        await new Promise<void>(resolve => {
-          setTimeout(async () => {
-            await StorPending.awaitPendingOperations(id);
-            resolve();
-          }, StorPending.AWAITING_INTERVAL_TIME);
-        });
-        return;
-      }
-    }
-
-    // cleanup
-    StorPending.pending = pending.filter(p => !p.isDone);
-  }
-
-  static start(engine: StorageEngine, id: string): PendingOperation {
-    const op: PendingOperation = { engine, id, isDone: false };
-    StorPending.pending.push(op);
-    return op;
-  }
-
-  static done(op: PendingOperation) {
-    op.isDone = true;
-  }
-}
-
-/* ---------------------------
- * Decorator builder
- * -------------------------- */
-
-class StorPropertyBuilder {
-  private scopeClass?: ClassLike;
-  private engine: StorageEngine;
-  private store: AsyncKVStore;
-  private filePath?: string;
-  private useJsonFile = false;
-
-  constructor(engine: StorageEngine, store: AsyncKVStore) {
-    this.engine = engine;
-    this.store = store;
-  }
-
-  for(scopeClass?: ClassLike) {
-    this.scopeClass = scopeClass;
-    return this;
-  }
-
-  withDefaultValue<T = any>(defaultValue: T) {
-    return this.withOptions<T>({ defaultValue });
-  }
-
-  withOptions<T = any>(options: StorOptions<T>) {
-    const scopeClass = this.scopeClass;
-
-    // per-instance state (fixes prototype-closure sharing)
-    const values = new WeakMap<object, T>();
-    const initStarted = new WeakMap<object, Promise<void>>();
-
-    const ensureInit = (instance: object) => {
-      if (initStarted.has(instance)) return;
-
-      const op = StorPending.start(this.engine, 'init');
-      const p = (async () => {
-        const memberName = (ensureInit as any).__memberName as string;
-
-        const kVal = keyValue(scopeClass, memberName);
-        const kDef = keyDefaultValueAlreadySet(scopeClass, memberName);
-
-        const defProvided = options.defaultValue !== undefined;
-
-        if (
-          !isBrowser &&
-          (this.engine === 'localstorage' || this.engine === 'indexeddb')
-        ) {
-          // SSR: just set defaults, no storage
-          if (defProvided) values.set(instance, options.defaultValue as T);
-          return;
-        }
-
-        // Browser (or node file/json)
-        if (defProvided) {
-          const already = await this.store.getItem<boolean>(kDef);
-          if (already) {
-            const stored = await this.store.getItem<any>(kVal);
-            const v = options.transformFrom
-              ? options.transformFrom(stored)
-              : stored;
-            if (v !== undefined) values.set(instance, v as T);
-            else values.set(instance, options.defaultValue as T);
-          } else {
-            await this.store.setItem(kDef, true);
-            const toDb = options.transformTo
-              ? options.transformTo(options.defaultValue as T)
-              : (options.defaultValue as any);
-            await this.store.setItem(kVal, toDb);
-            values.set(instance, options.defaultValue as T);
-          }
-        } else {
-          const stored = await this.store.getItem<any>(kVal);
-          const v = options.transformFrom
-            ? options.transformFrom(stored)
-            : stored;
-          if (v !== undefined) values.set(instance, v as T);
-        }
-      })()
-        .catch(() => {
-          // swallow, keep app alive
-        })
-        .finally(() => StorPending.done(op));
-
-      initStarted.set(instance, p);
-    };
-
-    return (target: any, memberName: string) => {
-      (ensureInit as any).__memberName = memberName;
-
-      Object.defineProperty(target, memberName, {
-        configurable: true,
-        enumerable: true,
-        get: function () {
-          ensureInit(this);
-
-          if (values.has(this)) return values.get(this);
-          if (options.defaultValue !== undefined) return options.defaultValue;
-          return undefined;
-        },
-        set: function (newValue: T) {
-          values.set(this, newValue);
-
-          // if this is the first interaction, init will happen anyway
-          ensureInit(this);
-
-          const op = StorPending.start(
-            (target as any)?.engine ?? 'localstorage',
-            'set',
-          );
-
-          const scope = scopeClass;
-          const kVal = keyValue(scope, memberName);
-
-          const toDb = options.transformTo
-            ? options.transformTo(newValue)
-            : (newValue as any);
-
-          Promise.resolve()
-            .then(() => target as any)
-            .then(() => this as any)
-            .then(() => this as any)
-            .then(async () => {
-              // If we are SSR + browser engine => no-op
-              if (!isBrowser && (options as any)) return;
-              await (options as any); // no-op line to keep TS happy about chaining in some builds
-            })
-            .catch(() => {
-              // ignore
-            });
-
-          // do real store write (async)
-          Promise.resolve()
-            .then(async () => {
-              // SSR guard for browser engines
-              if (!isBrowser && (StorPropertyInLocalStorage as any)) {
-                return;
-              }
-              await thisStoreForEngineWrite(this, kVal, toDb);
-            })
-            .catch(() => {
-              // ignore
-            })
-            .finally(() => StorPending.done(op));
-        },
-      });
-
-      // small helper to keep closure clean
-      const builderStore = this.store;
-      const builderEngine = this.engine;
-
-      async function thisStoreForEngineWrite(
-        _instance: any,
-        key: string,
-        value: any,
-      ) {
-        // If browser engines but not browser, skip.
-        if (
-          !isBrowser &&
-          (builderEngine === 'localstorage' || builderEngine === 'indexeddb')
-        )
-          return;
-        await builderStore.setItem(key, value);
-      }
-    };
-  }
-
-  /* optional node-only engines (same builder) */
-  file(filePath: string) {
-    this.engine = 'file';
-    this.filePath = filePath;
-    this.useJsonFile = false;
-    this.store = new FileStor(filePath, false);
-    return this;
-  }
-
-  jsonFile(filePath: string) {
-    this.engine = 'json';
-    this.filePath = filePath;
-    this.useJsonFile = true;
-    this.store = new FileStor(filePath, true);
-    return this;
-  }
-}
-
-/* ---------------------------
- * Public: clean API exports
- * -------------------------- */
-
-const localStorageStore: AsyncKVStore = isBrowser
-  ? new BrowserLocalStorageStore()
-  : new NoopStore();
-const indexedDbStore: AsyncKVStore = isBrowser
-  ? new BrowserIndexedDbStore()
-  : new NoopStore();
-
-export class StorPropertyInLocalStorage {
-  static for(scopeClass?: ClassLike) {
-    return new StorPropertyBuilder('localstorage', localStorageStore).for(
-      scopeClass,
-    );
-  }
-}
-
-export class StorPropertyInIndexedDb {
-  static for(scopeClass?: ClassLike) {
-    return new StorPropertyBuilder('indexeddb', indexedDbStore).for(scopeClass);
-  }
-}
-
-/**
- * Helpers
- */
-export async function uncache<CLASS_FUNCTION = any>(
-  onlyInThisComponentClass: CLASS_FUNCTION,
-  propertyValueToDeleteFromCache: keyof CLASS_FUNCTION,
-) {
-  const scope =
-    onlyInThisComponentClass || ({ name: '__GLOBAL_NAMESPACE__' } as any);
-  const prop = String(propertyValueToDeleteFromCache);
-
-  await Promise.all([
-    localStorageStore.removeItem(keyValue(scope as any, prop)),
-    localStorageStore.removeItem(keyDefaultValueAlreadySet(scope as any, prop)),
-    indexedDbStore.removeItem(keyValue(scope as any, prop)),
-    indexedDbStore.removeItem(keyDefaultValueAlreadySet(scope as any, prop)),
-  ]);
-}
-
-/**
- * Backwards-compatible facade:
- * Stor.property.in.localstorage.for(...).withDefaultValue(...)
- */
-class TaonStorageFacade {
-  static async awaitPendingOperatios() {
-    await StorPending.awaitPendingOperations();
-  }
-
-  static get property() {
-    return {
-      in: {
-        get localstorage() {
-          return new StorPropertyBuilder('localstorage', localStorageStore);
-        },
-        get indexedb() {
-          return new StorPropertyBuilder('indexeddb', indexedDbStore);
-        },
-        // node-only (safe: dynamic import inside FileStor)
-        file(filePath: string) {
-          return new StorPropertyBuilder('file', new FileStor(filePath, false));
-        },
-        jsonFile(filePath: string) {
-          return new StorPropertyBuilder('json', new FileStor(filePath, true));
-        },
-      },
-    };
-  }
-}
-
-export const Stor = TaonStorageFacade;