smart-lifecycle 0.1.1

package/dist/utils/object-registry.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Interface for ID generation strategies
+ */
+export interface IIdGenerator {
+    generate(): string;
+}
+/**
+ * Default ID generator using timestamp and counter
+ */
+export declare class TimestampIdGenerator implements IIdGenerator {
+    private counter;
+    generate(): string;
+}
+/**
+ * Contract for the Object Registry
+ */
+export interface IObjectRegistry {
+    set<T>(value: T): string;
+    get<T>(id: string): T | undefined;
+    has(id: string): boolean;
+    delete(id: string): void;
+    watch<T>(id: string, cb: (value: T | undefined) => void): () => void;
+    update<T>(id: string, value: T): void;
+}
+/**
+ * ObjectRegistry - Manages object references for attribute-based component communication
+ *
+ * Uses WeakMap and WeakRef to allow garbage collection of unused objects:
+ * - Objects are registered with unique IDs
+ * - IDs can be passed through DOM attributes (strings)
+ * - Objects are automatically cleaned up when no longer referenced
+ *
+ * Usage:
+ * ```typescript
+ * const items = [{ id: 1, name: 'Item 1' }];
+ * const id = ObjectRegistry.set(items); // "__obj_abc123"
+ *
+ * const retrieved = ObjectRegistry.get(id); // Returns the array
+ *
+ * // React to updates:
+ * const unwatch = ObjectRegistry.watch(id, (next) => console.log(next));
+ * ObjectRegistry.update(id, [...items, { id: 2 }]);
+ * ```
+ */
+export declare class WeakRefObjectRegistry implements IObjectRegistry {
+    private idGenerator;
+    private idToEntry;
+    private watchers;
+    constructor(idGenerator?: IIdGenerator);
+    set<T>(value: T): string;
+    get<T>(id: string): T | undefined;
+    has(id: string): boolean;
+    delete(id: string): void;
+    watch<T>(id: string, cb: (value: T | undefined) => void): () => void;
+    update<T>(id: string, value: T): void;
+    private storeEntry;
+    private resolveEntry;
+    private isObjectLike;
+    private notifyWatchers;
+}
+/**
+ * Token for dependency injection referencing the ObjectRegistry service.
+ * Use with Services.register() for custom implementations.
+ *
+ * @example
+ * ```typescript
+ * Services.register(ObjectRegistryToken, () => customRegistry);
+ * ```
+ */
+export declare const ObjectRegistryToken: "ObjectRegistry";
+//# sourceMappingURL=object-registry.d.ts.map

package/dist/utils/object-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-registry.d.ts","sourceRoot":"","sources":["../../src/utils/object-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,IAAI,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CAAC,OAAO,CAAK;IAEpB,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;IACzB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACrE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;CACvC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,qBAAsB,YAAW,eAAe;IAO/C,OAAO,CAAC,WAAW;IAN/B,OAAO,CAAC,SAAS,CAGb;IACJ,OAAO,CAAC,QAAQ,CAAoD;gBAEhD,WAAW,GAAE,YAAyC;IAE1E,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;IAMxB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAIjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAMxB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAgBpE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IASrC,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,YAAY;IAiBpB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;CAevB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAC"}

package/dist/utils/object-registry.js

