@design.estate/wcctools 5.1.0 → 6.1.0

package/dist_ts/standards/rules/demo.shape.js

@@ -0,0 +1,38 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { catalogElements, elementKey } from './shared.js';
+const ts = plugins.typescript;
+/** A demo factory: a function, or a reference to one (identifier or property access). */
+const isFactory = (expressionArg) => ts.isArrowFunction(expressionArg)
+    || ts.isFunctionExpression(expressionArg)
+    || ts.isIdentifier(expressionArg)
+    || ts.isPropertyAccessExpression(expressionArg);
+/** `static demo` is a function or a non-empty array of functions. */
+export const demoShapeRule = {
+    id: 'demo/shape',
+    severity: { base: 'error' },
+    fixMode: 'none',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const element of catalogElements(project)) {
+            const member = ast.findStaticProperty(element.classNode, 'demo');
+            if (!member) {
+                continue;
+            }
+            const initializer = member.initializer;
+            const valid = !!initializer && (ts.isArrayLiteralExpression(initializer)
+                ? initializer.elements.length > 0 && initializer.elements.every(isFactory)
+                : isFactory(initializer));
+            if (!valid) {
+                findings.push({
+                    file: element.file,
+                    position: member.getStart(),
+                    key: elementKey(element),
+                    message: `static demo of ${element.className ?? '?'} is not a function or a non-empty array of functions`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVtby5zaGFwZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9kZW1vLnNoYXBlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLEdBQUcsTUFBTSxtQkFBbUIsQ0FBQztBQUV6QyxPQUFPLEVBQUUsZUFBZSxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUxRCxNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDO0FBRTlCLHlGQUF5RjtBQUN6RixNQUFNLFNBQVMsR0FBRyxDQUFDLGFBQThCLEVBQVcsRUFBRSxDQUM1RCxFQUFFLENBQUMsZUFBZSxDQUFDLGFBQWEsQ0FBQztPQUM5QixFQUFFLENBQUMsb0JBQW9CLENBQUMsYUFBYSxDQUFDO09BQ3RDLEVBQUUsQ0FBQyxZQUFZLENBQUMsYUFBYSxDQUFDO09BQzlCLEVBQUUsQ0FBQywwQkFBMEIsQ0FBQyxhQUFhLENBQUMsQ0FBQztBQUVsRCxxRUFBcUU7QUFDckUsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFrQjtJQUMxQyxFQUFFLEVBQUUsWUFBWTtJQUNoQixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFO0lBQzNCLE9BQU8sRUFBRSxNQUFNO0lBQ2YsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsS0FBSyxNQUFNLE9BQU8sSUFBSSxlQUFlLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUMvQyxNQUFNLE1BQU0sR0FBRyxHQUFHLENBQUMsa0JBQWtCLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxNQUFNLENBQUMsQ0FBQztZQUNqRSxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUM7Z0JBQ1osU0FBUztZQUNYLENBQUM7WUFDRCxNQUFNLFdBQVcsR0FBRyxNQUFNLENBQUMsV0FBVyxDQUFDO1lBQ3ZDLE1BQU0sS0FBSyxHQUFHLENBQUMsQ0FBQyxXQUFXLElBQUksQ0FBQyxFQUFFLENBQUMsd0JBQXdCLENBQUMsV0FBVyxDQUFDO2dCQUN0RSxDQUFDLENBQUMsV0FBVyxDQUFDLFFBQVEsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxJQUFJLFdBQVcsQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLFNBQVMsQ0FBQztnQkFDMUUsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDO1lBQzVCLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztnQkFDWCxRQUFRLENBQUMsSUFBSSxDQUFDO29CQUNaLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtvQkFDbEIsUUFBUSxFQUFFLE1BQU0sQ0FBQyxRQUFRLEVBQUU7b0JBQzNCLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUN4QixPQUFPLEVBQUUsa0JBQWtCLE9BQU8sQ0FBQyxTQUFTLElBQUksR0FBRyxzREFBc0Q7aUJBQzFHLENBQUMsQ0FBQztZQUNMLENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztDQUNGLENBQUMifQ==

package/dist_ts/standards/rules/docs.component-index.d.ts

@@ -0,0 +1,8 @@
+import type { StandardProject } from '../classes.standardproject.js';
+import type { IStandardRule } from '../rule.js';
+export declare const componentIndexStart = "<!-- component-index:start -->";
+export declare const componentIndexEnd = "<!-- component-index:end -->";
+/** The generated component index block: one row per element under `ts_web/elements`, sorted by tag. */
+export declare const renderComponentIndex: (projectArg: StandardProject, readmeTextArg: string) => string;
+/** dees: the readme's generated component index is current and its relative links resolve. */
+export declare const docsComponentIndexRule: IStandardRule;

package/dist_ts/standards/rules/docs.component-index.js

@@ -0,0 +1,84 @@
+import { joinPath } from '../helpers.paths.js';
+import { catalogElements } from './shared.js';
+export const componentIndexStart = '<!-- component-index:start -->';
+export const componentIndexEnd = '<!-- component-index:end -->';
+const readme = 'readme.md';
+/** GitHub-style heading anchor. */
+const slug = (headingArg) => headingArg.toLowerCase().replace(/[^\p{L}\p{N}\s_-]/gu, '').replace(/ /g, '-');
+const headingsOf = (textArg) => new Set([...textArg.matchAll(/^#{1,6}\s+(.+)$/gm)].map((matchArg) => slug(matchArg[1])));
+/** The generated component index block: one row per element under `ts_web/elements`, sorted by tag. */
+export const renderComponentIndex = (projectArg, readmeTextArg) => {
+    const headings = headingsOf(readmeTextArg);
+    const rows = catalogElements(projectArg)
+        .filter((elementArg) => elementArg.tag && elementArg.className && elementArg.file.startsWith('ts_web/elements/'))
+        .map((elementArg) => {
+        const family = elementArg.file.split('/')[2].replace(/^00group-/, '').replace(/-/g, ' ');
+        const name = elementArg.className;
+        const api = headings.has(name.toLowerCase()) ? `[${name}](#${name.toLowerCase()})` : '—';
+        return { tag: elementArg.tag, row: `| \`${elementArg.tag}\` | ${family} | ${api} | [Source](${elementArg.file}) |` };
+    })
+        .sort((a, b) => a.tag.localeCompare(b.tag, 'en'));
+    return `${componentIndexStart}\n| Element | Family | API | Source |\n| --- | --- | --- | --- |\n${rows.map((rowArg) => rowArg.row).join('\n')}\n${componentIndexEnd}`;
+};
+/** dees: the readme's generated component index is current and its relative links resolve. */
+export const docsComponentIndexRule = {
+    id: 'docs/component-index',
+    severity: { dees: 'error' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        const text = project.files.get(readme);
+        if (text === undefined) {
+            return [{ file: readme, position: 0, key: readme, message: 'readme.md is missing' }];
+        }
+        const first = text.indexOf(componentIndexStart);
+        const last = text.indexOf(componentIndexEnd);
+        if (first < 0 || last < first) {
+            findings.push({ file: readme, position: 0, key: readme, message: `readme.md has no ${componentIndexStart} … ${componentIndexEnd} block` });
+        }
+        else {
+            const generated = renderComponentIndex(project, text);
+            const end = last + componentIndexEnd.length;
+            if (text.slice(first, end) !== generated) {
+                findings.push({
+                    file: readme,
+                    position: first,
+                    key: readme,
+                    message: 'the component index is stale',
+                    fix: (builderArg) => builderArg.edit(readme, first, end, generated),
+                });
+            }
+        }
+        const headings = headingsOf(text);
+        const withoutCode = text.replace(/^```[^\n]*\n[\s\S]*?^```/gm, (blockArg) => blockArg.replace(/[^\n]/g, ' '));
+        for (const match of withoutCode.matchAll(/\[[^\]]*\]\(([^\s)]+)\)/g)) {
+            const target = match[1];
+            if (/^[a-z]+:/i.test(target)) {
+                continue;
+            }
+            if (target.startsWith('#')) {
+                if (!headings.has(target.slice(1))) {
+                    findings.push({ file: readme, position: match.index, key: readme, message: `link to a missing section: ${target}` });
+                }
+                continue;
+            }
+            const file = target.split('#')[0];
+            if (!file) {
+                continue;
+            }
+            let decoded;
+            try {
+                decoded = decodeURIComponent(file);
+            }
+            catch {
+                findings.push({ file: readme, position: match.index, key: readme, message: `malformed link: ${target}` });
+                continue;
+            }
+            if (!project.exists(joinPath(decoded))) {
+                findings.push({ file: readme, position: match.index, key: readme, message: `link to a missing file: ${target}` });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG9jcy5jb21wb25lbnQtaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvZG9jcy5jb21wb25lbnQtaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRS9DLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFOUMsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQUcsZ0NBQWdDLENBQUM7QUFDcEUsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQUcsOEJBQThCLENBQUM7QUFDaEUsTUFBTSxNQUFNLEdBQUcsV0FBVyxDQUFDO0FBRTNCLG1DQUFtQztBQUNuQyxNQUFNLElBQUksR0FBRyxDQUFDLFVBQWtCLEVBQVUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxXQUFXLEVBQUUsQ0FBQyxPQUFPLENBQUMscUJBQXFCLEVBQUUsRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsQ0FBQztBQUU1SCxNQUFNLFVBQVUsR0FBRyxDQUFDLE9BQWUsRUFBZSxFQUFFLENBQUMsSUFBSSxHQUFHLENBQUMsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxRQUFRLENBQUMsbUJBQW1CLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztBQUU5SSx1R0FBdUc7QUFDdkcsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxVQUEyQixFQUFFLGFBQXFCLEVBQVUsRUFBRTtJQUNqRyxNQUFNLFFBQVEsR0FBRyxVQUFVLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDM0MsTUFBTSxJQUFJLEdBQUcsZUFBZSxDQUFDLFVBQVUsQ0FBQztTQUNyQyxNQUFNLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxHQUFHLElBQUksVUFBVSxDQUFDLFNBQVMsSUFBSSxVQUFVLENBQUMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxrQkFBa0IsQ0FBQyxDQUFDO1NBQ2hILEdBQUcsQ0FBQyxDQUFDLFVBQVUsRUFBRSxFQUFFO1FBQ2xCLE1BQU0sTUFBTSxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxXQUFXLEVBQUUsRUFBRSxDQUFDLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxHQUFHLENBQUMsQ0FBQztRQUN6RixNQUFNLElBQUksR0FBRyxVQUFVLENBQUMsU0FBVSxDQUFDO1FBQ25DLE1BQU0sR0FBRyxHQUFHLFFBQVEsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksSUFBSSxNQUFNLElBQUksQ0FBQyxXQUFXLEVBQUUsR0FBRyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUM7UUFDekYsT0FBTyxFQUFFLEdBQUcsRUFBRSxVQUFVLENBQUMsR0FBSSxFQUFFLEdBQUcsRUFBRSxPQUFPLFVBQVUsQ0FBQyxHQUFHLFFBQVEsTUFBTSxNQUFNLEdBQUcsZUFBZSxVQUFVLENBQUMsSUFBSSxLQUFLLEVBQUUsQ0FBQztJQUN4SCxDQUFDLENBQUM7U0FDRCxJQUFJLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxDQUFDLENBQUMsR0FBRyxFQUFFLElBQUksQ0FBQyxDQUFDLENBQUM7SUFDcEQsT0FBTyxHQUFHLG1CQUFtQixxRUFBcUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxpQkFBaUIsRUFBRSxDQUFDO0FBQ3hLLENBQUMsQ0FBQztBQUVGLDhGQUE4RjtBQUM5RixNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBa0I7SUFDbkQsRUFBRSxFQUFFLHNCQUFzQjtJQUMxQixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFO0lBQzNCLE9BQU8sRUFBRSxNQUFNO0lBQ2YsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsTUFBTSxJQUFJLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDdkMsSUFBSSxJQUFJLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDdkIsT0FBTyxDQUFDLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxRQUFRLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLHNCQUFzQixFQUFFLENBQUMsQ0FBQztRQUN2RixDQUFDO1FBQ0QsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDO1FBQ2hELE1BQU0sSUFBSSxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsaUJBQWlCLENBQUMsQ0FBQztRQUM3QyxJQUFJLEtBQUssR0FBRyxDQUFDLElBQUksSUFBSSxHQUFHLEtBQUssRUFBRSxDQUFDO1lBQzlCLFFBQVEsQ0FBQyxJQUFJLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxDQUFDLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsb0JBQW9CLG1CQUFtQixNQUFNLGlCQUFpQixRQUFRLEVBQUUsQ0FBQyxDQUFDO1FBQzdJLENBQUM7YUFBTSxDQUFDO1lBQ04sTUFBTSxTQUFTLEdBQUcsb0JBQW9CLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxDQUFDO1lBQ3RELE1BQU0sR0FBRyxHQUFHLElBQUksR0FBRyxpQkFBaUIsQ0FBQyxNQUFNLENBQUM7WUFDNUMsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLEtBQUssRUFBRSxHQUFHLENBQUMsS0FBSyxTQUFTLEVBQUUsQ0FBQztnQkFDekMsUUFBUSxDQUFDLElBQUksQ0FBQztvQkFDWixJQUFJLEVBQUUsTUFBTTtvQkFDWixRQUFRLEVBQUUsS0FBSztvQkFDZixHQUFHLEVBQUUsTUFBTTtvQkFDWCxPQUFPLEVBQUUsOEJBQThCO29CQUN2QyxHQUFHLEVBQUUsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsTUFBTSxFQUFFLEtBQUssRUFBRSxHQUFHLEVBQUUsU0FBUyxDQUFDO2lCQUNwRSxDQUFDLENBQUM7WUFDTCxDQUFDO1FBQ0gsQ0FBQztRQUNELE1BQU0sUUFBUSxHQUFHLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUNsQyxNQUFNLFdBQVcsR0FBRyxJQUFJLENBQUMsT0FBTyxDQUFDLDRCQUE0QixFQUFFLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FBQyxRQUFRLENBQUMsT0FBTyxDQUFDLFFBQVEsRUFBRSxHQUFHLENBQUMsQ0FBQyxDQUFDO1FBQzlHLEtBQUssTUFBTSxLQUFLLElBQUksV0FBVyxDQUFDLFFBQVEsQ0FBQywwQkFBMEIsQ0FBQyxFQUFFLENBQUM7WUFDckUsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ3hCLElBQUksV0FBVyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsRUFBRSxDQUFDO2dCQUM3QixTQUFTO1lBQ1gsQ0FBQztZQUNELElBQUksTUFBTSxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO2dCQUMzQixJQUFJLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztvQkFDbkMsUUFBUSxDQUFDLElBQUksQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLEtBQUssQ0FBQyxLQUFLLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsOEJBQThCLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQztnQkFDdkgsQ0FBQztnQkFDRCxTQUFTO1lBQ1gsQ0FBQztZQUNELE1BQU0sSUFBSSxHQUFHLE1BQU0sQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFDbEMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO2dCQUNWLFNBQVM7WUFDWCxDQUFDO1lBQ0QsSUFBSSxPQUFlLENBQUM7WUFDcEIsSUFBSSxDQUFDO2dCQUNILE9BQU8sR0FBRyxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUNyQyxDQUFDO1lBQUMsTUFBTSxDQUFDO2dCQUNQLFFBQVEsQ0FBQyxJQUFJLENBQUMsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxLQUFLLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRSxNQUFNLEVBQUUsT0FBTyxFQUFFLG1CQUFtQixNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUM7Z0JBQzFHLFNBQVM7WUFDWCxDQUFDO1lBQ0QsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDdkMsUUFBUSxDQUFDLElBQUksQ0FBQyxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLEtBQUssQ0FBQyxLQUFLLEVBQUUsR0FBRyxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsMkJBQTJCLE1BQU0sRUFBRSxFQUFFLENBQUMsQ0FBQztZQUNwSCxDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/element.exported.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** The element class is exported. */
+export declare const elementExportedRule: IStandardRule;

package/dist_ts/standards/rules/element.exported.js

@@ -0,0 +1,33 @@
+import * as plugins from '../../plugins.js';
+import { catalogElements, elementKey } from './shared.js';
+const ts = plugins.typescript;
+/** The element class is exported. */
+export const elementExportedRule = {
+    id: 'element/exported',
+    severity: { base: 'error' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const element of catalogElements(project)) {
+            if (element.exported) {
+                continue;
+            }
+            const finding = {
+                file: element.file,
+                position: element.decoratorCall.getStart(),
+                key: elementKey(element),
+                message: `class ${element.className ?? '?'} (<${element.tag ?? '?'}>) is not exported`,
+            };
+            // `export` goes before the first keyword modifier (e.g. `abstract`) or the `class` keyword, after the decorators.
+            const firstModifier = (ts.getModifiers(element.classNode) ?? [])[0];
+            const classKeyword = element.classNode.getChildren().find((childArg) => childArg.kind === ts.SyntaxKind.ClassKeyword);
+            const position = firstModifier?.getStart() ?? classKeyword?.getStart();
+            if (position !== undefined && element.classNode.parent === element.sourceFile) {
+                finding.fix = (builderArg) => builderArg.edit(element.file, position, position, 'export ');
+            }
+            findings.push(finding);
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWxlbWVudC5leHBvcnRlZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9lbGVtZW50LmV4cG9ydGVkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFFNUMsT0FBTyxFQUFFLGVBQWUsRUFBRSxVQUFVLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFMUQsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5QixxQ0FBcUM7QUFDckMsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQWtCO0lBQ2hELEVBQUUsRUFBRSxrQkFBa0I7SUFDdEIsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRTtJQUMzQixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLFFBQVEsR0FBbUIsRUFBRSxDQUFDO1FBQ3BDLEtBQUssTUFBTSxPQUFPLElBQUksZUFBZSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDL0MsSUFBSSxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUM7Z0JBQ3JCLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxPQUFPLEdBQWlCO2dCQUM1QixJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7Z0JBQ2xCLFFBQVEsRUFBRSxPQUFPLENBQUMsYUFBYSxDQUFDLFFBQVEsRUFBRTtnQkFDMUMsR0FBRyxFQUFFLFVBQVUsQ0FBQyxPQUFPLENBQUM7Z0JBQ3hCLE9BQU8sRUFBRSxTQUFTLE9BQU8sQ0FBQyxTQUFTLElBQUksR0FBRyxNQUFNLE9BQU8sQ0FBQyxHQUFHLElBQUksR0FBRyxvQkFBb0I7YUFDdkYsQ0FBQztZQUNGLGtIQUFrSDtZQUNsSCxNQUFNLGFBQWEsR0FBRyxDQUFDLEVBQUUsQ0FBQyxZQUFZLENBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO1lBQ3BFLE1BQU0sWUFBWSxHQUFHLE9BQU8sQ0FBQyxTQUFTLENBQUMsV0FBVyxFQUFFLENBQUMsSUFBSSxDQUFDLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FBQyxRQUFRLENBQUMsSUFBSSxLQUFLLEVBQUUsQ0FBQyxVQUFVLENBQUMsWUFBWSxDQUFDLENBQUM7WUFDdEgsTUFBTSxRQUFRLEdBQUcsYUFBYSxFQUFFLFFBQVEsRUFBRSxJQUFJLFlBQVksRUFBRSxRQUFRLEVBQUUsQ0FBQztZQUN2RSxJQUFJLFFBQVEsS0FBSyxTQUFTLElBQUksT0FBTyxDQUFDLFNBQVMsQ0FBQyxNQUFNLEtBQUssT0FBTyxDQUFDLFVBQVUsRUFBRSxDQUFDO2dCQUM5RSxPQUFPLENBQUMsR0FBRyxHQUFHLENBQUMsVUFBVSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsUUFBUSxFQUFFLFFBQVEsRUFBRSxTQUFTLENBQUMsQ0FBQztZQUM3RixDQUFDO1lBQ0QsUUFBUSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUN6QixDQUFDO1FBQ0QsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztDQUNGLENBQUMifQ==

package/dist_ts/standards/rules/element.literal-tag.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** `@customElement` takes a single string literal that is a valid custom element name. */
+export declare const elementLiteralTagRule: IStandardRule;

package/dist_ts/standards/rules/element.literal-tag.js

@@ -0,0 +1,30 @@
+import { elementKey, isCustomElementName } from './shared.js';
+/** `@customElement` takes a single string literal that is a valid custom element name. */
+export const elementLiteralTagRule = {
+    id: 'element/literal-tag',
+    severity: { base: 'error' },
+    fixMode: 'none',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const element of project.elements) {
+            if (element.tag === null) {
+                findings.push({
+                    file: element.file,
+                    position: element.decoratorCall.getStart(),
+                    key: elementKey(element),
+                    message: `@customElement of ${element.className ?? 'an anonymous class'} does not take a single string literal`,
+                });
+            }
+            else if (!isCustomElementName(element.tag)) {
+                findings.push({
+                    file: element.file,
+                    position: element.decoratorCall.getStart(),
+                    key: elementKey(element),
+                    message: `'${element.tag}' is not a valid custom element name (a lowercase letter, then lowercase letters, digits, '-', '.' or '_', with at least one '-')`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWxlbWVudC5saXRlcmFsLXRhZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9lbGVtZW50LmxpdGVyYWwtdGFnLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxVQUFVLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFOUQsMEZBQTBGO0FBQzFGLE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFrQjtJQUNsRCxFQUFFLEVBQUUscUJBQXFCO0lBQ3pCLFFBQVEsRUFBRSxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUU7SUFDM0IsT0FBTyxFQUFFLE1BQU07SUFDZixNQUFNLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUU7UUFDdEIsTUFBTSxRQUFRLEdBQW1CLEVBQUUsQ0FBQztRQUNwQyxLQUFLLE1BQU0sT0FBTyxJQUFJLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUN2QyxJQUFJLE9BQU8sQ0FBQyxHQUFHLEtBQUssSUFBSSxFQUFFLENBQUM7Z0JBQ3pCLFFBQVEsQ0FBQyxJQUFJLENBQUM7b0JBQ1osSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO29CQUNsQixRQUFRLEVBQUUsT0FBTyxDQUFDLGFBQWEsQ0FBQyxRQUFRLEVBQUU7b0JBQzFDLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUN4QixPQUFPLEVBQUUscUJBQXFCLE9BQU8sQ0FBQyxTQUFTLElBQUksb0JBQW9CLHdDQUF3QztpQkFDaEgsQ0FBQyxDQUFDO1lBQ0wsQ0FBQztpQkFBTSxJQUFJLENBQUMsbUJBQW1CLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQzdDLFFBQVEsQ0FBQyxJQUFJLENBQUM7b0JBQ1osSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO29CQUNsQixRQUFRLEVBQUUsT0FBTyxDQUFDLGFBQWEsQ0FBQyxRQUFRLEVBQUU7b0JBQzFDLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUN4QixPQUFPLEVBQUUsSUFBSSxPQUFPLENBQUMsR0FBRyxtSUFBbUk7aUJBQzVKLENBQUMsQ0FBQztZQUNMLENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztDQUNGLENBQUMifQ==

package/dist_ts/standards/rules/element.reachable.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** Every entry file outside demo files is reachable from `ts_web/index.ts`. */
+export declare const elementReachableRule: IStandardRule;

package/dist_ts/standards/rules/element.reachable.js

@@ -0,0 +1,48 @@
+import { rootBarrel } from '../classes.standardproject.js';
+import { dirOf } from '../helpers.paths.js';
+import { addReexport, catalogElements, elementKey } from './shared.js';
+/** Every entry file outside demo files is reachable from `ts_web/index.ts`. */
+export const elementReachableRule = {
+    id: 'element/reachable',
+    severity: { base: 'error' },
+    fixMode: 'auto',
+    allowlistCategories: ['internal'],
+    detect: ({ project }) => {
+        const findings = [];
+        const reached = project.reachableFrom(rootBarrel);
+        for (const element of catalogElements(project)) {
+            if (reached.has(element.file)) {
+                continue;
+            }
+            const finding = {
+                file: element.file,
+                position: element.decoratorCall.getStart(),
+                key: elementKey(element),
+                message: `<${element.tag ?? '?'}> in ${element.file} is not reachable from ${rootBarrel}`,
+            };
+            // Walk up to the nearest reachable barrel; an unreachable barrel that already re-exports the file is exported instead.
+            let candidate = element.file;
+            let dir = dirOf(element.file);
+            while (dir.startsWith('ts_web')) {
+                const barrel = `${dir}/index.ts`;
+                if (barrel !== candidate && project.files.has(barrel)) {
+                    if (reached.has(barrel)) {
+                        const target = candidate;
+                        finding.fix = (builderArg) => addReexport(builderArg, project, barrel, target);
+                        break;
+                    }
+                    if (project.reexports(barrel).some((reexportArg) => reexportArg.target === candidate)) {
+                        candidate = barrel;
+                    }
+                }
+                if (dir === 'ts_web') {
+                    break;
+                }
+                dir = dirOf(dir);
+            }
+            findings.push(finding);
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWxlbWVudC5yZWFjaGFibGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvZWxlbWVudC5yZWFjaGFibGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLCtCQUErQixDQUFDO0FBQzNELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUU1QyxPQUFPLEVBQUUsV0FBVyxFQUFFLGVBQWUsRUFBRSxVQUFVLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFdkUsK0VBQStFO0FBQy9FLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFrQjtJQUNqRCxFQUFFLEVBQUUsbUJBQW1CO0lBQ3ZCLFFBQVEsRUFBRSxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUU7SUFDM0IsT0FBTyxFQUFFLE1BQU07SUFDZixtQkFBbUIsRUFBRSxDQUFDLFVBQVUsQ0FBQztJQUNqQyxNQUFNLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUU7UUFDdEIsTUFBTSxRQUFRLEdBQW1CLEVBQUUsQ0FBQztRQUNwQyxNQUFNLE9BQU8sR0FBRyxPQUFPLENBQUMsYUFBYSxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBQ2xELEtBQUssTUFBTSxPQUFPLElBQUksZUFBZSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDL0MsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO2dCQUM5QixTQUFTO1lBQ1gsQ0FBQztZQUNELE1BQU0sT0FBTyxHQUFpQjtnQkFDNUIsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO2dCQUNsQixRQUFRLEVBQUUsT0FBTyxDQUFDLGFBQWEsQ0FBQyxRQUFRLEVBQUU7Z0JBQzFDLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO2dCQUN4QixPQUFPLEVBQUUsSUFBSSxPQUFPLENBQUMsR0FBRyxJQUFJLEdBQUcsUUFBUSxPQUFPLENBQUMsSUFBSSwwQkFBMEIsVUFBVSxFQUFFO2FBQzFGLENBQUM7WUFDRix1SEFBdUg7WUFDdkgsSUFBSSxTQUFTLEdBQUcsT0FBTyxDQUFDLElBQUksQ0FBQztZQUM3QixJQUFJLEdBQUcsR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQzlCLE9BQU8sR0FBRyxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO2dCQUNoQyxNQUFNLE1BQU0sR0FBRyxHQUFHLEdBQUcsV0FBVyxDQUFDO2dCQUNqQyxJQUFJLE1BQU0sS0FBSyxTQUFTLElBQUksT0FBTyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztvQkFDdEQsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxFQUFFLENBQUM7d0JBQ3hCLE1BQU0sTUFBTSxHQUFHLFNBQVMsQ0FBQzt3QkFDekIsT0FBTyxDQUFDLEdBQUcsR0FBRyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsV0FBVyxDQUFDLFVBQVUsRUFBRSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sQ0FBQyxDQUFDO3dCQUMvRSxNQUFNO29CQUNSLENBQUM7b0JBQ0QsSUFBSSxPQUFPLENBQUMsU0FBUyxDQUFDLE1BQU0sQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLFdBQVcsRUFBRSxFQUFFLENBQUMsV0FBVyxDQUFDLE1BQU0sS0FBSyxTQUFTLENBQUMsRUFBRSxDQUFDO3dCQUN0RixTQUFTLEdBQUcsTUFBTSxDQUFDO29CQUNyQixDQUFDO2dCQUNILENBQUM7Z0JBQ0QsSUFBSSxHQUFHLEtBQUssUUFBUSxFQUFFLENBQUM7b0JBQ3JCLE1BQU07Z0JBQ1IsQ0FBQztnQkFDRCxHQUFHLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ25CLENBQUM7WUFDRCxRQUFRLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3pCLENBQUM7UUFDRCxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDO0NBQ0YsQ0FBQyJ9

package/dist_ts/standards/rules/element.tag-map.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** The entry file declares `declare global { interface HTMLElementTagNameMap { '<tag>': <Class> } }`. */
+export declare const elementTagMapRule: IStandardRule;

package/dist_ts/standards/rules/element.tag-map.js

@@ -0,0 +1,83 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { catalogElements, elementKey, isCustomElementName } from './shared.js';
+const ts = plugins.typescript;
+/** The tags of a file's `declare global { interface HTMLElementTagNameMap { … } }` and the first such interface. */
+const tagMapOf = (sourceFileArg) => {
+    const tags = new Set();
+    let declaration = null;
+    for (const statement of sourceFileArg.statements) {
+        if (!ts.isModuleDeclaration(statement) || !ts.isIdentifier(statement.name) || statement.name.text !== 'global'
+            || !statement.body || !ts.isModuleBlock(statement.body)) {
+            continue;
+        }
+        for (const inner of statement.body.statements) {
+            if (ts.isInterfaceDeclaration(inner) && inner.name.text === 'HTMLElementTagNameMap') {
+                declaration ??= inner;
+                for (const member of inner.members) {
+                    if (ts.isPropertySignature(member) && member.name && (ts.isStringLiteral(member.name) || ts.isIdentifier(member.name))) {
+                        tags.add(member.name.text);
+                    }
+                }
+            }
+        }
+    }
+    return { tags, declaration };
+};
+/** Adds every missing element of one file to its tag map, or appends a tag map block to the file. */
+const tagMapFix = (missingArg) => (builderArg) => {
+    const sourceFile = missingArg[0].sourceFile;
+    const file = missingArg[0].file;
+    const text = sourceFile.text;
+    const { declaration } = tagMapOf(sourceFile);
+    if (declaration) {
+        const closeBrace = declaration.end - 1;
+        const lineStart = text.lastIndexOf('\n', closeBrace - 1) + 1;
+        const firstMember = declaration.members[0];
+        const indentation = firstMember
+            ? ast.indentationAt(text, firstMember.getStart())
+            : `${ast.indentationAt(text, declaration.getStart())}  `;
+        const lines = missingArg.map((elementArg) => `${indentation}'${elementArg.tag}': ${elementArg.className};\n`).join('');
+        if (/^[ \t]*$/.test(text.slice(lineStart, closeBrace))) {
+            builderArg.edit(file, lineStart, lineStart, lines);
+        }
+        else {
+            builderArg.edit(file, closeBrace, closeBrace, `\n${lines}`);
+        }
+        return;
+    }
+    const members = missingArg.map((elementArg) => `    '${elementArg.tag}': ${elementArg.className};\n`).join('');
+    const prefix = text.length === 0 || text.endsWith('\n') ? '' : '\n';
+    builderArg.edit(file, text.length, text.length, `${prefix}\ndeclare global {\n  interface HTMLElementTagNameMap {\n${members}  }\n}\n`);
+};
+/** The entry file declares `declare global { interface HTMLElementTagNameMap { '<tag>': <Class> } }`. */
+export const elementTagMapRule = {
+    id: 'element/tag-map',
+    severity: { base: 'warn' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        const byFile = new Map();
+        for (const element of catalogElements(project)) {
+            if (element.tag && !tagMapOf(element.sourceFile).tags.has(element.tag)) {
+                byFile.set(element.file, [...(byFile.get(element.file) ?? []), element]);
+            }
+        }
+        for (const missing of byFile.values()) {
+            // The tag is written into the source: only valid custom element names are.
+            const fixable = missing.every((elementArg) => elementArg.className && isCustomElementName(elementArg.tag));
+            const fix = fixable ? tagMapFix(missing) : undefined;
+            for (const element of missing) {
+                findings.push({
+                    file: element.file,
+                    position: element.decoratorCall.getStart(),
+                    key: elementKey(element),
+                    message: `HTMLElementTagNameMap of ${element.file} does not declare '${element.tag}'`,
+                    fix,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZWxlbWVudC50YWctbWFwLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvc3RhbmRhcmRzL3J1bGVzL2VsZW1lbnQudGFnLW1hcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sS0FBSyxHQUFHLE1BQU0sbUJBQW1CLENBQUM7QUFHekMsT0FBTyxFQUFFLGVBQWUsRUFBRSxVQUFVLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFL0UsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5QixvSEFBb0g7QUFDcEgsTUFBTSxRQUFRLEdBQUcsQ0FBQyxhQUE4QixFQUFzRixFQUFFO0lBQ3RJLE1BQU0sSUFBSSxHQUFHLElBQUksR0FBRyxFQUFVLENBQUM7SUFDL0IsSUFBSSxXQUFXLEdBQW1ELElBQUksQ0FBQztJQUN2RSxLQUFLLE1BQU0sU0FBUyxJQUFJLGFBQWEsQ0FBQyxVQUFVLEVBQUUsQ0FBQztRQUNqRCxJQUFJLENBQUMsRUFBRSxDQUFDLG1CQUFtQixDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLFlBQVksQ0FBQyxTQUFTLENBQUMsSUFBSSxDQUFDLElBQUksU0FBUyxDQUFDLElBQUksQ0FBQyxJQUFJLEtBQUssUUFBUTtlQUN6RyxDQUFDLFNBQVMsQ0FBQyxJQUFJLElBQUksQ0FBQyxFQUFFLENBQUMsYUFBYSxDQUFDLFNBQVMsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO1lBQzFELFNBQVM7UUFDWCxDQUFDO1FBQ0QsS0FBSyxNQUFNLEtBQUssSUFBSSxTQUFTLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRSxDQUFDO1lBQzlDLElBQUksRUFBRSxDQUFDLHNCQUFzQixDQUFDLEtBQUssQ0FBQyxJQUFJLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxLQUFLLHVCQUF1QixFQUFFLENBQUM7Z0JBQ3BGLFdBQVcsS0FBSyxLQUFLLENBQUM7Z0JBQ3RCLEtBQUssTUFBTSxNQUFNLElBQUksS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO29CQUNuQyxJQUFJLEVBQUUsQ0FBQyxtQkFBbUIsQ0FBQyxNQUFNLENBQUMsSUFBSSxNQUFNLENBQUMsSUFBSSxJQUFJLENBQUMsRUFBRSxDQUFDLGVBQWUsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDLFlBQVksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLENBQUMsRUFBRSxDQUFDO3dCQUN2SCxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLENBQUM7b0JBQzdCLENBQUM7Z0JBQ0gsQ0FBQztZQUNILENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sRUFBRSxJQUFJLEVBQUUsV0FBVyxFQUFFLENBQUM7QUFDL0IsQ0FBQyxDQUFDO0FBRUYscUdBQXFHO0FBQ3JHLE1BQU0sU0FBUyxHQUFHLENBQUMsVUFBOEIsRUFBYyxFQUFFLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRTtJQUMvRSxNQUFNLFVBQVUsR0FBRyxVQUFVLENBQUMsQ0FBQyxDQUFDLENBQUMsVUFBVSxDQUFDO0lBQzVDLE1BQU0sSUFBSSxHQUFHLFVBQVUsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUM7SUFDaEMsTUFBTSxJQUFJLEdBQUcsVUFBVSxDQUFDLElBQUksQ0FBQztJQUM3QixNQUFNLEVBQUUsV0FBVyxFQUFFLEdBQUcsUUFBUSxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQzdDLElBQUksV0FBVyxFQUFFLENBQUM7UUFDaEIsTUFBTSxVQUFVLEdBQUcsV0FBVyxDQUFDLEdBQUcsR0FBRyxDQUFDLENBQUM7UUFDdkMsTUFBTSxTQUFTLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsVUFBVSxHQUFHLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQztRQUM3RCxNQUFNLFdBQVcsR0FBRyxXQUFXLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQzNDLE1BQU0sV0FBVyxHQUFHLFdBQVc7WUFDN0IsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxhQUFhLENBQUMsSUFBSSxFQUFFLFdBQVcsQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNqRCxDQUFDLENBQUMsR0FBRyxHQUFHLENBQUMsYUFBYSxDQUFDLElBQUksRUFBRSxXQUFXLENBQUMsUUFBUSxFQUFFLENBQUMsSUFBSSxDQUFDO1FBQzNELE1BQU0sS0FBSyxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLEdBQUcsV0FBVyxJQUFJLFVBQVUsQ0FBQyxHQUFHLE1BQU0sVUFBVSxDQUFDLFNBQVMsS0FBSyxDQUFDLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxDQUFDO1FBQ3ZILElBQUksVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLFNBQVMsRUFBRSxVQUFVLENBQUMsQ0FBQyxFQUFFLENBQUM7WUFDdkQsVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsU0FBUyxFQUFFLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQztRQUNyRCxDQUFDO2FBQU0sQ0FBQztZQUNOLFVBQVUsQ0FBQyxJQUFJLENBQUMsSUFBSSxFQUFFLFVBQVUsRUFBRSxVQUFVLEVBQUUsS0FBSyxLQUFLLEVBQUUsQ0FBQyxDQUFDO1FBQzlELENBQUM7UUFDRCxPQUFPO0lBQ1QsQ0FBQztJQUNELE1BQU0sT0FBTyxHQUFHLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFFBQVEsVUFBVSxDQUFDLEdBQUcsTUFBTSxVQUFVLENBQUMsU0FBUyxLQUFLLENBQUMsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUM7SUFDL0csTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksSUFBSSxDQUFDLFFBQVEsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUM7SUFDcEUsVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLE1BQU0sRUFBRSxJQUFJLENBQUMsTUFBTSxFQUFFLEdBQUcsTUFBTSw0REFBNEQsT0FBTyxVQUFVLENBQUMsQ0FBQztBQUMxSSxDQUFDLENBQUM7QUFFRix5R0FBeUc7QUFDekcsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQWtCO0lBQzlDLEVBQUUsRUFBRSxpQkFBaUI7SUFDckIsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRTtJQUMxQixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLFFBQVEsR0FBbUIsRUFBRSxDQUFDO1FBQ3BDLE1BQU0sTUFBTSxHQUFHLElBQUksR0FBRyxFQUE4QixDQUFDO1FBQ3JELEtBQUssTUFBTSxPQUFPLElBQUksZUFBZSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDL0MsSUFBSSxPQUFPLENBQUMsR0FBRyxJQUFJLENBQUMsUUFBUSxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO2dCQUN2RSxNQUFNLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQyxHQUFHLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDLEVBQUUsT0FBTyxDQUFDLENBQUMsQ0FBQztZQUMzRSxDQUFDO1FBQ0gsQ0FBQztRQUNELEtBQUssTUFBTSxPQUFPLElBQUksTUFBTSxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUM7WUFDdEMsMkVBQTJFO1lBQzNFLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxTQUFTLElBQUksbUJBQW1CLENBQUMsVUFBVSxDQUFDLEdBQUksQ0FBQyxDQUFDLENBQUM7WUFDNUcsTUFBTSxHQUFHLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztZQUNyRCxLQUFLLE1BQU0sT0FBTyxJQUFJLE9BQU8sRUFBRSxDQUFDO2dCQUM5QixRQUFRLENBQUMsSUFBSSxDQUFDO29CQUNaLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtvQkFDbEIsUUFBUSxFQUFFLE9BQU8sQ0FBQyxhQUFhLENBQUMsUUFBUSxFQUFFO29CQUMxQyxHQUFHLEVBQUUsVUFBVSxDQUFDLE9BQU8sQ0FBQztvQkFDeEIsT0FBTyxFQUFFLDRCQUE0QixPQUFPLENBQUMsSUFBSSxzQkFBc0IsT0FBTyxDQUFDLEdBQUcsR0FBRztvQkFDckYsR0FBRztpQkFDSixDQUFDLENBQUM7WUFDTCxDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/i18n.literals.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** dees: no English literal a reader sees outside demo files, `ts_web/i18n/`, `ts_web/demos/` and `ts_web/pages/`. A ratchet. */
+export declare const i18nLiteralsRule: IStandardRule;

package/dist_ts/standards/rules/i18n.literals.js

@@ -0,0 +1,52 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { isDemoFile } from '../helpers.paths.js';
+const ts = plugins.typescript;
+/** The words belong to the catalog; demos, demo data, the i18n catalog and the demo pages show sample content. */
+const isExempt = (fileArg) => isDemoFile(fileArg)
+    || fileArg.startsWith('ts_web/i18n/')
+    || fileArg.startsWith('ts_web/demos/')
+    || fileArg.startsWith('ts_web/pages/');
+const wordAttributes = 'aria-label|aria-description|aria-valuetext|title|placeholder|label|text|heading|subheading|alt';
+const wordProperties = new Set(['name', 'label', 'text', 'heading', 'subheading', 'title', 'placeholder', 'message', 'description', 'confirmLabel', 'cancelLabel', 'emptyText', 'tooltip', 'hint']);
+const word = /^[A-Z][a-z]+(?:[ '’,.?!…-]+[A-Za-z]+)*[.?!…]?$/;
+/** The patterns of dees-catalog's scripts/check-literal-ratchet.cjs that apply to template and string text. */
+const textPatterns = () => [
+    // aria-label="Progress"
+    new RegExp(`\\s(?:${wordAttributes})="([A-Za-z][^"$]*[a-z][^"$]*)"`, 'g'),
+    // >Cancel< and > Back <
+    /(?<![=-])>\s*([A-Z][a-z]+(?:[ '’,.?!…-]+[A-Za-z]+)*[.?!…]?)\s*</g,
+];
+/** dees: no English literal a reader sees outside demo files, `ts_web/i18n/`, `ts_web/demos/` and `ts_web/pages/`. A ratchet. */
+export const i18nLiteralsRule = {
+    id: 'i18n/literals',
+    severity: { dees: 'error' },
+    fixMode: 'none',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const file of project.webFiles) {
+            if (isExempt(file)) {
+                continue;
+            }
+            const visit = (nodeArg) => {
+                if (ts.isStringLiteral(nodeArg) || ts.isNoSubstitutionTemplateLiteral(nodeArg)
+                    || ts.isTemplateHead(nodeArg) || ts.isTemplateMiddle(nodeArg) || ts.isTemplateTail(nodeArg)) {
+                    const text = nodeArg.getText();
+                    for (const pattern of textPatterns()) {
+                        for (const match of text.matchAll(pattern)) {
+                            findings.push({ file, position: nodeArg.getStart() + match.index, key: file, message: `English literal ${match[0].trim()}` });
+                        }
+                    }
+                }
+                if (ts.isPropertyAssignment(nodeArg) && (ts.isIdentifier(nodeArg.name) || ts.isStringLiteral(nodeArg.name))
+                    && wordProperties.has(nodeArg.name.text) && ts.isStringLiteral(nodeArg.initializer) && word.test(nodeArg.initializer.text)) {
+                    findings.push({ file, position: nodeArg.getStart(), key: file, message: `English literal ${nodeArg.getText()}` });
+                }
+                ts.forEachChild(nodeArg, visit);
+            };
+            visit(project.sourceFile(file));
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaTE4bi5saXRlcmFscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9pMThuLmxpdGVyYWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLEdBQUcsTUFBTSxtQkFBbUIsQ0FBQztBQUN6QyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFHakQsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5QixrSEFBa0g7QUFDbEgsTUFBTSxRQUFRLEdBQUcsQ0FBQyxPQUFlLEVBQVcsRUFBRSxDQUM1QyxVQUFVLENBQUMsT0FBTyxDQUFDO09BQ2hCLE9BQU8sQ0FBQyxVQUFVLENBQUMsY0FBYyxDQUFDO09BQ2xDLE9BQU8sQ0FBQyxVQUFVLENBQUMsZUFBZSxDQUFDO09BQ25DLE9BQU8sQ0FBQyxVQUFVLENBQUMsZUFBZSxDQUFDLENBQUM7QUFFekMsTUFBTSxjQUFjLEdBQUcsZ0dBQWdHLENBQUM7QUFDeEgsTUFBTSxjQUFjLEdBQUcsSUFBSSxHQUFHLENBQUMsQ0FBQyxNQUFNLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsWUFBWSxFQUFFLE9BQU8sRUFBRSxhQUFhLEVBQUUsU0FBUyxFQUFFLGFBQWEsRUFBRSxjQUFjLEVBQUUsYUFBYSxFQUFFLFdBQVcsRUFBRSxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztBQUNwTSxNQUFNLElBQUksR0FBRyxnREFBZ0QsQ0FBQztBQUU5RCwrR0FBK0c7QUFDL0csTUFBTSxZQUFZLEdBQUcsR0FBYSxFQUFFLENBQUM7SUFDbkMsd0JBQXdCO0lBQ3hCLElBQUksTUFBTSxDQUFDLFNBQVMsY0FBYyxpQ0FBaUMsRUFBRSxHQUFHLENBQUM7SUFDekUsd0JBQXdCO0lBQ3hCLGtFQUFrRTtDQUNuRSxDQUFD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

package/dist_ts/standards/rules/index.d.ts

@@ -0,0 +1,12 @@
+import type { IStandardRule } from '../rule.js';
+export { reflectExemptNames } from './props.reflect-primitive.js';
+export { renderComponentIndex } from './docs.component-index.js';
+/** Every rule of docs/standard.md, in the order of the document. */
+export declare const standardRules: readonly IStandardRule[];
+/**
+ * The order `wcctools fix` applies rules in: content edits first, then file moves (which rewrite imports),
+ * then barrels and reachability on the final layout, then the generated docs.
+ */
+export declare const fixOrder: readonly string[];
+/** Findings the checker itself produces for the allowlist. */
+export declare const allowlistStaleRuleId = "allowlist/stale";

package/dist_ts/standards/rules/index.js

@@ -0,0 +1,83 @@
+import { barrelElementIndexRule } from './barrel.element-index.js';
+import { barrelNoDemoExportRule } from './barrel.no-demo-export.js';
+import { demoFixtureNotExportedRule } from './demo.fixture-not-exported.js';
+import { demoGroupsRule } from './demo.groups.js';
+import { demoRequiredRule } from './demo.required.js';
+import { demoSeparateFileRule } from './demo.separate-file.js';
+import { demoShapeRule } from './demo.shape.js';
+import { docsComponentIndexRule } from './docs.component-index.js';
+import { elementExportedRule } from './element.exported.js';
+import { elementLiteralTagRule } from './element.literal-tag.js';
+import { elementReachableRule } from './element.reachable.js';
+import { elementTagMapRule } from './element.tag-map.js';
+import { i18nLiteralsRule } from './i18n.literals.js';
+import { layoutElementFolderRule } from './layout.element-folder.js';
+import { layoutEntryFileNameRule } from './layout.entry-file-name.js';
+import { layoutEntryRule } from './layout.entry.js';
+import { layoutGroupFolderRule } from './layout.group-folder.js';
+import { layoutShared00Rule } from './layout.shared-00.js';
+import { namingClassMatchesTagRule } from './naming.class-matches-tag.js';
+import { namingLowercaseFilesRule } from './naming.lowercase-files.js';
+import { namingTagPrefixRule } from './naming.tag-prefix.js';
+import { propsAccessorRule } from './props.accessor.js';
+import { propsObjectNoAttributeRule } from './props.object-no-attribute.js';
+import { propsReflectPrimitiveRule } from './props.reflect-primitive.js';
+import { propsTypedRule } from './props.typed.js';
+import { styleBdThemeRule } from './style.bdtheme.js';
+export { reflectExemptNames } from './props.reflect-primitive.js';
+export { renderComponentIndex } from './docs.component-index.js';
+/** Every rule of docs/standard.md, in the order of the document. */
+export const standardRules = [
+    layoutEntryRule,
+    layoutElementFolderRule,
+    layoutEntryFileNameRule,
+    layoutGroupFolderRule,
+    layoutShared00Rule,
+    namingLowercaseFilesRule,
+    namingTagPrefixRule,
+    namingClassMatchesTagRule,
+    elementLiteralTagRule,
+    elementExportedRule,
+    elementTagMapRule,
+    elementReachableRule,
+    barrelElementIndexRule,
+    barrelNoDemoExportRule,
+    demoShapeRule,
+    demoRequiredRule,
+    demoSeparateFileRule,
+    demoGroupsRule,
+    demoFixtureNotExportedRule,
+    propsAccessorRule,
+    propsTypedRule,
+    propsReflectPrimitiveRule,
+    propsObjectNoAttributeRule,
+    styleBdThemeRule,
+    i18nLiteralsRule,
+    docsComponentIndexRule,
+];
+/**
+ * The order `wcctools fix` applies rules in: content edits first, then file moves (which rewrite imports),
+ * then barrels and reachability on the final layout, then the generated docs.
+ */
+export const fixOrder = [
+    'element/exported',
+    'element/tag-map',
+    'props/accessor',
+    'props/typed',
+    'props/object-no-attribute',
+    'props/reflect-primitive',
+    'demo/groups',
+    'demo/required',
+    'barrel/no-demo-export',
+    'demo/fixture-not-exported',
+    'naming/lowercase-files',
+    'layout/shared-00',
+    'layout/entry-file-name',
+    'layout/element-folder',
+    'barrel/element-index',
+    'element/reachable',
+    'docs/component-index',
+];
+/** Findings the checker itself produces for the allowlist. */
+export const allowlistStaleRuleId = 'allowlist/stale';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDbkUsT0FBTyxFQUFFLHNCQUFzQixFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDcEUsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDNUUsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2xELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBQ3RELE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBQy9ELE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUNoRCxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSwyQkFBMkIsQ0FBQztBQUNuRSxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUM1RCxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSwwQkFBMEIsQ0FBQztBQUNqRSxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUM5RCxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUN6RCxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUN0RCxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUNyRSxPQUFPLEVBQUUsdUJBQXVCLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUN0RSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sbUJBQW1CLENBQUM7QUFDcEQsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDakUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFDM0QsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFDMUUsT0FBTyxFQUFFLHdCQUF3QixFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDdkUsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDN0QsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFDeEQsT0FBTyxFQUFFLDBCQUEwQixFQUFFLE1BQU0sZ0NBQWdDLENBQUM7QUFDNUUsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0sOEJBQThCLENBQUM7QUFDekUsT0FBTyxFQUFFLGNBQWMsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ2xELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRXRELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLDhCQUE4QixDQUFDO0FBQ2xFLE9BQU8sRUFBRSxvQkFBb0IsRUFBRSxNQUFNLDJCQUEyQixDQUFDO0FBRWpFLG9FQUFvRTtBQUNwRSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQTZCO0lBQ3JELGVBQWU7SUFDZix1QkFBdUI7SUFDdkIsdUJBQXVCO0lBQ3ZCLHFCQUFxQjtJQUNyQixrQkFBa0I7SUFDbEIsd0JBQXdCO0lBQ3hCLG1CQUFtQjtJQUNuQix5QkFBeUI7SUFDekIscUJBQXFCO0lBQ3JCLG1CQUFtQjtJQUNuQixpQkFBaUI7SUFDakIsb0JBQW9CO0lBQ3BCLHNCQUFzQjtJQUN0QixzQkFBc0I7SUFDdEIsYUFBYTtJQUNiLGdCQUFnQjtJQUNoQixvQkFBb0I7SUFDcEIsY0FBYztJQUNkLDBCQUEwQjtJQUMxQixpQkFBaUI7SUFDakIsY0FBYztJQUNkLHlCQUF5QjtJQUN6QiwwQkFBMEI7SUFDMUIsZ0JBQWdCO0lBQ2hCLGdCQUFnQjtJQUNoQixzQkFBc0I7Q0FDdkIsQ0FBQztBQUVGOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLFFBQVEsR0FBc0I7SUFDekMsa0JBQWtCO0lBQ2xCLGlCQUFpQjtJQUNqQixnQkFBZ0I7SUFDaEIsYUFBYTtJQUNiLDJCQUEyQjtJQUMzQix5QkFBeUI7SUFDekIsYUFBYTtJQUNiLGVBQWU7SUFDZix1QkFBdUI7SUFDdkIsMkJBQTJCO0lBQzNCLHdCQUF3QjtJQUN4QixrQkFBa0I7SUFDbEIsd0JBQXdCO0lBQ3hCLHVCQUF1QjtJQUN2QixzQkFBc0I7SUFDdEIsbUJBQW1CO0lBQ25CLHNCQUFzQjtDQUN2QixDQUFDO0FBRUYsOERBQThEO0FBQzlELE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLGlCQUFpQixDQUFDIn0=

package/dist_ts/standards/rules/layout.element-folder.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** Every element's entry file lives in its own element folder `ts_web/elements/[00group-<area>/]<tag>/<tag>.ts`. */
+export declare const layoutElementFolderRule: IStandardRule;

package/dist_ts/standards/rules/layout.element-folder.js

@@ -0,0 +1,47 @@
+import { baseOf, dirOf } from '../helpers.paths.js';
+import { catalogElements, elementKey, elementsDir, isCustomElementName, isElementParentDir, isInElementFolder } from './shared.js';
+/** Every element's entry file lives in its own element folder `ts_web/elements/[00group-<area>/]<tag>/<tag>.ts`. */
+export const layoutElementFolderRule = {
+    id: 'layout/element-folder',
+    severity: { base: 'warn' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        const elements = catalogElements(project);
+        for (const element of elements) {
+            if (!element.tag || isInElementFolder(element)) {
+                continue;
+            }
+            const currentDir = dirOf(element.file);
+            const group = /^ts_web\/elements\/(00group-[^/]+)(\/|$)/.exec(currentDir)?.[1];
+            const folder = `${elementsDir}/${group ? `${group}/` : ''}${element.tag}`;
+            const finding = {
+                file: element.file,
+                position: element.decoratorCall.getStart(),
+                key: elementKey(element),
+                message: `<${element.tag}> is declared in ${element.file}; its element folder is ${folder}/`,
+            };
+            const elementsInFile = elements.filter((otherArg) => otherArg.file === element.file);
+            const folderTaken = [...project.files.keys()].some((fileArg) => fileArg.startsWith(`${folder}/`)) || project.exists(folder);
+            // Only flat files move mechanically: a misnamed folder holds more than this element. The folder
+            // is named after the tag, so only a valid custom element name is usable.
+            if (isCustomElementName(element.tag) && elementsInFile.length === 1 && isElementParentDir(currentDir) && !folderTaken) {
+                const tag = element.tag;
+                const companions = [...project.files.keys()].filter((fileArg) => fileArg !== element.file && dirOf(fileArg) === currentDir && baseOf(fileArg).startsWith(`${tag}.`) && baseOf(fileArg) !== 'index.ts');
+                finding.fix = (builderArg) => {
+                    const entry = `${folder}/${tag}.ts`;
+                    const index = `${folder}/index.ts`;
+                    builderArg.create(index, `export * from './${tag}.js';\n`);
+                    builderArg.move(element.file, entry);
+                    for (const companion of companions) {
+                        builderArg.move(companion, `${folder}/${baseOf(companion)}`);
+                    }
+                    builderArg.redirectBarrelExports(element.file, index);
+                };
+            }
+            findings.push(finding);
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF5b3V0LmVsZW1lbnQtZm9sZGVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvc3RhbmRhcmRzL3J1bGVzL2xheW91dC5lbGVtZW50LWZvbGRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRXBELE9BQU8sRUFBRSxlQUFlLEVBQUUsVUFBVSxFQUFFLFdBQVcsRUFBRSxtQkFBbUIsRUFBRSxrQkFBa0IsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUVuSSxvSEFBb0g7QUFDcEgsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQWtCO0lBQ3BELEVBQUUsRUFBRSx1QkFBdUI7SUFDM0IsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRTtJQUMxQixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLFFBQVEsR0FBbUIsRUFBRSxDQUFDO1FBQ3BDLE1BQU0sUUFBUSxHQUFHLGVBQWUsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUMxQyxLQUFLLE1BQU0sT0FBTyxJQUFJLFFBQVEsRUFBRSxDQUFDO1lBQy9CLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxJQUFJLGlCQUFpQixDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7Z0JBQy9DLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxVQUFVLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQztZQUN2QyxNQUFNLEtBQUssR0FBRywwQ0FBMEMsQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUMvRSxNQUFNLE1BQU0sR0FBRyxHQUFHLFdBQVcsSUFBSSxLQUFLLENBQUMsQ0FBQyxDQUFDLEdBQUcsS0FBSyxHQUFHLENBQUMs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

package/dist_ts/standards/rules/layout.entry-file-name.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** Inside an element folder the entry file is `<tag>.ts` and the demo file is `<tag>.demo.ts`. */
+export declare const layoutEntryFileNameRule: IStandardRule;