create-yoya-ui 0.2.2 → 0.2.3

package/templates/admin/node_modules/@typescript/typescript-win32-x64/lib/lib.webworker.importscripts.d.ts

@@ -1,21 +0,0 @@
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
-
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABILITY OR NON-INFRINGEMENT.
-
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
-***************************************************************************** */
-
-
-/////////////////////////////
-/// WorkerGlobalScope APIs
-/////////////////////////////
-// These are only available in a Web Worker
-declare function importScripts(...urls: string[]): void;

package/templates/admin/node_modules/@typescript/typescript-win32-x64/lib/lib.webworker.iterable.d.ts

@@ -1,18 +0,0 @@
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
-
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABILITY OR NON-INFRINGEMENT.
-
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
-***************************************************************************** */
-
-
-// This file's contents are now included in the main types file.
-// The file has been left for backward compatibility.

package/templates/admin/node_modules/@typescript/typescript-win32-x64/package.json

@@ -1,45 +0,0 @@
-{
-    "name": "@typescript/typescript-win32-x64",
-    "version": "7.0.2",
-    "license": "Apache-2.0",
-    "author": "Microsoft Corp.",
-    "homepage": "https://www.typescriptlang.org/",
-    "description": "TypeScript is a language for application scale JavaScript development",
-    "keywords": [
-        "TypeScript",
-        "Microsoft",
-        "compiler",
-        "language",
-        "javascript"
-    ],
-    "bugs": {
-        "url": "https://github.com/microsoft/TypeScript/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/microsoft/TypeScript.git"
-    },
-    "type": "module",
-    "preferUnplugged": true,
-    "engines": {
-        "node": ">=16.20.0"
-    },
-    "files": [
-        "lib",
-        "NOTICE.txt"
-    ],
-    "exports": {
-        "./package.json": "./package.json"
-    },
-    "gitHead": "2bd066d87f5bafd315be9f40889d0a60b9e58e0b",
-    "publishConfig": {
-        "access": "public",
-        "tag": "latest"
-    },
-    "os": [
-        "win32"
-    ],
-    "cpu": [
-        "x64"
-    ]
-}

package/templates/admin/node_modules/@yoyaflow/yoya-ui/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 zhanglj
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/templates/admin/node_modules/@yoyaflow/yoya-ui/README.md

