release: 0.5.1

Rel1cx · Rel1cx · commit 19e79bbd672b · 2026-02-08T20:44:04.000+08:00
diff --git a/.pkgs/configs/tsl.config.ts b/.pkgs/configs/tsl.config.ts
@@ -1,5 +1,10 @@
 import { core, defineConfig } from "tsl";
-import { consistentNullishComparison, noDuplicateExports, noDuplicateImports } from "tsl-dx";
+import {
+  noDuplicateExports,
+  noDuplicateImports,
+  noMultilineTemplateExpressionsWithoutAutoDedent,
+  nullish,
+} from "tsl-dx";
 
 export default defineConfig({
   rules: [
@@ -18,8 +23,9 @@ export default defineConfig({
       considerDefaultExhaustiveForUnions: true,
     }),
     core.noConfusingVoidExpression("off"),
+    nullish(),
     noDuplicateImports(),
     noDuplicateExports(),
-    consistentNullishComparison(),
+    noMultilineTemplateExpressionsWithoutAutoDedent(),
   ],
 });
diff --git a/.pkgs/eff/src/index.ts b/.pkgs/eff/src/index.ts
@@ -44,7 +44,7 @@
 //     OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 // SOFTWARE.
 
-/* tsl-ignore local/consistentNullishComparison */
+/* tsl-ignore dx/nullish */
 
 // #region Helpers
 
diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-0.5.0
+0.5.1
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "dx",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": true,
   "description": "Monorepo for JavaScript and TypeScript dx libraries.",
   "homepage": "https://github.com/Rel1cx/dx",
@@ -38,7 +38,7 @@
     "@local/eff": "workspace:*",
     "@tsconfig/node24": "^24.0.4",
     "@tsconfig/strictest": "^2.0.8",
-    "@types/node": "^25.2.1",
+    "@types/node": "^25.2.2",
     "ansis": "^4.2.0",
     "dprint": "^0.51.1",
     "effect": "^3.19.16",
@@ -52,12 +52,12 @@
     "tsl-dx": "workspace:*",
     "tsx": "latest",
     "typedoc": "^0.28.16",
-    "typedoc-plugin-markdown": "^4.9.0",
+    "typedoc-plugin-markdown": "^4.10.0",
     "typedoc-plugin-mdn-links": "^5.1.1",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"
   },
-  "packageManager": "pnpm@10.28.2",
+  "packageManager": "pnpm@10.29.1",
   "engines": {
     "node": ">=24.0.0"
   }
