@design.estate/wcctools 6.0.0 → 6.1.0

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;

package/dist_ts/standards/rules/shared.js

@@ -0,0 +1,103 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+import { baseOf, dirOf, specifierFor } from '../helpers.paths.js';
+const ts = plugins.typescript;
+export const elementsDir = 'ts_web/elements';
+/** `ts_web/elements/00group-<area>` or `ts_web/elements` itself. */
+export const isElementParentDir = (dirArg) => dirArg === elementsDir || /^ts_web\/elements\/00group-[^/]+$/.test(dirArg);
+/** Names the HTML specification reserves; `customElements.define` rejects them. */
+const reservedElementNames = ['annotation-xml', 'color-profile', 'font-face', 'font-face-src', 'font-face-uri', 'font-face-format', 'font-face-name', 'missing-glyph'];
+/**
+ * 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 const isCustomElementName = (tagArg) => /^[a-z][a-z0-9._-]*$/.test(tagArg) && tagArg.includes('-') && !reservedElementNames.includes(tagArg);
+/** True when an element's entry file sits in its own element folder `…/<tag>/`. */
+export const isInElementFolder = (elementArg) => {
+    const folder = dirOf(elementArg.file);
+    return !!elementArg.tag && baseOf(folder) === elementArg.tag && isElementParentDir(dirOf(folder));
+};
+/** The `<area>` of `ts_web/elements/00group-<area>/…`, or null. */
+export const groupAreaOf = (fileArg) => /^ts_web\/elements\/00group-([^/]+)\//.exec(fileArg)?.[1] ?? null;
+/** Elements outside demo files: the catalog's own elements. */
+export const catalogElements = (projectArg) => projectArg.elements.filter((elementArg) => !elementArg.inDemoFile);
+/** Public `@property` members outside demo files. */
+export const publicProperties = (projectArg) => projectArg.properties.filter((propertyArg) => propertyArg.decorator === 'property' && propertyArg.isPublic && !propertyArg.inDemoFile);
+export const elementKey = (elementArg) => `${elementArg.file}#${elementArg.className ?? elementArg.tag ?? '?'}`;
+export const propertyKey = (propertyArg) => `${propertyArg.file}#${propertyArg.name}`;
+/** The type annotation of a property member without `undefined` and `null` union members. */
+export const coreTypeOf = (propertyArg) => {
+    const member = propertyArg.member;
+    const typeNode = ts.isPropertyDeclaration(member) ? member.type : undefined;
+    if (!typeNode) {
+        return null;
+    }
+    if (ts.isUnionTypeNode(typeNode)) {
+        const members = typeNode.types.filter((typeArg) => typeArg.kind !== ts.SyntaxKind.UndefinedKeyword
+            && !(ts.isLiteralTypeNode(typeArg) && typeArg.literal.kind === ts.SyntaxKind.NullKeyword));
+        if (members.length === 1) {
+            return members[0];
+        }
+        return typeNode;
+    }
+    return typeNode;
+};
+export const isArrayTypeNode = (typeArg) => {
+    if (ts.isArrayTypeNode(typeArg)) {
+        return true;
+    }
+    if (ts.isTypeOperatorNode(typeArg) && typeArg.operator === ts.SyntaxKind.ReadonlyKeyword) {
+        return ts.isArrayTypeNode(typeArg.type);
+    }
+    return ts.isTypeReferenceNode(typeArg) && ts.isIdentifier(typeArg.typeName) && ['Array', 'ReadonlyArray'].includes(typeArg.typeName.text);
+};
+/** The position at the start of the line after the last `export … from` statement, or at the end of the file. */
+export const exportInsertionPoint = (sourceFileArg) => {
+    let lastEnd = -1;
+    for (const statement of sourceFileArg.statements) {
+        if (ts.isExportDeclaration(statement)) {
+            lastEnd = statement.end;
+        }
+    }
+    const text = sourceFileArg.text;
+    if (lastEnd === -1) {
+        return { position: text.length, prefix: text.length > 0 && !text.endsWith('\n') ? '\n' : '' };
+    }
+    const newline = text.indexOf('\n', lastEnd);
+    return newline === -1 ? { position: text.length, prefix: '\n' } : { position: newline + 1, prefix: '' };
+};
+/** Adds `export * from '<target>';` to a barrel. */
+export const addReexport = (builderArg, projectArg, barrelArg, targetArg) => {
+    const point = exportInsertionPoint(projectArg.sourceFile(barrelArg));
+    builderArg.edit(barrelArg, point.position, point.position, `${point.prefix}export * from '${specifierFor(barrelArg, targetArg, 'js')}';\n`);
+};
+/** Removes a whole statement including its line break; from the line start when only indentation precedes it. */
+export const removeStatement = (builderArg, fileArg, statementArg) => {
+    const text = statementArg.getSourceFile().text;
+    let start = statementArg.getStart();
+    const lineStart = text.lastIndexOf('\n', start - 1) + 1;
+    if (/^[ \t]*$/.test(text.slice(lineStart, start))) {
+        start = lineStart;
+    }
+    let end = statementArg.end;
+    const rest = /^[ \t]*\r?\n/.exec(text.slice(end));
+    if (rest) {
+        end += rest[0].length;
+    }
+    builderArg.edit(fileArg, start, end, '');
+};
+/** The identifier a `static demo` value refers to at its root, e.g. `demoFunc` or `demos` in `demos.main`. */
+export const rootIdentifier = (expressionArg) => {
+    let current = expressionArg;
+    while (ts.isPropertyAccessExpression(current)) {
+        current = current.expression;
+    }
+    return ts.isIdentifier(current) ? current.text : null;
+};
+/** The start of the line following the line a position is on. */
+export const nextLineStart = (textArg, positionArg) => {
+    const newline = textArg.indexOf('\n', positionArg);
+    return newline === -1 ? textArg.length : newline + 1;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hhcmVkLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvc3RhbmRhcmRzL3J1bGVzL3NoYXJlZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sS0FBSyxHQUFHLE1BQU0sbUJBQW1CLENBQUM7QUFDekMsT0FBTyxFQUFFLE1BQU0sRUFBRSxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFJbEUsTUFBTSxFQUFFLEdBQUcsT0FBTyxDQUFDLFVBQVUsQ0FBQztBQUU5QixNQUFNLENBQUMsTUFBTSxXQUFXLEdBQUcsaUJBQWlCLENBQUM7QUFFN0Msb0VBQW9FO0FBQ3BFLE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLENBQUMsTUFBYyxFQUFXLEVBQUUsQ0FDNUQsTUFBTSxLQUFLLFdBQVcsSUFBSSxtQ0FBbUMsQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7QUFFN0UsbUZBQW1GO0FBQ25GLE1BQU0sb0JBQW9CLEdBQUcsQ0FBQyxnQkFBZ0IsRUFBRSxlQUFlLEVBQUUsV0FBVyxFQUFFLGVBQWUsRUFBRSxlQUFlLEVBQUUsa0JBQWtCLEVBQUUsZ0JBQWdCLEVBQUUsZUFBZSxDQUFDLENBQUM7QUFFdks7Ozs7R0FJRztBQUNILE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLENBQUMsTUFBYyxFQUFXLEVBQUUsQ0FDN0QscUJBQXFCLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLE1BQU0sQ0FBQyxRQUFRLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxRQUFRLENBQUMsTUFBTSxDQUFDLENBQUM7QUFFdkcsbUZBQW1GO0FBQ25GLE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLENBQUMsVUFBNEIsRUFBVyxFQUFFO0lBQ3pFLE1BQU0sTUFBTSxHQUFHLEtBQUssQ0FBQyxVQUFVLENB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

package/dist_ts/standards/rules/style.bdtheme.d.ts

@@ -0,0 +1,5 @@
+import type { IStandardRule } from '../rule.js';
+/** The one module that may call `bdTheme()`: the token bridge. */
+export declare const bdThemeBridge = "ts_web/elements/00theme.ts";
+/** dees: no new `cssManager.bdTheme()` call outside `ts_web/elements/00theme.ts`. A ratchet: baselines only. */
+export declare const styleBdThemeRule: IStandardRule;

package/dist_ts/standards/rules/style.bdtheme.js

@@ -0,0 +1,28 @@
+import * as plugins from '../../plugins.js';
+import * as ast from '../helpers.ast.js';
+const ts = plugins.typescript;
+/** The one module that may call `bdTheme()`: the token bridge. */
+export const bdThemeBridge = 'ts_web/elements/00theme.ts';
+/** dees: no new `cssManager.bdTheme()` call outside `ts_web/elements/00theme.ts`. A ratchet: baselines only. */
+export const styleBdThemeRule = {
+    id: 'style/bdtheme',
+    severity: { dees: 'error' },
+    fixMode: 'none',
+    detect: ({ project }) => {
+        const findings = [];
+        for (const file of project.webFiles) {
+            if (file === bdThemeBridge) {
+                continue;
+            }
+            const visit = (nodeArg) => {
+                if (ts.isCallExpression(nodeArg) && ast.calleeName(nodeArg.expression) === 'bdTheme') {
+                    findings.push({ file, position: nodeArg.getStart(), key: file, message: 'bdTheme() call; use --dees-* tokens' });
+                }
+                ts.forEachChild(nodeArg, visit);
+            };
+            visit(project.sourceFile(file));
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3R5bGUuYmR0aGVtZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL3N0YW5kYXJkcy9ydWxlcy9zdHlsZS5iZHRoZW1lLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sa0JBQWtCLENBQUM7QUFDNUMsT0FBTyxLQUFLLEdBQUcsTUFBTSxtQkFBbUIsQ0FBQztBQUd6QyxNQUFNLEVBQUUsR0FBRyxPQUFPLENBQUMsVUFBVSxDQUFDO0FBRTlCLGtFQUFrRTtBQUNsRSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsNEJBQTRCLENBQUM7QUFFMUQsZ0hBQWdIO0FBQ2hILE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFrQjtJQUM3QyxFQUFFLEVBQUUsZUFBZTtJQUNuQixRQUFRLEVBQUUsRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFO0lBQzNCLE9BQU8sRUFBRSxNQUFNO0lBQ2YsTUFBTSxFQUFFLENBQUMsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3RCLE1BQU0sUUFBUSxHQUFtQixFQUFFLENBQUM7UUFDcEMsS0FBSyxNQUFNLElBQUksSUFBSSxPQUFPLENBQUMsUUFBUSxFQUFFLENBQUM7WUFDcEMsSUFBSSxJQUFJLEtBQUssYUFBYSxFQUFFLENBQUM7Z0JBQzNCLFNBQVM7WUFDWCxDQUFDO1lBQ0QsTUFBTSxLQUFLLEdBQUcsQ0FBQyxPQUFrQixFQUFRLEVBQUU7Z0JBQ3pDLElBQUksRUFBRSxDQUFDLGdCQUFnQixDQUFDLE9BQU8sQ0FBQyxJQUFJLEdBQUcsQ0FBQyxVQUFVLENBQUMsT0FBTyxDQUFDLFVBQVUsQ0FBQyxLQUFLLFNBQVMsRUFBRSxDQUFDO29CQUNyRixRQUFRLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxPQUFPLENBQUMsUUFBUSxFQUFFLEVBQUUsR0FBRyxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUscUNBQXFDLEVBQUUsQ0FBQyxDQUFDO2dCQUNuSCxDQUFDO2dCQUNELEVBQUUsQ0FBQyxZQUFZLENBQUMsT0FBTyxFQUFFLEtBQUssQ0FBQyxDQUFDO1lBQ2xDLENBQUMsQ0FBQztZQUNGLEtBQUssQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7UUFDbEMsQ0FBQztRQUNELE9BQU8sUUFBUSxDQUFDO0lBQ2xCLENBQUM7Q0FDRixDQUFDIn0=

package/dist_ts_interfaces/index.d.ts

@@ -1,3 +1,4 @@
 export * from './catalog.js';
 export * from './bridge.js';
 export * from './requests.js';
+export * from './standard.js';

package/dist_ts_interfaces/index.js

@@ -1,4 +1,5 @@
 export * from './catalog.js';
 export * from './bridge.js';
 export * from './requests.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsZUFBZSxDQUFDIn0=
+export * from './standard.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsZUFBZSxDQUFDO0FBQzlCLGNBQWMsZUFBZSxDQUFDIn0=

package/dist_ts_interfaces/standard.d.ts

@@ -0,0 +1,93 @@
+/**
+ * The wcctools component standard (docs/standard.md): its configuration in `.smartconfig.json`
+ * and the reports `wcctools check` and `wcctools fix` produce.
+ */
+/** Rule set a repository adopts. */
+export type TStandardProfile = 'base' | 'dees';
+/** A rule id of the form `<area>/<name>`, e.g. `props/reflect-primitive`. */
+export type TStandardRuleId = string;
+export type TStandardSeverity = 'error' | 'warn' | 'info';
+/**
+ * What `wcctools fix` does for a rule:
+ * - `auto`: fixes it on every run;
+ * - `opt-in`: fixes it only when the rule is named with `--rule`;
+ * - `none`: reports only.
+ */
+export type TStandardFixMode = 'auto' | 'opt-in' | 'none';
+/** `.smartconfig.json` → `@design.estate/wcctools` → `standard`. */
+export interface IStandardConfig {
+    /** Rule set; 'base' when absent. */
+    profile?: TStandardProfile;
+    /** Tag prefix without the trailing hyphen, e.g. 'dees'. */
+    tagPrefix: string;
+    /** dees profile: display name per group area, e.g. { harness: 'Agent Chat' }. */
+    groupNames?: Record<string, string>;
+    /** Exact exceptions: rule id → '<file>#<member>' → '<category>: <reason>'. */
+    allowlist?: Record<TStandardRuleId, Record<string, string>>;
+    /** Accepted counts of error findings: rule id → file → count. Only shrinks. */
+    baselines?: Record<TStandardRuleId, Record<string, number>>;
+}
+/** `.smartconfig.json` → `@design.estate/wcctools`. */
+export interface IWccToolsConfig {
+    standard?: IStandardConfig;
+}
+export interface IStandardFinding {
+    ruleId: TStandardRuleId;
+    severity: TStandardSeverity;
+    /** Path relative to the repository root, '/' separators. */
+    file: string;
+    /** 1-based. */
+    line: number;
+    /** 1-based. */
+    column: number;
+    message: string;
+    /** True when `wcctools fix` resolves this finding (for opt-in rules: with --rule). */
+    fixable: boolean;
+    /** Set when the finding is covered by the allowlist or a baseline and does not fail check. */
+    covered?: 'allowlist' | 'baseline';
+}
+/** A file whose finding count is below its baseline: a candidate for lowering the baseline. */
+export interface IStandardBaselineSlack {
+    ruleId: TStandardRuleId;
+    file: string;
+    baseline: number;
+    current: number;
+}
+export interface IStandardReport {
+    profile: TStandardProfile;
+    findings: IStandardFinding[];
+    /** Files whose count is below their baseline: candidates for --update-baseline. */
+    baselineSlack: IStandardBaselineSlack[];
+    /** True when no error finding remains outside the allowlist and baselines. */
+    ok: boolean;
+}
+/** A rule as it applies in one profile. */
+export interface IStandardRuleInfo {
+    id: TStandardRuleId;
+    severity: TStandardSeverity;
+    fixMode: TStandardFixMode;
+    /** Categories an allowlist entry for this rule may use; empty when the rule takes no allowlist. */
+    allowlistCategories: string[];
+}
+export interface IStandardFileMove {
+    from: string;
+    to: string;
+}
+/** The changes a `wcctools fix` run makes (or, with --dry-run, would make). */
+export interface IStandardFixPlan {
+    /** `git mv` operations, from the original path to the final path. */
+    moves: IStandardFileMove[];
+    /** New files, by final path. */
+    created: string[];
+    /** Changed existing files, by final path, with the rules that changed them. */
+    edited: Array<{
+        file: string;
+        ruleIds: TStandardRuleId[];
+    }>;
+}
+export interface IStandardFixResult {
+    dryRun: boolean;
+    plan: IStandardFixPlan;
+    /** The check after the fix (with --dry-run: as the fix would leave the repository). */
+    remaining: IStandardReport;
+}

package/dist_ts_interfaces/standard.js

@@ -0,0 +1,6 @@
+/**
+ * The wcctools component standard (docs/standard.md): its configuration in `.smartconfig.json`
+ * and the reports `wcctools check` and `wcctools fix` produce.
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RhbmRhcmQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL3N0YW5kYXJkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRyJ9

package/dist_ts_web/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@design.estate/wcctools',
-    version: '6.0.0',
+    version: '6.1.0',
     description: 'A set of web component tools for creating element catalogues, enabling the structured development and documentation of custom elements and pages.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHNfd2ViLzAwX2NvbW1pdGluZm9fZGF0YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4QixJQUFJLEVBQUUseUJBQXlCO0lBQy9CLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSxtSkFBbUo7Q0FDakssQ0FBQSJ9