@gardenerim/react 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.0.0
+
+- 首个 Stable 版本。
+- 完整映射 Gardener CSS 1.0.0 的 506 个组件和 66 种行为。
+- 提供 Provider、7 个 Hooks、受控值、SSR、Tauri/Electron、29 个包入口和完整发布门禁。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gardener contributors
+
+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/README.md

@@ -0,0 +1,50 @@
+# Gardener React
+
+Gardener CSS 1.0.0 的官方 React 适配层，版本 `1.0.0`、状态 Stable。支持 React `>=18.3.0 <20.0.0`，完整映射 CSS 项目的 506 个组件和 66 种 DOM 行为，并提供类型安全组件、Provider、Hooks、受控值桥接、SSR 安全导入、桌面适配与按需样式。
+
+## 快速开始
+
+```bash
+npm install @gardenerim/react @gardenerim/css react react-dom
+```
+
+```tsx
+import { createRoot } from "react-dom/client";
+import { GButton, GCard, GardenerProvider } from "@gardenerim/react";
+import "@gardenerim/react/style.css";
+
+createRoot(document.getElementById("root")!).render(
+  <GardenerProvider theme="garden" mode="light" shape="subtle">
+    <GCard><GButton variant="primary">保存</GButton></GCard>
+  </GardenerProvider>,
+);
+```
+
+## 1.0.0 能力范围
+
+- 506 个自动生成、独立具名且支持 `forwardRef` 的 `G*` 组件。
+- 66 种 Gardener 行为的挂载、销毁和实例访问。
+- Web、Mobile、Desktop、Tauri、Electron 五种 CSS 平台入口。
+- 完整、核心、主题、工具、组件、AI 六种 CSS 入口与 28 个组件样式包代理。
+- 29 个公共包入口，同时支持 `component-css/forms` 与 `component-css/forms.css`。
+- 10 个组件公共属性、Imperative Handle、原生 attributes/events/children 透传。
+- 原生表单与 `gardener:*` 自定义事件的受控值桥接。
+- 十轴 `GardenerProvider`，默认不启用深色模式。
+- 7 个 Hooks，包括相互隔离的 Tauri/Electron 窗口控制入口与 Hooks。
+- React 18.3–19.x、TypeScript、SSR、StrictMode 和 Hydration 安全。
+- Chromium、WebKit、Firefox、Pixel 7、iPhone 13 及 WCAG A/AA 自动化门禁。
+- 公共 API、稳定兼容基线和性能报告的封闭 JSON Schema。
+
+完整 API 见 [docs/API.md](./docs/API.md)，全部组件逐项清单见 [docs/components.md](./docs/components.md)。
+
+## 发布验证
+
+```bash
+npm run release:verify
+```
+
+该命令覆盖生成完整性、类型、DOM 生命周期、SSR、真实浏览器、移动端、无障碍、示例、摇树、可复现构建、性能预算、npm 封包和 publint。
+
+## 许可证
+
+MIT

package/dist/adapter-target.d.ts

@@ -0,0 +1,5 @@
+import type { RefObject } from "react";
+import type { GardenerComponentHandle } from "./types.js";
+export type GardenerAdapterTarget = Element | GardenerComponentHandle | null;
+export declare const adapterRootValue: (root?: RefObject<GardenerAdapterTarget>) => Document | Element | undefined;
+//# sourceMappingURL=adapter-target.d.ts.map

package/dist/adapter-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-target.d.ts","sourceRoot":"","sources":["../src/adapter-target.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAAC;AAE7E,eAAO,MAAM,gBAAgB,UAAW,SAAS,CAAC,qBAAqB,CAAC,KAAG,QAAQ,GAAG,OAAO,GAAG,SAI/F,CAAC"}

package/dist/adapter-target.js

@@ -0,0 +1,7 @@
+export const adapterRootValue = (root) => {
+    if (!root)
+        return typeof document === "undefined" ? undefined : document;
+    const value = root.current;
+    return value && typeof value === "object" && "element" in value ? value.element ?? undefined : value ?? undefined;
+};
+//# sourceMappingURL=adapter-target.js.map

package/dist/adapter-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-target.js","sourceRoot":"","sources":["../src/adapter-target.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAuC,EAAkC,EAAE;IAC1G,IAAI,CAAC,IAAI;QAAE,OAAO,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC;IAC3B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC;AACpH,CAAC,CAAC"}

package/dist/adapters.d.ts

@@ -0,0 +1,5 @@
+export { bindTauriWindowControls, useTauriWindowControls } from "./tauri.js";
+export { bindElectronWindowControls, useElectronWindowControls } from "./electron.js";
+export type { GardenerTauriBinding, GardenerTauriBridge } from "./tauri.js";
+export type { GardenerElectronBinding, GardenerElectronBridge } from "./electron.js";
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AACtF,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC5E,YAAY,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC"}

package/dist/adapters.js

@@ -0,0 +1,3 @@
+export { bindTauriWindowControls, useTauriWindowControls } from "./tauri.js";
+export { bindElectronWindowControls, useElectronWindowControls } from "./electron.js";
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC"}

package/dist/ai.css

@@ -0,0 +1 @@
+@import "@gardenerim/css/ai.css";