@ai0x0/utils 0.0.25 → 0.0.27

package/README.md

@@ -0,0 +1,59 @@
+# @ai0x0/utils
+
+AI0x0 shared utilities — backend CRUD factories for Next.js App Router + drizzle-orm, and custom ESLint rules.
+
+## Backend (`src/backend/`)
+
+Declarative CRUD factories on top of `next-rest-framework`, `drizzle-orm/pg-core`, `drizzle-zod`, and `zod`. Each factory returns a `RouteOperationDefinition` that plugs directly into `route({ … })`.
+
+| Export                   | HTTP   | Description                              |
+| ------------------------ | ------ | ---------------------------------------- |
+| `createPostOperation`    | POST   | Create a record                          |
+| `createGetOperation`     | GET    | Get one record by filters                |
+| `createGetListOperation` | GET    | Paginated list with filters, sort, joins |
+| `createPutOperation`     | PUT    | Update a record                          |
+| `createDeleteOperation`  | DELETE | Delete a record                          |
+| `createTableSchema`      | —      | Generate pg table + 5 Zod schemas        |
+
+**Built-in conventions:** base fields (`id`, `creatorId`, `editorId`, `createdAt`, `updatedAt`, `accessedAt`), ownership checks via `byCreator`, automatic date coercion, pagination (`current`/`pageSize`/`orderBy`/`orderDir`), list filtering with `ILIKE`, `IN`, `jsonb` array matching, and relation joins.
+
+See [SKILL.md](./SKILL.md) for detailed workflow, setup, and escape hatches.
+
+## ESLint Rules (`eslint-rules/`)
+
+Custom ESLint 9 flat-config rules ported from production projects. All enabled via `configs.recommended`:
+
+```js
+// eslint.config.js
+import localPlugin from "./eslint-rules/index.js";
+
+export default [
+  localPlugin.configs.recommended,
+  // ... other config
+];
+```
+
+| Rule                      | Description                             |
+| ------------------------- | --------------------------------------- |
+| `no-hardcoded-style`      | Forbid hardcoded style values           |
+| `no-one-letter-vars`      | Forbid single-letter variable names     |
+| `no-then`                 | Prefer `async/await` over `.then()`     |
+| `no-antd-space`           | Use `<Flex>` instead of `<Space>`       |
+| `require-pro-components`  | Require ProComponents usage             |
+| `require-section-divider` | Large files need `===` comment dividers |
+| `no-consecutive-setstate` | Merge consecutive `setState` calls      |
+| `no-use-request-run`      | Forbid `useRequest.run()`               |
+| `require-use-form`        | Use `useForm()` for form state          |
+| `require-form-convention` | Form naming conventions                 |
+
+## Installation
+
+```bash
+pnpm add @ai0x0/utils
+```
+
+Peer dependencies: `drizzle-orm ^0.45.x`, `drizzle-zod ^0.8.x`, `zod ^4.x`.
+
+## Docs
+
+- [SKILL.md](./SKILL.md) — full backend CRUD workflow and API reference

package/es/backend/actions/get-list-query.js

@@ -84,8 +84,8 @@ export function getListQuery(_ref) {
     }).map(function (_ref6) {
       var table = _ref6.table;
       return table;
-    })) || []).find(function (t) {
-      return t[key];
+    })) || []).find(function (table) {
+      return table[key];
     })) === null || _concat$find === void 0 ? void 0 : _concat$find[key];
   }
 
