@carlesandres/component-identity 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Carles Andres
+
+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/README.md

@@ -0,0 +1,132 @@
+# @carlesandres/component-identity
+
+Audit exported React components for a canonical `data-component` root attribute.
+
+The convention is intentionally strict:
+
+```tsx
+export function UserMenu() {
+  return <div data-component="user-menu" />;
+}
+```
+
+`UserMenu` maps to `data-component="user-menu"`. The mapping is one-to-one and uses kebab-case derived from the component name.
+
+## Install
+
+```sh
+npm install --save-dev @carlesandres/component-identity
+```
+
+## Use
+
+Add a config file:
+
+```sh
+npx component-identity init
+```
+
+Run the audit:
+
+```sh
+npx component-identity audit
+```
+
+Use JSON output for CI, reports, or agent tooling:
+
+```sh
+npx component-identity report
+npx component-identity audit --json
+```
+
+The audit exits with code `1` when violations are found, so it can be used directly in CI.
+
+```json
+{
+  "scripts": {
+    "audit:components": "component-identity audit"
+  }
+}
+```
+
+## What v0.1 Checks
+
+The MVP checks exported React components that return a root host DOM element:
+
+```tsx
+export function UserMenu() {
+  return <div data-component="user-menu" />;
+}
+
+export const AccountCard = () => {
+  return <section data-component="account-card" />;
+};
+```
+
+It also supports simple `forwardRef` wrappers:
+
+```tsx
+export const Button = forwardRef<HTMLButtonElement>((props, ref) => {
+  return <button ref={ref} data-component="button" {...props} />;
+});
+```
+
+The MVP intentionally ignores components whose root is another custom component, a fragment, a portal, or an `asChild` pattern.
+
+## Config
+
+`component-identity.config.json`:
+
+```json
+{
+  "attribute": "data-component",
+  "include": [
+    "src/**/*.{ts,tsx,js,jsx}",
+    "app/**/*.{ts,tsx,js,jsx}",
+    "components/**/*.{ts,tsx,js,jsx}"
+  ],
+  "exclude": [
+    "**/components/ui/**",
+    "**/*.test.*",
+    "**/*.spec.*",
+    "**/*.stories.*",
+    "**/*.d.ts",
+    "**/node_modules/**",
+    "**/dist/**"
+  ]
+}
+```
+
+Use `--config` to point at another config file and `--cwd` to audit a different directory.
+
+## Library API
+
+```ts
+import { audit, componentNameToKebabCase } from "@carlesandres/component-identity";
+
+const result = audit({ cwd: process.cwd() });
+
+if (!result.ok) {
+  console.log(result.violations);
+}
+
+console.log(componentNameToKebabCase("UserMenu")); // "user-menu"
+```
+
+## Versioning And Publishing
+
+This package is designed for normal npm versioning:
+
+```sh
+npm run check
+npm test
+npm run pack:dry
+npm run version:patch
+npm run publish:public
+```
+
+`npm run prepack` builds `dist/` before packaging.
+
+## Contributions
+
+This project is in a very early stage. For now, issues are accepted as contributions, but pull requests are not.

package/dist/audit.d.ts

@@ -0,0 +1,3 @@
+import type { AuditOptions, AuditResult } from "./types.js";
+export declare function audit(options?: AuditOptions): AuditResult;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAsC,MAAM,YAAY,CAAC;AAOhG,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,WAAW,CAsC7D"}

package/dist/audit.js

