@vlian/framework 1.2.19 → 1.2.37

package/dist/kernel/manager/loggerManager.cjs

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "LoggerManager", {
+    enumerable: true,
+    get: function() {
+        return LoggerManager;
+    }
+});
+const _utils = require("../../utils");
+const _constants = require("../constants");
+const _persistence = require("./persistence");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function normalizeLogLevel(value, fallback) {
+    if (!value || typeof value !== 'string') {
+        return fallback;
+    }
+    switch(value.toUpperCase()){
+        case 'DEBUG':
+            return _utils.LogLevel.DEBUG;
+        case 'INFO':
+            return _utils.LogLevel.INFO;
+        case 'WARN':
+            return _utils.LogLevel.WARN;
+        case 'ERROR':
+            return _utils.LogLevel.ERROR;
+        default:
+            return fallback;
+    }
+}
+let LoggerManager = class LoggerManager {
+    async initialize(context) {
+        this.config = context.config.logger;
+        const persisted = await (0, _persistence.readPersistedValue)(this.config.persistence);
+        this.level = normalizeLogLevel(persisted, this.config.level ?? _utils.LogLevel.INFO);
+        _utils.logger.setLevel(this.level);
+    }
+    debug(message, payload) {
+        _utils.logger.debug(message, payload);
+    }
+    async setLevel(level) {
+        this.level = level;
+        _utils.logger.setLevel(level);
+        await (0, _persistence.writePersistedValue)(this.config.persistence, String(level));
+    }
+    getSnapshot() {
+        return {
+            level: this.level
+        };
+    }
+    constructor(){
+        _define_property(this, "level", _utils.LogLevel.INFO);
+        _define_property(this, "config", _constants.DEFAULT_CONFIG.logger);
+    }
+};
+
+//# sourceMappingURL=loggerManager.js.map

package/dist/kernel/manager/loggerManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kernel/manager/loggerManager.ts"],"sourcesContent":["import { logger, LogLevel } from '../../utils';\nimport type { KernelConfig, KernelManager, KernelManagerContext } from '../types';\nimport { DEFAULT_CONFIG } from '../constants';\nimport { readPersistedValue, writePersistedValue } from './persistence';\n\nfunction normalizeLogLevel(value: unknown, fallback: LogLevel): LogLevel {\n  if (!value || typeof value !== 'string') {\n    return fallback;\n  }\n\n  switch (value.toUpperCase()) {\n    case 'DEBUG':\n      return LogLevel.DEBUG;\n    case 'INFO':\n      return LogLevel.INFO;\n    case 'WARN':\n      return LogLevel.WARN;\n    case 'ERROR':\n      return LogLevel.ERROR;\n    default:\n      return fallback;\n  }\n}\n\nexport class LoggerManager implements KernelManager<{ level: LogLevel }> {\n  private level: LogLevel = LogLevel.INFO;\n  private config: KernelConfig['logger'] = DEFAULT_CONFIG.logger;\n\n  public async initialize(context: KernelManagerContext): Promise<void> {\n    this.config = context.config.logger;\n    const persisted = await readPersistedValue(this.config.persistence);\n    this.level = normalizeLogLevel(persisted, this.config.level ?? LogLevel.INFO);\n    logger.setLevel(this.level);\n  }\n\n  public debug(message: string, payload?: unknown): void {\n    logger.debug(message, payload);\n  }\n\n  public async setLevel(level: LogLevel): Promise<void> {\n    this.level = level;\n    logger.setLevel(level);\n    await writePersistedValue(this.config.persistence, String(level));\n  }\n\n  public getSnapshot(): { level: LogLevel } {\n    return { level: this.level };\n  }\n}\n"],"names":["LoggerManager","normalizeLogLevel","value","fallback","toUpperCase","LogLevel","DEBUG","INFO","WARN","ERROR","initialize","context","config","logger","persisted","readPersistedValue","persistence","level","setLevel","debug","message","payload","writePersistedValue","String","getSnapshot","DEFAULT_CONFIG"],"mappings":";;;;+BAwBaA;;;eAAAA;;;uBAxBoB;2BAEF;6BACyB;;;;;;;;;;;;;;AAExD,SAASC,kBAAkBC,KAAc,EAAEC,QAAkB;IAC3D,IAAI,CAACD,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAOC;IACT;IAEA,OAAQD,MAAME,WAAW;QACvB,KAAK;YACH,OAAOC,eAAQ,CAACC,KAAK;QACvB,KAAK;YACH,OAAOD,eAAQ,CAACE,IAAI;QACtB,KAAK;YACH,OAAOF,eAAQ,CAACG,IAAI;QACtB,KAAK;YACH,OAAOH,eAAQ,CAACI,KAAK;QACvB;YACE,OAAON;IACX;AACF;AAEO,IAAA,AAAMH,gBAAN,MAAMA;IAIX,MAAaU,WAAWC,OAA6B,EAAiB;QACpE,IAAI,CAACC,MAAM,GAAGD,QAAQC,MAAM,CAACC,MAAM;QACnC,MAAMC,YAAY,MAAMC,IAAAA,+BAAkB,EAAC,IAAI,CAACH,MAAM,CAACI,WAAW;QAClE,IAAI,CAACC,KAAK,GAAGhB,kBAAkBa,WAAW,IAAI,CAACF,MAAM,CAACK,KAAK,IAAIZ,eAAQ,CAACE,IAAI;QAC5EM,aAAM,CAACK,QAAQ,CAAC,IAAI,CAACD,KAAK;IAC5B;IAEOE,MAAMC,OAAe,EAAEC,OAAiB,EAAQ;QACrDR,aAAM,CAACM,KAAK,CAACC,SAASC;IACxB;IAEA,MAAaH,SAASD,KAAe,EAAiB;QACpD,IAAI,CAACA,KAAK,GAAGA;QACbJ,aAAM,CAACK,QAAQ,CAACD;QAChB,MAAMK,IAAAA,gCAAmB,EAAC,IAAI,CAACV,MAAM,CAACI,WAAW,EAAEO,OAAON;IAC5D;IAEOO,cAAmC;QACxC,OAAO;YAAEP,OAAO,IAAI,CAACA,KAAK;QAAC;IAC7B;;QAtBA,uBAAQA,SAAkBZ,eAAQ,CAACE,IAAI;QACvC,uBAAQK,UAAiCa,yBAAc,CAACZ,MAAM;;AAsBhE"}

package/dist/kernel/manager/loggerManager.d.ts

