@cruxjs/base 0.1.4 → 0.1.5

package/README.md

@@ -8,7 +8,7 @@
 </div>
 
 <div align="center">
-    <img src="https://img.shields.io/badge/v-0.1.4-black"/>
+    <img src="https://img.shields.io/badge/v-0.1.5-black"/>
     <img src="https://img.shields.io/badge/🔥-@cruxjs-black"/>
     <br>
     <img src="https://img.shields.io/github/issues/cruxjs-org/base?style=flat" alt="Github Repo Issues" />

package/dist/index.d.cts

@@ -1,5 +1,7 @@
 import { TableSchema as TableSchema$1, DB } from '@minejs/db';
 import { AppContext as AppContext$1 } from '@minejs/server';
+import { I18nConfig } from '@minejs/i18n';
+import { JSXElement } from '@minejs/jsx';
 import { Logger } from '@minejs/logger';
 
 type AppContext = AppContext$1;
@@ -140,6 +142,54 @@ interface AppInstance {
     getContext(): LifecycleContext;
     getMiddleware(name: string): AppMiddleware | undefined;
 }
+type RouteComponent = () => JSXElement | null;
+interface ThemeConfig {
+    default: string;
+    available: string[];
+}
+type LangConfig = I18nConfig;
+/**
+ * Client-side extension system
+ * Extensions can hook into lifecycle phases to extend functionality
+ * (logging, analytics, error handling, etc.)
+ */
+interface ClientExtension {
+    name: string;
+    config?: Record<string, unknown>;
+    onBoot?: (context: ExtensionContext) => void | Promise<void>;
+    onReady?: (context: ExtensionContext) => void | Promise<void>;
+    onDestroy?: (context: ExtensionContext) => void | Promise<void>;
+}
+/**
+ * Context passed to extension lifecycle hooks
+ */
+interface ExtensionContext {
+    debug: boolean;
+    config: Record<string, unknown>;
+    cconfig: ClientManagerConfig;
+}
+/**
+ * Lifecycle hooks for the client application
+ */
+interface ClientManagerHooks {
+    onBoot?: () => void | Promise<void>;
+    onReady?: () => void | Promise<void>;
+    onDestroy?: () => void | Promise<void>;
+}
+/**
+ * Client Manager Configuration
+ * Declarative configuration pattern mirroring @cruxjs/app AppConfig
+ */
+interface ClientManagerConfig {
+    routes: Record<string, RouteComponent>;
+    notFoundComponent?: RouteComponent;
+    rootLayout?: () => JSXElement | null;
+    debug?: boolean;
+    lifecycle?: ClientManagerHooks;
+    extensions?: ClientExtension[];
+    i18n?: I18nConfig;
+    theme?: ThemeConfig;
+}
 
 declare const logger: Logger;
 
@@ -164,4 +214,4 @@ declare class PluginRegistry {
     collectStatic(): StaticConfig[];
 }
 
-export { type AppConfig, type AppContext, type AppInstance, type AppMiddleware, type CruxPlugin, type LifecycleContext, type LifecycleHooks, type MiddlewareExport, PluginRegistry, ResourceMerger, type RouteDefinition, type StaticConfig, type TableSchema, logger };
+export { type AppConfig, type AppContext, type AppInstance, type AppMiddleware, type ClientExtension, type ClientManagerConfig, type ClientManagerHooks, type CruxPlugin, type ExtensionContext, type LangConfig, type LifecycleContext, type LifecycleHooks, type MiddlewareExport, PluginRegistry, ResourceMerger, type RouteComponent, type RouteDefinition, type StaticConfig, type TableSchema, type ThemeConfig, logger };

package/dist/index.d.ts

@@ -1,5 +1,7 @@
 import { TableSchema as TableSchema$1, DB } from '@minejs/db';
 import { AppContext as AppContext$1 } from '@minejs/server';
