@design.estate/wcctools 6.0.0 → 6.2.0

package/dist_ts/standards/rules/layout.entry-file-name.js

@@ -0,0 +1,71 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { baseOf, dirOf, isDemoFile, resolveSpecifier } from '../helpers.paths.js';
+import { catalogElements, elementKey, isCustomElementName, isInElementFolder, rootIdentifier } from './shared.js';
+const ts = plugins.typescript;
+/** Inside an element folder the entry file is `<tag>.ts` and the demo file is `<tag>.demo.ts`. */
+export const layoutEntryFileNameRule = {
+    id: 'layout/entry-file-name',
+    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 tag = element.tag;
+            // The expected file names come from the tag: only a valid custom element name is usable for a move.
+            const usableTag = isCustomElementName(tag);
+            const folder = dirOf(element.file);
+            const entry = `${folder}/${tag}.ts`;
+            if (element.file !== entry) {
+                const finding = {
+                    file: element.file,
+                    position: element.decoratorCall.getStart(),
+                    key: elementKey(element),
+                    message: `the entry file of <${tag}> is ${baseOf(element.file)}; expected ${tag}.ts`,
+                };
+                if (usableTag && elements.filter((otherArg) => otherArg.file === element.file).length === 1 && !project.exists(entry)) {
+                    finding.fix = (builderArg) => builderArg.move(element.file, entry);
+                }
+                findings.push(finding);
+            }
+            // The demo file the static demo is imported from.
+            const demoMember = ast.findStaticProperty(element.classNode, 'demo');
+            const initializer = demoMember?.initializer;
+            if (!initializer) {
+                continue;
+            }
+            const references = ts.isArrayLiteralExpression(initializer) ? [...initializer.elements] : [initializer];
+            const demoFiles = new Set();
+            for (const reference of references) {
+                const identifier = rootIdentifier(reference);
+                const source = identifier ? ast.importSourceOf(element.sourceFile, identifier) : null;
+                const resolved = source ? resolveSpecifier(element.file, source, (fileArg) => project.files.has(fileArg)) : null;
+                if (resolved && isDemoFile(resolved.target) && dirOf(resolved.target) === folder) {
+                    demoFiles.add(resolved.target);
+                }
+            }
+            const expectedDemo = `${folder}/${tag}.demo.ts`;
+            for (const demoFile of demoFiles) {
+                if (demoFile === expectedDemo) {
+                    continue;
+                }
+                const finding = {
+                    file: element.file,
+                    position: demoMember.getStart(),
+                    key: elementKey(element),
+                    message: `the demo file of <${tag}> is ${baseOf(demoFile)}; expected ${tag}.demo.ts`,
+                };
+                if (usableTag && demoFiles.size === 1 && !project.exists(expectedDemo)) {
+                    finding.fix = (builderArg) => builderArg.move(demoFile, expectedDemo);
+                }
+                findings.push(finding);
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF5b3V0LmVudHJ5LWZpbGUtbmFtZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9sYXlvdXQuZW50cnktZmlsZS1uYW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLEdBQUcsTUFBTSxtQkFBbUIsQ0FBQztBQUN6QyxPQUFPLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxVQUFVLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVsRixPQUFPLEVBQUUsZUFBZSxFQUFFLFVBQVUsRUFBRSxtQkFBbUIsRUFBRSxpQkFBaUIsRUFBRSxjQUFjLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFbEgsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5QixrR0FBa0c7QUFDbEcsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQWtCO0lBQ3BELEVBQUUsRUFBRSx3QkFBd0I7SUFDNUIsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRTtJQUMxQixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLFFBQVEsR0FBbUIsRUFBRSxDQUFDO1FBQ3BDLE1BQU0sUUFBUSxHQUFHLGVBQWUsQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUMxQyxLQUFLLE1BQU0sT0FBTyxJQUFJLFFBQVEsRUFBRSxDQUFDO1lBQy9CLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxJQUFJLENBQUMsaUJBQWlCLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztnQkFDaEQsU0FBUztZQUNYLENBQUM7WUFDRCxNQUFNLEdBQUcsR0FBRyxPQUFPLENBQUMsR0FBRyxDQUFDO1lBQ3hCLG9HQUFvRztZQUNwRyxNQUFNLFNBQVMsR0FBRyxtQkFBbUIsQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUMzQyxNQUFNLE1BQU0sR0FBRyxLQUFLLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQ25DLE1BQU0sS0FBSyxHQUFHLEdBQUcsTUFBTSxJQUFJLEdBQUcsS0FBSyxDQUFDO1lBQ3BDLElBQUksT0FBTyxDQUFDLElBQUksS0FBSyxLQUFLLEVBQUUsQ0FBQztnQkFDM0IsTUFBTSxPQUFPLEdBQWlCO29CQUM1QixJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7b0JBQ2xCLFFBQVEsRUFBRSxPQUFPLENBQUMsYUFBYSxDQUFDLFFBQVEsRUFBRTtvQkFDMUMsR0FBRyxFQUFFLFVBQVUsQ0FBQyxPQUFPLENBQUM7b0JBQ3hCLE9BQU8sRUFBRSxzQkFBc0IsR0FBRyxRQUFRLE1BQU0sQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLGNBQWMsR0FBRyxLQUFLO2lCQUNyRixDQUFDO2dCQUNGLElBQUksU0FBUyxJQUFJLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxRQUFRLEVBQUUsRUFBRSxDQUFDLFFBQVEsQ0FBQyxJQUFJLEtBQUssT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLE1BQU0sS0FBSyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7b0JBQ3RILE9BQU8sQ0FBQyxHQUFHLEdBQUcsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxLQUFLLENBQUMsQ0FBQztnQkFDckUsQ0FBQztnQkFDRCxRQUFRLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBQ3pCLENBQUM7WUFDRCxrREFBa0Q7WUFDbEQsTUFBTSxVQUFVLEdBQUcsR0FBRyxDQUFDLGtCQUFrQixDQUFDLE9BQU8sQ0FBQyxTQUFTLEVBQUUsTUFBTSxDQUFDLENBQUM7WUFDckUsTUFBTSxXQUFXLEdBQUcsVUFBVSxFQUFFLFdBQVcsQ0FBQztZQUM1QyxJQUFJLENBQUMsV0FBVyxFQUFFLENBQUM7Z0JBQ2pCLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxVQUFVLEdBQUcsRUFBRSxDQUFDLHdCQUF3QixDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLEdBQUcsV0FBVyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLFdBQVcsQ0FBQyxDQUFDO1lBQ3hHLE1BQU0sU0FBUyxHQUFHLElBQUksR0FBRyxFQUFVLENBQUM7WUFDcEMsS0FBSyxNQUFNLFNBQVMsSUFBSSxVQUFVLEVBQUUsQ0FBQztnQkFDbkMsTUFBTSxVQUFVLEdBQUcsY0FBYyxDQUFDLFNBQVMsQ0FBQyxDQUFDO2dCQUM3QyxNQUFNLE1BQU0sR0FBRyxVQUFVLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxjQUFjLENBQUMsT0FBTyxDQUFDLFVBQVUsRUFBRSxVQUFVLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO2dCQUN0RixNQUFNLFFBQVEsR0FBRyxNQUFNLENBQUMsQ0FBQyxDQUFDLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsTUFBTSxFQUFFLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUM7Z0JBQ2pILElBQUksUUFBUSxJQUFJLFVBQVUsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLElBQUksS0FBSyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsS0FBSyxNQUFNLEVBQUUsQ0FBQztvQkFDakYsU0FBUyxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUM7Z0JBQ2pDLENBQUM7WUFDSCxDQUFDO1lBQ0QsTUFBTSxZQUFZLEdBQUcsR0FBRyxNQUFNLElBQUksR0FBRyxVQUFVLENBQUM7WUFDaEQsS0FBSyxNQUFNLFFBQVEsSUFBSSxTQUFTLEVBQUUsQ0FBQztnQkFDakMsSUFBSSxRQUFRLEtBQUssWUFBWSxFQUFFLENBQUM7b0JBQzlCLFNBQVM7Z0JBQ1gsQ0FBQztnQkFDRCxNQUFNLE9BQU8sR0FBaUI7b0JBQzVCLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtvQkFDbEIsUUFBUSxFQUFFLFVBQVcsQ0FBQyxRQUFRLEVBQUU7b0JBQ2hDLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUN4QixPQUFPLEVBQUUscUJBQXFCLEdBQUcsUUFBUSxNQUFNLENBQUMsUUFBUSxDQUFDLGNBQWMsR0FBRyxVQUFVO2lCQUNyRixDQUFDO2dCQUNGLElBQUksU0FBUyxJQUFJLFNBQVMsQ0FBQyxJQUFJLEtBQUssQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsRUFBRSxDQUFDO29CQUN2RSxPQUFPLENBQUMsR0FBRyxHQUFHLENBQUMsVUFBVSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRSxZQUFZLENBQUMsQ0FBQztnQkFDeEUsQ0FBQztnQkFDRCxRQUFRLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBQ3pCLENBQUM7UUFDSCxDQUFDO1FBQ0QsT0FBTyxRQUFRLENBQUM7SUFDbEIsQ0FBQztDQUNGLENBQUMifQ==

package/dist_ts/standards/rules/layout.entry.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** `html/index.ts` exists and calls `setupWccTools({ sections })`; `html/index.html` exists. */
+export declare const layoutEntryRule: IStandardRule;

package/dist_ts/standards/rules/layout.entry.js

@@ -0,0 +1,38 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+const ts = plugins.typescript;
+/** `html/index.ts` exists and calls `setupWccTools({ sections })`; `html/index.html` exists. */
+export const layoutEntryRule = {
+    id: 'layout/entry',
+    severity: { base: 'error' },
+    fixMode: 'none',
+    detect: ({ project }) => {
+        const findings = [];
+        const entry = 'html/index.ts';
+        if (!project.files.has(entry)) {
+            findings.push({ file: entry, position: 0, key: entry, message: 'html/index.ts is missing' });
+        }
+        else {
+            let found = false;
+            const visit = (nodeArg) => {
+                if (ts.isCallExpression(nodeArg) && ast.calleeName(nodeArg.expression) === 'setupWccTools') {
+                    const config = nodeArg.arguments[0];
+                    if (config && ts.isObjectLiteralExpression(config) && config.properties.some((propertyArg) => (ts.isPropertyAssignment(propertyArg) || ts.isShorthandPropertyAssignment(propertyArg))
+                        && ts.isIdentifier(propertyArg.name) && propertyArg.name.text === 'sections')) {
+                        found = true;
+                    }
+                }
+                ts.forEachChild(nodeArg, visit);
+            };
+            visit(project.sourceFile(entry));
+            if (!found) {
+                findings.push({ file: entry, position: 0, key: entry, message: 'html/index.ts does not call setupWccTools({ sections })' });
+            }
+        }
+        if (!project.files.has('html/index.html')) {
+            findings.push({ file: 'html/index.html', position: 0, key: 'html/index.html', message: 'html/index.html is missing' });
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF5b3V0LmVudHJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvc3RhbmRhcmRzL3J1bGVzL2xheW91dC5lbnRyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sS0FBSyxHQUFHLE1BQU0sbUJBQW1CLENBQUM7QUFHekMsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5QixnR0FBZ0c7QUFDaEcsTUFBTSxDQUFDLE1BQU0sZUFBZSxHQUFrQjtJQUM1QyxFQUFFLEVBQUUsY0FBYztJQUNsQixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFO0lBQzNCLE9BQU8sRUFBRSxNQUFNO0lBQ2YsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsTUFBTSxLQUFLLEdBQUcsZUFBZSxDQUFDO1FBQzlCLElBQUksQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxLQUFLLENBQUMsRUFBRSxDQUFDO1lBQzlCLFFBQVEsQ0FBQyxJQUFJLENBQUMsRUFBRSxJQUFJLEVBQUUsS0FBSyxFQUFFLFFBQVEsRUFBRSxDQUFDLEVBQUUsR0FBRyxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUUsMEJBQTBCLEVBQUUsQ0FBQyxDQUFDO1FBQy9GLENBQUM7YUFBTSxDQUFDO1lBQ04sSUFBSSxLQUFLLEdBQUcsS0FBSyxDQUFDO1lBQ2xCLE1BQU0sS0FBSyxHQUFHLENBQUMsT0FBa0IsRUFBUSxFQUFFO2dCQUN6QyxJQUFJLEVBQUUsQ0FBQyxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsSUFBSSxHQUFHLENBQUMsVUFBVSxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUMsS0FBSyxlQUFlLEVBQUUsQ0FBQztvQkFDM0YsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQztvQkFDcEMsSUFBSSxNQUFNLElBQUksRUFBRSxDQUFDLHlCQUF5QixDQUFDLE1BQU0sQ0FBQyxJQUFJLE1BQU0sQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FDM0YsQ0FBQyxFQUFFLENBQUMsb0JBQW9CLENBQUMsV0FBVyxDQUFDLElBQUksRUFBRSxDQUFDLDZCQUE2QixDQUFDLFdBQVcsQ0FBQyxDQUFDOzJCQUNwRixFQUFFLENBQUMsWUFBWSxDQUFDLFdBQVcsQ0FBQyxJQUFJLENBQUMsSUFBSSxXQUFXLENBQUMsSUFBSSxDQUFDLElBQUksS0FBSyxVQUFVLENBQUMsRUFBRSxDQUFDO3dCQUNoRixLQUFLLEdBQUcsSUFBSSxDQUFDO29CQUNmLENBQUM7Z0JBQ0gsQ0FBQztnQkFDRCxFQUFFLENBQUMsWUFBWSxDQUFDLE9BQU8sRUFBRSxLQUFLLENBQUMsQ0FBQztZQUNsQyxDQUFDLENBQUM7WUFDRixLQUFLLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1lBQ2pDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztnQkFDWCxRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLEtBQUssRUFBRSxRQUFRLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFLHlEQUF5RCxFQUFFLENBQUMsQ0FBQztZQUM5SCxDQUFDO1FBQ0gsQ0FBQztRQUNELElBQUksQ0FBQyxPQUFPLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsQ0FBQyxFQUFFLENBQUM7WUFDMUMsUUFBUSxDQUFDLElBQUksQ0FBQyxFQUFFLElBQUksRUFBRSxpQkFBaUIsRUFBRSxRQUFRLEVBQUUsQ0FBQyxFQUFFLEdBQUcsRUFBRSxpQkFBaUIsRUFBRSxPQUFPLEVBQUUsNEJBQTRCLEVBQUUsQ0FBQyxDQUFDO1FBQ3pILENBQUM7UUFDRCxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDO0NBQ0YsQ0FBQyJ9

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

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** dees: element folders sit under `ts_web/elements/00group-<area>/`. */
+export declare const layoutGroupFolderRule: IStandardRule;

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

@@ -0,0 +1,22 @@
+import { catalogElements, elementKey } from './shared.js';
+/** dees: element folders sit under `ts_web/elements/00group-<area>/`. */
+export const layoutGroupFolderRule = {
+    id: 'layout/group-folder',
+    severity: { dees: 'warn' },
+    fixMode: 'none',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const element of catalogElements(project)) {
+            if (element.file.startsWith('ts_web/elements/') && !/^ts_web\/elements\/00group-[^/]+\//.test(element.file)) {
+                findings.push({
+                    file: element.file,
+                    position: element.decoratorCall.getStart(),
+                    key: elementKey(element),
+                    message: `<${element.tag ?? '?'}> is not inside a ts_web/elements/00group-<area>/ folder`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF5b3V0Lmdyb3VwLWZvbGRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9sYXlvdXQuZ3JvdXAtZm9sZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxlQUFlLEVBQUUsVUFBVSxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRTFELHlFQUF5RTtBQUN6RSxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBa0I7SUFDbEQsRUFBRSxFQUFFLHFCQUFxQjtJQUN6QixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFO0lBQzFCLE9BQU8sRUFBRSxNQUFNO0lBQ2YsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsS0FBSyxNQUFNLE9BQU8sSUFBSSxlQUFlLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQztZQUMvQyxJQUFJLE9BQU8sQ0FBQyxJQUFJLENBQUMsVUFBVSxDQUFDLGtCQUFrQixDQUFDLElBQUksQ0FBQyxvQ0FBb0MsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7Z0JBQzVHLFFBQVEsQ0FBQyxJQUFJLENBQUM7b0JBQ1osSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO29CQUNsQixRQUFRLEVBQUUsT0FBTyxDQUFDLGFBQWEsQ0FBQyxRQUFRLEVBQUU7b0JBQzFDLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUN4QixPQUFPLEVBQUUsSUFBSSxPQUFPLENBQUMsR0FBRyxJQUFJLEdBQUcsMERBQTBEO2lCQUMxRixDQUFDLENBQUM7WUFDTCxDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/layout.shared-00.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** A module at the root of `ts_web/elements/` that declares no element is named `00<name>.ts`. */
+export declare const layoutShared00Rule: IStandardRule;

package/dist_ts/standards/rules/layout.shared-00.js

@@ -0,0 +1,36 @@
+import { baseOf, dirOf, isDemoFile } from '../helpers.paths.js';
+import { elementsDir } from './shared.js';
+/** A module at the root of `ts_web/elements/` that declares no element is named `00<name>.ts`. */
+export const layoutShared00Rule = {
+    id: 'layout/shared-00',
+    severity: { base: 'info' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        const rootElements = project.elements.filter((elementArg) => dirOf(elementArg.file) === elementsDir);
+        const elementFiles = new Set(project.elements.map((elementArg) => elementArg.file));
+        for (const file of project.webFiles) {
+            const name = baseOf(file);
+            if (dirOf(file) !== elementsDir || name === 'index.ts' || name.startsWith('00') || isDemoFile(file) || elementFiles.has(file)) {
+                continue;
+            }
+            // Companion files of a flat element (`<tag>.styles.ts`) move with the element instead.
+            if (rootElements.some((elementArg) => elementArg.tag && name.startsWith(`${elementArg.tag}.`))) {
+                continue;
+            }
+            const target = `${elementsDir}/00${name}`;
+            const finding = {
+                file,
+                position: 0,
+                key: file,
+                message: `${name} declares no element; shared modules at the root of ts_web/elements are named 00${name}`,
+            };
+            if (!project.exists(target)) {
+                finding.fix = (builderArg) => builderArg.move(file, target);
+            }
+            findings.push(finding);
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibGF5b3V0LnNoYXJlZC0wMC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9sYXlvdXQuc2hhcmVkLTAwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxNQUFNLEVBQUUsS0FBSyxFQUFFLFVBQVUsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRWhFLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFMUMsa0dBQWtHO0FBQ2xHLE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFrQjtJQUMvQyxFQUFFLEVBQUUsa0JBQWtCO0lBQ3RCLFFBQVEsRUFBRSxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUU7SUFDMUIsT0FBTyxFQUFFLE1BQU07SUFDZixNQUFNLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUU7UUFDdEIsTUFBTSxRQUFRLEdBQW1CLEVBQUUsQ0FBQztRQUNwQyxNQUFNLFlBQVksR0FBRyxPQUFPLENBQUMsUUFBUSxDQUFDLE1BQU0sQ0FBQyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsS0FBSyxXQUFXLENBQUMsQ0FBQztRQUNyRyxNQUFNLFlBQVksR0FBRyxJQUFJLEdBQUcsQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7UUFDcEYsS0FBSyxNQUFNLElBQUksSUFBSSxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDcEMsTUFBTSxJQUFJLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQzFCLElBQUksS0FBSyxDQUFDLElBQUksQ0FBQyxLQUFLLFdBQVcsSUFBSSxJQUFJLEtBQUssVUFBVSxJQUFJLElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLElBQUksVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLFlBQVksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLEVBQUUsQ0FBQztnQkFDOUgsU0FBUztZQUNYLENBQUM7WUFDRCx1RkFBdUY7WUFDdkYsSUFBSSxZQUFZLENBQUMsSUFBSSxDQUFDLENBQUMsVUFBVSxFQUFFLEVBQUUsQ0FBQyxVQUFVLENBQUMsR0FBRyxJQUFJLElBQUksQ0FBQyxVQUFVLENBQUMsR0FBRyxVQUFVLENBQUMsR0FBRyxHQUFHLENBQUMsQ0FBQyxFQUFFLENBQUM7Z0JBQy9GLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxNQUFNLEdBQUcsR0FBRyxXQUFXLE1BQU0sSUFBSSxFQUFFLENBQUM7WUFDMUMsTUFBTSxPQUFPLEdBQWlCO2dCQUM1QixJQUFJO2dCQUNKLFFBQVEsRUFBRSxDQUFDO2dCQUNYLEdBQUcsRUFBRSxJQUFJO2dCQUNULE9BQU8sRUFBRSxHQUFHLElBQUksbUZBQW1GLElBQUksRUFBRTthQUMxRyxDQUFDO1lBQ0YsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztnQkFDNUIsT0FBTyxDQUFDLEdBQUcsR0FBRyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7WUFDOUQsQ0FBQztZQUNELFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDekIsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/naming.class-matches-tag.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** The class name, lowercased, equals the tag with hyphens removed. */
+export declare const namingClassMatchesTagRule: IStandardRule;

package/dist_ts/standards/rules/naming.class-matches-tag.js

@@ -0,0 +1,26 @@
+import { catalogElements, elementKey } from './shared.js';
+/** The class name, lowercased, equals the tag with hyphens removed. */
+export const namingClassMatchesTagRule = {
+    id: 'naming/class-matches-tag',
+    severity: { base: 'warn' },
+    fixMode: 'none',
+    allowlistCategories: ['published'],
+    detect: ({ project }) => {
+        const findings = [];
+        for (const element of catalogElements(project)) {
+            if (!element.tag || !element.className) {
+                continue;
+            }
+            if (element.className.toLowerCase() !== element.tag.replace(/-/g, '')) {
+                findings.push({
+                    file: element.file,
+                    position: element.classNode.name.getStart(),
+                    key: elementKey(element),
+                    message: `class ${element.className} does not match <${element.tag}>`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmFtaW5nLmNsYXNzLW1hdGNoZXMtdGFnLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvc3RhbmRhcmRzL3J1bGVzL25hbWluZy5jbGFzcy1tYXRjaGVzLXRhZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFDQSxPQUFPLEVBQUUsZUFBZSxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUUxRCx1RUFBdUU7QUFDdkUsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQWtCO0lBQ3RELEVBQUUsRUFBRSwwQkFBMEI7SUFDOUIsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRTtJQUMxQixPQUFPLEVBQUUsTUFBTTtJQUNmLG1CQUFtQixFQUFFLENBQUMsV0FBVyxDQUFDO0lBQ2xDLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLFFBQVEsR0FBbUIsRUFBRSxDQUFDO1FBQ3BDLEtBQUssTUFBTSxPQUFPLElBQUksZUFBZSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDL0MsSUFBSSxDQUFDLE9BQU8sQ0FBQyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsU0FBUyxFQUFFLENBQUM7Z0JBQ3ZDLFNBQVM7WUFDWCxDQUFDO1lBQ0QsSUFBSSxPQUFPLENBQUMsU0FBUyxDQUFDLFdBQVcsRUFBRSxLQUFLLE9BQU8sQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxFQUFFLENBQUMsRUFBRSxDQUFDO2dCQUN0RSxRQUFRLENBQUMsSUFBSSxDQUFDO29CQUNaLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtvQkFDbEIsUUFBUSxFQUFFLE9BQU8sQ0FBQyxTQUFTLENBQUMsSUFBSyxDQUFDLFFBQVEsRUFBRTtvQkFDNUMsR0FBRyxFQUFFLFVBQVUsQ0FBQyxPQUFPLENBQUM7b0JBQ3hCLE9BQU8sRUFBRSxTQUFTLE9BQU8sQ0FBQyxTQUFTLG9CQUFvQixPQUFPLENBQUMsR0FBRyxHQUFHO2lCQUN0RSxDQUFDLENBQUM7WUFDTCxDQUFDO1FBQ0gsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/naming.lowercase-files.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** File and folder names under `ts_web/` are lowercase. */
+export declare const namingLowercaseFilesRule: IStandardRule;

package/dist_ts/standards/rules/naming.lowercase-files.js

@@ -0,0 +1,26 @@
+/** File and folder names under `ts_web/` are lowercase. */
+export const namingLowercaseFilesRule = {
+    id: 'naming/lowercase-files',
+    severity: { base: 'error' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        const lowered = new Map();
+        for (const file of project.files.keys()) {
+            lowered.set(file.toLowerCase(), (lowered.get(file.toLowerCase()) ?? 0) + 1);
+        }
+        for (const file of project.webFiles) {
+            if (!/[A-Z]/.test(file)) {
+                continue;
+            }
+            const target = file.toLowerCase();
+            const finding = { file, position: 0, key: file, message: `${file} is not lowercase; expected ${target}` };
+            if (lowered.get(target) === 1 && !project.exists(target)) {
+                finding.fix = (builderArg) => builderArg.move(file, target);
+            }
+            findings.push(finding);
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmFtaW5nLmxvd2VyY2FzZS1maWxlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9uYW1pbmcubG93ZXJjYXNlLWZpbGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLDJEQUEyRDtBQUMzRCxNQUFNLENBQUMsTUFBTSx3QkFBd0IsR0FBa0I7SUFDckQsRUFBRSxFQUFFLHdCQUF3QjtJQUM1QixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFO0lBQzNCLE9BQU8sRUFBRSxNQUFNO0lBQ2YsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsTUFBTSxPQUFPLEdBQUcsSUFBSSxHQUFHLEVBQWtCLENBQUM7UUFDMUMsS0FBSyxNQUFNLElBQUksSUFBSSxPQUFPLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxFQUFFLENBQUM7WUFDeEMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsV0FBVyxFQUFFLEVBQUUsQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQyxJQUFJLENBQUMsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDO1FBQzlFLENBQUM7UUFDRCxLQUFLLE1BQU0sSUFBSSxJQUFJLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUNwQyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO2dCQUN4QixTQUFTO1lBQ1gsQ0FBQztZQUNELE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUNsQyxNQUFNLE9BQU8sR0FBaUIsRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLENBQUMsRUFBRSxHQUFHLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxHQUFHLElBQUksK0JBQStCLE1BQU0sRUFBRSxFQUFFLENBQUM7WUFDeEgsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztnQkFDekQsT0FBTyxDQUFDLEdBQUcsR0FBRyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsTUFBTSxDQUFDLENBQUM7WUFDOUQsQ0FBQztZQUNELFFBQVEsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDekIsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/naming.tag-prefix.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** Every tag starts with `<tagPrefix>-`. Applies to fixture elements in demo files too: they share the page. */
+export declare const namingTagPrefixRule: IStandardRule;

package/dist_ts/standards/rules/naming.tag-prefix.js

@@ -0,0 +1,23 @@
+import { elementKey } from './shared.js';
+/** Every tag starts with `<tagPrefix>-`. Applies to fixture elements in demo files too: they share the page. */
+export const namingTagPrefixRule = {
+    id: 'naming/tag-prefix',
+    severity: { base: 'error' },
+    fixMode: 'none',
+    allowlistCategories: ['published'],
+    detect: ({ project, config }) => {
+        const findings = [];
+        for (const element of project.elements) {
+            if (element.tag && !element.tag.startsWith(`${config.tagPrefix}-`)) {
+                findings.push({
+                    file: element.file,
+                    position: element.decoratorCall.getStart(),
+                    key: elementKey(element),
+                    message: `<${element.tag}> does not start with the tag prefix '${config.tagPrefix}-'`,
+                });
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibmFtaW5nLnRhZy1wcmVmaXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvbmFtaW5nLnRhZy1wcmVmaXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQ0EsT0FBTyxFQUFFLFVBQVUsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUV6QyxnSEFBZ0g7QUFDaEgsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQWtCO0lBQ2hELEVBQUUsRUFBRSxtQkFBbUI7SUFDdkIsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRTtJQUMzQixPQUFPLEVBQUUsTUFBTTtJQUNmLG1CQUFtQixFQUFFLENBQUMsV0FBVyxDQUFDO0lBQ2xDLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLE1BQU0sRUFBRSxFQUFFLEVBQUU7UUFDOUIsTUFBTSxRQUFRLEdBQW1CLEVBQUUsQ0FBQztRQUNwQyxLQUFLLE1BQU0sT0FBTyxJQUFJLE9BQU8sQ0FBQyxRQUFRLEVBQUUsQ0FBQztZQUN2QyxJQUFJLE9BQU8sQ0FBQyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxTQUFTLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQ25FLFFBQVEsQ0FBQyxJQUFJLENBQUM7b0JBQ1osSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO29CQUNsQixRQUFRLEVBQUUsT0FBTyxDQUFDLGFBQWEsQ0FBQyxRQUFRLEVBQUU7b0JBQzFDLEdBQUcsRUFBRSxVQUFVLENBQUMsT0FBTyxDQUFDO29CQUN4QixPQUFPLEVBQUUsSUFBSSxPQUFPLENBQUMsR0FBRyx5Q0FBeUMsTUFBTSxDQUFDLFNBQVMsSUFBSTtpQkFDdEYsQ0FBQyxDQUFDO1lBQ0wsQ0FBQztRQUNILENBQUM7UUFDRCxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDO0NBQ0YsQ0FBQyJ9

package/dist_ts/standards/rules/props.accessor.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** Members decorated with `@property` or `@state` use the `accessor` keyword (standard decorators). */
+export declare const propsAccessorRule: IStandardRule;

package/dist_ts/standards/rules/props.accessor.js

@@ -0,0 +1,35 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { propertyKey } from './shared.js';
+const ts = plugins.typescript;
+/** Members decorated with `@property` or `@state` use the `accessor` keyword (standard decorators). */
+export const propsAccessorRule = {
+    id: 'props/accessor',
+    severity: { base: 'error' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        if (project.experimentalDecorators) {
+            return findings;
+        }
+        for (const property of project.properties) {
+            const member = property.member;
+            if (!ts.isPropertyDeclaration(member) || ast.hasModifier(member, ts.SyntaxKind.AccessorKeyword)) {
+                continue;
+            }
+            const finding = {
+                file: property.file,
+                position: member.name.getStart(),
+                key: propertyKey(property),
+                message: `@${property.decorator} ${property.name} is a field; standard decorators need 'accessor ${property.name}'`,
+            };
+            if (!ast.hasModifier(member, ts.SyntaxKind.DeclareKeyword)) {
+                const at = member.name.getStart();
+                finding.fix = (builderArg) => builderArg.edit(property.file, at, at, 'accessor ');
+            }
+            findings.push(finding);
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvcHMuYWNjZXNzb3IuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvcHJvcHMuYWNjZXNzb3IudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEtBQUssR0FBRyxNQUFNLG1CQUFtQixDQUFDO0FBRXpDLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFFMUMsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5Qix1R0FBdUc7QUFDdkcsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQWtCO0lBQzlDLEVBQUUsRUFBRSxnQkFBZ0I7SUFDcEIsUUFBUSxFQUFFLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRTtJQUMzQixPQUFPLEVBQUUsTUFBTTtJQUNmLE1BQU0sRUFBRSxDQUFDLEVBQUUsT0FBTyxFQUFFLEVBQUUsRUFBRTtRQUN0QixNQUFNLFFBQVEsR0FBbUIsRUFBRSxDQUFDO1FBQ3BDLElBQUksT0FBTyxDQUFDLHNCQUFzQixFQUFFLENBQUM7WUFDbkMsT0FBTyxRQUFRLENBQUM7UUFDbEIsQ0FBQztRQUNELEtBQUssTUFBTSxRQUFRLElBQUksT0FBTyxDQUFDLFVBQVUsRUFBRSxDQUFDO1lBQzFDLE1BQU0sTUFBTSxHQUFHLFFBQVEsQ0FBQyxNQUFNLENBQUM7WUFDL0IsSUFBSSxDQUFDLEVBQUUsQ0FBQyxxQkFBcUIsQ0FBQyxNQUFNLENBQUMsSUFBSSxHQUFHLENBQUMsV0FBVyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLGVBQWUsQ0FBQyxFQUFFLENBQUM7Z0JBQ2hHLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxPQUFPLEdBQWlCO2dCQUM1QixJQUFJLEVBQUUsUUFBUSxDQUFDLElBQUk7Z0JBQ25CLFFBQVEsRUFBRSxNQUFNLENBQUMsSUFBSSxDQUFDLFFBQVEsRUFBRTtnQkFDaEMsR0FBRyxFQUFFLFdBQVcsQ0FBQyxRQUFRLENBQUM7Z0JBQzFCLE9BQU8sRUFBRSxJQUFJLFFBQVEsQ0FBQyxTQUFTLElBQUksUUFBUSxDQUFDLElBQUksbURBQW1ELFFBQVEsQ0FBQyxJQUFJLEdBQUc7YUFDcEgsQ0FBQztZQUNGLElBQUksQ0FBQyxHQUFHLENBQUMsV0FBVyxDQUFDLE1BQU0sRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLGNBQWMsQ0FBQyxFQUFFLENBQUM7Z0JBQzNELE1BQU0sRUFBRSxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFLENBQUM7Z0JBQ2xDLE9BQU8sQ0FBQyxHQUFHLEdBQUcsQ0FBQyxVQUFVLEVBQUUsRUFBRSxDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLElBQUksRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLFdBQVcsQ0FBQyxDQUFDO1lBQ3BGLENBQUM7WUFDRCxRQUFRLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3pCLENBQUM7UUFDRCxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDO0NBQ0YsQ0FBQyJ9

package/dist_ts/standards/rules/props.object-no-attribute.d.ts

@@ -0,0 +1,3 @@
+import type { IStandardRule } from '../rule.js';
+/** A public property holding an object or array declares `type: Object`/`type: Array` or `attribute: false`. */
+export declare const propsObjectNoAttributeRule: IStandardRule;

package/dist_ts/standards/rules/props.object-no-attribute.js

@@ -0,0 +1,42 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { addOptionFix } from './props.typed.js';
+import { coreTypeOf, isArrayTypeNode, propertyKey, publicProperties } from './shared.js';
+const ts = plugins.typescript;
+/** An array, object literal type or `I`-prefixed interface annotation. */
+const isObjectAnnotation = (typeArg) => {
+    if (!typeArg) {
+        return false;
+    }
+    return isArrayTypeNode(typeArg)
+        || ts.isTypeLiteralNode(typeArg)
+        || (ts.isTypeReferenceNode(typeArg) && ts.isIdentifier(typeArg.typeName) && /^I[A-Z]/.test(typeArg.typeName.text));
+};
+/** A public property holding an object or array declares `type: Object`/`type: Array` or `attribute: false`. */
+export const propsObjectNoAttributeRule = {
+    id: 'props/object-no-attribute',
+    severity: { base: 'warn' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const property of publicProperties(project)) {
+            if (property.dynamicOptions || !isObjectAnnotation(coreTypeOf(property))) {
+                continue;
+            }
+            const options = property.options;
+            const type = options ? ast.objectPropertyText(options, 'type') : null;
+            if (type === 'Object' || type === 'Array' || (options && ast.objectPropertyText(options, 'attribute') === 'false')) {
+                continue;
+            }
+            findings.push({
+                file: property.file,
+                position: property.call.getStart(),
+                key: propertyKey(property),
+                message: `@property ${property.name} holds an object or array but declares neither type: Object/Array nor attribute: false`,
+                fix: addOptionFix(property, 'attribute: false', 'last'),
+            });
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvcHMub2JqZWN0LW5vLWF0dHJpYnV0ZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9wcm9wcy5vYmplY3Qtbm8tYXR0cmlidXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLEdBQUcsTUFBTSxtQkFBbUIsQ0FBQztBQUV6QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDaEQsT0FBTyxFQUFFLFVBQVUsRUFBRSxlQUFlLEVBQUUsV0FBVyxFQUFFLGdCQUFnQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRXpGLE1BQU0sRUFBRSxHQUFHLE9BQU8sQ0FBQyxVQUFVLENBQUM7QUFFOUIsMEVBQTBFO0FBQzFFLE1BQU0sa0JBQWtCLEdBQUcsQ0FBQyxPQUE2QixFQUFXLEVBQUU7SUFDcEUsSUFBSSxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQ2IsT0FBTyxLQUFLLENBQUM7SUFDZixDQUFDO0lBQ0QsT0FBTyxlQUFlLENBQUMsT0FBTyxDQUFDO1dBQzFCLEVBQUUsQ0FBQyxpQkFBaUIsQ0FBQyxPQUFPLENBQUM7V0FDN0IsQ0FBQyxFQUFFLENBQUMsbUJBQW1CLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxDQUFDLFlBQVksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLElBQUksU0FBUyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7QUFDdkgsQ0FBQyxDQUFDO0FBRUYsZ0hBQWdIO0FBQ2hILE1BQU0sQ0FBQyxNQUFNLDBCQUEwQixHQUFrQjtJQUN2RCxFQUFFLEVBQUUsMkJBQTJCO0lBQy9CLFFBQVEsRUFBRSxFQUFFLElBQUksRUFBRSxNQUFNLEVBQUU7SUFDMUIsT0FBTyxFQUFFLE1BQU07SUFDZixNQUFNLEVBQUUsQ0FBQyxFQUFFLE9BQU8sRUFBRSxFQUFFLEVBQUU7UUFDdEIsTUFBTSxRQUFRLEdBQW1CLEVBQUUsQ0FBQztRQUNwQyxLQUFLLE1BQU0sUUFBUSxJQUFJLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUM7WUFDakQsSUFBSSxRQUFRLENBQUMsY0FBYyxJQUFJLENBQUMsa0JBQWtCLENBQUMsVUFBVSxDQUFDLFFBQVEsQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDekUsU0FBUztZQUNYLENBQUM7WUFDRCxNQUFNLE9BQU8sR0FBRyxRQUFRLENBQUMsT0FBTyxDQUFDO1lBQ2pDLE1BQU0sSUFBSSxHQUFHLE9BQU8sQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLGtCQUFrQixDQUFDLE9BQU8sRUFBRSxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO1lBQ3RFLElBQUksSUFBSSxLQUFLLFFBQVEsSUFBSSxJQUFJLEtBQUssT0FBTyxJQUFJLENBQUMsT0FBTyxJQUFJLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxPQUFPLEVBQUUsV0FBVyxDQUFDLEtBQUssT0FBTyxDQUFDLEVBQUUsQ0FBQztnQkFDbkgsU0FBUztZQUNYLENBQUM7WUFDRCxRQUFRLENBQUMsSUFBSSxDQUFDO2dCQUNaLElBQUksRUFBRSxRQUFRLENBQUMsSUFBSTtnQkFDbkIsUUFBUSxFQUFFLFFBQVEsQ0FBQyxJQUFJLENBQUMsUUFBUSxFQUFFO2dCQUNsQyxHQUFHLEVBQUUsV0FBVyxDQUFDLFFBQVEsQ0FBQztnQkFDMUIsT0FBTyxFQUFFLGFBQWEsUUFBUSxDQUFDLElBQUksd0ZBQXdGO2dCQUMzSCxHQUFHLEVBQUUsWUFBWSxDQUFDLFFBQVEsRUFBRSxrQkFBa0IsRUFBRSxNQUFNLENBQUM7YUFDeEQsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts/standards/rules/props.reflect-primitive.d.ts

@@ -0,0 +1,5 @@
+import type { IStandardRule } from '../rule.js';
+/** Global attributes with native behaviour that stay unreflected without an allowlist entry. */
+export declare const reflectExemptNames: readonly string[];
+/** A primitive public property declares `reflect: true` or `attribute: false`. */
+export declare const propsReflectPrimitiveRule: IStandardRule;

package/dist_ts/standards/rules/props.reflect-primitive.js

@@ -0,0 +1,41 @@
+import * as ast from '../helpers.ast.js';
+import { addOptionFix } from './props.typed.js';
+import { propertyKey, publicProperties } from './shared.js';
+/** Global attributes with native behaviour that stay unreflected without an allowlist entry. */
+export const reflectExemptNames = ['title', 'hidden', 'dir', 'lang', 'role', 'inert', 'draggable'];
+const primitiveTypes = ['String', 'Number', 'Boolean'];
+/** A primitive public property declares `reflect: true` or `attribute: false`. */
+export const propsReflectPrimitiveRule = {
+    id: 'props/reflect-primitive',
+    severity: { base: 'error' },
+    fixMode: 'opt-in',
+    allowlistCategories: ['user-data', 'object', 'large-text', 'global-attribute'],
+    detect: ({ project }) => {
+        const findings = [];
+        for (const property of publicProperties(project)) {
+            if (property.dynamicOptions || reflectExemptNames.includes(property.name)) {
+                continue;
+            }
+            const options = property.options;
+            const type = options ? ast.objectPropertyText(options, 'type') : null;
+            if (type !== null && !primitiveTypes.includes(type)) {
+                continue;
+            }
+            if (options && (ast.objectPropertyText(options, 'attribute') === 'false' || ast.objectPropertyText(options, 'reflect') === 'true')) {
+                continue;
+            }
+            const explicitReflect = options ? ast.objectProperty(options, 'reflect') : null;
+            findings.push({
+                file: property.file,
+                position: property.call.getStart(),
+                key: propertyKey(property),
+                message: `public primitive @property ${property.name} declares neither reflect: true nor attribute: false`,
+                fix: explicitReflect
+                    ? (builderArg) => builderArg.edit(property.file, explicitReflect.initializer.getStart(), explicitReflect.initializer.end, 'true')
+                    : addOptionFix(property, 'reflect: true', 'last'),
+            });
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvcHMucmVmbGVjdC1wcmltaXRpdmUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvcHJvcHMucmVmbGVjdC1wcmltaXRpdmUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEdBQUcsTUFBTSxtQkFBbUIsQ0FBQztBQUV6QyxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDaEQsT0FBTyxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUU1RCxnR0FBZ0c7QUFDaEcsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQXNCLENBQUMsT0FBTyxFQUFFLFFBQVEsRUFBRSxLQUFLLEVBQUUsTUFBTSxFQUFFLE1BQU0sRUFBRSxPQUFPLEVBQUUsV0FBVyxDQUFDLENBQUM7QUFFdEgsTUFBTSxjQUFjLEdBQUcsQ0FBQyxRQUFRLEVBQUUsUUFBUSxFQUFFLFNBQVMsQ0FBQyxDQUFDO0FBRXZELGtGQUFrRjtBQUNsRixNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBa0I7SUFDdEQsRUFBRSxFQUFFLHlCQUF5QjtJQUM3QixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFO0lBQzNCLE9BQU8sRUFBRSxRQUFRO0lBQ2pCLG1CQUFtQixFQUFFLENBQUMsV0FBVyxFQUFFLFFBQVEsRUFBRSxZQUFZLEVBQUUsa0JBQWtCLENBQUM7SUFDOUUsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsS0FBSyxNQUFNLFFBQVEsSUFBSSxnQkFBZ0IsQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDO1lBQ2pELElBQUksUUFBUSxDQUFDLGNBQWMsSUFBSSxrQkFBa0IsQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7Z0JBQzFFLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxPQUFPLEdBQUcsUUFBUSxDQUFDLE9BQU8sQ0FBQztZQUNqQyxNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsQ0FBQyxPQUFPLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQztZQUN0RSxJQUFJLElBQUksS0FBSyxJQUFJLElBQUksQ0FBQyxjQUFjLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUM7Z0JBQ3BELFNBQVM7WUFDWCxDQUFDO1lBQ0QsSUFBSSxPQUFPLElBQUksQ0FBQyxHQUFHLENBQUMsa0JBQWtCLENBQUMsT0FBTyxFQUFFLFdBQVcsQ0FBQyxLQUFLLE9BQU8sSUFBSSxHQUFHLENBQUMsa0JBQWtCLENBQUMsT0FBTyxFQUFFLFNBQVMsQ0FBQyxLQUFLLE1BQU0sQ0FBQyxFQUFFLENBQUM7Z0JBQ25JLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxlQUFlLEdBQUcsT0FBTyxDQUFDLENBQUMsQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLE9BQU8sRUFBRSxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDO1lBQ2hGLFFBQVEsQ0FBQyxJQUFJLENBQUM7Z0JBQ1osSUFBSSxFQUFFLFFBQVEsQ0FBQyxJQUFJO2dCQUNuQixRQUFRLEVBQUUsUUFBUSxDQUFDLElBQUksQ0FBQyxRQUFRLEVBQUU7Z0JBQ2xDLEdBQUcsRUFBRSxXQUFXLENBQUMsUUFBUSxDQUFDO2dCQUMxQixPQUFPLEVBQUUsOEJBQThCLFFBQVEsQ0FBQyxJQUFJLHNEQUFzRDtnQkFDMUcsR0FBRyxFQUFFLGVBQWU7b0JBQ2xCLENBQUMsQ0FBQyxDQUFDLFVBQVUsRUFBRSxFQUFFLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxFQUFFLGVBQWUsQ0FBQyxXQUFXLENBQUMsUUFBUSxFQUFFLEVBQUUsZUFBZSxDQUFDLFdBQVcsQ0FBQyxHQUFHLEVBQUUsTUFBTSxDQUFDO29CQUNqSSxDQUFDLENBQUMsWUFBWSxDQUFDLFFBQVEsRUFBRSxlQUFlLEVBQUUsTUFBTSxDQUFDO2FBQ3BELENBQUMsQ0FBQztRQUNMLENBQUM7UUFDRCxPQUFPLFFBQVEsQ0FBQztJQUNsQixDQUFDO0NBQ0YsQ0FBQyJ9

package/dist_ts/standards/rules/props.typed.d.ts

@@ -0,0 +1,6 @@
+import type { IStandardProperty } from '../classes.standardproject.js';
+import type { IStandardRule, TFixAction } from '../rule.js';
+/** The edit that adds `propertyTextArg` to a property decorator's options, creating the options literal when absent. */
+export declare const addOptionFix: (propertyArg: IStandardProperty, propertyTextArg: string, placementArg: "first" | "last") => TFixAction;
+/** A public property declares `type`. */
+export declare const propsTypedRule: IStandardRule;

package/dist_ts/standards/rules/props.typed.js

@@ -0,0 +1,64 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { coreTypeOf, isArrayTypeNode, propertyKey, publicProperties } from './shared.js';
+const ts = plugins.typescript;
+/** The Lit `type` that the property's annotation maps to, or null when the annotation does not decide it. */
+const litTypeFor = (propertyArg) => {
+    const typeNode = coreTypeOf(propertyArg);
+    if (!typeNode) {
+        return null;
+    }
+    switch (typeNode.kind) {
+        case ts.SyntaxKind.StringKeyword:
+            return 'String';
+        case ts.SyntaxKind.NumberKeyword:
+            return 'Number';
+        case ts.SyntaxKind.BooleanKeyword:
+            return 'Boolean';
+    }
+    if (ts.isUnionTypeNode(typeNode) && typeNode.types.every((typeArg) => (ts.isLiteralTypeNode(typeArg) && ts.isStringLiteral(typeArg.literal))
+        || typeArg.kind === ts.SyntaxKind.UndefinedKeyword
+        || (ts.isLiteralTypeNode(typeArg) && typeArg.literal.kind === ts.SyntaxKind.NullKeyword))) {
+        return 'String';
+    }
+    if (ts.isLiteralTypeNode(typeNode) && ts.isStringLiteral(typeNode.literal)) {
+        return 'String';
+    }
+    return isArrayTypeNode(typeNode) ? 'Array' : null;
+};
+/** The edit that adds `propertyTextArg` to a property decorator's options, creating the options literal when absent. */
+export const addOptionFix = (propertyArg, propertyTextArg, placementArg) => (builderArg) => {
+    if (propertyArg.options) {
+        const edit = placementArg === 'first'
+            ? ast.prependObjectPropertyEdit(propertyArg.options, propertyTextArg)
+            : ast.appendObjectPropertyEdit(propertyArg.options, propertyTextArg);
+        builderArg.edit(propertyArg.file, edit.start, edit.end, edit.text);
+        return;
+    }
+    const at = propertyArg.call.arguments.pos;
+    builderArg.edit(propertyArg.file, at, at, `{ ${propertyTextArg} }`);
+};
+/** A public property declares `type`. */
+export const propsTypedRule = {
+    id: 'props/typed',
+    severity: { base: 'warn' },
+    fixMode: 'auto',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const property of publicProperties(project)) {
+            if (property.dynamicOptions || (property.options && ast.objectProperty(property.options, 'type'))) {
+                continue;
+            }
+            const litType = litTypeFor(property);
+            findings.push({
+                file: property.file,
+                position: property.call.getStart(),
+                key: propertyKey(property),
+                message: `@property ${property.name} declares no type`,
+                fix: litType ? addOptionFix(property, `type: ${litType}`, 'first') : undefined,
+            });
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvcHMudHlwZWQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9zdGFuZGFyZHMvcnVsZXMvcHJvcHMudHlwZWQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxrQkFBa0IsQ0FBQztBQUM1QyxPQUFPLEtBQUssR0FBRyxNQUFNLG1CQUFtQixDQUFDO0FBR3pDLE9BQU8sRUFBRSxVQUFVLEVBQUUsZUFBZSxFQUFFLFdBQVcsRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUV6RixNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDO0FBRTlCLDZHQUE2RztBQUM3RyxNQUFNLFVBQVUsR0FBRyxDQUFDLFdBQThCLEVBQWlCLEVBQUU7SUFDbkUsTUFBTSxRQUFRLEdBQUcsVUFBVSxDQUFDLFdBQVcsQ0FBQyxDQUFDO0lBQ3pDLElBQUksQ0FBQyxRQUFRLEVBQUUsQ0FBQztRQUNkLE9BQU8sSUFBSSxDQUFDO0lBQ2QsQ0FBQztJQUNELFFBQVEsUUFBUSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQ3RCLEtBQUssRUFBRSxDQUFDLFVBQVUsQ0FBQyxhQUFhO1lBQzlCLE9BQU8sUUFBUSxDQUFDO1FBQ2xCLEtBQUssRUFBRSxDQUFDLFVBQVUsQ0FBQyxhQUFhO1lBQzlCLE9BQU8sUUFBUSxDQUFDO1FBQ2xCLEtBQUssRUFBRSxDQUFDLFVBQVUsQ0FBQyxjQUFjO1lBQy9CLE9BQU8sU0FBUyxDQUFDO0lBQ3JCLENBQUM7SUFDRCxJQUFJLEVBQUUsQ0FBQyxlQUFlLENBQUMsUUFBUSxDQUFDLElBQUksUUFBUSxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUNuRSxDQUFDLEVBQUUsQ0FBQyxpQkFBaUIsQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLENBQUMsZUFBZSxDQUFDLE9BQU8sQ0FBQyxPQUFPLENBQUMsQ0FBQztXQUNuRSxP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

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

@@ -0,0 +1,38 @@
+import * as ast from '../helpers.ast.js';
+import type { IStandardElement, IStandardProperty, StandardProject } from '../classes.standardproject.js';
+import type { IFixBuilder } from '../rule.js';
+export declare const elementsDir = "ts_web/elements";
+/** `ts_web/elements/00group-<area>` or `ts_web/elements` itself. */
+export declare const isElementParentDir: (dirArg: string) => boolean;
+/**
+ * A valid custom element name in the ASCII subset the standard allows: a lowercase letter first,
+ * then lowercase letters, digits, `-`, `.` and `_`, at least one `-`, and not a reserved name. Such
+ * a tag is also a safe file and folder name, so only these tags feed fixes that derive paths or code.
+ */
+export declare const isCustomElementName: (tagArg: string) => boolean;
+/** True when an element's entry file sits in its own element folder `…/<tag>/`. */
+export declare const isInElementFolder: (elementArg: IStandardElement) => boolean;
+/** The `<area>` of `ts_web/elements/00group-<area>/…`, or null. */
+export declare const groupAreaOf: (fileArg: string) => string | null;
+/** Elements outside demo files: the catalog's own elements. */
+export declare const catalogElements: (projectArg: StandardProject) => IStandardElement[];
+/** Public `@property` members outside demo files. */
+export declare const publicProperties: (projectArg: StandardProject) => IStandardProperty[];
+export declare const elementKey: (elementArg: IStandardElement) => string;
+export declare const propertyKey: (propertyArg: IStandardProperty) => string;
+/** The type annotation of a property member without `undefined` and `null` union members. */
+export declare const coreTypeOf: (propertyArg: IStandardProperty) => ast.TTypeNode | null;
+export declare const isArrayTypeNode: (typeArg: ast.TTypeNode) => boolean;
+/** The position at the start of the line after the last `export … from` statement, or at the end of the file. */
+export declare const exportInsertionPoint: (sourceFileArg: ast.TSourceFile) => {
+    position: number;
+    prefix: string;
+};
+/** Adds `export * from '<target>';` to a barrel. */
+export declare const addReexport: (builderArg: IFixBuilder, projectArg: StandardProject, barrelArg: string, targetArg: string) => void;
+/** Removes a whole statement including its line break; from the line start when only indentation precedes it. */
+export declare const removeStatement: (builderArg: IFixBuilder, fileArg: string, statementArg: ast.TNode) => void;
+/** The identifier a `static demo` value refers to at its root, e.g. `demoFunc` or `demos` in `demos.main`. */
+export declare const rootIdentifier: (expressionArg: ast.TExpression) => string | null;
+/** The start of the line following the line a position is on. */
+export declare const nextLineStart: (textArg: string, positionArg: number) => number;