@@ -1,271 +0,0 @@
-# yoya-ui
-
-> **English** | [简体中文](./README.zh-CN.md)
-
-> Browser-native UI library with declarative HTML authoring — no virtual DOM, no JSX/SFC, no build step required.
-
-yoya-ui is a web foundation library — a new form of business UI construction. Views are built directly on the real DOM: declarative HTML authoring, router, i18n, theming, state and server-side rendering (SSR) out of the box, with pure client rendering switchable from the same code. Bundled UI components exist for out-of-the-box convenience; they are not the boundary of the library — native elements and third-party components compose the same way.
-
-## Hello World — declarative UI and reactive i18n
-
-No framework runtime, no virtual DOM, no JSX build step: views are real DOM nodes described in plain JS, and i18n is a string shortcut.
-
-```js
-// HelloWorldExample — declarative UI
-function HelloWorldExample() {
-  return div((root) => {
-    root.p('Hello，World！');
-  });
-}
-```
-
-```js
-// HelloWorldExampleI18n — reactive i18n text with params
-function HelloWorldExampleI18n() {
-  return div((root) => {
-    root.p('Hello, {name}!'.s('greeting.hello', { name: 'yoya-ui' }));
-  });
-}
-```
-
-## Features
-
-- **Low-barrier declarative authoring**: build UI with declarative structured JS elements — view and logic live in the same language, eliminating the friction between HTML markup and complex manipulation logic; only HTML and plain JS are required, with no framework-specific concepts
-- **General-purpose UI foundation**: a general-purpose library for every web developer — the same declarative codebase builds admin consoles, dashboards, tools and content pages, and backend or full-stack developers can get started more easily than with React/Vue
-- **Flexible delivery**: embed in server-rendered templates, ship together with backend services for atomic per-service deployment, or run as a standalone SPA — same code, no changes
-- **Build-tool optional**: use the shipped files directly in a plain page (no Vite/bundler needed), or install via npm and bundle with Vite/webpack — both are first-class
-- **AI-friendly**: declarative structure means AI-generated component code runs directly, with or without a build step
-- **Ready-to-use component library**: forms, navigation, feedback, data display, layout, charts and more for high-frequency scenarios — convenience on top of the foundation, not its boundary
-- **Built-in router / i18n / theme / state**: everything a SPA needs, no extra selection required
-- **Server-side rendering**: one codebase, two modes — full-site SSR and island-style client enhancement both work
-- **Small core, zero dependencies, easy to extend**: follows standard component patterns; third-party components compose seamlessly with built-ins; import per module fits any project
-- **Maintenance-friendly**: the core stays stable, so long-lived projects don't fear version churn or rewrites
-- **Frontend-fatigue friendly**: for developers tired of endless new concepts, new frameworks and breaking version upgrades — plain HTML and JS syntax, and a stable core that don't churn
-
-## Installation
-
-### Scaffold a new project
-
-```bash
-npx create-yoya-ui@latest my-app                 # basic template (SPA)
-npx create-yoya-ui@latest my-app --template ssr  # SSR template (renderPage + hydrateOrMount)
-npx create-yoya-ui@latest my-app --template admin # admin console template (top nav + collapsible sidebar + RouterViews)
-cd my-app
-npm install
-npm run dev          # basic / admin: dev server
-# SSR: npm run build && npm start
-```
-
-`--template admin` scaffolds a standard admin console: top navigation, collapsible sidebar and a titled RouterViews content area, with feature examples for dashboard (data boards & charts), member / role / permission management, and dictionary management (type table with an item editor dialog).
-
-yoya-ui has its own unique development paradigm — declarative node DSL, page composition, and feature-module organization. The admin template is the recommended way to get familiar with it: it demonstrates the full stack of a real admin console (shell, routing, tables / forms / dialogs, dashboard boards & charts) using the library's idiomatic patterns.
-
-### Install into an existing project
-
-```bash
-npm install @yoyaflow/yoya-ui
-```
-
-## Quick Start
-
-```js
-import { div, vButton, toast } from '@yoyaflow/yoya-ui';
-import '@yoyaflow/yoya-ui/ui.css';
-
-div((page) => {
-  page.vButton('Start task', (button) => {
-    button.variant('primary');
-    button.on('click', () => toast.success('Task started'));
-  });
-}).bindTo('#app');
-```
-
-The page only needs a `<div id="app"></div>` loaded with a module script.
-
-## Server-Side Rendering (SSR)
-
-The same page factory switches between server rendering and client rendering. For a full page, use the high-level entry points — `renderPage` builds a complete HTML document (head/body in DSL) and `hydrateOrMount` bootstraps the client in one call:
-
-```js
-// Server — render a complete HTML document per request
-import { renderPage } from '@yoyaflow/yoya-ui/ssr';
-import { HomePage, messages } from './home-page.js';
-
-const html = renderPage(
-  {
-    page: (page, state) => {
-      page.head((head) => {
-        head.title('SSR Example'.s('title'));
-        head.meta({ charset: 'utf-8' });
-        head.link({ rel: 'stylesheet', href: '/assets/yoya.ui.css' });
-      });
-      page.body((body) => {
-        body.vBody((shell) => {
-          shell.child(HomePage(state)); // state = { lang, path, mode }
-        });
-      });
-    }
-  },
-  { lang, mode: 'history', path },
-  { messages } // per-request i18n; .s() is scoped automatically
-);
-
-// Client — reads __YOYA_DATA__; hydrates when server HTML exists, otherwise mounts
-import '@yoyaflow/yoya-ui/ui.css';
-import { hydrateOrMount } from '@yoyaflow/yoya-ui/ssr';
-import { HomePage, messages } from './home-page.js';
-
-hydrateOrMount(HomePage, { messages });
-```
-
-Lower-level primitives (`renderToString` / `serializeState` / `parseState` / `mount` / `hydrate`) remain available for fine-grained control, e.g. embedding an HTML fragment into your own server template.
-
-Key points:
-
-- `vClientOnly(loader)`: non-SSR modules (e.g. ECharts) emit a placeholder on the server and load on the client after hydration
-- `Router.renderPath(path)`: renders the matching route for a request path (params / guards / 404)
-- Per-request i18n instance, render-context id allocator, auto-destroy after render — the server stays stateless
-- `maxNodes` falls back to client rendering automatically when exceeded
-
-Full integration guide: [docs/ssr.md](docs/ssr.md) (Chinese); quick start with the SSR template:
-
-```bash
-npx create-yoya-ui@latest my-app --template ssr
-cd my-app
-npm install
-npm run build && npm start
-```
-
-Or run the in-repo example:
-
-```bash
-npm run build
-node src/examples/ssr/server-http.mjs
-```
-
-## Import per Module
-
-```js
-import { div, svg, createI18n } from '@yoyaflow/yoya-ui/core'; // core HTML/SVG/state
-import { vButton, vCard, vForm, vTable } from '@yoyaflow/yoya-ui/ui'; // official component library
-import { vEchart } from '@yoyaflow/yoya-ui/echart'; // ECharts component (bring your own echarts)
-import { renderPage, hydrateOrMount } from '@yoyaflow/yoya-ui/ssr'; // server-side rendering
-import '@yoyaflow/yoya-ui/ui.css'; // default styles and theme variables
-```
-
-## TypeScript Support
-
-The source stays plain JavaScript (zero build, runs directly); full TypeScript experience comes from the type declarations shipped with the package. The `types/` directory covers all four entry points (root / `core` / `echart` / `ssr`) and includes node classes, factory signatures, component state APIs and parent shortcut methods (e.g. `page.vButton(...)`).
-
-TypeScript projects get hints and type checking with no extra configuration:
-
-```ts
-import { div, vButton, vCard, vTable, toast } from '@yoyaflow/yoya-ui';
-import { createI18n } from '@yoyaflow/yoya-ui/core';
-import { renderPage } from '@yoyaflow/yoya-ui/ssr';
-import '@yoyaflow/yoya-ui/ui.css';
-
-div((page) => {
-  page.className('app');
-  page.vButton('Start task', (button) => {
-    button.variant('primary');
-    button.on('click', () => toast.success('Task started'));
-  });
-  page.vCard((card) => {
-    card.vCardBody((body) => {
-      body.vTable((table) => {
-        table.columns([{ key: 'name', title: 'Name', dataIndex: 'name' }]);
-        table.rows([{ name: 'api-gateway' }]);
-      });
-    });
-  });
-});
-```
-
-Type declaration quality is maintained in-repo:
-
-```bash
-npm run typecheck    # validates declaration files and consumer type tests
-npm run test:types   # same as typecheck
-```
-
-## Core Capabilities
-
-| Category   | Content                                                                                                                      |
-| ---------- | ---------------------------------------------------------------------------------------------------------------------------- |
-| HTML       | Full WHATWG element factories with `HtmlElementNode` nested shortcuts                                                        |
-| SVG        | `svg()` namespace entry and built-in icons (`SearchOutlined`, etc.)                                                          |
-| Layout     | `flex` / `grid` / `stack` / `container` / `vRow` / `vCol` / `vContainer` / `mobileLayout` / `themeShell`                     |
-| Actions    | `vButton` / `vButtons` / `vFloatButton` / `vDropdownMenu` / `vContextMenu`                                                   |
-| Navigation | `vMenu` / `vBreadcrumb` / `vSteps` / `vTabs` / `vAnchor` / `vNavbar` / Router / `vLink`                                      |
-| Feedback   | `vDialog` / `vTooltip` / `vMessage` / `vMessageManager` / `toast`                                                            |
-| Forms      | `vForm` / `vInput` / `vSelect` / `vCheckbox` / `vRadio` / `vSwitch` / `vRate` / `vTimer` / `vUpload`                         |
-| Data       | `vCard` / `vTable` / `vTree` / `vPagination` / `vProgress` / `vScroll` / `vCarousel` / `vTimeline` / `vDetail` / board series |
-| Charts     | `vEchart` (ECharts-based, import on demand)                                                                                  |
-| Async      | `vDynamicLoader`                                                                                                             |
-| State      | `vStateNode` / `@preact/signals-core` extension                                                                              |
-| i18n/Theme | `createI18n` / `withI18nStringShortcut` / theme tokens and light/dark modes                                                  |
-
-Full component demos live in the example site (`npm run examples:html`, then open `http://localhost:5173/#/components`).
-
-## Build Output
-
-```bash
-npm run build
-```
-
-`dist/` contains:
-
-- `yoya.core.js` / `yoya.ui.js` — core and component library ESM entries
-- `yoya.echart.js` — ECharts component entry (does not bundle echarts itself)
-- `yoya.ssr.js` — server rendering entry (`renderPage` / `hydrateOrMount` / `renderToString` / `hydrate` / `mount`)
-- `echarts.min.js` — ECharts core (load globally via `<script>`)
-- `yoya.ui.css` — default styles and theme variables
-- `yoya-ui.umd.js` — UMD build (`window.YoyaUI`)
-
-## Development
-
-```bash
-npm install
-npm test              # vitest full suite
-npm run lint          # eslint
-npm run build         # full build
-npm run examples:html # example site (localhost:5173)
-npm run format        # prettier
-```
-
-## Project Structure
-
-```text
-src/
-  core/        ViewNode/ElementNode core, state, i18n, theme, id allocator, SSR helpers
-  html/ svg/   HTML/SVG element factories
-  layout/      layout factories
-  actions/ navigation/ feedback/ form/ data-display/ async/ chart/ effects/
-               official component categories
-  components/  component aggregation and shared logic
-  examples/    example site (SSR demos and copy-paste guides)
-  index.js     dev aggregate entry
-  yoya.core.js / yoya.ui.js / yoya.echart.js / yoya.ssr.js / yoya.ui.css
-scripts/
-  build-entries.mjs        ESM entry build
-  copy-example-modules.mjs example asset copy
-vite.config.js / vite.umd.config.js / vite.examples.config.js
-```
-
-## Documentation
-
-- [Server-Side Rendering Guide](docs/ssr.md) (Chinese)
-- [Component Development Spec](docs/component-development-spec.md) (Chinese)
-- [Component Library Authoring Guide](docs/component-library-authoring.md) (Chinese)
-- [Theme Styling Spec](docs/theme-styling.md) (Chinese)
-- [Component Catalog](docs/components.md) (Chinese)
-- [Core Implementation Summary](docs/yoya-basic-core-summary.md) (Chinese)
-
-## Codex Skill
-
-Use yoya-ui inside Codex: install the [yoya-ui skill](skills/yoya-ui/README.md) (Chinese) to give Codex guidance on the component DSL, page composition, forms, theming, SSR/hydrate and i18n.
-
-## License
-
-MIT