@@ -0,0 +1,14 @@
+import { LogLevel } from '../../utils';
+import type { KernelManager, KernelManagerContext } from '../types';
+export declare class LoggerManager implements KernelManager<{
+    level: LogLevel;
+}> {
+    private level;
+    private config;
+    initialize(context: KernelManagerContext): Promise<void>;
+    debug(message: string, payload?: unknown): void;
+    setLevel(level: LogLevel): Promise<void>;
+    getSnapshot(): {
+        level: LogLevel;
+    };
+}

package/dist/kernel/manager/loggerManager.js

@@ -0,0 +1,60 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { logger, LogLevel } from "../../utils";
+import { DEFAULT_CONFIG } from "../constants";
+import { readPersistedValue, writePersistedValue } from "./persistence";
+function normalizeLogLevel(value, fallback) {
+    if (!value || typeof value !== 'string') {
+        return fallback;
+    }
+    switch(value.toUpperCase()){
+        case 'DEBUG':
+            return LogLevel.DEBUG;
+        case 'INFO':
+            return LogLevel.INFO;
+        case 'WARN':
+            return LogLevel.WARN;
+        case 'ERROR':
+            return LogLevel.ERROR;
+        default:
+            return fallback;
+    }
+}
+export class LoggerManager {
+    async initialize(context) {
+        this.config = context.config.logger;
+        const persisted = await readPersistedValue(this.config.persistence);
+        this.level = normalizeLogLevel(persisted, this.config.level ?? LogLevel.INFO);
+        logger.setLevel(this.level);
+    }
+    debug(message, payload) {
+        logger.debug(message, payload);
+    }
+    async setLevel(level) {
+        this.level = level;
+        logger.setLevel(level);
+        await writePersistedValue(this.config.persistence, String(level));
+    }
+    getSnapshot() {
+        return {
+            level: this.level
+        };
+    }
+    constructor(){
+        _define_property(this, "level", LogLevel.INFO);
+        _define_property(this, "config", DEFAULT_CONFIG.logger);
+    }
+}
+
+//# sourceMappingURL=loggerManager.js.map

package/dist/kernel/manager/loggerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kernel/manager/loggerManager.ts"],"sourcesContent":["import { logger, LogLevel } from '../../utils';\nimport type { KernelConfig, KernelManager, KernelManagerContext } from '../types';\nimport { DEFAULT_CONFIG } from '../constants';\nimport { readPersistedValue, writePersistedValue } from './persistence';\n\nfunction normalizeLogLevel(value: unknown, fallback: LogLevel): LogLevel {\n  if (!value || typeof value !== 'string') {\n    return fallback;\n  }\n\n  switch (value.toUpperCase()) {\n    case 'DEBUG':\n      return LogLevel.DEBUG;\n    case 'INFO':\n      return LogLevel.INFO;\n    case 'WARN':\n      return LogLevel.WARN;\n    case 'ERROR':\n      return LogLevel.ERROR;\n    default:\n      return fallback;\n  }\n}\n\nexport class LoggerManager implements KernelManager<{ level: LogLevel }> {\n  private level: LogLevel = LogLevel.INFO;\n  private config: KernelConfig['logger'] = DEFAULT_CONFIG.logger;\n\n  public async initialize(context: KernelManagerContext): Promise<void> {\n    this.config = context.config.logger;\n    const persisted = await readPersistedValue(this.config.persistence);\n    this.level = normalizeLogLevel(persisted, this.config.level ?? LogLevel.INFO);\n    logger.setLevel(this.level);\n  }\n\n  public debug(message: string, payload?: unknown): void {\n    logger.debug(message, payload);\n  }\n\n  public async setLevel(level: LogLevel): Promise<void> {\n    this.level = level;\n    logger.setLevel(level);\n    await writePersistedValue(this.config.persistence, String(level));\n  }\n\n  public getSnapshot(): { level: LogLevel } {\n    return { level: this.level };\n  }\n}\n"],"names":["logger","LogLevel","DEFAULT_CONFIG","readPersistedValue","writePersistedValue","normalizeLogLevel","value","fallback","toUpperCase","DEBUG","INFO","WARN","ERROR","LoggerManager","initialize","context","config","persisted","persistence","level","setLevel","debug","message","payload","String","getSnapshot"],"mappings":";;;;;;;;;;;;;AAAA,SAASA,MAAM,EAAEC,QAAQ,QAAQ,cAAc;AAE/C,SAASC,cAAc,QAAQ,eAAe;AAC9C,SAASC,kBAAkB,EAAEC,mBAAmB,QAAQ,gBAAgB;AAExE,SAASC,kBAAkBC,KAAc,EAAEC,QAAkB;IAC3D,IAAI,CAACD,SAAS,OAAOA,UAAU,UAAU;QACvC,OAAOC;IACT;IAEA,OAAQD,MAAME,WAAW;QACvB,KAAK;YACH,OAAOP,SAASQ,KAAK;QACvB,KAAK;YACH,OAAOR,SAASS,IAAI;QACtB,KAAK;YACH,OAAOT,SAASU,IAAI;QACtB,KAAK;YACH,OAAOV,SAASW,KAAK;QACvB;YACE,OAAOL;IACX;AACF;AAEA,OAAO,MAAMM;IAIX,MAAaC,WAAWC,OAA6B,EAAiB;QACpE,IAAI,CAACC,MAAM,GAAGD,QAAQC,MAAM,CAAChB,MAAM;QACnC,MAAMiB,YAAY,MAAMd,mBAAmB,IAAI,CAACa,MAAM,CAACE,WAAW;QAClE,IAAI,CAACC,KAAK,GAAGd,kBAAkBY,WAAW,IAAI,CAACD,MAAM,CAACG,KAAK,IAAIlB,SAASS,IAAI;QAC5EV,OAAOoB,QAAQ,CAAC,IAAI,CAACD,KAAK;IAC5B;IAEOE,MAAMC,OAAe,EAAEC,OAAiB,EAAQ;QACrDvB,OAAOqB,KAAK,CAACC,SAASC;IACxB;IAEA,MAAaH,SAASD,KAAe,EAAiB;QACpD,IAAI,CAACA,KAAK,GAAGA;QACbnB,OAAOoB,QAAQ,CAACD;QAChB,MAAMf,oBAAoB,IAAI,CAACY,MAAM,CAACE,WAAW,EAAEM,OAAOL;IAC5D;IAEOM,cAAmC;QACxC,OAAO;YAAEN,OAAO,IAAI,CAACA,KAAK;QAAC;IAC7B;;QAtBA,uBAAQA,SAAkBlB,SAASS,IAAI;QACvC,uBAAQM,UAAiCd,eAAeF,MAAM;;AAsBhE"}