@@ -96,8 +96,8 @@ export function getListQuery(_ref) {
     if (typeof value === "string") {
       if (value.includes(",")) {
         // 处理多值
-        var values = value.split(",").map(function (v) {
-          return v.trim();
+        var values = value.split(",").map(function (val) {
+          return val.trim();
         }).filter(Boolean);
         if (values.length > 0) {
           if (isJsonArray) {
@@ -106,8 +106,8 @@ export function getListQuery(_ref) {
           } else if (isIdField) {
             conditions.push(inArray(targetColumn, values));
           } else {
-            conditions.push(or.apply(void 0, _toConsumableArray(values.map(function (v) {
-              return ilike(targetColumn, "%".concat(v, "%"));
+            conditions.push(or.apply(void 0, _toConsumableArray(values.map(function (val) {
+              return ilike(targetColumn, "%".concat(val, "%"));
             }))));
           }
         }

package/eslint-rules/index.js

@@ -0,0 +1,40 @@
+/**
+ * 本地 ESLint plugin：封装项目自定义规则。
+ */
+import requireSectionDivider from "./require-section-divider.js";
+import noHardcodedStyle from "./no-hardcoded-style.js";
+import requireUseForm from "./require-use-form.js";
+import requireFormConvention from "./require-form-convention.js";
+import requireProComponents from "./require-pro-components.js";
+import noAntdSpace from "./no-antd-space.js";
+import noUseRequestRun from "./no-use-request-run.js";
+import noThen from "./no-then.js";
+import noOneLetterVars from "./no-one-letter-vars.js";
+import noConsecutiveSetState from "./no-consecutive-setstate.js";
+
+const rules = {
+  "require-section-divider": requireSectionDivider,
+  "no-hardcoded-style": noHardcodedStyle,
+  "require-use-form": requireUseForm,
+  "require-form-convention": requireFormConvention,
+  "require-pro-components": requireProComponents,
+  "no-antd-space": noAntdSpace,
+  "no-use-request-run": noUseRequestRun,
+  "no-then": noThen,
+  "no-one-letter-vars": noOneLetterVars,
+  "no-consecutive-setstate": noConsecutiveSetState,
+};
+
+const plugin = {
+  rules,
+  configs: {
+    recommended: {
+      plugins: { local: { rules } },
+      rules: Object.fromEntries(
+        Object.keys(rules).map((name) => [`local/${name}`, "error"]),
+      ),
+    },
+  },
+};
+
+export default plugin;

package/eslint-rules/no-antd-space.js

@@ -0,0 +1,63 @@
+/**
+ * no-antd-space
+ * -------------
+ * 禁止使用 antd <Space>，用 antd <Flex> 代替。
+ *
+ * 映射参考：
+ * - <Space direction="vertical"> → <Flex vertical>
+ * - <Space size={N}> → <Flex gap={N}>
+ * - <Space wrap> → <Flex wrap="wrap">
+ * - Space.Compact → 用 Flex 自行实现紧凑排列
+ *
+ * 本规则只负责检测，不负责自动修复。
+ */
+
+/** @type {import('eslint').Rule.RuleModule} */
+const rule = {
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "禁止使用 antd <Space>，请使用 antd <Flex> 代替。",
+    },
+    schema: [],
+    messages: {
+      useFlexInstead:
+        "禁止使用 antd <Space>，请使用 antd <Flex> 代替。<Space> 的 props 到 <Flex> 的映射：direction={vertical} → vertical, wrap → wrap='wrap', size={N} → gap={N}。",
+      useFlexInsteadCompact:
+        "禁止使用 antd <Space.Compact>，请使用 <Flex> 自行实现紧凑排列。",
+    },
+  },
+  create(context) {
+    const getTagName = (name) => {
+      if (name.type === "JSXIdentifier") return name.name;
+      if (
+        name.type === "JSXMemberExpression" &&
+        name.object.type === "JSXIdentifier" &&
+        name.property.type === "JSXIdentifier"
+      ) {
+        return `${name.object.name}.${name.property.name}`;
+      }
+      return "";
+    };
+
+    return {
+      JSXOpeningElement(node) {
+        const tagName = getTagName(node.name);
+        if (tagName === "Space") {
+          context.report({
+            node: node,
+            messageId: "useFlexInstead",
+          });
+        }
+        if (tagName === "Space.Compact") {
+          context.report({
+            node: node,
+            messageId: "useFlexInsteadCompact",
+          });
+        }
+      },
+    };
+  },
+};
+
+export default rule;

package/eslint-rules/no-consecutive-setstate.js

@@ -0,0 +1,87 @@
+/**
+ * no-consecutive-setstate
+ * ------------------------
+ * 禁止在同一个块中连续调用多个 setState()。
+ * ahooks useSetState 的 setState 会合并状态，连续多次调用应该合并为一次。
+ *
+ * 误：
+ *   setState({ a: 1 });
+ *   setState({ b: 2 });
+ *
+ * 正：
+ *   setState({ a: 1, b: 2 });
+ */
+
+/** @type {import('eslint').Rule.RuleModule} */
+const rule = {
+  meta: {
+    type: "suggestion",
+    docs: {
+      description: "禁止连续调用多个 setState()，应合并为一次。",
+    },
+    schema: [],
+    messages: {
+      merge:
+        "连续多个 setState() 应合并为一次：将 {{prevField}} 和 {{currField}} 合并到一个 setState 中",
+    },
+  },
+  create(context) {
+    return {
+      BlockStatement(node) {
+        const body = node.body;
+        for (let i = 0; i + 1 < body.length; i++) {
+          const curr = body[i];
+          const next = body[i + 1];
+
+          if (
+            curr.type !== "ExpressionStatement" ||
+            next.type !== "ExpressionStatement"
+          )
+            continue;
+
+          const currExpr = curr.expression;
+          const nextExpr = next.expression;
+
+          const isCurrSetState =
+            currExpr.type === "CallExpression" &&
+            currExpr.callee.type === "Identifier" &&
+            currExpr.callee.name === "setState" &&
+            currExpr.arguments.length === 1 &&
+            currExpr.arguments[0].type === "ObjectExpression";
+
+          const isNextSetState =
+            nextExpr.type === "CallExpression" &&
+            nextExpr.callee.type === "Identifier" &&
+            nextExpr.callee.name === "setState" &&
+            nextExpr.arguments.length === 1 &&
+            nextExpr.arguments[0].type === "ObjectExpression";
+
+          if (!isCurrSetState || !isNextSetState) continue;
+
+          const prevField = currExpr.arguments[0];
+          const currField = nextExpr.arguments[0];
+          const sourceCode = context.sourceCode ?? context.getSourceCode();
+          const prevFieldText = sourceCode
+            .getText(prevField)
+            .slice(1, -1)
+            .trim();
+          const currFieldText = sourceCode
+            .getText(currField)
+            .slice(1, -1)
+            .trim();
+
+          context.report({
+            node: next,
+            messageId: "merge",
+            data: {
+              prevField: prevFieldText,
+              currField: currFieldText,
+            },
+          });
+        }
+      },
+    };
+  },
+};
+
+export default rule;