@hamak/microkernel-impl 0.4.7 → 0.4.8

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@hamak/microkernel-impl",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "type": "module",
   "description": "Microkernel Implementation - Core microkernel functionality",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "sideEffects": false,
+  "files": [
+    "dist"
+  ],
   "repository": {
     "type": "git",
     "url": "https://github.com/amah/app-framework.git",

package/.turbo/turbo-build.log

@@ -1 +0,0 @@
-$ tsc -p tsconfig.lib.json && tsc -p tsconfig.lib.es2015.json

package/CHANGELOG.md

@@ -1,41 +0,0 @@
-## 0.4.0 (2025-11-10)
-
-### 🚀 Features
-
-- implement notification plugin with UI and backend components ([c19ffcf](https://github.com/amah/app-framework/commit/c19ffcf))
-- add ES2015 build support and fix TypeScript config for logging packages ([be5e45e](https://github.com/amah/app-framework/commit/be5e45e))
-- complete logging system build and add optional console interception ([f390bc6](https://github.com/amah/app-framework/commit/f390bc6))
-- implement core pluggable logging system (Phase 1) ([2abdc1a](https://github.com/amah/app-framework/commit/2abdc1a))
-
-### 🩹 Fixes
-
-- add notification packages to workspaces ([97a234d](https://github.com/amah/app-framework/commit/97a234d))
-
-### ❤️ Thank You
-
-- Amah
-- Claude
-
-## 0.3.0 (2025-11-06)
-
-### 🚀 Features
-
-- migrate from Turbo to Nx 22 with comprehensive monorepo setup ([e63801e](https://github.com/amah/app-framework/commit/e63801e))
-- add Nx Release for automated dependency management ([01d474f](https://github.com/amah/app-framework/commit/01d474f))
-- migrate from Turbo to Nx 22 monorepo orchestration ([d374271](https://github.com/amah/app-framework/commit/d374271))
-- add configurable main padding and resizable sidebar to DashboardLayout ([c1d25bf](https://github.com/amah/app-framework/commit/c1d25bf))
-- add debug logging and version management system ([ea514fc](https://github.com/amah/app-framework/commit/ea514fc))
-- **ui-store:** add STORE_EXTENSIONS_TOKEN for DI-based middleware/reducer registration ([e855bdd](https://github.com/amah/app-framework/commit/e855bdd))
-- Rename package scope from @amk to @hamak and configure npm publishing ([b6040b5](https://github.com/amah/app-framework/commit/b6040b5))
-- Add hybrid local/CI-CD development workflow with bun link ([d09f528](https://github.com/amah/app-framework/commit/d09f528))
-- Add Turborepo for intelligent build orchestration and fix test type errors ([ba41db8](https://github.com/amah/app-framework/commit/ba41db8))
-- Add Redux store integration with ui-store package and demo ([e5aafa8](https://github.com/amah/app-framework/commit/e5aafa8))
-
-### 🩹 Fixes
-
-- move git config to top-level release.git in nx.json ([1bb2187](https://github.com/amah/app-framework/commit/1bb2187))
-
-### ❤️ Thank You
-
-- Amah
-- Claude

package/project.json

@@ -1,24 +0,0 @@
-{
-  "name": "@hamak/microkernel-impl",
-  "$schema": "../../../node_modules/nx/schemas/project-schema.json",
-  "sourceRoot": "packages/microkernel/microkernel-impl/src",
-  "projectType": "library",
-  "targets": {
-    "build": {
-      "executor": "nx:run-commands",
-      "outputs": ["{projectRoot}/dist"],
-      "options": {
-        "command": "tsc -p tsconfig.lib.json && tsc -p tsconfig.lib.es2015.json",
-        "cwd": "{projectRoot}"
-      }
-    },
-    "clean": {
-      "executor": "nx:run-commands",
-      "options": {
-        "command": "rm -rf dist",
-        "cwd": "{projectRoot}"
-      }
-    }
-  },
-  "tags": ["type:library", "scope:microkernel"]
-}

package/src/index.ts

@@ -1,5 +0,0 @@
-export * from './runtime/di';
-export * from './runtime/registries';
-export * from './runtime/loader';
-export * from './runtime/host';
-export * from './ui/adapter';

package/src/runtime/di.ts

@@ -1,102 +0,0 @@
-import type { Provider, Token } from '@hamak/microkernel-api';
-
-const INJECT_KEY = Symbol('di:inject');
-
-export function Injectable(deps: Token[] = []): ClassDecorator {
-  return (t: any) => {
-    (t as any)[INJECT_KEY] = deps;
-  };
-}
-
-export interface ContainerConfig {
-  debug?: boolean;
-  pluginContext?: string;
-}
-
-export class Container {
-  private parent?: Container;
-  private providers = new Map<Token, Provider>();
-  private instances = new Map<Token, any>();
-  private config: ContainerConfig;
-
-  constructor(parent?: Container, config: ContainerConfig = {}) {
-    this.parent = parent;
-    this.config = config;
-  }
-
-  createChild(): Container {
-    return new Container(this, this.config);
-  }
-
-  provide<T>(prov: Provider<T>): this {
-    if (this.config.debug) {
-      const tokenName = this.getTokenName(prov.provide);
-      const context = this.config.pluginContext ? `[${this.config.pluginContext}] ` : '';
-      console.log(`🔧 ${context}Providing token: ${tokenName}`);
-    }
-    this.providers.set(prov.provide, prov);
-    return this;
-  }
-
-  resolve<T>(token: Token<T>): T {
-    if (this.instances.has(token)) {
-      if (this.config.debug) {
-        const tokenName = this.getTokenName(token);
-        const context = this.config.pluginContext ? `[${this.config.pluginContext}] ` : '';
-        console.log(`✓ ${context}Resolving token (cached): ${tokenName}`);
-      }
-      return this.instances.get(token);
-    }
-
-    if (this.providers.has(token)) {
-      if (this.config.debug) {
-        const tokenName = this.getTokenName(token);
-        const context = this.config.pluginContext ? `[${this.config.pluginContext}] ` : '';
-        console.log(`🔍 ${context}Resolving token: ${tokenName}`);
-      }
-
-      const prov: any = this.providers.get(token)!;
-      let value: any;
-
-      if ('useValue' in prov) {
-        value = prov.useValue;
-      } else if ('useClass' in prov) {
-        const C = prov.useClass;
-        const deps: Token[] = (C as any)[INJECT_KEY] || [];
-        const args = deps.map((d) => this.resolve(d));
-        value = new C(...args);
-      } else {
-        const deps: Token[] = prov.deps || [];
-        const args = deps.map((d) => this.resolve(d));
-        value = prov.useFactory(...args);
-      }
-
-      this.instances.set(token, value);
-      return value;
-    }
-
-    if (this.parent) {
-      return this.parent.resolve(token);
-    }
-
-    throw new Error(`No provider for token: ${token.toString?.() ?? String(token)}`);
-  }
-
-  setPluginContext(pluginName: string): void {
-    this.config.pluginContext = pluginName;
-  }
-
-  clearPluginContext(): void {
-    this.config.pluginContext = undefined;
-  }
-
-  private getTokenName(token: Token): string {
-    if (typeof token === 'symbol') {
-      return token.toString();
-    }
-    if (typeof token === 'function') {
-      return token.name || 'AnonymousClass';
-    }
-    return String(token);
-  }
-}

package/src/runtime/graph-utils.ts

@@ -1,50 +0,0 @@
-/**
- * Dependency graph utilities for topological sorting
- */
-
-export interface DependencyNode {
-  name: string;
-  dependsOn?: string[];
-}
-
-/**
- * Performs topological sort on items based on their dependencies
- * @param items Items to sort (must have name and optional dependsOn properties)
- * @returns Sorted items in dependency order
- * @throws Error if circular dependency is detected
- */
-export function topologicalSort<T extends DependencyNode>(items: T[]): T[] {
-  const index = new Map(items.map(i => [i.name, i]));
-  const visited = new Set<string>();
-  const result: T[] = [];
-
-  const visit = (item: T, path: Set<string> = new Set()) => {
-    if (visited.has(item.name)) return;
-
-    // Cycle detection
-    if (path.has(item.name)) {
-      throw new Error(
-        `Circular dependency detected: ${[...path, item.name].join(' -> ')}`
-      );
-    }
-
-    path.add(item.name);
-
-    (item.dependsOn ?? []).forEach(depName => {
-      const dep = index.get(depName);
-      if (!dep) {
-        console.warn(
-          `Dependency not found: ${depName} (required by ${item.name})`
-        );
-        return;
-      }
-      visit(dep, new Set(path));
-    });
-
-    visited.add(item.name);
-    result.push(item);
-  };
-
-  items.forEach(item => visit(item));
-  return result;
-}

package/src/runtime/host.ts

@@ -1,265 +0,0 @@
-import type { ActivateContext, IChildHost, IHost, PluginManifest, Provider, CommandRegistry, ViewRegistry, Hooks } from '@hamak/microkernel-api';
-import { Container, type ContainerConfig } from './di';
-import { createCommandRegistry, createHooks, createViewRegistry } from './registries';
-import { PluginRegistry } from './loader';
-import type { InitializationContext, PluginModule } from '@hamak/microkernel-spi';
-
-export interface HostConfig {
-  /** Enable debug logging for plugin lifecycle and DI operations */
-  debug?: boolean;
-}
-
-type SharedRegistries = {
-  commands: CommandRegistry;
-  views: ViewRegistry;
-  hooks: Hooks;
-};
-
-function createSharedRegistries(): SharedRegistries {
-  return {
-    commands: createCommandRegistry(),
-    views: createViewRegistry(),
-    hooks: createHooks(),
-  };
-}
-
-function createInitContext(
-  container: Container,
-  registries: SharedRegistries,
-  env?: Record<string, any>
-): InitializationContext {
-  return {
-    provide: (prov: Provider) => container.provide(prov),
-    resolve: <T>(t: any) => container.resolve(t),
-    commands: {
-      register: (id: string, h: (...a: any[]) => any) => registries.commands.register(id, h)
-    },
-    views: {
-      register: (slot: string, vf: any) => registries.views.register(slot, vf)
-    },
-    hooks: {
-      on: (ev: string, fn: (...a: any[]) => void) => registries.hooks.on(ev, fn),
-      emit: (ev: string, ...a: any[]) => registries.hooks.emit(ev, ...a)
-    },
-    env,
-  };
-}
-
-function createActivateContext(
-  container: Container,
-  registries: SharedRegistries,
-  env?: Record<string, any>
-): ActivateContext {
-  return {
-    resolve: <T>(t: any) => container.resolve(t),
-    commands: registries.commands,
-    views: registries.views,
-    hooks: registries.hooks,
-    env,
-  };
-}
-
-export class Host implements IHost {
-  readonly root: Container;
-  private readonly _registry: PluginRegistry;
-  private env?: Record<string, any>;
-  private config: HostConfig;
-  rootActivationCtx?: ActivateContext;
-
-  constructor(initialProviders: Provider[] = [], env?: Record<string, any>, config: HostConfig = {}){
-    const containerConfig: ContainerConfig = { debug: config.debug };
-    this.root = new Container(undefined, containerConfig);
-    initialProviders.forEach(p=>this.root.provide(p));
-    this._registry = new PluginRegistry();
-    this.env = env;
-    this.config = config;
-
-    if (this.config.debug) {
-      console.log('🚀 Microkernel Host created with debug logging enabled');
-    }
-  }
-
-  async loadPlugins(manifests: Array<string|PluginManifest>): Promise<void>{
-    await this._registry.loadAllAtRoot(manifests);
-  }
-
-  /**
-   * Register a plugin programmatically (useful for testing/inline plugins)
-   * @param name Plugin name
-   * @param manifest Plugin manifest
-   * @param module Plugin module implementation
-   */
-  registerPlugin(name: string, manifest: PluginManifest, module: PluginModule): void {
-    this._registry.register(name, manifest, module);
-  }
-
-  /**
-   * Get plugin manifest by name
-   * @param name Plugin name
-   * @returns Plugin manifest or undefined if not found
-   */
-  getPlugin(name: string): PluginManifest | undefined {
-    return this._registry.get(name)?.manifest;
-  }
-
-  /**
-   * List all loaded plugins
-   * @returns Array of plugin manifests
-   */
-  listPlugins(): PluginManifest[] {
-    return this._registry.list();
-  }
-
-  async bootstrapAllAtRoot(): Promise<void>{
-    const registries = createSharedRegistries();
-    const initCtx = createInitContext(this.root, registries, this.env);
-    const plugins = this._registry.getModulesWithNamesInOrder('all');
-
-    if (this.config.debug) {
-      console.log('\n📋 Plugin initialization order:', plugins.map(p => p.name).join(' → '));
-      console.log('\n--- INITIALIZATION PHASE ---\n');
-    }
-
-    // Initialize phase with error handling
-    for(const { name, module } of plugins) {
-      try {
-        if (this.config.debug) {
-          console.log(`⚙️  Initializing plugin: ${name}`);
-          this.root.setPluginContext(name);
-        }
-        await module.initialize?.(initCtx);
-        if (this.config.debug) {
-          console.log(`✅ Plugin initialized: ${name}\n`);
-          this.root.clearPluginContext();
-        }
-      } catch (error) {
-        const err = error instanceof Error ? error : new Error(String(error));
-        const initError = new Error(`Plugin initialization failed: ${err.message}`);
-        (initError as any).cause = error;
-        if (this.config.debug) {
-          console.error(`❌ Plugin initialization failed: ${name}`, err);
-        }
-        throw initError;
-      }
-    }
-
-    if (this.config.debug) {
-      console.log('--- ACTIVATION PHASE ---\n');
-    }
-
-    const actCtx = createActivateContext(this.root, registries, this.env);
-    this.rootActivationCtx = actCtx;
-
-    // Activation phase with error handling
-    for(const { name, module } of plugins) {
-      try {
-        if (this.config.debug) {
-          console.log(`🔌 Activating plugin: ${name}`);
-          this.root.setPluginContext(name);
-        }
-        await module.activate?.(actCtx);
-        if (this.config.debug) {
-          console.log(`✅ Plugin activated: ${name}\n`);
-          this.root.clearPluginContext();
-        }
-      } catch (error) {
-        const err = error instanceof Error ? error : new Error(String(error));
-        console.error(`Plugin activation failed:`, err);
-        if (this.config.debug) {
-          console.error(`❌ Plugin activation failed: ${name}`, err);
-        }
-        // Continue with other plugins rather than failing completely
-      }
-    }
-
-    if (this.config.debug) {
-      console.log('🎉 All plugins bootstrapped successfully!\n');
-    }
-
-    actCtx.hooks.emit('host:activated');
-  }
-
-  createChildHost(overrides: Provider[] = [], env?: Record<string, any>): IChildHost {
-    const child = this.root.createChild();
-    overrides.forEach(p=>child.provide(p));
-    const childEnv = { ...(this.env||{}), ...(env||{}) };
-    return new ChildHost(child, this._registry, childEnv, this.config);
-  }
-}
-
-class ChildHost implements IChildHost {
-  constructor(
-    private readonly container: Container,
-    private readonly registry: PluginRegistry,
-    private readonly env?: Record<string, any>,
-    private readonly config: HostConfig = {}
-  ) {}
-
-  async bootstrap(pluginNames: string[]|'all'='all'): Promise<void>{
-    const registries = createSharedRegistries();
-    const initCtx = createInitContext(this.container, registries, this.env);
-    const plugins = this.registry.getModulesWithNamesInOrder(pluginNames);
-
-    if (this.config.debug) {
-      console.log('\n📋 Child host plugin initialization order:', plugins.map(p => p.name).join(' → '));
-      console.log('\n--- CHILD INITIALIZATION PHASE ---\n');
-    }
-
-    // Initialize phase with error handling
-    for(const { name, module } of plugins) {
-      try {
-        if (this.config.debug) {
-          console.log(`⚙️  Initializing plugin: ${name}`);
-          this.container.setPluginContext(name);
-        }
-        await module.initialize?.(initCtx);
-        if (this.config.debug) {
-          console.log(`✅ Plugin initialized: ${name}\n`);
-          this.container.clearPluginContext();
-        }
-      } catch (error) {
-        const err = error instanceof Error ? error : new Error(String(error));
-        const initError = new Error(`Plugin initialization failed: ${err.message}`);
-        (initError as any).cause = error;
-        if (this.config.debug) {
-          console.error(`❌ Plugin initialization failed: ${name}`, err);
-        }
-        throw initError;
-      }
-    }
-
-    if (this.config.debug) {
-      console.log('--- CHILD ACTIVATION PHASE ---\n');
-    }
-
-    const actCtx = createActivateContext(this.container, registries, this.env);
-
-    // Activation phase with error handling
-    for(const { name, module } of plugins) {
-      try {
-        if (this.config.debug) {
-          console.log(`🔌 Activating plugin: ${name}`);
-          this.container.setPluginContext(name);
-        }
-        await module.activate?.(actCtx);
-        if (this.config.debug) {
-          console.log(`✅ Plugin activated: ${name}\n`);
-          this.container.clearPluginContext();
-        }
-      } catch (error) {
-        const err = error instanceof Error ? error : new Error(String(error));
-        console.error(`Plugin activation failed:`, err);
-        if (this.config.debug) {
-          console.error(`❌ Plugin activation failed: ${name}`, err);
-        }
-        // Continue with other plugins rather than failing completely
-      }
-    }
-
-    if (this.config.debug) {
-      console.log('🎉 Child host plugins bootstrapped successfully!\n');
-    }
-
-    actCtx.hooks.emit('child:activated');
-  }
-}

package/src/runtime/loader.ts

@@ -1,72 +0,0 @@
-import type { PluginManifest } from '@hamak/microkernel-api';
-import type { PluginModule } from '@hamak/microkernel-spi';
-import { topologicalSort } from './graph-utils';
-
-class PluginRecord {
-  constructor(public manifest: PluginManifest, public module?: PluginModule) {}
-}
-
-export class PluginRegistry {
-  private byName = new Map<string, PluginRecord>();
-
-  /**
-   * Get a plugin record by name
-   */
-  get(name: string) {
-    return this.byName.get(name);
-  }
-
-  /**
-   * List all loaded plugin manifests
-   */
-  list() {
-    return [...this.byName.values()].map(r => r.manifest);
-  }
-
-  /**
-   * Register a plugin programmatically (useful for testing/inline plugins)
-   */
-  register(name: string, manifest: PluginManifest, module: PluginModule): void {
-    this.byName.set(name, new PluginRecord(manifest, module));
-  }
-
-  /**
-   * Load plugins from manifest URLs or objects
-   */
-  async loadAllAtRoot(manifestInputs: Array<string | PluginManifest>) {
-    const mfs: PluginManifest[] = [];
-    for (const m of manifestInputs) {
-      if (typeof m === 'string') {
-        mfs.push(await fetch(m).then(r => r.json()));
-      } else {
-        mfs.push(m);
-      }
-    }
-    const sorted = topologicalSort(mfs);
-    for (const m of sorted) {
-      const url = new URL(m.entry, (m.baseUrl ?? location.origin) + '/').toString();
-      const mod: PluginModule = await import(/* @vite-ignore */ url);
-      this.byName.set(m.name, new PluginRecord(m, mod));
-    }
-  }
-
-  /**
-   * Get plugin modules in dependency order
-   */
-  getModulesInOrder(names: string[] | 'all' = 'all') {
-    const t = names === 'all' ? [...this.byName.keys()] : names;
-    const order = topologicalSort(t.map(n => this.byName.get(n)!.manifest));
-    return order.map(m => this.byName.get(m.name)!.module!).filter(Boolean);
-  }
-
-  /**
-   * Get plugin modules with their names in dependency order
-   */
-  getModulesWithNamesInOrder(names: string[] | 'all' = 'all'): Array<{ name: string; module: PluginModule }> {
-    const t = names === 'all' ? [...this.byName.keys()] : names;
-    const order = topologicalSort(t.map(n => this.byName.get(n)!.manifest));
-    return order
-      .map(m => ({ name: m.name, module: this.byName.get(m.name)!.module! }))
-      .filter(item => item.module);
-  }
-}

package/src/runtime/registries.ts

@@ -1,4 +0,0 @@
-import type { CommandRegistry, Hooks, ViewRegistry } from '@hamak/microkernel-api';
-export function createHooks(): Hooks { const map = new Map<string, Set<(...a:any[])=>void>>(); return { on(e: string,f: (...a: any[]) => void){ if(!map.has(e)) map.set(e,new Set()); map.get(e)!.add(f); }, off(e: string,f: (...a: any[]) => void){ map.get(e)?.delete(f); }, emit(e: string,...a: any[]){ for(const fn of map.get(e) ?? []) fn(...a); } }; }
-export function createCommandRegistry(): CommandRegistry { const h=new Map<string,(...a:any[])=>any>(); return { register(id: string,fn: (...a:any[])=>any){h.set(id,fn);}, run(id: string,...a: any[]){const fn=h.get(id); if(!fn) throw new Error(`Command not found: ${id}`); return fn(...a);}, has(id: string){return h.has(id);} }; }
-export function createViewRegistry(): ViewRegistry { const s=new Map<string,any[]>(); return { register(slot: string,v: any){ const arr=s.get(slot)??[]; arr.push(v); s.set(slot,arr); }, list(slot: string){ return [...(s.get(slot)??[])]; } }; }

package/src/ui/adapter.ts

@@ -1,2 +0,0 @@
-import type { ProvidedServices } from '@hamak/microkernel-api';
-export const UI = { registerView(ctx: ProvidedServices, slot: string, viewFactory: any){ ctx.views.register(slot, viewFactory); }, getViews(ctx: ProvidedServices, slot: string){ return ctx.views.list(slot); } };

package/tsconfig.lib.es2015.json

@@ -1,23 +0,0 @@
-{
-  "extends": "./tsconfig.lib.json",
-  "compilerOptions": {
-    "target": "ES2015",
-    "lib": [
-      "ES2015",
-      "DOM"
-    ],
-    "outDir": "./dist/es2015",
-    "declaration": false,
-    "declarationMap": false,
-    "sourceMap": false,
-    "downlevelIteration": true,
-    "composite": false
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}

package/tsconfig.lib.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "lib": ["ES2020", "DOM"],
-    "module": "ESNext",
-    "moduleResolution": "Bundler",
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true,
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "types": []
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules",
-    "dist"
-  ]
-}