+import { I18nConfig } from '@minejs/i18n';
+import { JSXElement } from '@minejs/jsx';
 import { Logger } from '@minejs/logger';
 
 type AppContext = AppContext$1;
@@ -140,6 +142,54 @@ interface AppInstance {
     getContext(): LifecycleContext;
     getMiddleware(name: string): AppMiddleware | undefined;
 }
+type RouteComponent = () => JSXElement | null;
+interface ThemeConfig {
+    default: string;
+    available: string[];
+}
+type LangConfig = I18nConfig;
+/**
+ * Client-side extension system
+ * Extensions can hook into lifecycle phases to extend functionality
+ * (logging, analytics, error handling, etc.)
+ */
+interface ClientExtension {
+    name: string;
+    config?: Record<string, unknown>;
+    onBoot?: (context: ExtensionContext) => void | Promise<void>;
+    onReady?: (context: ExtensionContext) => void | Promise<void>;
+    onDestroy?: (context: ExtensionContext) => void | Promise<void>;
+}
+/**
+ * Context passed to extension lifecycle hooks
+ */
+interface ExtensionContext {
+    debug: boolean;
+    config: Record<string, unknown>;
+    cconfig: ClientManagerConfig;
+}
+/**
+ * Lifecycle hooks for the client application
+ */
+interface ClientManagerHooks {
+    onBoot?: () => void | Promise<void>;
+    onReady?: () => void | Promise<void>;
+    onDestroy?: () => void | Promise<void>;
+}
+/**
+ * Client Manager Configuration
+ * Declarative configuration pattern mirroring @cruxjs/app AppConfig
+ */
+interface ClientManagerConfig {
+    routes: Record<string, RouteComponent>;
+    notFoundComponent?: RouteComponent;
+    rootLayout?: () => JSXElement | null;
+    debug?: boolean;
+    lifecycle?: ClientManagerHooks;
+    extensions?: ClientExtension[];
+    i18n?: I18nConfig;
+    theme?: ThemeConfig;
+}
 
 declare const logger: Logger;
 
@@ -164,4 +214,4 @@ declare class PluginRegistry {
     collectStatic(): StaticConfig[];
 }
 
-export { type AppConfig, type AppContext, type AppInstance, type AppMiddleware, type CruxPlugin, type LifecycleContext, type LifecycleHooks, type MiddlewareExport, PluginRegistry, ResourceMerger, type RouteDefinition, type StaticConfig, type TableSchema, logger };
+export { type AppConfig, type AppContext, type AppInstance, type AppMiddleware, type ClientExtension, type ClientManagerConfig, type ClientManagerHooks, type CruxPlugin, type ExtensionContext, type LangConfig, type LifecycleContext, type LifecycleHooks, type MiddlewareExport, PluginRegistry, ResourceMerger, type RouteComponent, type RouteDefinition, type StaticConfig, type TableSchema, type ThemeConfig, logger };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cruxjs/base",
-	"version": "0.1.4",
+	"version": "0.1.5",
 	"description": "Core types and utilities for building CruxJS applications and plugins. A shared foundation for @cruxjs/app and plugin packages.",
 	"keywords": ["cruxjs", "base", "types"],
 	"license": "MIT",
@@ -40,12 +40,14 @@
 		"bun": "^1.3.3"
 	},
 	"dependencies": {
-		"@minejs/db": "^0.0.3",
-		"@minejs/logger": "^0.0.2",
-		"@minejs/server": "^0.1.4"
+		"@minejs/logger": "^0.0.2"
 	},
 	"devDependencies": {
 		"@eslint/js": "^9.39.2",
+		"@minejs/db": "^0.0.3",
+		"@minejs/i18n": "^0.1.3",
+		"@minejs/jsx": "^0.0.9",
+		"@minejs/server": "^0.1.4",
 		"@stylistic/eslint-plugin": "^5.7.0",
 		"@types/bun": "^1.3.6",
 		"@types/node": "^20.19.29",