addon-ui 0.3.0 → 0.4.0

package/.commitlintrc.json

@@ -0,0 +1,5 @@
+{
+  "extends": [
+    "@commitlint/config-conventional"
+  ]
+}

package/.gitattributes

@@ -0,0 +1,6 @@
+# Enforce LF for all text files
+* text=auto eol=lf
+
+# Keep Windows command scripts with CRLF line endings
+*.bat text eol=crlf
+*.cmd text eol=crlf

package/.husky/commit-msg

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+
+# Husky commit-msg hook: validate commit message with commitlint
+
+npx --no -- commitlint --edit "$1"

package/.husky/pre-commit

@@ -0,0 +1,6 @@
+#!/usr/bin/env sh
+
+# Husky pre-commit hook: format and run related tests on staged files
+
+npm run test:related
+npm run format

package/.husky/pre-push

@@ -0,0 +1,8 @@
+#!/usr/bin/env sh
+
+# Husky pre-push hook: typecheck, run full tests, and build
+
+npm run typecheck || exit 1
+npm run lint || exit 1
+#npm run test:ci || exit 1
+#npm run build || exit 1

package/.mailmap

@@ -0,0 +1,2 @@
+Addon Stack <191148085+addon-stack@users.noreply.github.com> <addonbonedev@gmail.com>
+Addon Stack <addon-stack@users.noreply.github.com> <addonbonedev@gmail.com>

package/.release-it.cjs

