@saolabs/client 1.0.0

package/README.md

@@ -0,0 +1,221 @@
+# Saola Client
+
+> Modern TypeScript Framework for Laravel - Reactive SPAs with TypeScript-first approach
+
+[![npm version](https://badge.fury.io/js/saola-client.svg)](https://badge.fury.io/js/saola-client)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Saola Client is the TypeScript runtime library for building reactive single-page applications that integrate seamlessly with Laravel backends.
+
+## Features
+
+- ⚡ **TypeScript First**: Full TypeScript support with excellent type safety
+- 🎨 **Reactive Views**: Built-in reactive view system with automatic state management
+- 📦 **Modular Architecture**: Component-based architecture for scalable applications
+- 🔄 **Hot Module Replacement**: Development watch mode with automatic compilation
+- 🚀 **Laravel Integration**: Seamless integration with Laravel backends
+- 📱 **SSR Support**: Server-side rendering capabilities
+- 🎯 **Lightweight**: Minimal bundle size with tree-shaking support
+- 🔧 **Developer Friendly**: Excellent DX with CLI tools and build utilities
+
+## Installation
+
+```bash
+npm install saola-client
+# or
+yarn add saola-client
+# or
+pnpm add saola-client
+```
+
+## Quick Start
+
+### Basic Setup
+
+```typescript
+import { Application, app, appContainer } from 'saola-client';
+import { ViewController } from 'saola-client';
+
+// Initialize your app
+const app = new Application({
+  el: '#app',
+  debug: true
+});
+
+await app.init();
+```
+
+### Creating a View
+
+```typescript
+import { ViewBase, ViewController } from 'saola-client';
+
+export class HomeView extends ViewBase {
+  constructor() {
+    super('home', 'home-template');
+  }
+
+  onMount() {
+    // Initialize view logic
+  }
+}
+
+export class HomeController extends ViewController {
+  view = HomeView;
+
+  onLoad() {
+    // Handle view data loading
+  }
+}
+```
+
+### Routing
+
+```typescript
+import { Router } from 'saola-client';
+
+const router = new Router();
+
+router.register('home', HomeController);
+router.register('about', AboutController);
+
+router.navigate('home');
+```
+
+### State Management
+
+```typescript
+import { ViewState, StateManager } from 'saola-client';
+
+const state = new ViewState({
+  count: 0,
+  user: null
+});
+
+state.count = 5; // Trigger reactive updates
+state.subscribe(newState => {
+  console.log('State updated:', newState);
+});
+```
+
+## API Reference
+
+### Core Classes
+
+#### Application
+
+The main application class that manages the lifecycle of your Saola app.
+
+```typescript
+import { Application } from 'saola-client';
+
+const app = new Application({
+  el: '#app',           // Mount element
+  debug: true,          // Enable debug mode
+  baseUrl: '/app'       // Base URL for routing
+});
+```
+
+#### View System
+
+```typescript
+import { View, ViewController, ViewManager } from 'saola-client';
+
+// Create a view
+class MyView extends View {
+  template = '<div>Hello World</div>';
+
+  onMount() {
+    console.log('View mounted');
+  }
+}
+
+// Create a controller
+class MyController extends ViewController {
+  view = MyView;
+
+  onLoad() {
+    // Load data
+  }
+}
+```
+
+#### Router
+
+```typescript
+import { Router } from 'saola-client';
+
+const router = new Router();
+
+// Register routes
+router.register('home', HomeController);
+router.register('user/:id', UserController);
+
+// Navigate
+router.navigate('home');
+router.navigate('user/123');
+```
+
+## Plugins
+
+Extend Saola Client with plugins:
+
+```typescript
+import { PluginManager } from 'saola-client/plugins';
+
+const pluginManager = new PluginManager();
+
+// Register and install plugins
+pluginManager
+  .register(myPlugin)
+  .install('myPlugin', { option: 'value' });
+```
+
+## Development
+
+### Building
+
+```bash
+npm run build    # Build for production
+npm run dev      # Watch mode for development
+npm run clean    # Clean build artifacts
+```
+
+### Testing
+
+```bash
+npm test
+```
+
+## Integration with Saola Compiler
+
+Saola Client works seamlessly with [Saola Compiler](https://github.com/saolabs/saola-compiler) to compile `.one` files into Blade templates and JavaScript.
+
+```bash
+# Install both packages
+npm install saola-client saola-compiler
+
+# Use in your Laravel project
+# The compiler will generate files that use saola-client
+```
+
+## Contributing
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add some amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Related Projects
+
+- [Saola Compiler](https://github.com/saolabs/saola-compiler) - Template compiler for .one files
+- [Saola Language Support](https://github.com/saolabs/saola-language-support) - VS Code extension for .one files
+
+---
+
+**Built with ❤️ by Saola Labs**

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * OneJS V2 - Main Export
+ * TypeScript Core with Optimizations
+ */
+export { Application } from './src/core/app/Application.js';
+export { app } from './src/core/hellpers/app.js';
+export { default as App } from './src/core/bootstrap/app.js';
+export { MarkerService } from './src/core/services/MarkerService.js';
+export { EventService } from './src/core/services/EventService.js';
+export { HttpService } from './src/core/services/HttpService.js';
+export { StoreService } from './src/core/services/StoreService.js';
+export { StorageService } from './src/core/services/StorageService.js';
+export { LoggerService } from './src/core/services/LoggerService.js';
+export { HelperService, CollectionProxy } from './src/core/services/HelperService.js';
+export { BlockManagerService, BlockManager } from './src/core/services/BlockManager.js';
+export { MarkerRegistry, MarkerRegistryService } from './src/core/services/MarkerRegistry.js';
+export { View, ViewController, ViewManager, ViewState, StateManager, LoopContext } from './src/core/view/index.js';
+export { Router, ActiveRoute, useRoute, useParams, useQuery } from './src/core/routers/Router.js';
+export { Reactive } from './src/core/elements/Reactive.js';
+export { Block } from './src/core/elements/Block.js';
+export { BlockOutlet } from './src/core/elements/BlockOutlet.js';
+export { Html } from './src/core/elements/Html.js';
+export { Fragment } from './src/core/elements/Fragment.js';
+export { Component } from './src/core/elements/Component.js';
+export { TextElement } from './src/core/elements/TextElement.js';
+export { Output } from './src/core/elements/Output.js';
+export { Wrapper } from './src/core/elements/Wrapper.js';
+export { ElementManager } from './src/core/elements/ElementManager.js';
+export { Dom, DomService } from './src/core/services/DomService.js';
+export { ApiClient } from './src/core/hellpers/ApiClient.js';
+export type { ApplicationInterface } from './src/core/contracts/ApplicationInterface.js';
+export type { HelperInterface, CollectionProxyInterface } from './src/core/contracts/HelperInterface.js';
+export type { EventServiceInterface } from './src/core/contracts/EventServiceInterface.js';
+export type { HttpServiceInterface, HttpRequestConfig, HttpResponse, HttpInterceptor } from './src/core/contracts/HttpServiceInterface.js';
+export type { StoreServiceInterface } from './src/core/contracts/StoreServiceInterface.js';
+export type { StorageServiceInterface } from './src/core/contracts/StorageServiceInterface.js';
+export type { LoggerServiceInterface, LoggerConfig, LogLevel } from './src/core/contracts/LoggerServiceInterface.js';
+export type { ViewInterface } from './src/core/contracts/ViewInterface.js';
+export type { ViewControllerInterface } from './src/core/contracts/ViewControllerInterface.js';
+export type { ViewManagerInterface } from './src/core/contracts/ViewManagerInterface.js';
+export type { ReactiveInterface } from './src/core/contracts/ReactiveInterface.js';
+export type { RouterInterface } from './src/core/contracts/RouterInterface.js';
+export type { RouteDefinition, Route, RouteMatch, RouterConfig } from './src/core/routers/Router.js';
+export type { MarkerRecord, MarkerTagName } from './src/core/contracts/MarkerInterface.js';
+export type { APIEndpoints } from './src/core/hellpers/ApiClient.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * OneJS V2 - Main Export
+ * TypeScript Core with Optimizations
+ */
+// App
+export { Application } from './src/core/app/Application.js';
+export { app } from './src/core/hellpers/app.js';
+export { default as App } from './src/core/bootstrap/app.js';
+// Services
+export { MarkerService } from './src/core/services/MarkerService.js';
+export { EventService } from './src/core/services/EventService.js';
+export { HttpService } from './src/core/services/HttpService.js';
+export { StoreService } from './src/core/services/StoreService.js';
+export { StorageService } from './src/core/services/StorageService.js';
+export { LoggerService } from './src/core/services/LoggerService.js';
+export { HelperService, CollectionProxy } from './src/core/services/HelperService.js';
+export { BlockManagerService, BlockManager } from './src/core/services/BlockManager.js';
+export { MarkerRegistry, MarkerRegistryService } from './src/core/services/MarkerRegistry.js';
+// View System
+export { View, ViewController, ViewManager, ViewState, StateManager, LoopContext } from './src/core/view/index.js';
+// Router
+export { Router, ActiveRoute, useRoute, useParams, useQuery } from './src/core/routers/Router.js';
+// Elements
+export { Reactive } from './src/core/elements/Reactive.js';
+export { Block } from './src/core/elements/Block.js';
+export { BlockOutlet } from './src/core/elements/BlockOutlet.js';
+export { Html } from './src/core/elements/Html.js';
+export { Fragment } from './src/core/elements/Fragment.js';
+export { Component } from './src/core/elements/Component.js';
+export { TextElement } from './src/core/elements/TextElement.js';
+export { Output } from './src/core/elements/Output.js';
+export { Wrapper } from './src/core/elements/Wrapper.js';
+export { ElementManager } from './src/core/elements/ElementManager.js';
+// DOM
+export { Dom, DomService } from './src/core/services/DomService.js';
+// Helpers
+export { ApiClient } from './src/core/hellpers/ApiClient.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM;AACN,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAE7D,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9F,cAAc;AACd,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEnH,SAAS;AACT,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAElG,WAAW;AACX,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAGvE,MAAM;AACN,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAEpE,UAAU;AACV,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/plugins.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OneView Plugins
+ * Extension system for OneView framework
+ */
+export interface PluginOptions {
+    [key: string]: unknown;
+}
+export interface Plugin {
+    name: string;
+    install(options?: PluginOptions): void;
+}
+declare class PluginManager {
+    private plugins;
+    private installed;
+    /**
+     * Register a plugin
+     */
+    register(plugin: Plugin): this;
+    /**
+     * Install a registered plugin
+     */
+    install(name: string, options?: PluginOptions): this;
+    /**
+     * Check if a plugin is installed
+     */
+    isInstalled(name: string): boolean;
+    /**
+     * Get all registered plugins
+     */
+    getPlugins(): Plugin[];
+}
+export declare const pluginManager: PluginManager;
+/**
+ * Create a plugin
+ */
+export declare function createPlugin(name: string, install: (options?: PluginOptions) => void): Plugin;
+export default pluginManager;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.ts","sourceRoot":"","sources":["../plugins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACxC;AAED,cAAM,aAAa;IACjB,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAA0B;IAE3C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAS9B;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAgBpD;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;CAGvB;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE,aAAa,KAAK,IAAI,GAAG,MAAM,CAK7F;AAED,eAAe,aAAa,CAAC"}

package/dist/plugins.js

@@ -0,0 +1,61 @@
+/**
+ * OneView Plugins
+ * Extension system for OneView framework
+ */
+class PluginManager {
+    constructor() {
+        this.plugins = new Map();
+        this.installed = new Set();
+    }
+    /**
+     * Register a plugin
+     */
+    register(plugin) {
+        if (this.plugins.has(plugin.name)) {
+            console.warn(`Plugin "${plugin.name}" is already registered`);
+            return this;
+        }
+        this.plugins.set(plugin.name, plugin);
+        return this;
+    }
+    /**
+     * Install a registered plugin
+     */
+    install(name, options) {
+        const plugin = this.plugins.get(name);
+        if (!plugin) {
+            throw new Error(`Plugin "${name}" is not registered`);
+        }
+        if (this.installed.has(name)) {
+            console.warn(`Plugin "${name}" is already installed`);
+            return this;
+        }
+        plugin.install(options);
+        this.installed.add(name);
+        return this;
+    }
+    /**
+     * Check if a plugin is installed
+     */
+    isInstalled(name) {
+        return this.installed.has(name);
+    }
+    /**
+     * Get all registered plugins
+     */
+    getPlugins() {
+        return Array.from(this.plugins.values());
+    }
+}
+export const pluginManager = new PluginManager();
+/**
+ * Create a plugin
+ */
+export function createPlugin(name, install) {
+    return {
+        name,
+        install
+    };
+}
+export default pluginManager;
+//# sourceMappingURL=plugins.js.map

package/dist/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sourceRoot":"","sources":["../plugins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,aAAa;IAAnB;QACU,YAAO,GAAwB,IAAI,GAAG,EAAE,CAAC;QACzC,cAAS,GAAgB,IAAI,GAAG,EAAE,CAAC;IA8C7C,CAAC;IA5CC;;OAEG;IACH,QAAQ,CAAC,MAAc;QACrB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,IAAI,yBAAyB,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,IAAY,EAAE,OAAuB;QAC3C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,qBAAqB,CAAC,CAAC;QACxD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,WAAW,IAAI,wBAAwB,CAAC,CAAC;YACtD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAA0C;IACnF,OAAO;QACL,IAAI;QACJ,OAAO;KACR,CAAC;AACJ,CAAC;AAED,eAAe,aAAa,CAAC"}

package/dist/src/core/app/Application.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Application — DI Container + App Lifecycle.
+ *
+ * Tương tự Laravel Service Container:
+ *   - bind / singleton / instance  → đăng ký service
+ *   - make / resolve               → lấy service
+ *   - alias                        → tên tắt
+ *   - register / boot              → service providers
+ *
+ * Khác với core Application (hardcode services), bản này hoàn toàn DI-driven:
+ * mọi service (Router, ViewManager, Store...) đều được đăng ký qua providers.
+ *
+ * @example
+ * const app = new Application();
+ *
+ * // Đăng ký trực tiếp
+ * app.singleton('markerRegistry', MarkerRegistry);
+ * app.instance('config', { debug: true });
+ *
+ * // Đăng ký qua provider
+ * app.register({
+ *     register(app) { app.singleton('router', () => new Router(app)); },
+ *     boot(app) { app.make('router').start(); }
+ * });
+ *
+ * app.boot();
+ * const router = app.make('router');
+ */
+import type { ApplicationInterface, ServiceKey, ServiceFactory, ServiceBinding } from '../contracts/ApplicationInterface';
+import type { ServiceProviderInterface } from '../contracts/ServiceProviderInterface';
+import type { ViewManagerInterface, RouterInterface } from '../contracts/utils';
+import type { HelperInterface } from '../contracts/HelperInterface';
+import type { EventServiceInterface } from '../contracts/EventServiceInterface';
+import type { HttpServiceInterface } from '../contracts/HttpServiceInterface';
+import type { StoreServiceInterface } from '../contracts/StoreServiceInterface';
+import type { StorageServiceInterface } from '../contracts/StorageServiceInterface';
+import type { LoggerServiceInterface } from '../contracts/LoggerServiceInterface';
+import { APIClientInterface } from '../contracts/ApiInterface';
+import { OneObjectType } from '../types/utils';
+export declare class Application implements ApplicationInterface {
+    readonly oneType: OneObjectType;
+    isInitialized: boolean;
+    isStarted: boolean;
+    View: ViewManagerInterface;
+    Router: RouterInterface;
+    Helper: HelperInterface;
+    Events: EventServiceInterface;
+    Http: HttpServiceInterface;
+    API: APIClientInterface;
+    Store: StoreServiceInterface;
+    Storage: StorageServiceInterface;
+    Logger: LoggerServiceInterface;
+    /** Factory bindings — mỗi lần make() gọi factory tạo instance mới */
+    private bindings;
+    /** Singleton instances — tạo một lần, reuse */
+    private singletons;
+    /** Aliases — tên tắt trỏ về key gốc */
+    private aliases;
+    /** Service providers đã đăng ký */
+    private providers;
+    /** Đã boot chưa */
+    private booted;
+    private ownProperties;
+    __store: Map<string, {
+        isOverridable: boolean;
+        value: any;
+    }>;
+    [key: string]: any;
+    constructor();
+    /**
+     * Đăng ký transient service.
+     * Mỗi lần make() trả về instance mới (không cache).
+     *
+     * @example
+     * app.transient('request', (app) => new Request(app.make('config')));
+     * app.transient(Database, Database); // class shorthand
+     */
+    transient<T>(key: ServiceKey<T>, value: ServiceBinding<T>): this;
+    bind<T>(key: ServiceKey<T>, value: ServiceBinding<T>): this;
+    /**
+     * Đăng ký singleton — tạo một lần, reuse mãi mãi.
+     *
+     * @example
+     * app.singleton('store', StoreService);           // class
+     * app.singleton('config', (app) => loadConfig()); // factory
+     * app.singleton(StoreService);                    // class, tự tạo
+     * app.singleton('store', existingInstance);        // instance sẵn
+     */
+    singleton<T>(key: ServiceKey<T>, value?: ServiceBinding<T> | T): this;
+    /**
+     * Đăng ký instance đã tạo sẵn.
+     * Shortcut cho singleton khi đã có instance.
+     *
+     * @example
+     * app.instance('config', { debug: true, api_url: '/api' });
+     */
+    instance<T>(key: ServiceKey<T>, value: T): this;
+    /**
+     * Tạo tên tắt cho service.
+     *
+     * @example
+     * app.singleton('email.service', EmailService);
+     * app.alias('mailer', 'email.service');
+     * app.make('mailer') === app.make('email.service') // true
+     */
+    alias(alias: string | symbol, key: ServiceKey): this;
+    /**
+     * Lấy service instance. Shortcut cho resolve().
+     *
+     * @example
+     * const router = app.make<Router>('router');
+     */
+    make<T>(key: ServiceKey<T>, defaultValue?: T): T;
+    /**
+     * Resolve service instance.
+     *
+     * Thứ tự tìm:
+     *   1. Alias → resolve key gốc
+     *   2. Singleton đã tạo → reuse
+     *   3. Binding (factory) → gọi factory
+     *   4. Key là class → auto-instantiate + cache
+     *   5. defaultValue → trả về
+     *   6. Throw error
+     */
+    resolve<T>(key: ServiceKey<T>, defaultValue?: T): T;
+    /** Kiểm tra service đã đăng ký chưa */
+    has(key: ServiceKey): boolean;
+    /** Alias cho has() */
+    bound(key: ServiceKey): boolean;
+    /**
+     * Đăng ký service provider.
+     * register() được gọi ngay, boot() gọi khi app.boot().
+     *
+     * @example
+     * app.register({
+     *     register(app) { app.singleton('db', Database); },
+     *     boot(app) { app.make('db').connect(); }
+     * });
+     */
+    register(provider: ServiceProviderInterface): this;
+    /**
+     * Boot tất cả providers.
+     * Gọi boot() của mỗi provider theo thứ tự đăng ký.
+     * Chỉ chạy một lần.
+     */
+    boot(): void;
+    /** Đã boot chưa */
+    get isBooted(): boolean;
+    /** Xóa toàn bộ bindings, singletons, aliases, __store. Reset container. */
+    flush(): void;
+    /** Destroy app — flush + cleanup */
+    destroy(): void;
+    getBindings(): Map<ServiceKey, ServiceFactory<any>>;
+    getSingletons(): Map<ServiceKey, any>;
+    set<T = any>(name: string, value: T, isOne?: boolean): void;
+    get<T = any>(name: string): T;
+    setMethod(name: string, method: Function, isOne?: boolean): void;
+}
+//# sourceMappingURL=Application.d.ts.map

package/dist/src/core/app/Application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../../src/core/app/Application.ts"],"names":[],"mappings":"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"}