chore: init docs

Author: CCherry07

.gitignore

@@ -0,0 +1,27 @@
+# deps
+/node_modules
+
+# generated content
+.contentlayer
+.content-collections
+.source
+
+# test & build
+/coverage
+/.next/
+/build
+*.tsbuildinfo
+
+# misc
+.DS_Store
+*.pem
+/.pnp
+.pnp.js
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# others
+.env*.local
+.vercel
+next-env.d.ts

README.md

@@ -0,0 +1,26 @@
+# form-docs
+
+This is a Next.js application generated with
+[Create Fumadocs](https://github.com/fuma-nama/fumadocs).
+
+Run development server:
+
+```bash
+npm run dev
+# or
+pnpm dev
+# or
+yarn dev
+```
+
+Open http://localhost:3000 with your browser to see the result.
+
+## Learn More
+
+To learn more about Next.js and Fumadocs, take a look at the following
+resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js
+  features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+- [Fumadocs](https://fumadocs.vercel.app) - learn about Fumadocs

components.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "new-york",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "src/app/global.css",
+    "baseColor": "neutral",
+    "cssVariables": true,
+    "prefix": ""
+  },
+  "aliases": {
+    "components": "@/components",
+    "utils": "@/lib/utils",
+    "ui": "@/components/ui",
+    "lib": "@/lib",
+    "hooks": "@/hooks"
+  },
+  "iconLibrary": "lucide"
+}

content/docs/api-reference/index.cn.mdx

@@ -0,0 +1,7 @@
+---
+title: "ApiReference"
+---
+
+🚧 正在建设中
+
+我们正在努力生成更详细的参考资料。

content/docs/api-reference/index.mdx

@@ -0,0 +1,7 @@
+---
+title: Quick Start
+---
+
+🚧 Under Construction
+
+We are working on generating a more detailed reference. 

content/docs/api-reference/meta.cn.json

@@ -0,0 +1,10 @@
+{
+  "title": "Api 文档",
+  "description": "Signals Form 的 API 文档",
+  "icon": "NotebookText",
+  "root": true,
+  "pages": [
+    "---Introduction---",
+    "index"
+  ]
+} 

content/docs/api-reference/meta.json

@@ -0,0 +1,10 @@
+{
+  "title": "Api Reference",
+  "description": "Api Reference for Signals Form",
+  "icon": "NotebookText",
+  "root": true,
+  "pages": [
+    "---Introduction---",
+    "index"
+  ]
+}

content/docs/core/decision/customOperations.cn.mdx

@@ -0,0 +1,48 @@
+---
+title: 自定义操作符
+---
+
+- `nand`：与非操作符，只有当所有条件都为 `false` 时，结果才为 `true`。
+- `nor`：或非操作符，只有当所有条件都为 `false` 时，结果才为 `true`。
+
+## `nand`
+- 操作符用于判断所有条件是否都为 `false`，即只有当所有条件都为 `false` 时，结果才为 `true`。
+
+
+```ts
+import { D, registerCustomOperator } from "@signals-from/core"
+const model = {
+  isA: true,
+  isB: false,
+}
+registerCustomOperator(
+  "nand",
+  function (...bools: boolean[]) {
+    return !bools.every(Boolean);
+  }
+)
+
+D.nand('isA', 'isB').execute(model) // !(isA && isB) true
+```
+## `nor`
+- 操作符用于判断所有条件是否都为 `false`，即只有当所有条件都为 `false` 时，结果才为 `true`。
+
+```ts
+import { D, registerCustomOperator} from "@signals-from/core"
+const model = {
+  isA: true,
+  isB: false,
+}
+
+registerCustomOperator(
+  "nor",
+  function (...bools: boolean[]) {
+    return !bools.some(Boolean);
+  }
+)
+D.nor('isA', 'isB').execute(model) // !(isA || isB) false
+```
+
+## 注：
+- 此等操作符，是一个二次计算的过程，会导致开发者在使用时，增加了很大的复杂度，心智负担大，请谨慎使用。
+- 建议使用基础的操作符，如 `and`、`or`、`not`、`use`，以简化决策逻辑。 `nand` 可以使用 `not` 和 `and` 组合实现，`nor` 可以使用 `not` 和 `or` 组合实现。

content/docs/core/decision/customOperations.mdx

@@ -0,0 +1,49 @@
+---
+title: Custom Operators
+description: Advanced logical operators for complex decision making
+---
+
+- `nand`: NAND operator, only returns `true` when all conditions are `false`.
+- `nor`: NOR operator, only returns `true` when all conditions are `false`.
+
+## `nand`
+- The `nand` operator is used to determine whether all conditions are `false`, i.e., only when all conditions are `false`, the result is `true`.
+
+```ts
+import { D, registerCustomOperator } from "@signals-form/core"
+const model = {
+  isA: true,
+  isB: false,
+}
+registerCustomOperator(
+  "nand",
+  function (...bools: boolean[]) {
+    return !bools.every(Boolean);
+  }
+)
+
+D.nand('isA', 'isB').execute(model) // !(isA && isB) true
+```
+
+## `nor`
+- The `nor` operator is used to determine whether all conditions are `false`, i.e., only when all conditions are `false`, the result is `true`.
+
+```ts
+import { D, registerCustomOperator} from "@signals-form/core"
+const model = {
+  isA: true,
+  isB: false,
+}
+
+registerCustomOperator(
+  "nor",
+  function (...bools: boolean[]) {
+    return !bools.some(Boolean);
+  }
+)
+D.nor('isA', 'isB').execute(model) // !(isA || isB) false
+```
+
+## Note:
+- These operators involve a secondary calculation process, which can significantly increase complexity and mental burden for developers when using them. Please use with caution.
+- It's recommended to use basic operators such as `and`, `or`, `not`, `use` to simplify decision logic. `nand` can be implemented using `not` and `and` combination, `nor` can be implemented using `not` and `or` combination.

content/docs/core/decision/decision.cn.mdx

@@ -0,0 +1,33 @@
+---
+title: 决策对象
+description: 表单系统中的条件渲染和逻辑判断
+---
+`Decision` 是一个决策对象。常用于字段的显示与隐藏，以及业务逻辑的处理。
+
+## 基本用法 
+```ts
+import { setup, D } from "@signals-from/core"
+
+const boolConfig = {
+  isDisabled: false,
+  isHidden: () => true,
+  isA:(model) => model.data === 'a',
+}
+
+// 注册 布尔配置
+setup(boolConfig)
+
+const ds = D.and(
+  D.or(
+    'isDisabled',
+    'isHidden'
+  ),
+  D.use('isA')
+)
+
+const model = {
+  data: 'a'
+}
+
+ds.execute(model) // true
+```