package/dist/kernel/manager/persistence.cjs

@@ -0,0 +1,93 @@
+"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 readPersistedValue () {
+        return readPersistedValue;
+    },
+    get writePersistedValue () {
+        return writePersistedValue;
+    }
+});
+const _library = require("../../library");
+function resolveWebStorage(driver) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    if (driver === 'localStorage') {
+        return window.localStorage;
+    }
+    if (driver === 'sessionStorage') {
+        return window.sessionStorage;
+    }
+    return null;
+}
+async function readPersistedValue(persistence) {
+    if (!persistence || persistence.enabled === false) {
+        return null;
+    }
+    const driver = persistence.storage ?? 'localStorage';
+    const key = persistence.key;
+    if (!key) {
+        return null;
+    }
+    if (driver === 'indexedDB') {
+        try {
+            const value = await _library.storage.indexedDB.get(key);
+            if (value === null || value === undefined) {
+                return null;
+            }
+            if (typeof value === 'string') {
+                return value;
+            }
+            return JSON.stringify(value);
+        } catch  {
+            return null;
+        }
+    }
+    const targetStorage = resolveWebStorage(driver);
+    if (!targetStorage) {
+        return null;
+    }
+    try {
+        return targetStorage.getItem(key);
+    } catch  {
+        return null;
+    }
+}
+async function writePersistedValue(persistence, value) {
+    if (!persistence || persistence.enabled === false) {
+        return;
+    }
+    const driver = persistence.storage ?? 'localStorage';
+    const key = persistence.key;
+    if (!key) {
+        return;
+    }
+    if (driver === 'indexedDB') {
+        try {
+            await _library.storage.indexedDB.set(key, value);
+        } catch  {
+        // ignore persistence errors
+        }
+        return;
+    }
+    const targetStorage = resolveWebStorage(driver);
+    if (!targetStorage) {
+        return;
+    }
+    try {
+        targetStorage.setItem(key, value);
+    } catch  {
+    // ignore persistence errors
+    }
+}
+
+//# sourceMappingURL=persistence.js.map