package/templates/admin/node_modules/@yoyaflow/yoya-ui/README.zh-CN.md

@@ -1,272 +0,0 @@
-# yoya-ui
-
-> [English](./README.md) | **简体中文**
-
-> Browser-native UI library with declarative HTML authoring — no virtual DOM, no JSX/SFC, no build step required.
-> 轻量原生 JS UI 基础库：小核心 + 开放标准 + 官方组件库，覆盖管理台、看板、工具与内容页等通用 Web 界面。
-
-yoya-ui 是一套新的业务界面构建形式，也是一个 Web 基础库：直接在真实 DOM 上构建视图，声明式 HTML 写法、路由、i18n、主题与状态系统开箱即用，支持服务端渲染（SSR）与纯客户端渲染同代码切换。自带 UI 组件只是为了开箱即用，组件清单并不代表库的能力边界——原生元素与第三方组件以同样方式自由组合。
-
-## Hello World——声明式构建与响应式 i18n
-
-没有框架运行时、没有虚拟 DOM、没有 JSX 构建链：视图就是由原生 JS 描述的真实 DOM，i18n 只是字符串快捷方式。
-
-```js
-// HelloWorldExample —— 声明式构建
-function HelloWorldExample() {
-  return div((root) => {
-    root.p('Hello，World！');
-  });
-}
-```
-
-```js
-// HelloWorldExampleI18n —— 响应式 i18n 文本（带参数）
-function HelloWorldExampleI18n() {
-  return div((root) => {
-    root.p('Hello, {name}!'.s('greeting.hello', { name: 'yoya-ui' }));
-  });
-}
-```
-
-## 特性
-
-- **低门槛声明式构建**：采用声明式结构化 JS 元素构建方案，视图与操作逻辑同源，消除 HTML 标签化语言与复杂操作逻辑不兼容的问题；只学 HTML 与原生 JS 即可使用，无框架专属概念
-- **通用 UI 基础**：面向所有 Web 开发者的通用 UI 库，同一套声明式代码可构建管理台、看板、工具类与内容类页面；相比 React/Vue，后端与全栈开发者也能更低门槛地上手
-- **交付方式灵活**：可嵌入服务端模板、随后端服务同包发布（适合微服务原子化部署），也可作为独立 SPA 运行，同一套代码无需改动
-- **构建可选、工程化可用**：构建产物可直接在普通页面中运行，无需 Vite 等打包工具；也支持 npm 安装后在 Vite/webpack 等工程化项目中使用
-- **AI 友好**：声明式结构让 AI 生成的组件代码可直接运行，无论是否使用构建工具
-- **开箱即用的组件库**：表单、导航、反馈、数据展示、布局、图表等高频场景开箱即用——这是基础库之上的便利，不代表库的能力边界
-- **内置路由 / i18n / 主题 / 状态管理**：单页应用所需能力自带，无需额外选型
-- **服务端渲染**：一套代码双模式可切换，整站服务端渲染与局部组件客户端加载加强均可用
-- **小核心、零依赖、易扩展**：遵循标准组件形态，第三方组件可与内置组件无缝组合，按模块引入适配任意工程
-- **长期维护友好**：核心库保持稳定，长期项目无需担心版本过时或升级重写
-- **远离前端疲劳**：适合厌倦层出不穷的新概念、新框架与破坏性版本更新的开发者，语法回归原生 HTML 和 JS，核心保持稳定
-
-## 安装
-
-### 脚手架快速搭建
-
-```bash
-npx create-yoya-ui@latest my-app                 # basic 模板（SPA）
-npx create-yoya-ui@latest my-app --template ssr  # SSR 模板（renderPage + hydrateOrMount）
-npx create-yoya-ui@latest my-app --template admin # admin 后台管理模板（顶部导航 + 可折叠侧栏 + RouterViews）
-cd my-app
-npm install
-npm run dev          # basic / admin：开发服务器
-# SSR：npm run build && npm start
-```
-
-`--template admin` 生成标准后台管理模板：顶部导航 + 可折叠侧栏 + 带标题的 RouterViews 内容区，内置数据概览看板与图表，以及成员 / 角色 / 权限 / 字典管理等业务域示例。
-
-yoya-ui 拥有自己独特的开发范式：声明式节点 DSL、页面编排与 feature 模块组织。推荐使用 admin 模板创建项目来了解这些范式——它用库的原生写法完整展示了一个真实后台（页面壳、路由、表格/表单/弹窗、数据看板与图表）。
-
-### 已有项目引入
-
-```bash
-npm install @yoyaflow/yoya-ui
-```
-
-## 快速开始
-
-```js
-import { div, vButton, toast } from '@yoyaflow/yoya-ui';
-import '@yoyaflow/yoya-ui/ui.css';
-
-div((page) => {
-  page.vButton('启动任务', (button) => {
-    button.variant('primary');
-    button.on('click', () => toast.success('任务已启动'));
-  });
-}).bindTo('#app');
-```
-
-页面只需要一个 `<div id="app"></div>`，用模块脚本加载即可。
-
-## 服务端渲染（SSR）
-
-同一份页面工厂代码，服务端渲染与客户端渲染可切换。整页场景直接使用高层入口：`renderPage` 输出完整 HTML 文档（head/body 用 DSL 定义），`hydrateOrMount` 一行完成客户端接入：
-
-```js
-// 服务端：按请求渲染完整 HTML 文档
-import { renderPage } from '@yoyaflow/yoya-ui/ssr';
-import { HomePage, messages } from './home-page.js';
-
-const html = renderPage(
-  {
-    page: (page, state) => {
-      page.head((head) => {
-        head.title('SSR 示例'.s('title'));
-        head.meta({ charset: 'utf-8' });
-        head.link({ rel: 'stylesheet', href: '/assets/yoya.ui.css' });
-      });
-      page.body((body) => {
-        body.vBody((shell) => {
-          shell.child(HomePage(state)); // state = { lang, path, mode }
-        });
-      });
-    }
-  },
-  { lang, mode: 'history', path },
-  { messages } // 每请求 i18n，.s() 自动作用域
-);
-
-// 客户端：自动读取 __YOYA_DATA__，有服务端 HTML 走 hydrate，否则 mount
-import '@yoyaflow/yoya-ui/ui.css';
-import { hydrateOrMount } from '@yoyaflow/yoya-ui/ssr';
-import { HomePage, messages } from './home-page.js';
-
-hydrateOrMount(HomePage, { messages });
-```
-
-底层原语（`renderToString` / `serializeState` / `parseState` / `mount` / `hydrate`）仍然可用，适合需要细粒度控制的场景，例如把 HTML 片段嵌入自有服务端模板。
-
-要点：
-
-- `vClientOnly(loader)`：非 SSR 模块（如 ECharts）服务端只出占位，hydration 后客户端加载
-- `Router.renderPath(path)`：服务端按请求路径渲染匹配路由（参数 / 守卫 / 404）
-- 每请求 i18n 实例、渲染上下文 id 分配器、渲染后自动销毁——服务端保持无状态
-- `maxNodes` 超限自动回退客户端渲染
-
-完整集成指南见 [docs/ssr.md](docs/ssr.md)；用 SSR 模板快速开始：
-
-```bash
-npx create-yoya-ui@latest my-app --template ssr
-cd my-app
-npm install
-npm run build && npm start
-```
-
-或运行仓库内示例：
-
-```bash
-npm run build
-node src/examples/ssr/server-http.mjs
-```
-
-## 按需引入
-
-```js
-import { div, svg, createI18n } from '@yoyaflow/yoya-ui/core'; // 核心 HTML/SVG/状态
-import { vButton, vCard, vForm, vTable } from '@yoyaflow/yoya-ui/ui'; // 官方组件库
-import { vEchart } from '@yoyaflow/yoya-ui/echart'; // ECharts 组件（需自行引入 echarts）
-import { renderPage, hydrateOrMount } from '@yoyaflow/yoya-ui/ssr'; // 服务端渲染
-import '@yoyaflow/yoya-ui/ui.css'; // 默认样式与主题变量
-```
-
-## TypeScript 支持
-
-源码保持纯 JavaScript（无需构建也可直接运行，同样兼容工程化构建），通过随包发布的类型声明提供完整的 TypeScript 体验。`types/` 目录覆盖四个入口（根入口 / `core` / `echart` / `ssr`），并包含节点类、工厂函数签名、组件状态 API 与父节点快捷方法（如 `page.vButton(...)`）的类型。
-
-TypeScript 项目无需额外配置即可获得提示与类型检查：
-
-```ts
-import { div, vButton, vCard, vTable, toast } from '@yoyaflow/yoya-ui';
-import { createI18n } from '@yoyaflow/yoya-ui/core';
-import { renderPage } from '@yoyaflow/yoya-ui/ssr';
-import '@yoyaflow/yoya-ui/ui.css';
-
-div((page) => {
-  page.className('app');
-  page.vButton('启动任务', (button) => {
-    button.variant('primary');
-    button.on('click', () => toast.success('任务已启动'));
-  });
-  page.vCard((card) => {
-    card.vCardBody((body) => {
-      body.vTable((table) => {
-        table.columns([{ key: 'name', title: '名称', dataIndex: 'name' }]);
-        table.rows([{ name: 'api-gateway' }]);
-      });
-    });
-  });
-});
-```
-
-库内维护类型声明质量：
-
-```bash
-npm run typecheck    # 校验声明文件与 consumer 类型测试
-npm run test:types   # 同 typecheck
-```
-
-## 核心能力
-
-| 分类        | 内容                                                                                                                      |
-| ----------- | ------------------------------------------------------------------------------------------------------------------------- |
-| HTML 元素   | WHATWG 全量元素工厂，`HtmlElementNode` 嵌套快捷方法                                                                       |
-| SVG         | `svg()` 命名空间入口与内置图标（`SearchOutlined` 等）                                                                     |
-| 布局        | `flex` / `grid` / `stack` / `container` / `vRow` / `vCol` / `vContainer` / `mobileLayout` / `themeShell`                  |
-| 动作        | `vButton` / `vButtons` / `vFloatButton` / `vDropdownMenu` / `vContextMenu`                                                |
-| 导航        | `vMenu` / `vBreadcrumb` / `vSteps` / `vTabs` / `vAnchor` / `vNavbar` / Router / `vLink`                                   |
-| 反馈        | `vDialog` / `vTooltip` / `vMessage` / `vMessageManager` / `toast`                                                         |
-| 表单        | `vForm` / `vInput` / `vSelect` / `vCheckbox` / `vRadio` / `vSwitch` / `vRate` / `vTimer` / `vUpload`                      |
-| 数据展示    | `vCard` / `vTable` / `vTree` / `vPagination` / `vProgress` / `vScroll` / `vCarousel` / `vTimeline` / `vDetail` / 看板系列 |
-| 图表        | `vEchart`（基于 ECharts，按需引入）                                                                                       |
-| 异步        | `vDynamicLoader`                                                                                                          |
-| 状态        | `vStateNode` / `@preact/signals-core` 扩展                                                                                |
-| i18n / 主题 | `createI18n` / `withI18nStringShortcut` / 主题 token 与明暗模式                                                           |
-
-完整组件与交互演示见示例站（`npm run examples:html` 后打开 `http://localhost:5173/#/components`）。
-
-## 构建产物
-
-```bash
-npm run build
-```
-
-`dist/` 输出：
-
-- `yoya.core.js` / `yoya.ui.js` — 核心与组件库 ESM 入口
-- `yoya.echart.js` — ECharts 组件入口（不包含 echarts 本体）
-- `yoya.ssr.js` — 服务端渲染入口（`renderPage` / `hydrateOrMount` / `renderToString` / `hydrate` / `mount`）
-- `echarts.min.js` — ECharts 本体（用 `<script>` 标签全局引入）
-- `yoya.ui.css` — 默认样式与主题变量
-- `yoya-ui.umd.js` — UMD 版（`window.YoyaUI`）
-
-## 开发
-
-```bash
-npm install
-npm test              # vitest 全量测试
-npm run lint          # eslint
-npm run build         # 全量构建
-npm run examples:html # 示例站（localhost:5173）
-npm run format        # prettier
-```
-
-## 目录结构
-
-```text
-src/
-  core/        ViewNode/ElementNode 核心、状态、i18n、主题、id 分配器、SSR 助手
-  html/ svg/   HTML/SVG 元素工厂
-  layout/      布局工厂
-  actions/ navigation/ feedback/ form/ data-display/ async/ chart/ effects/
-               官方组件库各分类
-  components/  组件聚合与共享逻辑
-  examples/    示例站（含 SSR 演示与复制即用指南）
-  index.js     开发聚合入口
-  yoya.core.js / yoya.ui.js / yoya.echart.js / yoya.ssr.js / yoya.ui.css
-scripts/
-  build-entries.mjs        ESM 入口构建
-  copy-example-modules.mjs 示例资源拷贝
-vite.config.js / vite.umd.config.js / vite.examples.config.js
-```
-
-## 文档
-
-- [服务端渲染集成指南](docs/ssr.md)
-- [组件开发规格](docs/component-development-spec.md)
-- [组件库开发规范（第三方开发者）](docs/component-library-authoring.md)
-- [主题样式规范](docs/theme-styling.md)
-- [组件目录](docs/components.md)
-- [核心实现摘要](docs/yoya-basic-core-summary.md)
-
-## Codex 技能
-
-在 Codex 中使用 yoya-ui：按[技能安装说明](skills/yoya-ui/README.md)安装 yoya-ui 技能，Codex 即可获得组件 DSL、页面组合、表单、主题、SSR/hydrate 与 i18n 的使用指导。
-
-## License
-
-MIT