@@ -0,0 +1,256 @@
+const {execSync} = require("node:child_process");
+const pkg = require("./package.json");
+
+function deriveGithubFromEmail(email) {
+    if (!email) {
+        return {};
+    }
+
+    const m = email.match(/^([^@]+)@users\.noreply\.github\.com$/i);
+
+    if (!m) {
+        return {};
+    }
+
+    const local = m[1];
+    const login = local.includes("+") ? local.split("+").pop() : local;
+
+    if (!login) {
+        return {};
+    }
+
+    return {login, url: `https://github.com/${login}`};
+}
+
+function getContributors() {
+    try {
+        let fromTag;
+
+        try {
+            const tag = execSync("git describe --tags --abbrev=0", {encoding: "utf8"}).trim();
+            fromTag = tag || null;
+        } catch {
+            fromTag = null;
+        }
+
+        const range = fromTag ? `${fromTag}..HEAD` : "";
+        const cmd = `git shortlog -sne ${range}`.trim();
+        const out = execSync(cmd, {encoding: "utf8"}).trim();
+
+        if (!out) {
+            return [];
+        }
+
+        const lines = out.split("\n").filter(Boolean);
+
+        const map = new Map();
+
+        for (const line of lines) {
+            const m = line.match(/^\s*(\d+)\s+(.*?)(?:\s+<([^>]+)>)?\s*$/);
+
+            const count = Number(m?.[1] || 0);
+
+            const displayName = (m?.[2] || "").trim() || undefined;
+            const displayEmail = (m?.[3] || "").trim() || undefined;
+
+            const lcName = (displayName || "").toLowerCase();
+            const lcEmail = (displayEmail || "").toLowerCase();
+
+            // Filter bots using lowercase keys only
+            if (lcName.includes("bot") || lcEmail.includes("bot")) {
+                continue;
+            }
+
+            const gh = deriveGithubFromEmail(displayEmail);
+            const loginKey = gh.login ? gh.login.toLowerCase() : null;
+
+            const key = loginKey ? `gh:${loginKey}` : lcEmail ? `em:${lcEmail}` : `nm:${lcName}`;
+
+            const existing = map.get(key);
+
+            if (existing) {
+                existing.count += count;
+                if (!existing.login && gh.login) {
+                    existing.login = gh.login;
+                    existing.url = gh.url;
+                }
+                if (!existing.name && displayName) {
+                    existing.name = displayName;
+                }
+                if (!existing.email && displayEmail) {
+                    existing.email = displayEmail;
+                }
+            } else {
+                map.set(key, {count, name: displayName, email: displayEmail, ...gh});
+            }
+        }
+
+        return Array.from(map.values());
+    } catch {
+        return [];
+    }
+}
+
+const types = new Map([
+    ["feat", "✨ Features"],
+    ["fix", "🐛 Bug Fixed"],
+    ["perf", "⚡️ Performance Improvements"],
+    ["refactor", "🛠️ Refactoring"],
+    ["docs", "📝 Documentation"],
+    ["test", "🧪 Tests"],
+    ["build", "🏗️ Build System"],
+    ["ci", "🤖 CI"],
+    ["chore", "🧹 Chores"],
+    ["revert", "⏪ Reverts"],
+]);
+
+const normalizeRepoUrl = url => url.replace(/^git\+/, "").replace(/\.git$/, "");
+const repoUrl = pkg?.repository?.url ? normalizeRepoUrl(pkg.repository.url) : null;
+
+module.exports = () => {
+    const contributors = getContributors();
+
+    return {
+        ci: true,
+
+        git: {
+            requireCleanWorkingDir: true,
+            requireUpstream: false,
+            requireBranch: false,
+            commit: true,
+            // biome-ignore lint/suspicious/noTemplateCurlyInString: release-it placeholder
+            commitMessage: "chore(release): v${version}",
+            tag: true,
+            // biome-ignore lint/suspicious/noTemplateCurlyInString: release-it placeholder
+            tagName: "v${version}",
+            // biome-ignore lint/suspicious/noTemplateCurlyInString: release-it placeholder
+            tagAnnotation: "v${version}",
+            push: true,
+        },
+
+        github: {
+            release: true,
+            // biome-ignore lint/suspicious/noTemplateCurlyInString: release-it placeholder
+            releaseName: "v${version}",
+            autoGenerate: false,
+            // Ensure GitHub receives exactly the generated changelog body
+            releaseNotes: ({changelog}) => changelog,
+        },
+
+        npm: {
+            publish: true,
+            versionArgs: ["--no-git-tag-version"],
+            publishArgs: ["--provenance", "--access", "public"],
+        },
+
+        plugins: {
+            "@release-it/conventional-changelog": {
+                infile: "CHANGELOG.md",
+                preset: "conventionalcommits",
+
+                parserOpts: {
+                    headerPattern: /^(\w+)(?:\(([^)]+)\))?(!)?:\s(.+?)(?:\s\(#\d+\))?$/,
+                    headerCorrespondence: ["type", "scope", "breaking", "subject"],
+                    noteKeywords: ["BREAKING CHANGE", "BREAKING-CHANGE"],
+                },
+
+                presetConfig: {
+                    types: [...types.entries()].map(([type, section]) => ({type, section, hidden: false})),
+                },
+
+                context: {
+                    name: pkg.name,
+                    pkg: {name: pkg.name},
+                    repoUrl,
+                    contributors,
+                },
+
+                recommendedBumpOpts: {
+                    preset: "conventionalcommits",
+                    whatBump: commits => {
+                        let isMajor = false;
+                        let isMinor = false;
+                        let isPatch = false;
+
+                        for (const commit of commits) {
+                            if (commit.notes?.some(n => /BREAKING CHANGE/i.test(n.title || n.text || ""))) {
+                                isMajor = true;
+                                break;
+                            }
+
+                            const type = (commit.type || "").toLowerCase();
+
+                            if (type === "feat") {
+                                isMinor = true;
+                            }
+
+                            if (["fix", "perf", "refactor", "ci"].includes(type)) {
+                                isPatch = true;
+                            }
+                        }
+
+                        if (isMajor) return {level: 0};
+                        if (isMinor) return {level: 1};
+                        if (isPatch) return {level: 2};
+
+                        return null;
+                    },
+                },
+                writerOpts: {
+                    headerPartial:
+                        "## 🚀 Release {{#if name}}`{{name}}` {{else}}{{#if @root.pkg}}`{{@root.pkg.name}}` {{/if}}{{/if}}v{{version}} ({{date}})\n\n",
+                    footerPartial: `{{#if @root.contributors.length}}\n### 🙌 Contributors\n\n{{#each @root.contributors}}- {{#if url}}{{#if name}}[{{name}}]({{url}}){{#if login}} (@{{login}}){{/if}}{{else}}[@{{login}}]({{url}}){{/if}}{{else}}{{#if email}}{{#if name}}[{{name}}](mailto:{{email}}){{else}}{{email}}{{/if}}{{else}}{{name}}{{/if}}{{/if}} — commits: {{count}}\n{{/each}}{{/if}}`,
+                    mainTemplate:
+                        "{{> header}}\n" +
+                        "{{#if noteGroups}}\n### 💥 Breaking Changes\n\n{{#each noteGroups}}{{#each notes}}* {{{text}}}\n\n{{/each}}{{/each}}{{/if}}" +
+                        "{{#each commitGroups}}\n### {{title}}\n\n{{#each commits}}{{> commit root=@root}}\n{{/each}}\n\n{{/each}}" +
+                        "{{#unless commitGroups}}\n{{#each commits}}{{> commit root=@root}}\n{{/each}}{{/unless}}\n\n" +
+                        "{{> footer}}",
+                    commitPartial:
+                        "{{#if type}}* {{#if scope}}**{{scope}}:** {{/if}}{{#if subject}}{{subject}}{{else}}{{header}}{{/if}}{{#if href}} ([{{shorthash}}]({{href}})){{/if}}\n\n{{#if body}}{{{body}}}\n{{/if}}{{/if}}",
+                    groupBy: "type",
+                    commitGroupsSort: "title",
+                    commitsSort: ["scope", "subject"],
+                    transform: commit => {
+                        const nextCommit = {...commit};
+
+                        // If header had a '!' (captured into `breaking` by parser), ensure we surface a BREAKING note
+                        if (nextCommit.breaking && (!nextCommit.notes || nextCommit.notes.length === 0)) {
+                            const text = nextCommit.subject || nextCommit.header;
+                            nextCommit.notes = [{title: "BREAKING CHANGE", text}];
+                        }
+
+                        // Normalize type: lowercase and drop trailing '!' so 'feat!' maps to 'feat'
+                        const type = (nextCommit.type || "").toLowerCase().replace(/!+$/, "");
+                        const section = types.get(type);
+
+                        if (section) {
+                            nextCommit.type = section;
+                        } else {
+                            nextCommit.type = "🧩 Other";
+                        }
+
+                        if (nextCommit.body) {
+                            const body = nextCommit.body.replace(/\r\n/g, "\n").trim();
+
+                            nextCommit.body = body
+                                .split("\n")
+                                .map(line => (line ? `  ${line}` : ""))
+                                .join("\n");
+                        }
+
+                        if (!nextCommit.href && nextCommit.hash && repoUrl) {
+                            nextCommit.href = `${repoUrl}/commit/${nextCommit.hash}`;
+                        }
+
+                        if (!nextCommit.shorthash && nextCommit.hash) {
+                            nextCommit.shorthash = nextCommit.hash.slice(0, 7);
+                        }
+
+                        return nextCommit;
+                    },
+                },
+            },
+        },
+    };
+};

package/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2025 Addon Stack; Anjey Tsibylskij
+
+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.