package/dist/kernel/manager/persistence.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kernel/manager/persistence.ts"],"sourcesContent":["import { storage } from '../../library';\nimport type { KernelStorageDriver, PersistenceOptions } from '../types';\n\nfunction resolveWebStorage(driver: KernelStorageDriver): Storage | null {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  if (driver === 'localStorage') {\n    return window.localStorage;\n  }\n  if (driver === 'sessionStorage') {\n    return window.sessionStorage;\n  }\n  return null;\n}\n\nexport async function readPersistedValue(\n  persistence: PersistenceOptions | undefined\n): Promise<string | null> {\n  if (!persistence || persistence.enabled === false) {\n    return null;\n  }\n\n  const driver = persistence.storage ?? 'localStorage';\n  const key = persistence.key;\n  if (!key) {\n    return null;\n  }\n\n  if (driver === 'indexedDB') {\n    try {\n      const value = await (storage.indexedDB as any).get(key);\n      if (value === null || value === undefined) {\n        return null;\n      }\n      if (typeof value === 'string') {\n        return value;\n      }\n      return JSON.stringify(value);\n    } catch {\n      return null;\n    }\n  }\n\n  const targetStorage = resolveWebStorage(driver);\n  if (!targetStorage) {\n    return null;\n  }\n\n  try {\n    return targetStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nexport async function writePersistedValue(\n  persistence: PersistenceOptions | undefined,\n  value: string\n): Promise<void> {\n  if (!persistence || persistence.enabled === false) {\n    return;\n  }\n\n  const driver = persistence.storage ?? 'localStorage';\n  const key = persistence.key;\n  if (!key) {\n    return;\n  }\n\n  if (driver === 'indexedDB') {\n    try {\n      await (storage.indexedDB as any).set(key, value);\n    } catch {\n      // ignore persistence errors\n    }\n    return;\n  }\n\n  const targetStorage = resolveWebStorage(driver);\n  if (!targetStorage) {\n    return;\n  }\n\n  try {\n    targetStorage.setItem(key, value);\n  } catch {\n    // ignore persistence errors\n  }\n}\n"],"names":["readPersistedValue","writePersistedValue","resolveWebStorage","driver","window","localStorage","sessionStorage","persistence","enabled","storage","key","value","indexedDB","get","undefined","JSON","stringify","targetStorage","getItem","set","setItem"],"mappings":";;;;;;;;;;;QAgBsBA;eAAAA;;QAwCAC;eAAAA;;;yBAxDE;AAGxB,SAASC,kBAAkBC,MAA2B;IACpD,IAAI,OAAOC,WAAW,aAAa;QACjC,OAAO;IACT;IACA,IAAID,WAAW,gBAAgB;QAC7B,OAAOC,OAAOC,YAAY;IAC5B;IACA,IAAIF,WAAW,kBAAkB;QAC/B,OAAOC,OAAOE,cAAc;IAC9B;IACA,OAAO;AACT;AAEO,eAAeN,mBACpBO,WAA2C;IAE3C,IAAI,CAACA,eAAeA,YAAYC,OAAO,KAAK,OAAO;QACjD,OAAO;IACT;IAEA,MAAML,SAASI,YAAYE,OAAO,IAAI;IACtC,MAAMC,MAAMH,YAAYG,GAAG;IAC3B,IAAI,CAACA,KAAK;QACR,OAAO;IACT;IAEA,IAAIP,WAAW,aAAa;QAC1B,IAAI;YACF,MAAMQ,QAAQ,MAAM,AAACF,gBAAO,CAACG,SAAS,CAASC,GAAG,CAACH;YACnD,IAAIC,UAAU,QAAQA,UAAUG,WAAW;gBACzC,OAAO;YACT;YACA,IAAI,OAAOH,UAAU,UAAU;gBAC7B,OAAOA;YACT;YACA,OAAOI,KAAKC,SAAS,CAACL;QACxB,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAMM,gBAAgBf,kBAAkBC;IACxC,IAAI,CAACc,eAAe;QAClB,OAAO;IACT;IAEA,IAAI;QACF,OAAOA,cAAcC,OAAO,CAACR;IAC/B,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEO,eAAeT,oBACpBM,WAA2C,EAC3CI,KAAa;IAEb,IAAI,CAACJ,eAAeA,YAAYC,OAAO,KAAK,OAAO;QACjD;IACF;IAEA,MAAML,SAASI,YAAYE,OAAO,IAAI;IACtC,MAAMC,MAAMH,YAAYG,GAAG;IAC3B,IAAI,CAACA,KAAK;QACR;IACF;IAEA,IAAIP,WAAW,aAAa;QAC1B,IAAI;YACF,MAAM,AAACM,gBAAO,CAACG,SAAS,CAASO,GAAG,CAACT,KAAKC;QAC5C,EAAE,OAAM;QACN,4BAA4B;QAC9B;QACA;IACF;IAEA,MAAMM,gBAAgBf,kBAAkBC;IACxC,IAAI,CAACc,eAAe;QAClB;IACF;IAEA,IAAI;QACFA,cAAcG,OAAO,CAACV,KAAKC;IAC7B,EAAE,OAAM;IACN,4BAA4B;IAC9B;AACF"}

package/dist/kernel/manager/persistence.d.ts

@@ -0,0 +1,3 @@
+import type { PersistenceOptions } from '../types';
+export declare function readPersistedValue(persistence: PersistenceOptions | undefined): Promise<string | null>;
+export declare function writePersistedValue(persistence: PersistenceOptions | undefined, value: string): Promise<void>;

package/dist/kernel/manager/persistence.js

@@ -0,0 +1,75 @@
+import { storage } from "../../library";
+function resolveWebStorage(driver) {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    if (driver === 'localStorage') {
+        return window.localStorage;
+    }
+    if (driver === 'sessionStorage') {
+        return window.sessionStorage;
+    }
+    return null;
+}
+export async function readPersistedValue(persistence) {
+    if (!persistence || persistence.enabled === false) {
+        return null;
+    }
+    const driver = persistence.storage ?? 'localStorage';
+    const key = persistence.key;
+    if (!key) {
+        return null;
+    }
+    if (driver === 'indexedDB') {
+        try {
+            const value = await storage.indexedDB.get(key);
+            if (value === null || value === undefined) {
+                return null;
+            }
+            if (typeof value === 'string') {
+                return value;
+            }
+            return JSON.stringify(value);
+        } catch  {
+            return null;
+        }
+    }
+    const targetStorage = resolveWebStorage(driver);
+    if (!targetStorage) {
+        return null;
+    }
+    try {
+        return targetStorage.getItem(key);
+    } catch  {
+        return null;
+    }
+}
+export async function writePersistedValue(persistence, value) {
+    if (!persistence || persistence.enabled === false) {
+        return;
+    }
+    const driver = persistence.storage ?? 'localStorage';
+    const key = persistence.key;
+    if (!key) {
+        return;
+    }
+    if (driver === 'indexedDB') {
+        try {
+            await storage.indexedDB.set(key, value);
+        } catch  {
+        // ignore persistence errors
+        }
+        return;
+    }
+    const targetStorage = resolveWebStorage(driver);
+    if (!targetStorage) {
+        return;
+    }
+    try {
+        targetStorage.setItem(key, value);
+    } catch  {
+    // ignore persistence errors
+    }
+}
+
+//# sourceMappingURL=persistence.js.map

package/dist/kernel/manager/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kernel/manager/persistence.ts"],"sourcesContent":["import { storage } from '../../library';\nimport type { KernelStorageDriver, PersistenceOptions } from '../types';\n\nfunction resolveWebStorage(driver: KernelStorageDriver): Storage | null {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  if (driver === 'localStorage') {\n    return window.localStorage;\n  }\n  if (driver === 'sessionStorage') {\n    return window.sessionStorage;\n  }\n  return null;\n}\n\nexport async function readPersistedValue(\n  persistence: PersistenceOptions | undefined\n): Promise<string | null> {\n  if (!persistence || persistence.enabled === false) {\n    return null;\n  }\n\n  const driver = persistence.storage ?? 'localStorage';\n  const key = persistence.key;\n  if (!key) {\n    return null;\n  }\n\n  if (driver === 'indexedDB') {\n    try {\n      const value = await (storage.indexedDB as any).get(key);\n      if (value === null || value === undefined) {\n        return null;\n      }\n      if (typeof value === 'string') {\n        return value;\n      }\n      return JSON.stringify(value);\n    } catch {\n      return null;\n    }\n  }\n\n  const targetStorage = resolveWebStorage(driver);\n  if (!targetStorage) {\n    return null;\n  }\n\n  try {\n    return targetStorage.getItem(key);\n  } catch {\n    return null;\n  }\n}\n\nexport async function writePersistedValue(\n  persistence: PersistenceOptions | undefined,\n  value: string\n): Promise<void> {\n  if (!persistence || persistence.enabled === false) {\n    return;\n  }\n\n  const driver = persistence.storage ?? 'localStorage';\n  const key = persistence.key;\n  if (!key) {\n    return;\n  }\n\n  if (driver === 'indexedDB') {\n    try {\n      await (storage.indexedDB as any).set(key, value);\n    } catch {\n      // ignore persistence errors\n    }\n    return;\n  }\n\n  const targetStorage = resolveWebStorage(driver);\n  if (!targetStorage) {\n    return;\n  }\n\n  try {\n    targetStorage.setItem(key, value);\n  } catch {\n    // ignore persistence errors\n  }\n}\n"],"names":["storage","resolveWebStorage","driver","window","localStorage","sessionStorage","readPersistedValue","persistence","enabled","key","value","indexedDB","get","undefined","JSON","stringify","targetStorage","getItem","writePersistedValue","set","setItem"],"mappings":"AAAA,SAASA,OAAO,QAAQ,gBAAgB;AAGxC,SAASC,kBAAkBC,MAA2B;IACpD,IAAI,OAAOC,WAAW,aAAa;QACjC,OAAO;IACT;IACA,IAAID,WAAW,gBAAgB;QAC7B,OAAOC,OAAOC,YAAY;IAC5B;IACA,IAAIF,WAAW,kBAAkB;QAC/B,OAAOC,OAAOE,cAAc;IAC9B;IACA,OAAO;AACT;AAEA,OAAO,eAAeC,mBACpBC,WAA2C;IAE3C,IAAI,CAACA,eAAeA,YAAYC,OAAO,KAAK,OAAO;QACjD,OAAO;IACT;IAEA,MAAMN,SAASK,YAAYP,OAAO,IAAI;IACtC,MAAMS,MAAMF,YAAYE,GAAG;IAC3B,IAAI,CAACA,KAAK;QACR,OAAO;IACT;IAEA,IAAIP,WAAW,aAAa;QAC1B,IAAI;YACF,MAAMQ,QAAQ,MAAM,AAACV,QAAQW,SAAS,CAASC,GAAG,CAACH;YACnD,IAAIC,UAAU,QAAQA,UAAUG,WAAW;gBACzC,OAAO;YACT;YACA,IAAI,OAAOH,UAAU,UAAU;gBAC7B,OAAOA;YACT;YACA,OAAOI,KAAKC,SAAS,CAACL;QACxB,EAAE,OAAM;YACN,OAAO;QACT;IACF;IAEA,MAAMM,gBAAgBf,kBAAkBC;IACxC,IAAI,CAACc,eAAe;QAClB,OAAO;IACT;IAEA,IAAI;QACF,OAAOA,cAAcC,OAAO,CAACR;IAC/B,EAAE,OAAM;QACN,OAAO;IACT;AACF;AAEA,OAAO,eAAeS,oBACpBX,WAA2C,EAC3CG,KAAa;IAEb,IAAI,CAACH,eAAeA,YAAYC,OAAO,KAAK,OAAO;QACjD;IACF;IAEA,MAAMN,SAASK,YAAYP,OAAO,IAAI;IACtC,MAAMS,MAAMF,YAAYE,GAAG;IAC3B,IAAI,CAACA,KAAK;QACR;IACF;IAEA,IAAIP,WAAW,aAAa;QAC1B,IAAI;YACF,MAAM,AAACF,QAAQW,SAAS,CAASQ,GAAG,CAACV,KAAKC;QAC5C,EAAE,OAAM;QACN,4BAA4B;QAC9B;QACA;IACF;IAEA,MAAMM,gBAAgBf,kBAAkBC;IACxC,IAAI,CAACc,eAAe;QAClB;IACF;IAEA,IAAI;QACFA,cAAcI,OAAO,CAACX,KAAKC;IAC7B,EAAE,OAAM;IACN,4BAA4B;IAC9B;AACF"}

package/dist/kernel/manager/themeManager.cjs

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "ThemeManager", {
+    enumerable: true,
+    get: function() {
+        return ThemeManager;
+    }
+});
+const _constants = require("../constants");
+const _persistence = require("./persistence");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function applyThemeToDocument(theme) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const root = document.documentElement;
+    root.classList.remove('light', 'dark');
+    const resolvedMode = theme.mode === 'system' ? typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light' : theme.mode;
+    root.classList.add(resolvedMode);
+    if (theme.primaryColor) {
+        root.style.setProperty('--app-primary-color', theme.primaryColor);
+    }
+    if (theme.tokens) {
+        Object.entries(theme.tokens).forEach(([token, tokenValue])=>{
+            root.style.setProperty(`--${token}`, String(tokenValue));
+        });
+    }
+}
+let ThemeManager = class ThemeManager {
+    async initialize(context) {
+        this.config = context.config.theme;
+        this.theme = {
+            ..._constants.DEFAULT_THEME,
+            ...this.config.initial || {}
+        };
+        const persisted = await (0, _persistence.readPersistedValue)(this.config.persistence);
+        if (persisted) {
+            try {
+                const parsed = JSON.parse(persisted);
+                this.theme = {
+                    ...this.theme,
+                    ...parsed
+                };
+            } catch  {
+            // ignore parse errors
+            }
+        }
+        applyThemeToDocument(this.theme);
+    }
+    getTheme() {
+        return {
+            ...this.theme
+        };
+    }
+    async setTheme(nextTheme) {
+        this.theme = {
+            ...nextTheme
+        };
+        applyThemeToDocument(this.theme);
+        await (0, _persistence.writePersistedValue)(this.config.persistence, JSON.stringify(this.theme));
+    }
+    getSnapshot() {
+        return this.getTheme();
+    }
+    constructor(){
+        _define_property(this, "theme", _constants.DEFAULT_THEME);
+        _define_property(this, "config", _constants.DEFAULT_CONFIG.theme);
+    }
+};
+
+//# sourceMappingURL=themeManager.js.map

package/dist/kernel/manager/themeManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kernel/manager/themeManager.ts"],"sourcesContent":["import type { KernelConfig, KernelManager, KernelManagerContext, ThemeSnapshot } from '../types';\nimport { DEFAULT_CONFIG, DEFAULT_THEME } from '../constants';\nimport { readPersistedValue, writePersistedValue } from './persistence';\n\nfunction applyThemeToDocument(theme: ThemeSnapshot): void {\n  if (typeof document === 'undefined') {\n    return;\n  }\n\n  const root = document.documentElement;\n  root.classList.remove('light', 'dark');\n\n  const resolvedMode = theme.mode === 'system'\n    ? (typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches\n      ? 'dark'\n      : 'light')\n    : theme.mode;\n\n  root.classList.add(resolvedMode);\n\n  if (theme.primaryColor) {\n    root.style.setProperty('--app-primary-color', theme.primaryColor);\n  }\n\n  if (theme.tokens) {\n    Object.entries(theme.tokens).forEach(([token, tokenValue]) => {\n      root.style.setProperty(`--${token}`, String(tokenValue));\n    });\n  }\n}\n\nexport class ThemeManager implements KernelManager<ThemeSnapshot> {\n  private theme: ThemeSnapshot = DEFAULT_THEME;\n  private config: KernelConfig['theme'] = DEFAULT_CONFIG.theme;\n\n  public async initialize(context: KernelManagerContext): Promise<void> {\n    this.config = context.config.theme;\n    this.theme = { ...DEFAULT_THEME, ...(this.config.initial || {}) };\n\n    const persisted = await readPersistedValue(this.config.persistence);\n    if (persisted) {\n      try {\n        const parsed = JSON.parse(persisted) as Partial<ThemeSnapshot>;\n        this.theme = { ...this.theme, ...parsed };\n      } catch {\n        // ignore parse errors\n      }\n    }\n\n    applyThemeToDocument(this.theme);\n  }\n\n  public getTheme(): ThemeSnapshot {\n    return { ...this.theme };\n  }\n\n  public async setTheme(nextTheme: ThemeSnapshot): Promise<void> {\n    this.theme = { ...nextTheme };\n    applyThemeToDocument(this.theme);\n    await writePersistedValue(this.config.persistence, JSON.stringify(this.theme));\n  }\n\n  public getSnapshot(): ThemeSnapshot {\n    return this.getTheme();\n  }\n}\n"],"names":["ThemeManager","applyThemeToDocument","theme","document","root","documentElement","classList","remove","resolvedMode","mode","window","matchMedia","matches","add","primaryColor","style","setProperty","tokens","Object","entries","forEach","token","tokenValue","String","initialize","context","config","DEFAULT_THEME","initial","persisted","readPersistedValue","persistence","parsed","JSON","parse","getTheme","setTheme","nextTheme","writePersistedValue","stringify","getSnapshot","DEFAULT_CONFIG"],"mappings":";;;;+BA+BaA;;;eAAAA;;;2BA9BiC;6BACU;;;;;;;;;;;;;;AAExD,SAASC,qBAAqBC,KAAoB;IAChD,IAAI,OAAOC,aAAa,aAAa;QACnC;IACF;IAEA,MAAMC,OAAOD,SAASE,eAAe;IACrCD,KAAKE,SAAS,CAACC,MAAM,CAAC,SAAS;IAE/B,MAAMC,eAAeN,MAAMO,IAAI,KAAK,WAC/B,OAAOC,WAAW,eAAeA,OAAOC,UAAU,CAAC,gCAAgCC,OAAO,GACzF,SACA,UACFV,MAAMO,IAAI;IAEdL,KAAKE,SAAS,CAACO,GAAG,CAACL;IAEnB,IAAIN,MAAMY,YAAY,EAAE;QACtBV,KAAKW,KAAK,CAACC,WAAW,CAAC,uBAAuBd,MAAMY,YAAY;IAClE;IAEA,IAAIZ,MAAMe,MAAM,EAAE;QAChBC,OAAOC,OAAO,CAACjB,MAAMe,MAAM,EAAEG,OAAO,CAAC,CAAC,CAACC,OAAOC,WAAW;YACvDlB,KAAKW,KAAK,CAACC,WAAW,CAAC,CAAC,EAAE,EAAEK,OAAO,EAAEE,OAAOD;QAC9C;IACF;AACF;AAEO,IAAA,AAAMtB,eAAN,MAAMA;IAIX,MAAawB,WAAWC,OAA6B,EAAiB;QACpE,IAAI,CAACC,MAAM,GAAGD,QAAQC,MAAM,CAACxB,KAAK;QAClC,IAAI,CAACA,KAAK,GAAG;YAAE,GAAGyB,wBAAa;YAAE,GAAI,IAAI,CAACD,MAAM,CAACE,OAAO,IAAI,CAAC,CAAC;QAAE;QAEhE,MAAMC,YAAY,MAAMC,IAAAA,+BAAkB,EAAC,IAAI,CAACJ,MAAM,CAACK,WAAW;QAClE,IAAIF,WAAW;YACb,IAAI;gBACF,MAAMG,SAASC,KAAKC,KAAK,CAACL;gBAC1B,IAAI,CAAC3B,KAAK,GAAG;oBAAE,GAAG,IAAI,CAACA,KAAK;oBAAE,GAAG8B,MAAM;gBAAC;YAC1C,EAAE,OAAM;YACN,sBAAsB;YACxB;QACF;QAEA/B,qBAAqB,IAAI,CAACC,KAAK;IACjC;IAEOiC,WAA0B;QAC/B,OAAO;YAAE,GAAG,IAAI,CAACjC,KAAK;QAAC;IACzB;IAEA,MAAakC,SAASC,SAAwB,EAAiB;QAC7D,IAAI,CAACnC,KAAK,GAAG;YAAE,GAAGmC,SAAS;QAAC;QAC5BpC,qBAAqB,IAAI,CAACC,KAAK;QAC/B,MAAMoC,IAAAA,gCAAmB,EAAC,IAAI,CAACZ,MAAM,CAACK,WAAW,EAAEE,KAAKM,SAAS,CAAC,IAAI,CAACrC,KAAK;IAC9E;IAEOsC,cAA6B;QAClC,OAAO,IAAI,CAACL,QAAQ;IACtB;;QAhCA,uBAAQjC,SAAuByB,wBAAa;QAC5C,uBAAQD,UAAgCe,yBAAc,CAACvC,KAAK;;AAgC9D"}

package/dist/kernel/manager/themeManager.d.ts

@@ -0,0 +1,9 @@
+import type { KernelManager, KernelManagerContext, ThemeSnapshot } from '../types';
+export declare class ThemeManager implements KernelManager<ThemeSnapshot> {
+    private theme;
+    private config;
+    initialize(context: KernelManagerContext): Promise<void>;
+    getTheme(): ThemeSnapshot;
+    setTheme(nextTheme: ThemeSnapshot): Promise<void>;
+    getSnapshot(): ThemeSnapshot;
+}

package/dist/kernel/manager/themeManager.js

@@ -0,0 +1,75 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+import { DEFAULT_CONFIG, DEFAULT_THEME } from "../constants";
+import { readPersistedValue, writePersistedValue } from "./persistence";
+function applyThemeToDocument(theme) {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    const root = document.documentElement;
+    root.classList.remove('light', 'dark');
+    const resolvedMode = theme.mode === 'system' ? typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light' : theme.mode;
+    root.classList.add(resolvedMode);
+    if (theme.primaryColor) {
+        root.style.setProperty('--app-primary-color', theme.primaryColor);
+    }
+    if (theme.tokens) {
+        Object.entries(theme.tokens).forEach(([token, tokenValue])=>{
+            root.style.setProperty(`--${token}`, String(tokenValue));
+        });
+    }
+}
+export class ThemeManager {
+    async initialize(context) {
+        this.config = context.config.theme;
+        this.theme = {
+            ...DEFAULT_THEME,
+            ...this.config.initial || {}
+        };
+        const persisted = await readPersistedValue(this.config.persistence);
+        if (persisted) {
+            try {
+                const parsed = JSON.parse(persisted);
+                this.theme = {
+                    ...this.theme,
+                    ...parsed
+                };
+            } catch  {
+            // ignore parse errors
+            }
+        }
+        applyThemeToDocument(this.theme);
+    }
+    getTheme() {
+        return {
+            ...this.theme
+        };
+    }
+    async setTheme(nextTheme) {
+        this.theme = {
+            ...nextTheme
+        };
+        applyThemeToDocument(this.theme);
+        await writePersistedValue(this.config.persistence, JSON.stringify(this.theme));
+    }
+    getSnapshot() {
+        return this.getTheme();
+    }
+    constructor(){
+        _define_property(this, "theme", DEFAULT_THEME);
+        _define_property(this, "config", DEFAULT_CONFIG.theme);
+    }
+}
+
+//# sourceMappingURL=themeManager.js.map

package/dist/kernel/manager/themeManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kernel/manager/themeManager.ts"],"sourcesContent":["import type { KernelConfig, KernelManager, KernelManagerContext, ThemeSnapshot } from '../types';\nimport { DEFAULT_CONFIG, DEFAULT_THEME } from '../constants';\nimport { readPersistedValue, writePersistedValue } from './persistence';\n\nfunction applyThemeToDocument(theme: ThemeSnapshot): void {\n  if (typeof document === 'undefined') {\n    return;\n  }\n\n  const root = document.documentElement;\n  root.classList.remove('light', 'dark');\n\n  const resolvedMode = theme.mode === 'system'\n    ? (typeof window !== 'undefined' && window.matchMedia('(prefers-color-scheme: dark)').matches\n      ? 'dark'\n      : 'light')\n    : theme.mode;\n\n  root.classList.add(resolvedMode);\n\n  if (theme.primaryColor) {\n    root.style.setProperty('--app-primary-color', theme.primaryColor);\n  }\n\n  if (theme.tokens) {\n    Object.entries(theme.tokens).forEach(([token, tokenValue]) => {\n      root.style.setProperty(`--${token}`, String(tokenValue));\n    });\n  }\n}\n\nexport class ThemeManager implements KernelManager<ThemeSnapshot> {\n  private theme: ThemeSnapshot = DEFAULT_THEME;\n  private config: KernelConfig['theme'] = DEFAULT_CONFIG.theme;\n\n  public async initialize(context: KernelManagerContext): Promise<void> {\n    this.config = context.config.theme;\n    this.theme = { ...DEFAULT_THEME, ...(this.config.initial || {}) };\n\n    const persisted = await readPersistedValue(this.config.persistence);\n    if (persisted) {\n      try {\n        const parsed = JSON.parse(persisted) as Partial<ThemeSnapshot>;\n        this.theme = { ...this.theme, ...parsed };\n      } catch {\n        // ignore parse errors\n      }\n    }\n\n    applyThemeToDocument(this.theme);\n  }\n\n  public getTheme(): ThemeSnapshot {\n    return { ...this.theme };\n  }\n\n  public async setTheme(nextTheme: ThemeSnapshot): Promise<void> {\n    this.theme = { ...nextTheme };\n    applyThemeToDocument(this.theme);\n    await writePersistedValue(this.config.persistence, JSON.stringify(this.theme));\n  }\n\n  public getSnapshot(): ThemeSnapshot {\n    return this.getTheme();\n  }\n}\n"],"names":["DEFAULT_CONFIG","DEFAULT_THEME","readPersistedValue","writePersistedValue","applyThemeToDocument","theme","document","root","documentElement","classList","remove","resolvedMode","mode","window","matchMedia","matches","add","primaryColor","style","setProperty","tokens","Object","entries","forEach","token","tokenValue","String","ThemeManager","initialize","context","config","initial","persisted","persistence","parsed","JSON","parse","getTheme","setTheme","nextTheme","stringify","getSnapshot"],"mappings":";;;;;;;;;;;;;AACA,SAASA,cAAc,EAAEC,aAAa,QAAQ,eAAe;AAC7D,SAASC,kBAAkB,EAAEC,mBAAmB,QAAQ,gBAAgB;AAExE,SAASC,qBAAqBC,KAAoB;IAChD,IAAI,OAAOC,aAAa,aAAa;QACnC;IACF;IAEA,MAAMC,OAAOD,SAASE,eAAe;IACrCD,KAAKE,SAAS,CAACC,MAAM,CAAC,SAAS;IAE/B,MAAMC,eAAeN,MAAMO,IAAI,KAAK,WAC/B,OAAOC,WAAW,eAAeA,OAAOC,UAAU,CAAC,gCAAgCC,OAAO,GACzF,SACA,UACFV,MAAMO,IAAI;IAEdL,KAAKE,SAAS,CAACO,GAAG,CAACL;IAEnB,IAAIN,MAAMY,YAAY,EAAE;QACtBV,KAAKW,KAAK,CAACC,WAAW,CAAC,uBAAuBd,MAAMY,YAAY;IAClE;IAEA,IAAIZ,MAAMe,MAAM,EAAE;QAChBC,OAAOC,OAAO,CAACjB,MAAMe,MAAM,EAAEG,OAAO,CAAC,CAAC,CAACC,OAAOC,WAAW;YACvDlB,KAAKW,KAAK,CAACC,WAAW,CAAC,CAAC,EAAE,EAAEK,OAAO,EAAEE,OAAOD;QAC9C;IACF;AACF;AAEA,OAAO,MAAME;IAIX,MAAaC,WAAWC,OAA6B,EAAiB;QACpE,IAAI,CAACC,MAAM,GAAGD,QAAQC,MAAM,CAACzB,KAAK;QAClC,IAAI,CAACA,KAAK,GAAG;YAAE,GAAGJ,aAAa;YAAE,GAAI,IAAI,CAAC6B,MAAM,CAACC,OAAO,IAAI,CAAC,CAAC;QAAE;QAEhE,MAAMC,YAAY,MAAM9B,mBAAmB,IAAI,CAAC4B,MAAM,CAACG,WAAW;QAClE,IAAID,WAAW;YACb,IAAI;gBACF,MAAME,SAASC,KAAKC,KAAK,CAACJ;gBAC1B,IAAI,CAAC3B,KAAK,GAAG;oBAAE,GAAG,IAAI,CAACA,KAAK;oBAAE,GAAG6B,MAAM;gBAAC;YAC1C,EAAE,OAAM;YACN,sBAAsB;YACxB;QACF;QAEA9B,qBAAqB,IAAI,CAACC,KAAK;IACjC;IAEOgC,WAA0B;QAC/B,OAAO;YAAE,GAAG,IAAI,CAAChC,KAAK;QAAC;IACzB;IAEA,MAAaiC,SAASC,SAAwB,EAAiB;QAC7D,IAAI,CAAClC,KAAK,GAAG;YAAE,GAAGkC,SAAS;QAAC;QAC5BnC,qBAAqB,IAAI,CAACC,KAAK;QAC/B,MAAMF,oBAAoB,IAAI,CAAC2B,MAAM,CAACG,WAAW,EAAEE,KAAKK,SAAS,CAAC,IAAI,CAACnC,KAAK;IAC9E;IAEOoC,cAA6B;QAClC,OAAO,IAAI,CAACJ,QAAQ;IACtB;;QAhCA,uBAAQhC,SAAuBJ;QAC/B,uBAAQ6B,UAAgC9B,eAAeK,KAAK;;AAgC9D"}

package/dist/kernel/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kernel/types.ts"],"names":[],"mappings":""}

package/dist/kernel/types.d.ts

@@ -0,0 +1,72 @@
+import type { LogLevel } from '../utils';
+import type { LangType } from '../library/locale/types';
+import type { StartOptions as CoreStartOptions } from '../core/types';
+import type { StorageOptions } from '../types';
+export type KernelInstanceId = string;
+export type KernelStorageDriver = 'localStorage' | 'sessionStorage' | 'indexedDB' | 'none';
+export interface ThemeSnapshot {
+    mode: 'light' | 'dark' | 'system';
+    primaryColor?: string;
+    tokens?: Record<string, string | number>;
+}
+export interface I18nSnapshot {
+    locale: LangType;
+    resources?: Record<LangType, Record<string, unknown>>;
+}
+export interface PersistenceOptions {
+    enabled?: boolean;
+    storage?: KernelStorageDriver;
+    key?: string;
+}
+export interface LoggerManagerConfig {
+    level?: LogLevel;
+    persistence?: PersistenceOptions;
+}
+export interface CacheManagerConfig {
+    enabled?: boolean;
+    storageOptions?: Partial<StorageOptions>;
+}
+export interface ThemeManagerConfig {
+    initial?: ThemeSnapshot;
+    persistence?: PersistenceOptions;
+}
+export interface I18nManagerConfig {
+    initial?: I18nSnapshot;
+    persistence?: PersistenceOptions;
+}
+export interface KernelConfig {
+    logger: LoggerManagerConfig;
+    cache: CacheManagerConfig;
+    theme: ThemeManagerConfig;
+    i18n: I18nManagerConfig;
+}
+export interface KernelTimingMetric {
+    phase: string;
+    startTime: number;
+    endTime: number;
+    duration: number;
+}
+export interface KernelManagerContext {
+    instanceId: KernelInstanceId;
+    config: KernelConfig;
+}
+export interface KernelManager<TSnapshot = unknown> {
+    initialize: (context: KernelManagerContext) => Promise<void> | void;
+    getSnapshot?: () => TSnapshot;
+    destroy?: () => Promise<void> | void;
+}
+export interface KernelRenderContext {
+    instanceId: KernelInstanceId;
+    config: KernelConfig;
+}
+export interface StartupHooks {
+    initialize?: () => Promise<void> | void;
+}
+export interface StartOptions extends CoreStartOptions {
+    config?: Partial<KernelConfig>;
+    configLoader?: () => Promise<Partial<KernelConfig> | void> | Partial<KernelConfig> | void;
+    render?: (context: KernelRenderContext) => Promise<void> | void;
+    customManagers?: Record<string, KernelManager>;
+    hooks?: StartupHooks;
+}
+export type KernelStartOptions = StartOptions;

package/dist/kernel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/kernel/types.ts"],"sourcesContent":["import type { LogLevel } from '../utils';\nimport type { LangType } from '../library/locale/types';\nimport type { StartOptions as CoreStartOptions } from '../core/types';\nimport type { StorageOptions } from '../types';\n\nexport type KernelInstanceId = string;\nexport type KernelStorageDriver = 'localStorage' | 'sessionStorage' | 'indexedDB' | 'none';\n\nexport interface ThemeSnapshot {\n  mode: 'light' | 'dark' | 'system';\n  primaryColor?: string;\n  tokens?: Record<string, string | number>;\n}\n\nexport interface I18nSnapshot {\n  locale: LangType;\n  resources?: Record<LangType, Record<string, unknown>>;\n}\n\nexport interface PersistenceOptions {\n  enabled?: boolean;\n  storage?: KernelStorageDriver;\n  key?: string;\n}\n\nexport interface LoggerManagerConfig {\n  level?: LogLevel;\n  persistence?: PersistenceOptions;\n}\n\nexport interface CacheManagerConfig {\n  enabled?: boolean;\n  storageOptions?: Partial<StorageOptions>;\n}\n\nexport interface ThemeManagerConfig {\n  initial?: ThemeSnapshot;\n  persistence?: PersistenceOptions;\n}\n\nexport interface I18nManagerConfig {\n  initial?: I18nSnapshot;\n  persistence?: PersistenceOptions;\n}\n\nexport interface KernelConfig {\n  logger: LoggerManagerConfig;\n  cache: CacheManagerConfig;\n  theme: ThemeManagerConfig;\n  i18n: I18nManagerConfig;\n}\n\nexport interface KernelTimingMetric {\n  phase: string;\n  startTime: number;\n  endTime: number;\n  duration: number;\n}\n\nexport interface KernelManagerContext {\n  instanceId: KernelInstanceId;\n  config: KernelConfig;\n}\n\nexport interface KernelManager<TSnapshot = unknown> {\n  initialize: (context: KernelManagerContext) => Promise<void> | void;\n  getSnapshot?: () => TSnapshot;\n  destroy?: () => Promise<void> | void;\n}\n\nexport interface KernelRenderContext {\n  instanceId: KernelInstanceId;\n  config: KernelConfig;\n}\n\nexport interface StartupHooks {\n  initialize?: () => Promise<void> | void;\n}\n\nexport interface StartOptions extends CoreStartOptions {\n  config?: Partial<KernelConfig>;\n  configLoader?: () => Promise<Partial<KernelConfig> | void> | Partial<KernelConfig> | void;\n  render?: (context: KernelRenderContext) => Promise<void> | void;\n  customManagers?: Record<string, KernelManager>;\n  hooks?: StartupHooks;\n}\n\nexport type KernelStartOptions = StartOptions;\n"],"names":[],"mappings":"AAuFA,WAA8C"}

package/dist/library/storage/index.cjs

@@ -57,7 +57,7 @@ let Storage = class Storage {
     }
     /**
    * 获取单例实例
-   * 
+   *
    * @returns Singleton 实例
    */ static getInstance() {
         if (!Storage.instance) {