@saolabs/client 1.0.0 → 1.1.0

package/README.md

@@ -1,221 +1,78 @@
-# Saola Client
+# @saolabs/client
 
-> Modern TypeScript Framework for Laravel - Reactive SPAs with TypeScript-first approach
+Runtime TypeScript phía trình duyệt của Saola: hydration HTML do Laravel render,
+state, component, điều hướng SPA và vòng đời tài nguyên.
 
-[![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
+## Bắt đầu
 
 ```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);
-});
+npm install @saolabs/client
+npm install --save-dev @saolabs/builder typescript
+composer require saola/core saola/compiler
 ```
 
-## API Reference
+Viết giao diện bằng `.sao`, để compiler sinh class View và registry. Bắt đầu với
+[hướng dẫn component](../saola/docs/SAO_FILE.md) trong workspace hệ sinh thái.
+Compiler PHP sinh Blade SSR; client nhận DOM và xử lý tương tác trong browser.
 
-### Core Classes
+## Module và tương thích
 
-#### Application
+Package phát hành **ESM**. Các entry công khai:
 
-The main application class that manages the lifecycle of your Saola app.
+- `@saolabs/client`: runtime, services và kiểu dữ liệu.
+- `@saolabs/client/plugins`: `createPlugin`, `pluginManager`.
+- `@saolabs/client/testing`: `mount`, `mountView`, `nextFrame` và `Harness`.
 
-```typescript
-import { Application } from 'saola-client';
+```ts
+import { HttpService } from '@saolabs/client';
+import { createPlugin, pluginManager } from '@saolabs/client/plugins';
 
-const app = new Application({
-  el: '#app',           // Mount element
-  debug: true,          // Enable debug mode
-  baseUrl: '/app'       // Base URL for routing
-});
+const http = new HttpService();
+pluginManager.register(createPlugin('example', () => {
+    http.setTimeout(5000);
+})).install('example');
 ```
 
-#### View System
+Các công cụ CommonJS dùng `await import('@saolabs/client')`; package không cam kết
+`require()` đồng bộ. Runtime cần DOM (browser hoặc jsdom trong test), không phải
+renderer SSR chạy trong Node. Dùng PHP compiler cho SSR Laravel.
+Các import tương đối có đuôi `.js`; build và declaration được kiểm với NodeNext.
 
-```typescript
-import { View, ViewController, ViewManager } from 'saola-client';
+## Test component đã compile
 
-// Create a view
-class MyView extends View {
-  template = '<div>Hello World</div>';
+```ts
+import { mount, nextFrame } from '@saolabs/client/testing';
+import Counter from './compiled/counter.js';
 
-  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' });
+const counter = mount(Counter, {initial: 3});
+counter.container.querySelector('button')?.click();
+await nextFrame();
+console.log(counter.text());
+counter.destroy();
 ```
 
-## Development
+Chạy trong môi trường DOM. Với theme nạp rời, externalize `@saolabs/client` để
+app và theme dùng cùng một runtime; xem [bootstrap](docs/BOOTSTRAP_PROVIDER_GUIDE.md).
 
-### Building
+## Phát triển và kiểm chứng
 
 ```bash
-npm run build    # Build for production
-npm run dev      # Watch mode for development
-npm run clean    # Clean build artifacts
+npm run build          # ESM JS và declarations
+npm run typecheck      # Kiểm source, không emit
+npm test               # Runtime + compile-to-mount contract tests
+npm run check-exports  # Pack thật; kiểm 3 entry và types trong consumer tạm
 ```
 
-### 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
+`check-exports` không publish. Nó kiểm native ESM, dynamic import từ CommonJS,
+mount view qua package đã đóng và TypeScript NodeNext, không dùng alias source.
+Bộ test compile fixture cần sibling `builder/`, `compiler/`, `saola/` trong
+workspace hệ sinh thái. Thiếu builder là lỗi kiểm tra, không tự bỏ qua test.
 
-- [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
+## Tài liệu
 
----
+- [Runtime API](docs/RUNTIME_API_SPEC.md)
+- [Compiler contract](docs/COMPILER_CONTRACT.md)
+- [Testing](docs/TESTING.md)
+- [Devtools](docs/DEVTOOLS.md)
 
-**Built with ❤️ by Saola Labs**
+MIT.

package/dist/index.d.ts

@@ -3,9 +3,14 @@
  * TypeScript Core with Optimizations
  */
 export { Application } from './src/core/app/Application.js';
-export { app } from './src/core/hellpers/app.js';
+export { app } from './src/core/helpers/app.js';
 export { default as App } from './src/core/bootstrap/app.js';
-export { MarkerService } from './src/core/services/MarkerService.js';
+export { defineBundle, loadBundles, mergeBundles, bootBundles } from './src/core/bootstrap/bundle.js';
+export type { SaolaBundle, MergedBundles, ViewFactory } from './src/core/contracts/BundleInterface.js';
+export { ServiceProvider } from './src/core/bootstrap/providers/ServiceProvider.js';
+export { PROVIDER_NAMES, resolveProviderOrder } from './src/core/bootstrap/providers/provider-order.js';
+export type { NamedServiceProvider, ProviderName } from './src/core/bootstrap/providers/provider-order.js';
+export type { ServiceProviderInterface } from './src/core/contracts/ServiceProviderInterface.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';
@@ -14,7 +19,16 @@ 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 { PageCache, PageCacheService, detachWrapperDOM } from './src/core/services/PageCache.js';
+export type { PageCacheEntry, PageCacheSetOptions } from './src/core/services/PageCache.js';
+export { SectionManager, SectionManagerService } from './src/core/services/SectionManager.js';
+export { HeadService } from './src/core/services/HeadService.js';
+export { Devtools, devtools, inspector } from './src/core/devtools/index.js';
+export type { DevtoolsEvent, DevtoolsEventType, DevtoolsViewNode } from './src/core/devtools/index.js';
 export { View, ViewController, ViewManager, ViewState, StateManager, LoopContext } from './src/core/view/index.js';
+export type { ViewUserConfig } from './src/core/view/View.js';
+export { ResourceScope } from './src/core/view/ResourceScope.js';
+export type { WatchCallback, WatchContext, WatchOptions, Cleanup } from './src/core/view/ResourceScope.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';
@@ -27,7 +41,7 @@ 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 { ApiClient } from './src/core/helpers/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';
@@ -37,10 +51,11 @@ export type { StorageServiceInterface } from './src/core/contracts/StorageServic
 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 { ViewConfigThis, ViewRuntimeConfig } 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';
+export type { MarkerTagName } from './src/core/contracts/MarkerInterface.js';
+export type { APIEndpoints } from './src/core/helpers/ApiClient.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4,10 +4,15 @@
  */
 // App
 export { Application } from './src/core/app/Application.js';
-export { app } from './src/core/hellpers/app.js';
+export { app } from './src/core/helpers/app.js';
 export { default as App } from './src/core/bootstrap/app.js';
+// Bundle nạp rời (theme / gói mở rộng)
+export { defineBundle, loadBundles, mergeBundles, bootBundles } from './src/core/bootstrap/bundle.js';
+// Service Provider — lớp base + hằng tên, để app và theme viết provider của mình.
+// KHÔNG export thì cả tính năng "người dùng thêm provider" chỉ dùng được nội bộ.
+export { ServiceProvider } from './src/core/bootstrap/providers/ServiceProvider.js';
+export { PROVIDER_NAMES, resolveProviderOrder } from './src/core/bootstrap/providers/provider-order.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';
@@ -16,8 +21,14 @@ 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 { PageCache, PageCacheService, detachWrapperDOM } from './src/core/services/PageCache.js';
+export { SectionManager, SectionManagerService } from './src/core/services/SectionManager.js';
+export { HeadService } from './src/core/services/HeadService.js';
+// DevTools — tắt mặc định, xem docs/DEVTOOLS.md
+export { Devtools, devtools, inspector } from './src/core/devtools/index.js';
 // View System
 export { View, ViewController, ViewManager, ViewState, StateManager, LoopContext } from './src/core/view/index.js';
+export { ResourceScope } from './src/core/view/ResourceScope.js';
 // Router
 export { Router, ActiveRoute, useRoute, useParams, useQuery } from './src/core/routers/Router.js';
 // Elements
@@ -34,5 +45,5 @@ 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';
+export { ApiClient } from './src/core/helpers/ApiClient.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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,2BAA2B,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,6BAA6B,CAAC;AAE7D,uCAAuC;AACvC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAGtG,kFAAkF;AAClF,iFAAiF;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,mDAAmD,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAIxG,WAAW;AACX,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;AAC9F,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEjG,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,gDAAgD;AAChD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAG7E,cAAc;AACd,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEnH,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGjE,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,iCAAiC,CAAC"}

package/dist/plugins.d.ts

@@ -1,6 +1,6 @@
 /**
- * OneView Plugins
- * Extension system for OneView framework
+ * SaoView Plugins
+ * Extension system for SaoView framework
  */
 export interface PluginOptions {
     [key: string]: unknown;

package/dist/plugins.js

@@ -1,6 +1,6 @@
 /**
- * OneView Plugins
- * Extension system for OneView framework
+ * SaoView Plugins
+ * Extension system for SaoView framework
  */
 class PluginManager {
     constructor() {

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

@@ -26,19 +26,20 @@
  * 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';
+import type { ApplicationInterface, ServiceKey, ServiceFactory, ServiceBinding } from '../contracts/ApplicationInterface.js';
+import type { ServiceProviderInterface } from '../contracts/ServiceProviderInterface.js';
+import type { ViewManagerInterface, RouterInterface } from '../contracts/utils.js';
+import type { HelperInterface } from '../contracts/HelperInterface.js';
+import type { EventServiceInterface } from '../contracts/EventServiceInterface.js';
+import type { HttpServiceInterface } from '../contracts/HttpServiceInterface.js';
+import type { StoreServiceInterface } from '../contracts/StoreServiceInterface.js';
+import type { StorageServiceInterface } from '../contracts/StorageServiceInterface.js';
+import type { LoggerServiceInterface } from '../contracts/LoggerServiceInterface.js';
+import type { HeadServiceInterface } from '../contracts/HeadServiceInterface.js';
+import { APIClientInterface } from '../contracts/ApiInterface.js';
+import { SaoObjectType } from '../types/utils.js';
 export declare class Application implements ApplicationInterface {
-    readonly oneType: OneObjectType;
+    readonly saoType: SaoObjectType;
     isInitialized: boolean;
     isStarted: boolean;
     View: ViewManagerInterface;
@@ -50,6 +51,7 @@ export declare class Application implements ApplicationInterface {
     Store: StoreServiceInterface;
     Storage: StorageServiceInterface;
     Logger: LoggerServiceInterface;
+    Head: HeadServiceInterface;
     /** 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 */
@@ -61,7 +63,7 @@ export declare class Application implements ApplicationInterface {
     /** Đã boot chưa */
     private booted;
     private ownProperties;
-    __store: Map<string, {
+    __store: Map<any, {
         isOverridable: boolean;
         value: any;
     }>;
@@ -152,8 +154,16 @@ export declare class Application implements ApplicationInterface {
     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;
+    set<T = any>(name: any, value: T, isOne?: boolean): void;
+    get<T = any>(name: any): T;
+    /**
+     * Dữ liệu package PHP chia sẻ cho client theo từng request (`Saola::share()`
+     * → `APP_CONFIGS.shared` → `App.init({ shared })`). Helper JS của package đọc
+     * ở đây thay vì tự đọc `window`, để test truyền được qua config.
+     *
+     * @example App.shared('permission', { routes: [] }).routes
+     */
+    shared<T = any>(key?: string, fallback?: T): T;
     setMethod(name: string, method: Function, isOne?: boolean): void;
 }
 //# sourceMappingURL=Application.d.ts.map

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

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

package/dist/src/core/app/Application.js

@@ -26,11 +26,11 @@
  * app.boot();
  * const router = app.make('router');
  */
-import { OOTEnum } from '../types/utils';
+import { OOTEnum } from '../types/utils.js';
 // ─── Application ────────────────────────────────────────────────
 export class Application {
     constructor() {
-        this.oneType = OOTEnum.APPLICATION;
+        this.saoType = OOTEnum.APPLICATION;
         /** Factory bindings — mỗi lần make() gọi factory tạo instance mới */
         this.bindings = new Map();
         /** Singleton instances — tạo một lần, reuse */
@@ -64,6 +64,7 @@ export class Application {
             'destroy',
             'getBindings',
             'getSingletons',
+            'shared',
             '__store',
         ]; // Để track dynamic properties nếu cần
         this.__store = new Map(); // Store cho dynamic properties nếu cần
@@ -136,6 +137,18 @@ export class Application {
      */
     instance(key, value) {
         this.singletons.set(key, value);
+        if (typeof key === 'string' && !this.ownProperties.includes(key)) {
+            this.__store.set(key, { value, isOverridable: true });
+            Object.defineProperty(this, key, {
+                get: () => this.__store.get(key)?.value,
+                set: (newValue) => {
+                    this.__store.set(key, { value: newValue, isOverridable: true });
+                    this.singletons.set(key, newValue);
+                },
+                configurable: true,
+                enumerable: false,
+            });
+        }
         return this;
     }
     // ─── Alias ──────────────────────────────────────────────────
@@ -231,6 +244,13 @@ export class Application {
             provider.initApplication();
         }
         provider.register();
+        // Đăng ký SAU khi app đã boot — plugin nạp muộn qua App.push(), hoặc
+        // provider của theme cắm vào giữa phiên. boot() vòng lặp chính đã chạy
+        // xong và có cờ chặn, nên nếu không gọi ở đây thì provider chỉ chạy nửa
+        // vòng đời: register() có, boot() không, và KHÔNG có lỗi nào phát ra.
+        if (this.booted && typeof provider.boot === 'function') {
+            provider.boot();
+        }
         return this;
     }
     /**
@@ -274,29 +294,33 @@ export class Application {
         return this.singletons;
     }
     set(name, value, isOne = false) {
-        if (this.ownProperties.includes(name)) {
-            return; // Không cho ghi đè lên thuộc tính có sẵn
-        }
         if (this.__store.has(name) && this.__store.get(name)?.isOverridable === false) {
             return; // Không cho ghi đè lên thuộc tính không thể override
         }
+        const isString = typeof name === 'string';
+        if (isString && this.ownProperties.includes(name)) {
+            return; // Không cho ghi đè lên thuộc tính có sẵn
+        }
         this.__store.set(name, { value, isOverridable: !isOne });
         this.singletons.set(name, value); // Sync → DI container
-        Object.defineProperty(this, name, {
-            get: () => this.__store.get(name)?.value,
-            set: (newValue) => {
-                if (this.__store.has(name) && this.__store.get(name)?.isOverridable === false) {
-                    return; // Không cho ghi đè nếu isOverridable là false
-                }
-                this.__store.set(name, { value: newValue, isOverridable: !isOne });
-                this.singletons.set(name, newValue); // Sync → DI container
-            },
-            configurable: isOne ? false : true,
-            enumerable: false,
-        });
+        if (isString) {
+            Object.defineProperty(this, name, {
+                get: () => this.__store.get(name)?.value,
+                set: (newValue) => {
+                    if (this.__store.has(name) && this.__store.get(name)?.isOverridable === false) {
+                        return; // Không cho ghi đè nếu isOverridable là false
+                    }
+                    this.__store.set(name, { value: newValue, isOverridable: !isOne });
+                    this.singletons.set(name, newValue); // Sync → DI container
+                },
+                configurable: isOne ? false : true,
+                enumerable: false,
+            });
+        }
     }
     get(name) {
-        if (this.ownProperties.includes(name)) {
+        const isString = typeof name === 'string';
+        if (isString && this.ownProperties.includes(name)) {
             return this[name]; // Trả về thuộc tính có sẵn
         }
         // Check __store first (registered via set())
@@ -309,6 +333,19 @@ export class Application {
         }
         return undefined;
     }
+    /**
+     * Dữ liệu package PHP chia sẻ cho client theo từng request (`Saola::share()`
+     * → `APP_CONFIGS.shared` → `App.init({ shared })`). Helper JS của package đọc
+     * ở đây thay vì tự đọc `window`, để test truyền được qua config.
+     *
+     * @example App.shared('permission', { routes: [] }).routes
+     */
+    shared(key, fallback) {
+        const all = (this.__store.get('SharedData')?.value ?? {});
+        if (key === undefined)
+            return all;
+        return (Object.prototype.hasOwnProperty.call(all, key) ? all[key] : fallback);
+    }
     setMethod(name, method, isOne = false) {
         if (this.ownProperties.includes(name)) {
             return; // Không cho ghi đè lên thuộc tính có sẵn