@@ -0,0 +1,179 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import ts from "typescript";
+import { loadConfig } from "./config.js";
+import { findCandidateFiles } from "./glob.js";
+import { componentNameToKebabCase } from "./naming.js";
+export function audit(options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const config = loadConfig(cwd, options.configPath);
+    const files = findCandidateFiles(cwd, config.include, config.exclude);
+    const violations = [];
+    let componentsChecked = 0;
+    for (const file of files) {
+        const absolutePath = path.join(cwd, file);
+        const sourceText = readFileSync(absolutePath, "utf8");
+        const sourceFile = ts.createSourceFile(absolutePath, sourceText, ts.ScriptTarget.Latest, true, scriptKindForFile(file));
+        for (const candidate of findExportedComponents(sourceFile)) {
+            const root = findRootJsxElement(candidate.body);
+            if (!root || !isHostElement(root.tagName)) {
+                continue;
+            }
+            componentsChecked += 1;
+            const violation = auditRootElement(sourceFile, file, candidate.name, root, config);
+            if (violation) {
+                violations.push(violation);
+            }
+        }
+    }
+    return {
+        ok: violations.length === 0,
+        filesChecked: files.length,
+        componentsChecked,
+        violations,
+    };
+}
+function findExportedComponents(sourceFile) {
+    const candidates = [];
+    for (const statement of sourceFile.statements) {
+        if (ts.isFunctionDeclaration(statement) && statement.name && isExported(statement) && isComponentName(statement.name.text)) {
+            candidates.push({ name: statement.name.text, body: statement.body ?? statement });
+            continue;
+        }
+        if (ts.isVariableStatement(statement) && isExported(statement)) {
+            for (const declaration of statement.declarationList.declarations) {
+                if (!ts.isIdentifier(declaration.name) || !isComponentName(declaration.name.text) || !declaration.initializer) {
+                    continue;
+                }
+                const body = componentBodyFromInitializer(declaration.initializer);
+                if (body) {
+                    candidates.push({ name: declaration.name.text, body });
+                }
+            }
+        }
+        if (ts.isExportAssignment(statement)) {
+            const candidate = componentFromDefaultExport(statement.expression);
+            if (candidate) {
+                candidates.push(candidate);
+            }
+        }
+    }
+    return candidates;
+}
+function componentFromDefaultExport(expression) {
+    if (ts.isIdentifier(expression) && isComponentName(expression.text)) {
+        return undefined;
+    }
+    if (ts.isArrowFunction(expression) || ts.isFunctionExpression(expression)) {
+        return undefined;
+    }
+    return undefined;
+}
+function componentBodyFromInitializer(initializer) {
+    if (ts.isArrowFunction(initializer) || ts.isFunctionExpression(initializer)) {
+        return initializer.body;
+    }
+    if (ts.isCallExpression(initializer) && isForwardRefCall(initializer)) {
+        const render = initializer.arguments[0];
+        if (render && (ts.isArrowFunction(render) || ts.isFunctionExpression(render))) {
+            return render.body;
+        }
+    }
+    return undefined;
+}
+function isForwardRefCall(call) {
+    const expression = call.expression;
+    if (ts.isIdentifier(expression)) {
+        return expression.text === "forwardRef";
+    }
+    return ts.isPropertyAccessExpression(expression) && expression.name.text === "forwardRef";
+}
+function findRootJsxElement(body) {
+    if (ts.isJsxElement(body)) {
+        return body.openingElement;
+    }
+    if (ts.isJsxSelfClosingElement(body)) {
+        return body;
+    }
+    if (ts.isParenthesizedExpression(body)) {
+        return findRootJsxElement(body.expression);
+    }
+    if (ts.isBlock(body)) {
+        for (const statement of body.statements) {
+            if (ts.isReturnStatement(statement) && statement.expression) {
+                return findRootJsxElement(statement.expression);
+            }
+        }
+    }
+    return undefined;
+}
+function auditRootElement(sourceFile, file, componentName, root, config) {
+    const expectedValue = componentNameToKebabCase(componentName);
+    const attribute = findJsxAttribute(root, config.attribute);
+    const { line, character } = sourceFile.getLineAndCharacterOfPosition(root.getStart(sourceFile));
+    if (!attribute) {
+        return {
+            code: "missing-attribute",
+            file,
+            line: line + 1,
+            column: character + 1,
+            componentName,
+            expectedValue,
+            message: `${componentName} must set ${config.attribute}="${expectedValue}" on its root DOM element.`,
+        };
+    }
+    const actualValue = getStaticAttributeValue(attribute);
+    if (actualValue !== expectedValue) {
+        return {
+            code: "mismatched-attribute",
+            file,
+            line: line + 1,
+            column: character + 1,
+            componentName,
+            expectedValue,
+            actualValue,
+            message: `${componentName} must use ${config.attribute}="${expectedValue}" on its root DOM element.`,
+        };
+    }
+    return undefined;
+}
+function findJsxAttribute(root, attributeName) {
+    return root.attributes.properties.find((property) => ts.isJsxAttribute(property) && ts.isIdentifier(property.name) && property.name.text === attributeName);
+}
+function getStaticAttributeValue(attribute) {
+    if (!attribute.initializer) {
+        return undefined;
+    }
+    if (ts.isStringLiteral(attribute.initializer)) {
+        return attribute.initializer.text;
+    }
+    if (ts.isJsxExpression(attribute.initializer)) {
+        const expression = attribute.initializer.expression;
+        if (expression && ts.isStringLiteral(expression)) {
+            return expression.text;
+        }
+    }
+    return undefined;
+}
+function isHostElement(tagName) {
+    return ts.isIdentifier(tagName) && /^[a-z]/.test(tagName.text);
+}
+function isComponentName(name) {
+    return /^[A-Z]/.test(name);
+}
+function isExported(node) {
+    return ts.canHaveModifiers(node) && Boolean(ts.getModifiers(node)?.some((modifier) => modifier.kind === ts.SyntaxKind.ExportKeyword));
+}
+function scriptKindForFile(file) {
+    if (file.endsWith(".tsx")) {
+        return ts.ScriptKind.TSX;
+    }
+    if (file.endsWith(".jsx")) {
+        return ts.ScriptKind.JSX;
+    }
+    if (file.endsWith(".js")) {
+        return ts.ScriptKind.JS;
+    }
+    return ts.ScriptKind.TS;
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+import { writeFileSync } from "node:fs";
+import path from "node:path";
+import { defaultConfig } from "./config.js";
+import { audit } from "./audit.js";
+async function main() {
+    const args = parseArgs(process.argv.slice(2));
+    if (args.command === "help" || args.command === "--help" || args.command === "-h") {
+        printHelp();
+        return;
+    }
+    if (args.command === "init") {
+        const cwd = path.resolve(args.cwd ?? process.cwd());
+        const configPath = path.join(cwd, "component-identity.config.json");
+        writeFileSync(`${configPath}`, `${JSON.stringify(defaultConfig, null, 2)}\n`, { flag: "wx" });
+        console.log(`Created ${path.relative(process.cwd(), configPath)}`);
+        return;
+    }
+    if (args.command !== "audit" && args.command !== "report") {
+        console.error(`Unknown command: ${args.command}`);
+        printHelp();
+        process.exitCode = 2;
+        return;
+    }
+    const auditOptions = {};
+    if (args.cwd) {
+        auditOptions.cwd = args.cwd;
+    }
+    if (args.configPath) {
+        auditOptions.configPath = args.configPath;
+    }
+    const result = audit(auditOptions);
+    if (args.json || args.command === "report") {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else if (result.ok) {
+        console.log(`component-identity: checked ${result.componentsChecked} component(s) in ${result.filesChecked} file(s), no violations found.`);
+    }
+    else {
+        for (const violation of result.violations) {
+            console.error(`${violation.file}:${violation.line}:${violation.column} ${violation.message}`);
+        }
+        console.error(`component-identity: found ${result.violations.length} violation(s).`);
+    }
+    process.exitCode = args.command === "report" || result.ok ? 0 : 1;
+}
+function parseArgs(rawArgs) {
+    const [command = "audit", ...rest] = rawArgs;
+    const parsed = {
+        command,
+        json: false,
+    };
+    for (let index = 0; index < rest.length; index += 1) {
+        const arg = rest[index];
+        if (arg === "--json") {
+            parsed.json = true;
+            continue;
+        }
+        if (arg === "--config") {
+            const value = rest[index + 1];
+            if (value) {
+                parsed.configPath = value;
+            }
+            index += 1;
+            continue;
+        }
+        if (arg === "--cwd") {
+            const value = rest[index + 1];
+            if (value) {
+                parsed.cwd = value;
+            }
+            index += 1;
+            continue;
+        }
+    }
+    return parsed;
+}
+function printHelp() {
+    console.log(`component-identity
+
+Usage:
+  component-identity audit [--json] [--config path] [--cwd path]
+  component-identity report [--config path] [--cwd path]
+  component-identity init [--cwd path]
+
+Commands:
+  audit   Check exported React components and exit non-zero on violations.
+  report  Print the same audit result as JSON.
+  init    Create component-identity.config.json in the target directory.
+`);
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentIdentityConfig } from "./types.js";
+export declare const defaultConfig: ComponentIdentityConfig;
+export declare function loadConfig(cwd: string, configPath?: string): ComponentIdentityConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,eAAO,MAAM,aAAa,EAAE,uBAgB3B,CAAC;AAEF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,uBAAuB,CAgBpF"}

package/dist/config.js

@@ -0,0 +1,34 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+export const defaultConfig = {
+    attribute: "data-component",
+    include: [
+        "src/**/*.{ts,tsx,js,jsx}",
+        "app/**/*.{ts,tsx,js,jsx}",
+        "components/**/*.{ts,tsx,js,jsx}",
+    ],
+    exclude: [
+        "**/components/ui/**",
+        "**/*.test.*",
+        "**/*.spec.*",
+        "**/*.stories.*",
+        "**/*.d.ts",
+        "**/node_modules/**",
+        "**/dist/**",
+    ],
+};
+export function loadConfig(cwd, configPath) {
+    const resolvedPath = configPath
+        ? path.resolve(cwd, configPath)
+        : path.join(cwd, "component-identity.config.json");
+    if (!existsSync(resolvedPath)) {
+        return defaultConfig;
+    }
+    const parsed = JSON.parse(readFileSync(resolvedPath, "utf8"));
+    return {
+        attribute: parsed.attribute ?? defaultConfig.attribute,
+        include: parsed.include ?? defaultConfig.include,
+        exclude: parsed.exclude ?? defaultConfig.exclude,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,CAAC,MAAM,aAAa,GAA4B;IACpD,SAAS,EAAE,gBAAgB;IAC3B,OAAO,EAAE;QACP,0BAA0B;QAC1B,0BAA0B;QAC1B,iCAAiC;KAClC;IACD,OAAO,EAAE;QACP,qBAAqB;QACrB,aAAa;QACb,aAAa;QACb,gBAAgB;QAChB,WAAW;QACX,oBAAoB;QACpB,YAAY;KACb;CACF,CAAC;AAEF,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,UAAmB;IACzD,MAAM,YAAY,GAAG,UAAU;QAC7B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gCAAgC,CAAC,CAAC;IAErD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAqC,CAAC;IAElG,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS;QACtD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;QAChD,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,aAAa,CAAC,OAAO;KACjD,CAAC;AACJ,CAAC"}

package/dist/glob.d.ts

@@ -0,0 +1,2 @@
+export declare function findCandidateFiles(cwd: string, include: string[], exclude: string[]): string[];
+//# sourceMappingURL=glob.d.ts.map

package/dist/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAKA,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAc9F"}

package/dist/glob.js

@@ -0,0 +1,97 @@
+import { readdirSync, statSync } from "node:fs";
+import path from "node:path";
+const DEFAULT_IGNORED_DIRS = new Set([".git", "node_modules", "dist"]);
+export function findCandidateFiles(cwd, include, exclude) {
+    const roots = rootsFromIncludePatterns(include);
+    const files = new Set();
+    for (const root of roots) {
+        const absoluteRoot = path.join(cwd, root);
+        collectFiles(cwd, absoluteRoot, files);
+    }
+    return [...files]
+        .filter((file) => isSupportedSourceFile(file))
+        .filter((file) => matchesAnyInclude(file, include))
+        .filter((file) => !matchesAnyExclude(file, exclude))
+        .sort();
+}
+function collectFiles(cwd, absolutePath, files) {
+    let stat;
+    try {
+        stat = statSync(absolutePath);
+    }
+    catch {
+        return;
+    }
+    if (stat.isFile()) {
+        files.add(toPosix(path.relative(cwd, absolutePath)));
+        return;
+    }
+    if (!stat.isDirectory()) {
+        return;
+    }
+    const basename = path.basename(absolutePath);
+    if (DEFAULT_IGNORED_DIRS.has(basename)) {
+        return;
+    }
+    for (const entry of readdirSync(absolutePath)) {
+        collectFiles(cwd, path.join(absolutePath, entry), files);
+    }
+}
+function rootsFromIncludePatterns(include) {
+    const roots = include.map((pattern) => {
+        const wildcardIndex = pattern.search(/[*{]/);
+        const prefix = wildcardIndex === -1 ? pattern : pattern.slice(0, wildcardIndex);
+        const root = prefix.split("/").filter(Boolean)[0];
+        return root ?? ".";
+    });
+    return [...new Set(roots)];
+}
+function matchesAnyInclude(file, include) {
+    return include.some((pattern) => matchesPattern(file, pattern));
+}
+function matchesAnyExclude(file, exclude) {
+    return exclude.some((pattern) => matchesPattern(file, pattern));
+}
+function matchesPattern(file, pattern) {
+    const normalizedPattern = toPosix(pattern);
+    if (normalizedPattern.includes("{ts,tsx,js,jsx}")) {
+        const base = normalizedPattern.replace(".{ts,tsx,js,jsx}", "");
+        return matchesPattern(file, `${base}.ts`) || matchesPattern(file, `${base}.tsx`) || matchesPattern(file, `${base}.js`) || matchesPattern(file, `${base}.jsx`);
+    }
+    return globToRegExp(normalizedPattern).test(file);
+}
+function isSupportedSourceFile(file) {
+    return /\.(tsx?|jsx?)$/.test(file) && !file.endsWith(".d.ts");
+}
+function toPosix(value) {
+    return value.split(path.sep).join("/");
+}
+function globToRegExp(pattern) {
+    let source = "^";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        const next = pattern[index + 1];
+        const afterNext = pattern[index + 2];
+        if (character === "*" && next === "*" && afterNext === "/") {
+            source += "(?:.*/)?";
+            index += 2;
+            continue;
+        }
+        if (character === "*" && next === "*") {
+            source += ".*";
+            index += 1;
+            continue;
+        }
+        if (character === "*") {
+            source += "[^/]*";
+            continue;
+        }
+        source += escapeRegExp(character);
+    }
+    source += "$";
+    return new RegExp(source);
+}
+function escapeRegExp(value) {
+    return value.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
+}
+//# sourceMappingURL=glob.js.map

package/dist/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,OAAiB,EAAE,OAAiB;IAClF,MAAM,KAAK,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1C,YAAY,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC;SACd,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;SAC7C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;SACnD,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,YAAoB,EAAE,KAAkB;IACzE,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAClB,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAC7C,IAAI,oBAAoB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvC,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9C,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAiB;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACpC,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,aAAa,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;QAChF,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,IAAI,IAAI,GAAG,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,OAAiB;IACxD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY,EAAE,OAAiB;IACxD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,iBAAiB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,KAAK,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IAChK,CAAC;IAED,OAAO,YAAY,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,IAAI,MAAM,GAAG,GAAG,CAAC;IAEjB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAE,CAAC;QAClC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAChC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAErC,IAAI,SAAS,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YAC3D,MAAM,IAAI,UAAU,CAAC;YACrB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,SAAS,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YACtC,MAAM,IAAI,IAAI,CAAC;YACf,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,OAAO,CAAC;YAClB,SAAS;QACX,CAAC;QAED,MAAM,IAAI,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,IAAI,GAAG,CAAC;IACd,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { audit } from "./audit.js";
+export { defaultConfig, loadConfig } from "./config.js";
+export { componentNameToKebabCase } from "./naming.js";
+export type { AuditOptions, AuditResult, ComponentIdentityConfig, Violation, ViolationCode } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,uBAAuB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { audit } from "./audit.js";
+export { defaultConfig, loadConfig } from "./config.js";
+export { componentNameToKebabCase } from "./naming.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/naming.d.ts

@@ -0,0 +1,2 @@
+export declare function componentNameToKebabCase(componentName: string): string;
+//# sourceMappingURL=naming.d.ts.map

package/dist/naming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/dist/naming.js

@@ -0,0 +1,8 @@
+export function componentNameToKebabCase(componentName) {
+    return componentName
+        .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2")
+        .replace(/[_\s]+/g, "-")
+        .toLowerCase();
+}
+//# sourceMappingURL=naming.js.map

package/dist/naming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"naming.js","sourceRoot":"","sources":["../src/naming.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,aAAqB;IAC5D,OAAO,aAAa;SACjB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,28 @@
+export type ComponentIdentityConfig = {
+    attribute: string;
+    include: string[];
+    exclude: string[];
+};
+export type AuditOptions = {
+    cwd?: string | undefined;
+    configPath?: string | undefined;
+    json?: boolean;
+};
+export type ViolationCode = "missing-attribute" | "mismatched-attribute";
+export type Violation = {
+    code: ViolationCode;
+    file: string;
+    line: number;
+    column: number;
+    componentName: string;
+    expectedValue: string;
+    actualValue?: string | undefined;
+    message: string;
+};
+export type AuditResult = {
+    ok: boolean;
+    filesChecked: number;
+    componentsChecked: number;
+    violations: Violation[];
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,mBAAmB,GAAG,sBAAsB,CAAC;AAEzE,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,OAAO,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@carlesandres/component-identity",
+  "version": "0.1.0",
+  "description": "Audit exported React components for canonical data-component root attributes.",
+  "type": "module",
+  "bin": {
+    "component-identity": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "check": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test test/*.test.mjs",
+    "prepack": "npm run build",
+    "pack:dry": "npm pack --dry-run",
+    "version:patch": "npm version patch",
+    "version:minor": "npm version minor",
+    "version:major": "npm version major",
+    "publish:public": "npm publish --access public"
+  },
+  "keywords": [
+    "react",
+    "components",
+    "lint",
+    "audit",
+    "data-component"
+  ],
+  "author": "Carles Andres",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/carlesandres/component-identity.git"
+  },
+  "bugs": {
+    "url": "https://github.com/carlesandres/component-identity/issues"
+  },
+  "homepage": "https://github.com/carlesandres/component-identity#readme",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "typescript": "^5.8.3"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.3"
+  }
+}