@decohere/core 0.0.1-dev.118 → 0.0.1-dev.119

package/commonjs/src/caching/cache-manager.js

@@ -16,7 +16,7 @@ _export(exports, {
         return Caching;
     }
 });
-const _nodecachememoizeadapter = require("./node-cache-memoize.adapter.js");
+const _mapcache = require("./map-cache.js");
 const Caches = {
     default: "DEFAULT",
     memoize: "MEMOIZE_CACHE"
@@ -40,8 +40,8 @@ const Caches = {
 	 */ getCache(name, memoize = false) {
         const cacheName = name ?? this.defaultCacheName;
         if (!this.caches.has(cacheName)) {
-            const cache = _nodecachememoizeadapter.NodeCacheAdapter.create({
-                enableMemoization: memoize
+            const cache = new _mapcache.MapCache({
+                memoize
             });
             this.caches.set(cacheName, cache);
         }

package/commonjs/src/caching/index.js

@@ -7,7 +7,7 @@ _export_star(require("./cache.js"), exports);
 _export_star(require("./cache-manager.js"), exports);
 _export_star(require("./invalidate-cache.decorator.js"), exports);
 _export_star(require("./memoize.decorator.js"), exports);
-_export_star(require("./node-cache-memoize.adapter.js"), exports);
+_export_star(require("./map-cache.js"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {
         if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {

package/commonjs/src/caching/map-cache.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "MapCache", {
+    enumerable: true,
+    get: function() {
+        return MapCache;
+    }
+});
+class MapCache {
+    #entries = new Map();
+    #memoize;
+    constructor(options = {}){
+        this.#memoize = options.memoize ?? false;
+    }
+    get isMemoize() {
+        return this.#memoize;
+    }
+    get(key) {
+        const value = this.#entries.get(key);
+        if (this.#memoize || value === null || typeof value !== "object") {
+            return value;
+        }
+        return structuredClone(value);
+    }
+    set(key, value) {
+        this.#entries.set(key, value);
+    }
+    has(key) {
+        return this.#entries.has(key);
+    }
+    del(key) {
+        this.#entries.delete(key);
+    }
+    flushAll() {
+        this.#entries.clear();
+    }
+}

package/commonjs/src/io/io.js

@@ -6,12 +6,9 @@ _export_star(require("./copy-file.js"), exports);
 _export_star(require("./delete-file.js"), exports);
 _export_star(require("./directory-exists.js"), exports);
 _export_star(require("./file-exists.js"), exports);
-_export_star(require("./find-directories.js"), exports);
-_export_star(require("./find-file.js"), exports);
 _export_star(require("./read-file.js"), exports);
 _export_star(require("./remove-dir.js"), exports);
 _export_star(require("./url-to-path.js"), exports);
-_export_star(require("./watch.js"), exports);
 _export_star(require("./write-file.js"), exports);
 function _export_star(from, to) {
     Object.keys(from).forEach(function(k) {

package/es6/src/caching/cache-manager.js

@@ -1,4 +1,4 @@
-import { NodeCacheAdapter } from "./node-cache-memoize.adapter.js";
+import { MapCache } from "./map-cache.js";
 export const Caches = {
     default: "DEFAULT",
     memoize: "MEMOIZE_CACHE"
@@ -22,8 +22,8 @@ export const Caches = {
 	 */ getCache(name, memoize = false) {
         const cacheName = name ?? this.defaultCacheName;
         if (!this.caches.has(cacheName)) {
-            const cache = NodeCacheAdapter.create({
-                enableMemoization: memoize
+            const cache = new MapCache({
+                memoize
             });
             this.caches.set(cacheName, cache);
         }

package/es6/src/caching/index.js

@@ -3,4 +3,4 @@ export * from "./cache.js";
 export * from "./cache-manager.js";
 export * from "./invalidate-cache.decorator.js";
 export * from "./memoize.decorator.js";
-export * from "./node-cache-memoize.adapter.js";
+export * from "./map-cache.js";

package/es6/src/caching/map-cache.js

@@ -0,0 +1,35 @@
+/**
+ * The built-in cache: a plain `Map`, no expiry.
+ *
+ * By default `get` returns a `structuredClone` of an object, so a caller that changes what it
+ * got back can't change the cached value. With `memoize` it returns the stored reference.
+ * Scalars, `null` and `undefined` are returned as they are.
+ */ export class MapCache {
+    #entries = new Map();
+    #memoize;
+    constructor(options = {}){
+        this.#memoize = options.memoize ?? false;
+    }
+    get isMemoize() {
+        return this.#memoize;
+    }
+    get(key) {
+        const value = this.#entries.get(key);
+        if (this.#memoize || value === null || typeof value !== "object") {
+            return value;
+        }
+        return structuredClone(value);
+    }
+    set(key, value) {
+        this.#entries.set(key, value);
+    }
+    has(key) {
+        return this.#entries.has(key);
+    }
+    del(key) {
+        this.#entries.delete(key);
+    }
+    flushAll() {
+        this.#entries.clear();
+    }
+}

package/es6/src/caching/memoize.decorator.js

@@ -2,7 +2,7 @@ import { CacheDecorator } from "./cache.decorator.js";
 import { Caches, Caching } from "./cache-manager.js";
 /**
  * Memoize decorator class that extends CacheDecorator with memoization support
- * Automatically uses a memoization-capable cache (NodeCache with useClones: false)
+ * Automatically uses a memoization-capable cache (a MapCache that hands out references)
  */ export class MemoizeDecorator extends CacheDecorator {
     decorator(target, propertyKey, descriptor) {
         const cache = this.options?.cache ?? Caching.getCache(this.options?.name ?? Caches.memoize, true);

package/es6/src/io/io.js

@@ -2,10 +2,7 @@ export * from "./copy-file.js";
 export * from "./delete-file.js";
 export * from "./directory-exists.js";
 export * from "./file-exists.js";
-export * from "./find-directories.js";
-export * from "./find-file.js";
 export * from "./read-file.js";
 export * from "./remove-dir.js";
 export * from "./url-to-path.js";
-export * from "./watch.js";
 export * from "./write-file.js";

package/package.json

@@ -1,15 +1,13 @@
 {
   "name": "@decohere/core",
-  "version": "0.0.1-dev.118",
-  "description": "Core utility library — collections, caching, IO, CLI primitives, reflection, and composition",
+  "version": "0.0.1-dev.119",
+  "description": "The runtime base every Decohere package builds on: reflection, composition, configuration types, extensibility, collections, objects, caching on a Map, and basic file IO. No side effects on import.",
   "keywords": [
     "typescript",
     "utilities",
-    "collections",
-    "caching",
-    "io",
-    "cli",
     "reflection",
+    "composition",
+    "caching",
     "decohere"
   ],
   "license": "ISC",
@@ -37,11 +35,6 @@
       "import": "./es6/src/extensibility/index.js",
       "require": "./commonjs/src/extensibility/index.js"
     },
-    "./interop": {
-      "types": "./types/src/interop/index.d.ts",
-      "import": "./es6/src/interop/index.js",
-      "require": "./commonjs/src/interop/index.js"
-    },
     "./io": {
       "types": "./types/src/io/index.d.ts",
       "import": "./es6/src/io/index.js",
@@ -62,45 +55,18 @@
       "import": "./es6/src/system/index.js",
       "require": "./commonjs/src/system/index.js"
     },
-    "./semver": {
-      "types": "./types/src/semver/index.d.ts",
-      "import": "./es6/src/semver/index.js",
-      "require": "./commonjs/src/semver/index.js"
-    },
-    "./testing": {
-      "types": "./types/src/testing/index.d.ts",
-      "import": "./es6/src/testing/index.js",
-      "require": "./commonjs/src/testing/index.js"
-    },
     "./composition": {
       "types": "./types/src/composition/index.d.ts",
       "import": "./es6/src/composition/index.js",
       "require": "./commonjs/src/composition/index.js"
-    },
-    "./cli": {
-      "types": "./types/src/cli/index.d.ts",
-      "import": "./es6/src/cli/index.js",
-      "require": "./commonjs/src/cli/index.js"
-    },
-    "./diagnostics": {
-      "types": "./types/src/diagnostics/index.d.ts",
-      "import": "./es6/src/diagnostics/index.js",
-      "require": "./commonjs/src/diagnostics/index.js"
     }
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "dependencies": {
-    "@cacheable/node-cache": "^2.0.1",
-    "@decohere/scribe": "0.0.1-dev.118",
-    "commander": "^13.1.0",
-    "glob": "^13.0.1",
-    "picomatch": "^4.0.4",
+    "@decohere/scribe": "0.0.1-dev.119",
     "reflect-metadata": "^0.2.2"
   },
-  "devDependencies": {
-    "memfs": "^4.17.0",
-    "vitest": "^3.2.6"
-  }
+  "devDependencies": {}
 }

package/types/src/caching/index.d.ts

@@ -3,4 +3,4 @@ export * from "./cache.js";
 export * from "./cache-manager.js";
 export * from "./invalidate-cache.decorator.js";
 export * from "./memoize.decorator.js";
-export * from "./node-cache-memoize.adapter.js";
+export * from "./map-cache.js";

package/types/src/caching/map-cache.d.ts

@@ -0,0 +1,23 @@
+import type { ICache } from "./cache.js";
+type MapCacheOptions = {
+    /** Hand out the stored reference instead of a copy (what `@memoize` needs). */
+    memoize?: boolean;
+};
+/**
+ * The built-in cache: a plain `Map`, no expiry.
+ *
+ * By default `get` returns a `structuredClone` of an object, so a caller that changes what it
+ * got back can't change the cached value. With `memoize` it returns the stored reference.
+ * Scalars, `null` and `undefined` are returned as they are.
+ */
+export declare class MapCache implements ICache {
+    #private;
+    constructor(options?: MapCacheOptions);
+    get isMemoize(): boolean;
+    get(key: string): unknown;
+    set(key: string, value: unknown): void;
+    has(key: string): boolean;
+    del(key: string): void;
+    flushAll(): void;
+}
+export {};

package/types/src/caching/memoize.decorator.d.ts

@@ -1,7 +1,7 @@
 import { CacheDecorator } from "./cache.decorator.js";
 /**
  * Memoize decorator class that extends CacheDecorator with memoization support
- * Automatically uses a memoization-capable cache (NodeCache with useClones: false)
+ * Automatically uses a memoization-capable cache (a MapCache that hands out references)
  */
 export declare class MemoizeDecorator extends CacheDecorator {
     decorator(target: object, propertyKey: string, descriptor: PropertyDescriptor): void;

package/types/src/io/io.d.ts

@@ -2,10 +2,7 @@ export * from "./copy-file.js";
 export * from "./delete-file.js";
 export * from "./directory-exists.js";
 export * from "./file-exists.js";
-export * from "./find-directories.js";
-export * from "./find-file.js";
 export * from "./read-file.js";
 export * from "./remove-dir.js";
 export * from "./url-to-path.js";
-export * from "./watch.js";
 export * from "./write-file.js";

package/commonjs/src/caching/node-cache-memoize.adapter.js

@@ -1,49 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "NodeCacheAdapter", {
-    enumerable: true,
-    get: function() {
-        return NodeCacheAdapter;
-    }
-});
-const _nodecache = /*#__PURE__*/ _interop_require_default(require("@cacheable/node-cache"));
-function _interop_require_default(obj) {
-    return obj && obj.__esModule ? obj : {
-        default: obj
-    };
-}
-class NodeCacheAdapter {
-    static create(options = {
-        enableMemoization: false
-    }) {
-        const nodeCache = new _nodecache.default({
-            useClones: !options.enableMemoization
-        });
-        return new NodeCacheAdapter(nodeCache);
-    }
-    supportsMemoization = true;
-    cache;
-    constructor(inst = new _nodecache.default()){
-        this.cache = inst;
-    }
-    get isMemoize() {
-        return !this.cache.options.useClones;
-    }
-    get(key) {
-        return this.cache.get(key);
-    }
-    set(key, value) {
-        this.cache.set(key, value);
-    }
-    has(key) {
-        return this.cache.has(key);
-    }
-    del(key) {
-        this.cache.del(key);
-    }
-    flushAll() {
-        this.cache.flushAll();
-    }
-}

package/commonjs/src/cli/action.js

@@ -1,65 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get ActionMap () {
-        return ActionMap;
-    },
-    get ActionResponse () {
-        return ActionResponse;
-    }
-});
-const ActionMap = Symbol("ActionMap");
-class ActionResponse {
-    static Success(name, data) {
-        return new ActionResponse({
-            name,
-            data,
-            succeeded: true
-        });
-    }
-    static Skipped(name) {
-        return new ActionResponse({
-            name,
-            skipped: true
-        });
-    }
-    static Blocking(name) {
-        return new ActionResponse({
-            name,
-            succeeded: true,
-            blocking: true
-        });
-    }
-    static Error(name, messageOrData, data) {
-        if (Array.isArray(messageOrData)) {
-            const message = messageOrData.filter((r)=>!r.succeeded).map((r)=>r.error ?? "Unknown error").join("\n");
-            return new ActionResponse({
-                name,
-                message,
-                data: messageOrData
-            });
-        }
-        return new ActionResponse({
-            name,
-            message: messageOrData,
-            data
-        });
-    }
-    constructor(data){
-        Object.assign(this, data);
-    }
-    name;
-    succeeded = false;
-    skipped = false;
-    blocking = false;
-    message;
-    data;
-}

package/commonjs/src/cli/command.js

@@ -1,127 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get CommandError () {
-        return CommandError;
-    },
-    get CommandResponse () {
-        return CommandResponse;
-    },
-    get DecohereCommand () {
-        return DecohereCommand;
-    }
-});
-const _commander = require("commander");
-const CommandResponse = {
-    success (_ctx, responses) {
-        return responses;
-    },
-    help () {
-        return {};
-    },
-    fromAction (name, response) {
-        return {
-            [name]: response
-        };
-    }
-};
-class CommandError extends Error {
-}
-class DecohereCommand extends _commander.Command {
-    get actions() {
-        return [];
-    }
-    constructor(name, handler){
-        super();
-        if (typeof name === "string" || typeof name === "function") {
-            this.name(this.parseCommandName(name));
-        } else {
-            this.name(this.parseCommandName(this.constructor));
-            if (name) {
-                this.registerSubcommand(name, handler);
-            }
-        }
-        if (handler && !this.commands.length) {
-            this.action(handler);
-        }
-        this.exitOverride();
-    }
-    /**
-	 * Whether the command, with these options, runs until it is stopped (`flux serve`,
-	 * `forge build --watch`). The CLI then listens for SIGINT and SIGTERM from the moment it
-	 * starts, so a stop during start-up still shuts down cleanly; other commands keep Node's
-	 * default, where Ctrl+C ends them at once.
-	 */ runsUntilStopped(_options) {
-        return false;
-    }
-    async run(actions, options) {
-        const responses = await this.runActions(actions, options);
-        this.throwOnErrors(responses);
-        return CommandResponse.success(options, responses);
-    }
-    registerSubcommand(commands, onAction) {
-        if (typeof commands === "function") {
-            const instance = new commands(commands, onAction);
-            this.addCommand(instance);
-            if (onAction && !instance.commands.length) {
-                instance.action(onAction);
-            }
-            return;
-        }
-        for (const [key, command] of Object.entries(commands)){
-            const instance = command instanceof DecohereCommand ? command : new command(key, onAction);
-            this.addCommand(instance);
-            if (onAction && !instance.commands.length) {
-                instance.action(onAction);
-            }
-        }
-    }
-    async runActions(actions, options) {
-        const selectedActions = this.getSelectedActions(actions);
-        const responses = {};
-        for (const [actionKey, action] of selectedActions){
-            responses[actionKey] = await action.run(options);
-        }
-        return responses;
-    }
-    getSelectedActions(actions) {
-        if (!this.actions.length) {
-            return [];
-        }
-        const actionEntries = Object.entries(actions);
-        return this.actions.map((ActionClass)=>{
-            const selectedAction = actionEntries.find(([, action])=>action instanceof ActionClass);
-            if (!selectedAction) {
-                throw new CommandError(`${this.name()} command missing action instance for ${ActionClass.name}`);
-            }
-            return selectedAction;
-        });
-    }
-    throwOnErrors(responses) {
-        const failures = Object.entries(responses).filter(([, response])=>{
-            if (!response) {
-                return false;
-            }
-            return !response.succeeded && !response.skipped;
-        });
-        if (!failures.length) {
-            return;
-        }
-        throw new CommandError(`${this.name()} command failed. ${failures.map(([actionName, response])=>`${actionName}: ${response?.message ?? "Unknown error"}`).join("\n")}`);
-    }
-    parseCommandName(stringLike) {
-        const command = typeof stringLike === "string" ? stringLike : stringLike.name?.toLowerCase().replace("command", "") ?? "";
-        if (command === "") {
-            throw new CommandError(`Could not parse command name from ${stringLike.toString()}`);
-        }
-        return command;
-    }
-}

package/commonjs/src/cli/index.js

@@ -1,61 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get ActionMap () {
-        return _action.ActionMap;
-    },
-    get ActionResponse () {
-        return _action.ActionResponse;
-    },
-    get CommandError () {
-        return _command.CommandError;
-    },
-    get CommandResponse () {
-        return _command.CommandResponse;
-    },
-    get ConfigFileOption () {
-        return _options.ConfigFileOption;
-    },
-    get ConfigurationOption () {
-        return _options.ConfigurationOption;
-    },
-    get DecohereCommand () {
-        return _command.DecohereCommand;
-    },
-    get DryRunOption () {
-        return _options.DryRunOption;
-    },
-    get EnvFileIfExistsOption () {
-        return _options.EnvFileIfExistsOption;
-    },
-    get EnvFileOption () {
-        return _options.EnvFileOption;
-    },
-    get LogLevelOption () {
-        return _options.LogLevelOption;
-    },
-    get ModuleManifest () {
-        return _moduletype.ModuleManifest;
-    },
-    get NoBuildOptions () {
-        return _options.NoBuildOptions;
-    },
-    get NoCleanOptions () {
-        return _options.NoCleanOptions;
-    },
-    get ProjectOption () {
-        return _options.ProjectOption;
-    }
-});
-const _action = require("./action.js");
-const _command = require("./command.js");
-const _moduletype = require("./module.type.js");
-const _options = require("./options.js");

package/commonjs/src/cli/module.type.js

@@ -1,18 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "ModuleManifest", {
-    enumerable: true,
-    get: function() {
-        return ModuleManifest;
-    }
-});
-class ModuleManifest {
-    /** Sub-command classes this module contributes. */ commands = {};
-    /** Action classes this module contributes. */ actions = {};
-    /** Register infrastructure services into the DI container. */ registerServices(_builder) {}
-    /** Lazily create a workspace instance. Return null if this module does not use a workspace. */ createWorkspace(_options) {
-        return Promise.resolve(null);
-    }
-}