@@ -0,0 +1,126 @@
+/**
+ * Default ID generator using timestamp and counter
+ */
+export class TimestampIdGenerator {
+    counter = 0;
+    generate() {
+        return `__obj_${Date.now()}_${this.counter++}`;
+    }
+}
+/**
+ * ObjectRegistry - Manages object references for attribute-based component communication
+ *
+ * Uses WeakMap and WeakRef to allow garbage collection of unused objects:
+ * - Objects are registered with unique IDs
+ * - IDs can be passed through DOM attributes (strings)
+ * - Objects are automatically cleaned up when no longer referenced
+ *
+ * Usage:
+ * ```typescript
+ * const items = [{ id: 1, name: 'Item 1' }];
+ * const id = ObjectRegistry.set(items); // "__obj_abc123"
+ *
+ * const retrieved = ObjectRegistry.get(id); // Returns the array
+ *
+ * // React to updates:
+ * const unwatch = ObjectRegistry.watch(id, (next) => console.log(next));
+ * ObjectRegistry.update(id, [...items, { id: 2 }]);
+ * ```
+ */
+export class WeakRefObjectRegistry {
+    idGenerator;
+    idToEntry = new Map();
+    watchers = new Map();
+    constructor(idGenerator = new TimestampIdGenerator()) {
+        this.idGenerator = idGenerator;
+    }
+    set(value) {
+        const id = this.idGenerator.generate();
+        this.storeEntry(id, value);
+        return id;
+    }
+    get(id) {
+        return this.resolveEntry(id);
+    }
+    has(id) {
+        return this.get(id) !== undefined;
+    }
+    delete(id) {
+        this.notifyWatchers(id, undefined);
+        this.watchers.delete(id);
+        this.idToEntry.delete(id);
+    }
+    watch(id, cb) {
+        const watcherSet = this.watchers.get(id) ?? new Set();
+        watcherSet.add(cb);
+        this.watchers.set(id, watcherSet);
+        return () => {
+            const current = this.watchers.get(id);
+            if (!current)
+                return;
+            current.delete(cb);
+            if (current.size === 0) {
+                this.watchers.delete(id);
+            }
+        };
+    }
+    update(id, value) {
+        if (!this.idToEntry.has(id)) {
+            throw new Error(`[ObjectRegistry] Attempted to update unknown id: ${id}`);
+        }
+        this.storeEntry(id, value);
+        this.notifyWatchers(id, this.get(id));
+    }
+    storeEntry(id, value) {
+        if (this.isObjectLike(value)) {
+            this.idToEntry.set(id, {
+                type: "object",
+                ref: new WeakRef(value),
+            });
+            return;
+        }
+        this.idToEntry.set(id, { type: "value", value });
+    }
+    resolveEntry(id) {
+        const entry = this.idToEntry.get(id);
+        if (!entry)
+            return undefined;
+        if (entry.type === "value") {
+            return entry.value;
+        }
+        const obj = entry.ref.deref();
+        if (!obj) {
+            this.idToEntry.delete(id);
+            return undefined;
+        }
+        return obj;
+    }
+    isObjectLike(value) {
+        return ((typeof value === "object" && value !== null) ||
+            typeof value === "function");
+    }
+    notifyWatchers(id, value) {
+        const watcherSet = this.watchers.get(id);
+        if (!watcherSet || watcherSet.size === 0)
+            return;
+        watcherSet.forEach((cb) => {
+            try {
+                cb(value);
+            }
+            catch (error) {
+                console.error("[ObjectRegistry] Watcher callback threw an error:", error);
+            }
+        });
+    }
+}
+/**
+ * Token for dependency injection referencing the ObjectRegistry service.
+ * Use with Services.register() for custom implementations.
+ *
+ * @example
+ * ```typescript
+ * Services.register(ObjectRegistryToken, () => customRegistry);
+ * ```
+ */
+export const ObjectRegistryToken = "ObjectRegistry";
+//# sourceMappingURL=object-registry.js.map

package/dist/utils/object-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-registry.js","sourceRoot":"","sources":["../../src/utils/object-registry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "smart-lifecycle",
+  "version": "0.1.1",
+  "description": "A tiny lifecycle-focused framework for building reactive web components",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build:lib": "tsc -p tsconfig.json",
+    "build:prod": "npm run build:lib && rollup -c rollup.config.mjs",
+    "build:examples": "node scripts/build-examples.mjs",
+    "build": "npm run build:lib && npm run build:examples",
+    "pretest": "node scripts/guardrails.mjs && node scripts/check-no-browser-in-node-tests.mjs",
+    "serve:dev": "node scripts/serve-examples.mjs",
+    "serve:dist": "node scripts/serve-dist.mjs",
+    "test": "cross-env SKIP_WEBSERVER=1 playwright test --project=unit --project=integration",
+    "test:unit": "cross-env SKIP_WEBSERVER=1 playwright test --project=unit",
+    "test:unit:node": "npm run test:unit",
+    "test:integration": "cross-env SKIP_WEBSERVER=1 playwright test --project=integration",
+    "test:integration:node": "npm run test:integration",
+    "test:playground": "playwright test --project=playground",
+    "test:headed": "playwright test --headed",
+    "test:ui": "playwright test --ui",
+    "test:report": "playwright show-report",
+    "lint": "eslint . --ext .ts",
+    "format": "prettier --write ."
+  },
+  "keywords": [
+    "typescript",
+    "components",
+    "reactive",
+    "lifecycle",
+    "mvvm",
+    "vanilla",
+    "web-components"
+  ],
+  "author": "janmbaco",
+  "license": "MIT",
+  "devDependencies": {
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/theme-one-dark": "^6.1.3",
+    "@playwright/test": "^1.57.0",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@types/jsdom": "^28.0.1",
+    "@types/node": "^20.19.26",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "@picocss/pico": "^2.1.1",
+    "codemirror": "^6.0.2",
+    "cross-env": "^10.1.0",
+    "esbuild": "^0.27.0",
+    "eslint": "^8.57.0",
+    "eslint-config-prettier": "^9.1.0",
+    "happy-dom": "^20.0.11",
+    "injectkit": "^1.2.0",
+    "jsdom": "^27.2.0",
+    "node-fetch": "^3.3.2",
+    "playwright": "^1.57.0",
+    "prettier": "^3.3.3",
+    "reflect-metadata": "^0.2.2",
+    "rollup": "^4.53.3",
+    "terser": "^5.44.1",
+    "typescript": "^5.3.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/janmbaco/smart-components.git"
+  }
+}