diff --git a/packages/eslint-plugin-function-rule/package.json b/packages/eslint-plugin-function-rule/package.json
@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-function-rule",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "An ESLint plugin to write custom rules with JavaScript functions.",
   "homepage": "https://github.com/Rel1cx/dx",
   "bugs": {
diff --git a/packages/eslint-plugin-function-rule/tsdown.config.ts b/packages/eslint-plugin-function-rule/tsdown.config.ts
@@ -5,7 +5,7 @@ export default {
   dts: true,
   entry: ["src/index.ts"],
   external: ["eslint", "typescript"],
-  inlineOnly: ["@jsr/let__eff"],
+  inlineOnly: ["@local/eff"],
   fixedExtension: false,
   format: ["esm"],
   minify: false,
diff --git a/packages/eslint-plugin-function/package.json b/packages/eslint-plugin-function/package.json
@@ -1,6 +1,6 @@
 {
   "name": "eslint-plugin-function",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": false,
   "description": "(WIP) An ESLint plugin for function-related rules.",
   "homepage": "https://github.com/Rel1cx/dx",
@@ -34,8 +34,8 @@
     "publish": "pnpm run build && pnpm run lint:publish"
   },
   "dependencies": {
-    "@eslint-react/ast": "^2.10.0",
-    "@eslint-react/shared": "^2.10.0",
+    "@eslint-react/ast": "^2.12.2",
+    "@eslint-react/shared": "^2.12.2",
     "@typescript-eslint/scope-manager": "^8.54.0",
     "@typescript-eslint/type-utils": "^8.54.0",
     "@typescript-eslint/types": "^8.54.0",
@@ -47,9 +47,9 @@
   },
   "devDependencies": {
     "@local/eff": "workspace:*",
-    "@types/node": "^25.2.1",
+    "@types/node": "^25.2.2",
     "dedent": "^1.7.1",
-    "eslint": "^9.39.2",
+    "eslint": "^10.0.0",
     "tsdown": "^0.20.3",
     "tsl": "^1.0.28"
   },
diff --git a/packages/eslint-plugin-function/tsdown.config.ts b/packages/eslint-plugin-function/tsdown.config.ts
@@ -5,7 +5,7 @@ export default {
   dts: true,
   entry: ["src/index.ts"],
   external: ["eslint", "typescript"],
-  inlineOnly: ["@jsr/let__eff"],
+  inlineOnly: ["@local/eff"],
   fixedExtension: false,
   format: ["esm"],
   minify: false,
diff --git a/packages/tsl-dx/docs/README.md b/packages/tsl-dx/docs/README.md
@@ -6,4 +6,5 @@
 | ------ | ------ |
 | [noDuplicateExports](variables/noDuplicateExports.md) | Rule to detect and merge duplicate `export from` statements from the same module. |
 | [noDuplicateImports](variables/noDuplicateImports.md) | Rule to detect and merge duplicate `import from` statements from the same module. |
-| [nullishComparison](variables/nullishComparison.md) | Enforces the use of '==' and '!=' for nullish comparisons (i.e., comparisons to null or undefined) |
+| [noMultilineTemplateExpressionsWithoutAutoDedent](variables/noMultilineTemplateExpressionsWithoutAutoDedent.md) | - |
+| [nullish](variables/nullish.md) | - |
diff --git a/packages/tsl-dx/docs/variables/noMultilineTemplateExpressionsWithoutAutoDedent.md b/packages/tsl-dx/docs/variables/noMultilineTemplateExpressionsWithoutAutoDedent.md
@@ -0,0 +1,17 @@
+[tsl-module](../README.md) / noMultilineTemplateExpressionsWithoutAutoDedent
+
+# Variable: noMultilineTemplateExpressionsWithoutAutoDedent()
+
+```ts
+const noMultilineTemplateExpressionsWithoutAutoDedent: (options?: "off") => Rule<unknown>;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `options?` | `"off"` |
+
+## Returns
+
+`Rule`\<`unknown`\>
diff --git a/packages/tsl-dx/docs/variables/nullish.md b/packages/tsl-dx/docs/variables/nullish.md
@@ -0,0 +1,17 @@
+[tsl-module](../README.md) / nullish
+
+# Variable: nullish()
+
+```ts
+const nullish: (options?: "off") => Rule<unknown>;
+```
+
+## Parameters
+
+| Parameter | Type |
+| ------ | ------ |
+| `options?` | `"off"` |
+
+## Returns
+
+`Rule`\<`unknown`\>
diff --git a/packages/tsl-dx/docs/variables/nullishComparison.md b/packages/tsl-dx/docs/variables/nullishComparison.md
diff --git a/packages/tsl-dx/package.json b/packages/tsl-dx/package.json
@@ -1,6 +1,6 @@
 {
   "name": "tsl-dx",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "A tsl plugin for better JavaScript/TypeScript DX.",
   "keywords": [
     "tsl",
diff --git a/packages/tsl-dx/src/index.ts b/packages/tsl-dx/src/index.ts
@@ -1,3 +1,4 @@
 export { noDuplicateExports } from "./rules/no-duplicate-exports";
 export { noDuplicateImports } from "./rules/no-duplicate-imports";
-export { nullishComparison } from "./rules/nullish-comparison";
+export { noMultilineTemplateExpressionsWithoutAutoDedent } from "./rules/no-multiline-template-expressions-without-auto-dedent";
+export { nullish } from "./rules/nullish";
diff --git a/packages/tsl-dx/src/rules/no-multiline-template-expressions-without-auto-dedent.test.ts b/packages/tsl-dx/src/rules/no-multiline-template-expressions-without-auto-dedent.test.ts
@@ -0,0 +1,33 @@
+import { ruleTester } from "tsl/ruleTester";
+import { expect, test } from "vitest";
+
+import {
+  messages,
+  noMultilineTemplateExpressionsWithoutAutoDedent,
+} from "./no-multiline-template-expressions-without-auto-dedent";
+
+test("no-multiline-template-expressions-without-auto-dedent", () => {
+  const ret = ruleTester({
+    invalid: [
+      {
+        code: "`\n`",
+        errors: [
+          {
+            message: messages.default(),
+          },
+        ],
+      },
+    ],
+    ruleFn: noMultilineTemplateExpressionsWithoutAutoDedent,
+    tsx: true,
+    valid: [
+      {
+        code: "``",
+      },
+      {
+        code: "dedent`\n`",
+      },
+    ],
+  });
+  expect(ret).toBe(false);
+});
diff --git a/packages/tsl-dx/src/rules/no-multiline-template-expressions-without-auto-dedent.ts b/packages/tsl-dx/src/rules/no-multiline-template-expressions-without-auto-dedent.ts
@@ -0,0 +1,25 @@
+import { defineRule } from "tsl";
+import { SyntaxKind } from "typescript";
+
+import { getLine } from "../utils";
+
+export const messages = {
+  default: () => `Avoid using multiline template expressions without auto-dedent`,
+} as const;
+
+export const noMultilineTemplateExpressionsWithoutAutoDedent = defineRule(() => ({
+  name: "dx/no-multiline-template-expressions-without-auto-dedent",
+  visitor: {
+    NoSubstitutionTemplateLiteral(ctx, node) {
+      // Assuming this tag supports auto-dedentation to keep it simple
+      if (node.parent.kind === SyntaxKind.TaggedTemplateExpression) return;
+      const [startLine, endLine] = getLine(node);
+      if (startLine !== endLine) {
+        ctx.report({
+          node,
+          message: messages.default(),
+        });
+      }
+    },
+  },
+}));
diff --git a/packages/tsl-dx/src/rules/nullish.test.ts b/packages/tsl-dx/src/rules/nullish.test.ts
@@ -2,21 +2,40 @@ import tsx from "dedent";
 import { ruleTester } from "tsl/ruleTester";
 import { expect, test } from "vitest";
 
-import { messages, nullishComparison } from "./nullish-comparison";
+import { messages, nullish, suggestions } from "./nullish";
 
-test("nullish-comparison", () => {
+test("nullish", () => {
   const ret = ruleTester({
     invalid: [
+      {
+        code: tsx`
+          let undef: undefined;
+        `,
+        errors: [
+          {
+            message: messages.useUnitForUndefined,
+            suggestions: [
+              {
+                message: suggestions.replaceWithExpression({ expr: "unit" }),
+                output: tsx`
+                  import { unit } from '@local/eff';
+                  let undef: unit;
+                `,
+              },
+            ],
+          },
+        ],
+      },
       {
         code: tsx`
           if (a === null) { }
         `,
         errors: [
           {
-            message: messages.default({ op: "==" }),
+            message: messages.useLooseNullishComparison({ op: "==" }),
             suggestions: [
               {
-                message: messages.replace({ expr: "a == null" }),
+                message: suggestions.replaceWithExpression({ expr: "a == null" }),
                 output: tsx`
                   if (a == null) { }
                 `,
@@ -31,10 +50,10 @@ test("nullish-comparison", () => {
         `,
         errors: [
           {
-            message: messages.default({ op: "!=" }),
+            message: messages.useLooseNullishComparison({ op: "!=" }),
             suggestions: [
               {
-                message: messages.replace({ expr: "a != null" }),
+                message: suggestions.replaceWithExpression({ expr: "a != null" }),
                 output: tsx`
                   if (a != null) { }
                 `,
@@ -49,10 +68,10 @@ test("nullish-comparison", () => {
         `,
         errors: [
           {
-            message: messages.default({ op: "!=" }),
+            message: messages.useLooseNullishComparison({ op: "!=" }),
             suggestions: [
               {
-                message: messages.replace({ expr: "null != a" }),
+                message: suggestions.replaceWithExpression({ expr: "null != a" }),
                 output: tsx`
                   if (null != a) { }
                 `,
@@ -67,10 +86,10 @@ test("nullish-comparison", () => {
         `,
         errors: [
           {
-            message: messages.default({ op: "==" }),
+            message: messages.useLooseNullishComparison({ op: "==" }),
             suggestions: [
               {
-                message: messages.replace({ expr: "a == null" }),
+                message: suggestions.replaceWithExpression({ expr: "a == null" }),
                 output: tsx`
                   if (a == null) { }
                 `,
@@ -85,10 +104,10 @@ test("nullish-comparison", () => {
         `,
         errors: [
           {
-            message: messages.default({ op: "!=" }),
+            message: messages.useLooseNullishComparison({ op: "!=" }),
             suggestions: [
               {
-                message: messages.replace({ expr: "null != b" }),
+                message: suggestions.replaceWithExpression({ expr: "null != b" }),
                 output: tsx`
                   if (null != b) { }
                 `,
@@ -98,7 +117,7 @@ test("nullish-comparison", () => {
         ],
       },
     ],
-    ruleFn: nullishComparison,
+    ruleFn: nullish,
     tsx: true,
     valid: [
       tsx`
diff --git a/packages/tsl-dx/src/rules/nullish.ts b/packages/tsl-dx/src/rules/nullish.ts
diff --git a/packages/tsl-dx/src/utils/index.ts b/packages/tsl-dx/src/utils/index.ts
diff --git a/packages/tsl-dx/src/utils/source-file.ts b/packages/tsl-dx/src/utils/source-file.ts
diff --git a/packages/tsl-dx/tsdown.config.ts b/packages/tsl-dx/tsdown.config.ts
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "eslint-plugin-function-rule",`
`3`		`- "version": "0.5.0",`
	`3`	`+ "version": "0.5.1",`
`4`	`4`	`"description": "An ESLint plugin to write custom rules with JavaScript functions.",`
`5`	`5`	`"homepage": "https://github.com/Rel1cx/dx",`
`6`	`6`	`"bugs": {`