@html-validate/plugin-template 0.0.1 → 1.0.2

package/files/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @html-validate/plugin-template changelog
+
+## 1.0.2 (2026-06-25)
+
+### Bug Fixes
+
+- **deps:** update cloneman to v1.18.1 ([881c389](https://gitlab.com/html-validate/plugin-template/commit/881c3893e2cf5323c83e7658f1b4883a8c262be6))
+
+## 1.0.1 (2026-06-21)
+
+### Bug Fixes
+
+- ignore eslint and prettier dependencies ([1f49d2a](https://gitlab.com/html-validate/plugin-template/commit/1f49d2a5964150df02342dbf22a0090bb2eb68e1))
+
+## 1.0.0 (2026-06-21)
+
+### Features
+
+- initial version ([1ac7862](https://gitlab.com/html-validate/plugin-template/commit/1ac786208f5f0f91b7d0f0f8bee6d9ff52e23062))
+
+### Bug Fixes
+
+- no need to rerun test-files ([e7a7391](https://gitlab.com/html-validate/plugin-template/commit/e7a73910ee1e2b077e0f076e6fa236e295c7c26a))

package/files/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2018-2026 David Sveningsson <ext@sidvind.com>
+
+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/files/README.md

@@ -0,0 +1,11 @@
+# @html-validate/plugin-template
+
+[Cloneman] template for [HTML-Validate][html-validate] plugins.
+
+[cloneman]: https://github.com/Forsakringskassan/cloneman
+[html-validate]: https://www.npmjs.com/package/html-validate
+
+## Usage
+
+    npx cloneman create awesome-plugin @html-validate/plugin-template
+    npx cloneman update

package/files/_editorconfig

@@ -0,0 +1,20 @@
+# EditorConfig: http://EditorConfig.org
+#
+# This file is managed by "@html-validate/plugin-template".
+# Changes will be overwritten.
+
+root = true
+
+[*]
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_style = tab
+charset = utf-8
+
+[*.json]
+indent_style = space
+indent_size = 2
+
+[*.yml]
+indent_style = space
+indent_size = 2

package/files/_gitignore

@@ -0,0 +1,9 @@
+# This file is managed by "@html-validate/plugin-template".
+# Changes will be overwritten.
+
+*.tgz
+.eslintcache
+dist/
+coverage/
+node_modules/
+temp/

package/files/_gitlab-ci.yml

@@ -0,0 +1,117 @@
+image: node:24
+
+include:
+  - component: $CI_SERVER_FQDN/html-validate/gitlab-ci/release@master
+    inputs:
+      legacy: false
+      on-push: true
+
+stages:
+  - prepare
+  - test
+  - build
+  - compatibility
+  - release
+
+NPM:
+  stage: prepare
+  artifacts:
+    name: ${CI_PROJECT_PATH_SLUG}-${CI_PIPELINE_ID}-npm
+    paths:
+      - node_modules/
+      - packages/*/node_modules/
+    reports:
+      dependency_scanning: gl-dependency-scanning.json
+  script:
+    - node --version
+    - npm --version
+    - npm ci --no-fund --no-audit --no-update-notifier
+    - npm audit --json --production | npx --yes gitlab-npm-audit-parser -o gl-dependency-scanning.json || true
+    - test -z "${UPSTREAM_VERSION}" || npm install "html-validate@${UPSTREAM_VERSION}"
+
+ESLint:
+  stage: test
+  script:
+    - npm exec eslint-config -- --check
+    - npm run eslint -- --max-warnings 0
+
+Jest:
+  stage: test
+  coverage: /Branches\s+:\s(\d+.\d+%)/
+  artifacts:
+    name: ${CI_PROJECT_PATH_SLUG}-${CI_PIPELINE_ID}-coverage
+    paths:
+      - coverage
+    reports:
+      junit: temp/jest.xml
+  before_script:
+    - npm run --if-present build
+  script:
+    - npm test
+
+Prettier:
+  stage: test
+  script:
+    - npm run prettier:check
+
+attw:
+  stage: test
+  needs: []
+  script:
+    - npm ci
+    - npm run build
+    - npm run attw
+
+Build:
+  stage: build
+  needs:
+    - NPM
+  dependencies:
+    - NPM
+  artifacts:
+    name: ${CI_PROJECT_PATH_SLUG}-${CI_PIPELINE_ID}-build
+    paths:
+      - dist
+  script:
+    - npm run --if-present build
+    - node dist/cjs/index.cjs
+    - node dist/esm/index.mjs
+    - npm pack
+    - npm exec npm-pkg-lint
+
+.compat: &compat
+  stage: compatibility
+  dependencies:
+    - NPM
+    - Build
+  needs:
+    - NPM
+    - Build
+  script:
+    - for spec in test/*.spec.ts; do sed 's#../src#../dist/cjs/index.cjs#g' -i "${spec}"; done
+    - sed '/dist/s#jest.mock#//#' -i "test/htmlvalidate.spec.ts"
+    - npm test -- --no-coverage test
+
+Node:
+  extends: .compat
+  parallel:
+    matrix:
+      - VERSION:
+          - 22
+          - 24
+  image: "node:${VERSION}"
+
+HTML-validate:
+  extends: .compat
+  parallel:
+    matrix:
+      - VERSION:
+          - 8
+          - 9
+          - 10
+          - 11
+  before_script:
+    - test ${VERSION} -lt 10 && npm install jest@29 jest-environment-jsdom@29 jest-snapshot@29 jest-diff@29 jest-runtime@29 @types/jest@29
+    - npm install $(npx -y npm-min-peer html-validate --major ${VERSION} --with-name)
+    - npm ls html-validate
+    - npm ls jest

package/files/_htmlvalidate.mjs

@@ -0,0 +1,9 @@
+/* This file is managed by "@html-validate/plugin-template". Changes will be overwritten */
+
+import Plugin from "./dist/esm/index.mjs";
+
+export default {
+	plugins: [Plugin],
+	extends: ["html-validate:recommended", `${Plugin.name}:recommended`],
+	elements: ["html5"],
+};

package/files/_npmrc

@@ -0,0 +1,3 @@
+save-exact = true
+provenance = true
+strict-allow-scripts = true

package/files/_prettierignore

@@ -0,0 +1,9 @@
+# This file is managed by "@html-validate/plugin-template".
+# Changes will be overwritten.
+
+# generated by npm
+package-lock.json
+
+# compiled files
+dist/
+coverage/

package/files/build.mjs

@@ -0,0 +1,37 @@
+/* This file is managed by "@html-validate/plugin-template". Changes will be overwritten */
+
+import fs from "node:fs/promises";
+import { analyzeMetafile, build as esbuild } from "esbuild";
+
+const entrypoint = {
+	cjs: "src/entry-cjs.ts",
+	esm: "src/entry-esm.ts",
+};
+
+const extension = {
+	cjs: ".cjs",
+	esm: ".mjs",
+};
+
+await fs.rm("dist", { recursive: true, force: true });
+
+for (const format of ["cjs", "esm"]) {
+	const result = await esbuild({
+		entryPoints: [{ in: entrypoint[format], out: "index" }],
+		outdir: `dist/${format}`,
+		bundle: true,
+		platform: "node",
+		format,
+		target: "node22",
+		logLevel: "info",
+		sourcemap: true,
+		metafile: true,
+		outExtension: {
+			".js": extension[format],
+		},
+		external: ["@html-validate/plugin-utils", "html-validate"],
+	});
+	if (format === "esm") {
+		console.log(await analyzeMetafile(result.metafile));
+	}
+}

package/files/eslint.config.mjs

@@ -0,0 +1,37 @@
+/* This file is managed by @html-validate/eslint-config */
+/* Changes may be overwritten */
+
+import defaultConfig from "@html-validate/eslint-config";
+import jestConfig from "@html-validate/eslint-config-jest";
+import typescriptConfig from "@html-validate/eslint-config-typescript";
+import typescriptTypeinfoConfig from "@html-validate/eslint-config-typescript-typeinfo";
+
+export default [
+	...defaultConfig({ type: "commonjs" }),
+
+	{
+		name: "@html-validate/eslint-config-typescript",
+		files: ["**/*.{ts,cts,mts}"],
+		...typescriptConfig,
+	},
+
+	{
+		name: "@html-validate/eslint-config-typeinfo",
+		files: ["src/**/*.{ts,cts,mts}"],
+		ignores: ["src/**/*.spec.ts"],
+		languageOptions: {
+			parserOptions: {
+				tsconfigRootDir: import.meta.dirname,
+				projectService: true,
+			},
+		},
+		...typescriptTypeinfoConfig,
+	},
+
+	{
+		name: "@html-validate/eslint-config-jest",
+		files: ["**/*.spec.[jt]s"],
+		ignores: ["cypress/**", "tests/e2e/**"],
+		...jestConfig,
+	},
+];

package/files/package.json

@@ -0,0 +1,117 @@
+{
+  "name": "${name}",
+  "version": "${version}",
+  "description": "${description}",
+  "keywords": [
+    "cloneman",
+    "html-validate"
+  ],
+  "homepage": "https://gitlab.com/html-validate/plugin-template",
+  "bugs": {
+    "url": "https://gitlab.com/html-validate/plugin-template/-/work_items/new?type=Issue"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/html-validate/plugin-template.git"
+  },
+  "license": "MIT",
+  "author": "David Sveningsson <ext@sidvind.com>",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.mts",
+        "default": "./dist/esm/index.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.cts",
+        "default": "./dist/cjs/index.cjs"
+      }
+    }
+  },
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "prebuild": "tsc",
+    "build": "run-s build:*",
+    "postbuild": "cloneman build -o temp/cloneman",
+    "build:lib": "node build.mjs",
+    "build:cjs": "dts-bundle-generator --no-banner --project tsconfig.cjs.json -o dist/cjs/index.d.cts src/entry-cjs.ts",
+    "build:esm": "dts-bundle-generator --no-banner --project tsconfig.esm.json -o dist/esm/index.d.mts src/entry-esm.ts",
+    "eslint": "eslint --cache .",
+    "eslint:fix": "eslint --cache --fix .",
+    "prepack": "release-prepack package.json --bundle",
+    "postpack": "release-postpack package.json",
+    "prepare": "husky",
+    "prepublishOnly": "release-prepack package.json --bundle",
+    "prettier:check": "prettier --check .",
+    "prettier:write": "prettier --write .",
+    "postpublish": "release-postpack package.json",
+    "attw": "attw --no-emoji --pack .",
+    "test": "jest"
+  },
+  "commitlint": {
+    "extends": "@html-validate"
+  },
+  "prettier": "@html-validate/prettier-config",
+  "release": {
+    "extends": "@html-validate/semantic-release-cloneman-config"
+  },
+  "jest": {
+    "preset": "@html-validate/jest-config"
+  },
+  "dependencies": {
+    "@html-validate/plugin-utils": "^4.0.0"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.4",
+    "@html-validate/commitlint-config": "4.0.3",
+    "@html-validate/eslint-config": "9.8.2",
+    "@html-validate/eslint-config-jest": "9.8.0",
+    "@html-validate/eslint-config-typescript": "9.8.0",
+    "@html-validate/eslint-config-typescript-typeinfo": "9.8.0",
+    "@html-validate/jest-config": "3.18.2",
+    "@html-validate/plugin-template": "1.0.2",
+    "@html-validate/prettier-config": "4.1.1",
+    "@html-validate/release-scripts": "7.3.1",
+    "@jest/globals": "30.4.1",
+    "@tsconfig/node22": "22.0.5",
+    "@tsconfig/strictest": "2.0.8",
+    "@types/estree": "1.0.9",
+    "@types/node": "22.20.0",
+    "@types/semver": "7.7.1",
+    "cloneman": "1.18.1",
+    "dts-bundle-generator": "9.5.1",
+    "esbuild": "0.28.1",
+    "html-validate": "11.5.3",
+    "husky": "9.1.7",
+    "jest": "30.4.2",
+    "jest-environment-jsdom": "30.4.1",
+    "npm-pkg-lint": "5.1.8",
+    "npm-run-all2": "9.0.2",
+    "semver": "7.8.5",
+    "ts-jest": "29.4.11",
+    "typescript": "6.0.3"
+  },
+  "peerDependencies": {
+    "html-validate": "^8.21.0 || ^9.0.0 || ^10.0.0 || ^11.0.0"
+  },
+  "engines": {
+    "node": "^22.16 || >= 24"
+  },
+  "allowScripts": {
+    "@html-validate/commitlint-config": true,
+    "esbuild": true,
+    "fsevents": false,
+    "unrs-resolver": true
+  },
+  "cloneman": {
+    "template": "@html-validate/plugin-template",
+    "version": "1.0.2"
+  },
+  "externalDependencies": [
+    "@html-validate/plugin-utils"
+  ]
+}

package/files/renovate.json

@@ -0,0 +1,3 @@
+{
+  "extends": ["gitlab>html-validate/renovate-config"]
+}

package/files/src/__snapshots__/elements.spec.ts.snap

@@ -0,0 +1,71 @@
+// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+
+exports[`HTML elements <custom-component> invalid markup 1`] = `
+[
+  {
+    "errorCount": 3,
+    "filePath": "test-files/elements/custom-component-invalid.html",
+    "messages": [
+      {
+        "column": 2,
+        "context": {
+          "attr": "value",
+          "tagName": "<custom-component>",
+        },
+        "line": 2,
+        "message": "<custom-component> is missing required "value" attribute",
+        "offset": 43,
+        "ruleId": "element-required-attributes",
+        "ruleUrl": "https://html-validate.org/rules/element-required-attributes.html",
+        "selector": "custom-component:nth-child(1)",
+        "severity": 2,
+        "size": 16,
+      },
+      {
+        "column": 26,
+        "context": {
+          "allowed": {
+            "enum": [
+              "yes",
+              "no",
+            ],
+          },
+          "attribute": "value",
+          "element": "custom-component",
+          "value": "invalid",
+        },
+        "line": 5,
+        "message": "Attribute "value" has invalid value "invalid"",
+        "offset": 139,
+        "ruleId": "attribute-allowed-values",
+        "ruleUrl": "https://html-validate.org/rules/attribute-allowed-values.html",
+        "selector": "custom-component:nth-child(2)",
+        "severity": 2,
+        "size": 7,
+      },
+      {
+        "column": 2,
+        "line": 8,
+        "message": "lorem ipsum",
+        "offset": 212,
+        "ruleId": "awesome-plugin/custom-rule",
+        "selector": "custom-component:nth-child(3)",
+        "severity": 2,
+        "size": 16,
+      },
+    ],
+    "source": "<!-- missing required value attribute -->
+<custom-component></custom-component>
+
+<!-- invalid value attribute -->
+<custom-component value="invalid"></custom-component>
+
+<!-- custom rule disallows value "no" -->
+<custom-component value="no"></custom-component>
+",
+    "warningCount": 0,
+  },
+]
+`;
+
+exports[`HTML elements <custom-component> valid markup 1`] = `[]`;

package/files/src/configs/index.ts

@@ -0,0 +1,5 @@
+import recommended from "./recommended";
+
+export default {
+	recommended,
+};

package/files/src/configs/recommended.ts

@@ -0,0 +1,13 @@
+import { type ConfigData } from "html-validate";
+import elements from "../elements";
+
+export function createConfig(): ConfigData {
+	return {
+		elements: [elements],
+		rules: {
+			"awesome-plugin/custom-rule": "error",
+		},
+	};
+}
+
+export default createConfig();

package/files/src/elements.spec.ts

@@ -0,0 +1,49 @@
+import path from "node:path";
+import { describe, expect, it } from "@jest/globals";
+import { type Report, HtmlValidate } from "html-validate";
+import metadata from "./elements";
+import Plugin from "./index";
+
+const rootDir = path.resolve(__dirname, "..");
+const fileDirectory = path.join(rootDir, "test-files/elements");
+const tagNames = Object.keys(metadata).filter((it) => it !== "*");
+
+const htmlvalidate = new HtmlValidate({
+	root: true,
+	plugins: [Plugin],
+	extends: ["html-validate:recommended", `${Plugin.name}:recommended`],
+	elements: ["html5"],
+	rules: {
+		"no-unknown-attributes": "error",
+		"no-unknown-elements": "error",
+	},
+});
+
+function normalizePath(report: Report): void {
+	for (const result of report.results) {
+		result.filePath = path.relative(rootDir, result.filePath);
+	}
+}
+
+describe("HTML elements", () => {
+	for (const tagName of tagNames) {
+		const slug = tagName.replace(":", "_");
+		const filename = (variant: string): string => `${fileDirectory}/${slug}-${variant}.html`;
+
+		describe(`<${tagName}>`, () => {
+			it("valid markup", async () => {
+				expect.assertions(1);
+				const report = await htmlvalidate.validateFile(filename("valid"));
+				normalizePath(report);
+				expect(report.results).toMatchSnapshot();
+			});
+
+			it("invalid markup", async () => {
+				expect.assertions(1);
+				const report = await htmlvalidate.validateFile(filename("invalid"));
+				normalizePath(report);
+				expect(report.results).toMatchSnapshot();
+			});
+		});
+	}
+});

package/files/src/elements.ts

@@ -0,0 +1,13 @@
+import { defineMetadata } from "html-validate";
+
+export default defineMetadata({
+	"custom-component": {
+		flow: true,
+		attributes: {
+			value: {
+				required: true,
+				enum: ["yes", "no"],
+			},
+		},
+	},
+});

package/files/src/entry-cjs.ts

@@ -0,0 +1,5 @@
+/* istanbul ignore file */
+
+import plugin from "./index";
+
+export = plugin;

package/files/src/entry-esm.ts

@@ -0,0 +1,3 @@
+/* istanbul ignore file */
+
+export { default } from "./index";

package/files/src/index.ts

@@ -0,0 +1,17 @@
+import { type Plugin, compatibilityCheck } from "html-validate";
+import { name, peerDependencies } from "../package.json";
+import configs from "./configs";
+import rules from "./rules";
+
+const range = peerDependencies["html-validate"];
+
+/* eslint-disable-next-line unicorn/no-top-level-side-effects -- intentional side-effect */
+compatibilityCheck(name, range);
+
+const plugin: Plugin = {
+	name,
+	configs,
+	rules,
+};
+
+export default plugin;

package/files/src/rules/custom-rule.spec.ts

@@ -0,0 +1,61 @@
+import { beforeAll, describe, expect, it } from "@jest/globals";
+import { ConfigData, FileSystemConfigLoader, HtmlValidate } from "html-validate";
+import "html-validate/jest";
+import Plugin from "..";
+
+const config: ConfigData = {
+	root: true,
+	plugins: [Plugin],
+	rules: { "awesome-plugin/custom-rule": "error" },
+};
+const loader = new FileSystemConfigLoader(config);
+
+describe("awesome-plugin/custom-rule", () => {
+	let htmlvalidate: HtmlValidate;
+
+	beforeAll(() => {
+		htmlvalidate = new HtmlValidate(loader);
+	});
+
+	it("should not report error for other elements", async () => {
+		expect.assertions(1);
+		const markup = /* HTML */ ` <input value="no" /> `;
+		const report = await htmlvalidate.validateString(markup);
+		expect(report).toBeValid();
+	});
+
+	it("should not report error when <custom-component> omits value", async () => {
+		expect.assertions(1);
+		const markup = /* HTML */ ` <custom-component></custom-component> `;
+		const report = await htmlvalidate.validateString(markup);
+		expect(report).toBeValid();
+	});
+
+	it("should not report error when <custom-component> uses positive value", async () => {
+		expect.assertions(1);
+		const markup = /* HTML */ ` <custom-component value="yes"></custom-component> `;
+		const report = await htmlvalidate.validateString(markup);
+		expect(report).toBeValid();
+	});
+
+	it("should report error when <custom-component> uses negative value", async () => {
+		expect.assertions(2);
+		const markup = /* HTML */ ` <custom-component value="no"></custom-component> `;
+		const report = await htmlvalidate.validateString(markup);
+		expect(report).toBeInvalid();
+		expect(report).toMatchInlineCodeframe(`
+			"error: lorem ipsum (awesome-plugin/custom-rule)
+			> 1 |  <custom-component value="no"></custom-component>
+			    |   ^^^^^^^^^^^^^^^^
+			Selector: custom-component"
+		`);
+	});
+
+	it("should contain documentation", async () => {
+		expect.assertions(1);
+		const docs = await htmlvalidate.getContextualDocumentation({
+			ruleId: "awesome-plugin/custom-rule",
+		});
+		expect(docs?.description).toMatchInlineSnapshot(`"Lorem ipsum dolor sit amet."`);
+	});
+});

package/files/src/rules/custom-rule.ts

@@ -0,0 +1,24 @@
+import { type RuleDocumentation, Rule } from "html-validate";
+
+export class CustomRule extends Rule {
+	public override documentation(): RuleDocumentation {
+		return {
+			description: "Lorem ipsum dolor sit amet.",
+		};
+	}
+
+	public setup(): void {
+		this.on("dom:ready", (event) => {
+			const { document } = event;
+			for (const node of document.querySelectorAll("custom-component")) {
+				const attr = node.getAttribute("value");
+				if (attr?.value === "no") {
+					this.report({
+						node,
+						message: "lorem ipsum",
+					});
+				}
+			}
+		});
+	}
+}

package/files/src/rules/index.ts

@@ -0,0 +1,7 @@
+import { CustomRule } from "./custom-rule";
+
+const rules = {
+	"awesome-plugin/custom-rule": CustomRule,
+};
+
+export default rules;

package/files/test/htmlvalidate.spec.ts

@@ -0,0 +1,40 @@
+/* eslint-disable jest/no-conditional-expect, jest/no-conditional-in-test -- needed to handle backwards compatibility, we use expect.assertions(N) to ensure the right number of expectations have run */
+
+import { expect, it } from "@jest/globals";
+import { ConfigData, FileSystemConfigLoader, HtmlValidate, version } from "html-validate";
+import "html-validate/jest";
+import { gtr } from "semver";
+import Plugin from "../src";
+
+const config: ConfigData = {
+	root: true,
+	plugins: [Plugin],
+	extends: ["html-validate:recommended", `${Plugin.name}:recommended`],
+	elements: ["html5"],
+};
+
+const loader = new FileSystemConfigLoader(config);
+
+it('should find errors in "smoketest.html"', async () => {
+	expect.assertions(2);
+	const htmlvalidate = new HtmlValidate(loader);
+	const report = await htmlvalidate.validateFile("test-files/smoketest.html");
+	expect(report.valid).toBeFalsy();
+	if (gtr(version, "10.12.0")) {
+		expect(report).toMatchInlineCodeframe(`
+			"error: lorem ipsum (awesome-plugin/custom-rule)
+			> 1 | <custom-component value="no"></custom-component>
+			    |  ^^^^^^^^^^^^^^^^
+			  2 |
+			Selector: custom-component"
+		`);
+	} else {
+		expect(report).toMatchInlineCodeframe(`
+			"error: lorem ipsum (awesome-plugin/custom-rule) at test-files/smoketest.html:1:2:
+			> 1 | <custom-component value="no"></custom-component>
+			    |  ^^^^^^^^^^^^^^^^
+			  2 |
+			Selector: custom-component"
+		`);
+	}
+});

package/files/test-files/elements/custom-component-invalid.html

@@ -0,0 +1,8 @@
+<!-- missing required value attribute -->
+<custom-component></custom-component>
+
+<!-- invalid value attribute -->
+<custom-component value="invalid"></custom-component>
+
+<!-- custom rule disallows value "no" -->
+<custom-component value="no"></custom-component>

package/files/test-files/elements/custom-component-valid.html

@@ -0,0 +1 @@
+<custom-component value="yes"></custom-component>

package/files/test-files/smoketest.html

@@ -0,0 +1 @@
+<custom-component value="no"></custom-component>

package/files/tsconfig.cjs.json

@@ -0,0 +1,8 @@
+/* This file is managed by "@html-validate/plugin-template". Changes will be overwritten */
+
+{
+  "extends": ["./tsconfig.json"],
+  "compilerOptions": {
+    "rootDirs": ["./src", "./tests"]
+  }
+}

package/files/tsconfig.esm.json

@@ -0,0 +1,10 @@
+/* This file is managed by "@html-validate/plugin-template". Changes will be overwritten */
+
+{
+  "extends": ["./tsconfig.json"],
+  "compilerOptions": {
+    "rootDirs": ["./src", "./tests"],
+    "module": "esnext",
+    "moduleResolution": "bundler"
+  }
+}

package/files/tsconfig.json

@@ -0,0 +1,16 @@
+/* This file is managed by "@html-validate/plugin-template". Changes will be overwritten */
+
+{
+  "extends": ["@tsconfig/node22", "@tsconfig/strictest"],
+  "compilerOptions": {
+    "rootDir": ".",
+    "declaration": true,
+    "noEmit": true,
+    "outDir": "dist",
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts", "test/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/index.js

@@ -0,0 +1,15 @@
+
+        import fs from "node:fs/promises";
+        import path from "node:path";
+
+        const packageJsonFile = await fs.readFile(path.join(import.meta.dirname, "package.json"), "utf8");
+        const packageJson = JSON.parse(packageJsonFile);
+
+        const options = {
+            ...packageJson.cloneman,
+            filesDir: path.join(import.meta.dirname, "files"),
+            hooksDir: path.join(import.meta.dirname, "hooks"),
+        }
+
+        export default options;
+    

package/package.json

@@ -1,10 +1,79 @@
 {
   "name": "@html-validate/plugin-template",
-  "version": "0.0.1",
-  "description": "OIDC trusted publishing setup package for @html-validate/plugin-template",
+  "version": "1.0.2",
+  "description": "cloneman template for html-validate plugins",
   "keywords": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
+    "cloneman",
+    "html-validate"
+  ],
+  "homepage": "https://gitlab.com/html-validate/plugin-template",
+  "bugs": {
+    "url": "https://gitlab.com/html-validate/plugin-template/-/work_items/new?type=Issue"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/html-validate/plugin-template.git"
+  },
+  "license": "MIT",
+  "author": "David Sveningsson <ext@sidvind.com>",
+  "type": "module",
+  "exports": {
+    ".": "./index.js"
+  },
+  "cloneman": {
+    "boilerplateFiles": [
+      ".editorconfig",
+      ".gitignore",
+      ".gitlab-ci.yml",
+      ".htmlvalidate.mjs",
+      ".npmrc",
+      ".prettierignore",
+      "CHANGELOG.md",
+      "LICENSE",
+      "README.md",
+      "build.mjs",
+      "eslint.config.mjs",
+      "renovate.json",
+      "src/__snapshots__/elements.spec.ts.snap",
+      "src/configs/index.ts",
+      "src/configs/recommended.ts",
+      "src/elements.spec.ts",
+      "src/elements.ts",
+      "src/entry-cjs.ts",
+      "src/entry-esm.ts",
+      "src/index.ts",
+      "src/rules/custom-rule.spec.ts",
+      "src/rules/custom-rule.ts",
+      "src/rules/index.ts",
+      "test-files/elements/custom-component-invalid.html",
+      "test-files/elements/custom-component-valid.html",
+      "test-files/smoketest.html",
+      "test/htmlvalidate.spec.ts",
+      "tsconfig.cjs.json",
+      "tsconfig.esm.json",
+      "tsconfig.json"
+    ],
+    "managedFiles": [
+      ".editorconfig",
+      ".gitignore",
+      ".gitlab-ci.yml",
+      ".htmlvalidate.mjs",
+      ".npmrc",
+      ".prettierignore",
+      "LICENSE",
+      "build.mjs",
+      "eslint.config.mjs",
+      "package.json",
+      "renovate.json",
+      "tsconfig.cjs.json",
+      "tsconfig.esm.json",
+      "tsconfig.json"
+    ],
+    "uninstallDependencies": [],
+    "ignoredDependencies": [
+      "html-validate",
+      "@html-validate/eslint-*",
+      "@html-validate/prettier-*"
+    ]
+  }
 }

package/README.md

@@ -1,45 +0,0 @@
-# @html-validate/plugin-template
-
-## ⚠️ IMPORTANT NOTICE ⚠️
-
-**This package is created solely for the purpose of setting up OIDC (OpenID Connect) trusted publishing with npm.**
-
-This is **NOT** a functional package and contains **NO** code or functionality beyond the OIDC setup configuration.
-
-## Purpose
-
-This package exists to:
-1. Configure OIDC trusted publishing for the package name `@html-validate/plugin-template`
-2. Enable secure, token-less publishing from CI/CD workflows
-3. Establish provenance for packages published under this name
-
-## What is OIDC Trusted Publishing?
-
-OIDC trusted publishing allows package maintainers to publish packages directly from their CI/CD workflows without needing to manage npm access tokens. Instead, it uses OpenID Connect to establish trust between the CI/CD provider (like GitHub Actions) and npm.
-
-## Setup Instructions
-
-To properly configure OIDC trusted publishing for this package:
-
-1. Go to [npmjs.com](https://www.npmjs.com/) and navigate to your package settings
-2. Configure the trusted publisher (e.g., GitHub Actions)
-3. Specify the repository and workflow that should be allowed to publish
-4. Use the configured workflow to publish your actual package
-
-## DO NOT USE THIS PACKAGE
-
-This package is a placeholder for OIDC configuration only. It:
-- Contains no executable code
-- Provides no functionality
-- Should not be installed as a dependency
-- Exists only for administrative purposes
-
-## More Information
-
-For more details about npm's trusted publishing feature, see:
-- [npm Trusted Publishing Documentation](https://docs.npmjs.com/generating-provenance-statements)
-- [GitHub Actions OIDC Documentation](https://docs.github.com/en/actions/deployment/security-hardening-your-deployments/about-security-hardening-with-openid-connect)
-
----
-
-**Maintained for OIDC setup purposes only**