First commit

ByScripts · ByScripts · commit e06e7f2cda96 · 2026-02-23T22:20:41.000+01:00
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -0,0 +1,26 @@
+name: Publish to npm
+
+on:
+  push:
+    branches: [main]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org
+
+      - run: pnpm install --frozen-lockfile
+
+      - run: pnpm build
+
+      - run: pnpm publish -r --access public --no-git-checks --provenance
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,2 @@
+node_modules
+.turbo
diff --git a/package.json b/package.json
@@ -0,0 +1,13 @@
+{
+  "name": "@byscripts/toolbox",
+  "scripts": {
+    "build": "turbo build"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "turbo": "^2.8.10"
+  },
+  "packageManager": "pnpm@10.30.1"
+}
diff --git a/packages/eslint-config/.gitignore b/packages/eslint-config/.gitignore
@@ -0,0 +1 @@
+dist
diff --git a/packages/eslint-config/README.md b/packages/eslint-config/README.md
@@ -0,0 +1,42 @@
+# @byscripts/eslint-config
+
+Shared ESLint flat config for Vue 3 + TypeScript projects.
+
+## Install
+
+```bash
+pnpm add -D @byscripts/eslint-config eslint
+```
+
+The config references rules from `eslint-plugin-vue`, `typescript-eslint`, and `vue-eslint-parser`. These must be available at runtime. In a typical Vue + TypeScript project, they are already installed (via `@vue/eslint-config-typescript`, `eslint-plugin-vue`, etc.). If not, install them explicitly:
+
+```bash
+pnpm add -D eslint-plugin-vue typescript-eslint vue-eslint-parser
+```
+
+## Usage
+
+```js
+// eslint.config.js
+import byscriptsConfig from "@byscripts/eslint-config";
+
+export default [
+  ...byscriptsConfig,
+  // your overrides here
+];
+```
+
+## Dev
+
+```bash
+pnpm build        # compile src/index.ts -> dist/index.mjs + dist/index.d.mts
+pnpm publish --access public   # publish to npm (pnpm replaces workspace:* automatically)
+```
+
+## Notes
+
+- Built with `tsdown --dts`
+- Uses ESLint flat config (`defineConfig` from `eslint/config`, available since ESLint 9.22)
+- Peer dependency: `eslint ^9.22.0`
+- `@byscripts/eslint-plugin` is a regular dependency (installed automatically)
+- `eslint-plugin-vue`, `typescript-eslint`, and `vue-eslint-parser` must be available at runtime (usually already present in Vue + TS projects)
diff --git a/packages/eslint-config/package.json b/packages/eslint-config/package.json
@@ -0,0 +1,28 @@
+{
+  "name": "@byscripts/eslint-config",
+  "version": "0.3.3",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown --dts"
+  },
+  "dependencies": {
+    "@byscripts/eslint-plugin": "workspace:*"
+  },
+  "peerDependencies": {
+    "eslint": "^9.22.0"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "^22.0.5",
+    "tsdown": "^0.20.3"
+  },
+  "license": "MIT"
+}
diff --git a/packages/eslint-config/src/index.ts b/packages/eslint-config/src/index.ts
@@ -0,0 +1,87 @@
+import { defineConfig } from "eslint/config";
+import byscriptsPlugins from "@byscripts/eslint-plugin";
+
+export default defineConfig([
+  {
+    plugins: {
+      byscripts: {
+        rules: {
+          "vue-block-attribute-order": byscriptsPlugins.blockAttributeOrder,
+        },
+      },
+    },
+    rules: {
+      "vue/block-order": ["error", { order: ["script", "template", "style"] }],
+      "vue/block-lang": [
+        "error",
+        {
+          script: { lang: "ts" },
+          style: { lang: "postcss" },
+        },
+      ],
+      "vue/block-tag-newline": [
+        "error",
+        {
+          singleline: "consistent",
+          multiline: "always",
+          maxEmptyLines: 0,
+        },
+      ],
+      "vue/component-api-style": ["error", ["script-setup"]],
+      "vue/component-name-in-template-casing": [
+        "error",
+        "PascalCase",
+        { registeredComponentsOnly: false },
+      ],
+      "vue/custom-event-name-casing": ["error", "camelCase"],
+      "vue/define-emits-declaration": ["error", "type-literal"],
+      "vue/define-macros-order": [
+        "error",
+        {
+          order: [
+            "defineOptions",
+            "defineProps",
+            "defineEmits",
+            "defineModel",
+            "defineSlots",
+          ],
+          defineExposeLast: true,
+        },
+      ],
+      "vue/define-props-declaration": ["error", "type-based"],
+      "vue/enforce-style-attribute": ["error", { allow: ["scoped", "module"] }],
+      "vue/html-button-has-type": "error",
+      "vue/html-comment-content-newline": [
+        "error",
+        {
+          singleline: "never",
+          multiline: "always",
+        },
+      ],
+      "vue/html-comment-content-spacing": ["error", "always"],
+      "vue/no-duplicate-attr-inheritance": "error",
+      "vue/no-empty-component-block": "error",
+      "vue/no-multiple-objects-in-class": "error",
+      "vue/no-ref-object-reactivity-loss": "error",
+      "vue/no-static-inline-styles": "error",
+      "vue/no-template-target-blank": "error",
+      "vue/no-undef-components": [
+        "error",
+        { ignorePatterns: ["RouterLink", "RouterView", "I18nT"] },
+      ],
+      "vue/no-undef-properties": "error",
+      "vue/no-unused-refs": "error",
+      "vue/no-use-v-else-with-v-for": "error",
+      "vue/no-useless-mustaches": "error",
+      "vue/no-useless-v-bind": "error",
+      "vue/no-v-text": "error",
+      "vue/padding-line-between-blocks": "error",
+      "vue/prefer-define-options": "error",
+      "vue/prefer-separate-static-class": "error",
+      "vue/prefer-true-attribute-shorthand": "error",
+      "vue/require-macro-variable-name": "error",
+      "vue/valid-define-options": "error",
+      "byscripts/vue-block-attribute-order": "error",
+    },
+  },
+]);
diff --git a/packages/eslint-config/tsconfig.json b/packages/eslint-config/tsconfig.json
@@ -0,0 +1,3 @@
+{
+  "extends": "@tsconfig/node22/tsconfig.json"
+}
diff --git a/packages/eslint-plugin/.gitignore b/packages/eslint-plugin/.gitignore
@@ -0,0 +1 @@
+dist
diff --git a/packages/eslint-plugin/README.md b/packages/eslint-plugin/README.md
@@ -0,0 +1,38 @@
+# @byscripts/eslint-plugin
+
+Custom ESLint rules for Vue 3 projects.
+
+## Rules
+
+| Rule                                  | Description                                                 | Fixable |
+| ------------------------------------- | ----------------------------------------------------------- | ------- |
+| `byscripts/vue-block-attribute-order` | Enforces attribute order on `<script>` and `<style>` blocks | Yes     |
+
+### `vue-block-attribute-order`
+
+Default order:
+
+- `<script>`: `lang`, `setup`
+- `<style>`: `lang`, `scoped`
+
+Custom order via rule options:
+
+```js
+"byscripts/vue-block-attribute-order": ["error", {
+  script: ["setup", "lang"],
+  style: ["scoped", "lang"],
+}]
+```
+
+## Dev
+
+```bash
+pnpm build        # compile src/ -> dist/index.mjs + dist/index.d.mts
+pnpm publish --access public   # publish to npm
+```
+
+## Notes
+
+- Built with `tsdown --dts`
+- Peer dependency: `eslint ^9.22.0`
+- Requires `vue-eslint-parser` in the consumer project (for `parserServices.getDocumentFragment()`)
diff --git a/packages/eslint-plugin/package.json b/packages/eslint-plugin/package.json
@@ -0,0 +1,25 @@
+{
+  "name": "@byscripts/eslint-plugin",
+  "version": "0.3.3",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown --dts"
+  },
+  "devDependencies": {
+    "@tsconfig/node22": "^22.0.5",
+    "tsdown": "^0.20.3"
+  },
+  "peerDependencies": {
+    "eslint": "^9.22.0"
+  },
+  "license": "MIT"
+}
diff --git a/packages/eslint-plugin/src/block-attribute-order.ts b/packages/eslint-plugin/src/block-attribute-order.ts
@@ -0,0 +1,120 @@
+// eslint/block-attribute-order.ts
+import type { Rule } from "eslint";
+
+type AttributeOrder = Record<string, string[]>;
+
+const DEFAULT_ORDER: AttributeOrder = {
+  script: ["lang", "setup"],
+  style: ["lang", "scoped"],
+};
+
+export const blockAttributeOrder: Rule.RuleModule = {
+  meta: {
+    type: "layout",
+    fixable: "code",
+    schema: [
+      {
+        type: "object",
+        additionalProperties: {
+          type: "array",
+          items: { type: "string" },
+        },
+      },
+    ],
+    messages: {
+      wrongOrder: "Attributes on <{{tag}}> should follow order: {{expected}}.",
+    },
+  },
+  create(context) {
+    if (!context.filename.endsWith(".vue")) {
+      return {};
+    }
+
+    const attributeOrder: AttributeOrder = {
+      ...DEFAULT_ORDER,
+      ...(context.options[0] as AttributeOrder),
+    };
+
+    const { parserServices } = context.sourceCode;
+
+    const documentFragment = parserServices.getDocumentFragment?.();
+
+    if (!documentFragment) {
+      return {};
+    }
+
+    return {
+      Program() {
+        for (const child of documentFragment.children) {
+          if (child.type !== "VElement") {
+            continue;
+          }
+
+          const expectedOrder = attributeOrder[child.name];
+
+          if (!expectedOrder) {
+            continue;
+          }
+
+          const attributes = child.startTag.attributes.filter(
+            (a: Record<string, unknown>) =>
+              a.type === "VAttribute" && !a.directive,
+          );
+
+          const attributeNames: string[] = attributes.map(
+            (a: Record<string, Record<string, unknown>>) => a.key.name,
+          );
+
+          const relevantNames = attributeNames.filter((n) =>
+            expectedOrder.includes(n),
+          );
+
+          const expectedNames = expectedOrder.filter((n) =>
+            relevantNames.includes(n),
+          );
+
+          if (relevantNames.every((name, i) => name === expectedNames[i])) {
+            continue;
+          }
+
+          const sourceCode = context.sourceCode;
+
+          context.report({
+            loc: child.startTag.loc,
+            messageId: "wrongOrder",
+            data: { tag: child.name, expected: expectedNames.join(", ") },
+            fix(fixer) {
+              const sorted = [...attributes].sort((attributeA, attributeB) => {
+                const attributeAIndex = expectedOrder.indexOf(
+                  attributeA.key.name,
+                );
+
+                const attributeBIndex = expectedOrder.indexOf(
+                  attributeB.key.name,
+                );
+
+                return (
+                  (attributeAIndex === -1 ? 999 : attributeAIndex) -
+                  (attributeBIndex === -1 ? 999 : attributeBIndex)
+                );
+              });
+
+              const newText = sorted
+                .map((a) => sourceCode.getText(a))
+                .join(" ");
+
+              const firstAttribute = attributes[0];
+
+              const lastAttribute = attributes[attributes.length - 1];
+
+              return fixer.replaceTextRange(
+                [firstAttribute.range[0], lastAttribute.range[1]],
+                newText,
+              );
+            },
+          });
+        }
+      },
+    };
+  },
+};
diff --git a/packages/eslint-plugin/src/index.ts b/packages/eslint-plugin/src/index.ts
diff --git a/packages/eslint-plugin/tsconfig.json b/packages/eslint-plugin/tsconfig.json
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
diff --git a/pnpm-workspace.yaml b/pnpm-workspace.yaml
diff --git a/turbo.json b/turbo.json

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+{`
	`2`	`+ "extends": "@tsconfig/node22/tsconfig.json"`
	`3`	`+}`