@oddkin/analyzer 0.0.0-stage → 1.0.0-beta.0

package/dist/stylesheets.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Document stylesheets a package publishes (opt-in CSS such as a reset, page layout classes, and
+ * recipes for native elements: component-contracts.md §2.1), as metadata records an agent or a
+ * documentation site can use without reading the CSS: what to import, its cascade layer, the
+ * classes it defines, the theme tokens it reads, and the variables an author may set.
+ */
+/** One stylesheet, as the package builds it. */
+export interface StylesheetInput {
+    /** File name without `.css`, e.g. `typography`. */
+    readonly name: string;
+    /** The package export that loads it, e.g. `@oddkin/components/css/typography.css`. */
+    readonly import: string;
+    /** The cascade layer its rules are in, e.g. `odd.components`. */
+    readonly layer: string;
+    /** Its rules (without the layer wrapper). */
+    readonly css: string;
+    /** What it is for, from its source documentation. */
+    readonly description?: string;
+    /** Where it is defined, relative to the package root. */
+    readonly source?: {
+        readonly file: string;
+        readonly line: number;
+    };
+}
+/** The published record: `stylesheets["stylesheet:<name>"]`. */
+export interface StylesheetRecord {
+    readonly name: string;
+    readonly import: string;
+    readonly layer: string;
+    readonly description?: string;
+    /** Classes it defines that carry the library prefix, without the dot. */
+    readonly classes: readonly string[];
+    /** Theme tokens it reads, by token name. */
+    readonly tokens: readonly string[];
+    /** Prefixed custom properties it reads that are not theme tokens: hooks an author may set. */
+    readonly variables: readonly string[];
+    readonly source?: {
+        readonly file: string;
+        readonly line: number;
+    };
+}
+/**
+ * Records for `inputs`. `prefix` is the library's class and variable prefix (`odd-`); `tokens`
+ * maps a theme token's CSS variable to its name.
+ */
+export declare function stylesheetRecords(inputs: readonly StylesheetInput[], prefix: string, tokens?: ReadonlyMap<string, string>): Record<string, StylesheetRecord>;
+/**
+ * The documentation of each stylesheet in a module that exports a `mapName` object from file name
+ * to stylesheet constant (`{ reset, 'avatar-group': avatarGroup }`): each key's JSDoc summary
+ * and the line of its constant.
+ */
+export declare function stylesheetDocs(text: string, file: string, mapName?: string): Map<string, {
+    readonly description?: string;
+    readonly line: number;
+}>;
+//# sourceMappingURL=stylesheets.d.ts.map

package/dist/stylesheets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stylesheets.d.ts","sourceRoot":"","sources":["../src/stylesheets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,eAAe,EAAE,EAClC,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAC9C,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAyBlC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,SAAwB,GAC9B,GAAG,CAAC,MAAM,EAAE;IAAE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmCvE"}

package/dist/stylesheets.js

@@ -0,0 +1,83 @@
+/**
+ * Document stylesheets a package publishes (opt-in CSS such as a reset, page layout classes, and
+ * recipes for native elements: component-contracts.md §2.1), as metadata records an agent or a
+ * documentation site can use without reading the CSS: what to import, its cascade layer, the
+ * classes it defines, the theme tokens it reads, and the variables an author may set.
+ */
+import ts from 'typescript';
+const escape = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Records for `inputs`. `prefix` is the library's class and variable prefix (`odd-`); `tokens`
+ * maps a theme token's CSS variable to its name.
+ */
+export function stylesheetRecords(inputs, prefix, tokens = new Map()) {
+    const classPattern = new RegExp(`\\.(${escape(prefix)}[A-Za-z0-9_-]+)`, 'g');
+    const variablePattern = new RegExp(`var\\(\\s*(--${escape(prefix)}[A-Za-z0-9_-]+)`, 'g');
+    const unique = (values) => [...new Set(values)].sort();
+    const records = [...inputs]
+        .sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0))
+        .map((input) => {
+        // Comments can quote selectors that the sheet does not define.
+        const css = input.css.replace(/\/\*[\s\S]*?\*\//g, '');
+        const read = unique([...css.matchAll(variablePattern)].map((m) => m[1]));
+        return [
+            `stylesheet:${input.name}`,
+            {
+                name: input.name,
+                import: input.import,
+                layer: input.layer,
+                ...(input.description ? { description: input.description } : {}),
+                classes: unique([...css.matchAll(classPattern)].map((m) => m[1])),
+                tokens: unique(read.flatMap((v) => (tokens.has(v) ? [tokens.get(v)] : []))),
+                variables: read.filter((v) => !tokens.has(v)),
+                ...(input.source ? { source: input.source } : {}),
+            },
+        ];
+    });
+    return Object.fromEntries(records);
+}
+/**
+ * The documentation of each stylesheet in a module that exports a `mapName` object from file name
+ * to stylesheet constant (`{ reset, 'avatar-group': avatarGroup }`): each key's JSDoc summary
+ * and the line of its constant.
+ */
+export function stylesheetDocs(text, file, mapName = 'documentStylesheets') {
+    const source = ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true);
+    const declarations = new Map();
+    for (const statement of source.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const d of statement.declarationList.declarations)
+            if (ts.isIdentifier(d.name))
+                declarations.set(d.name.text, d);
+    }
+    let literal = declarations.get(mapName)?.initializer;
+    while (literal && (ts.isAsExpression(literal) || ts.isSatisfiesExpression(literal)))
+        literal = literal.expression;
+    const docs = new Map();
+    if (!literal || !ts.isObjectLiteralExpression(literal))
+        return docs;
+    for (const p of literal.properties) {
+        const key = p.name && (ts.isIdentifier(p.name) || ts.isStringLiteral(p.name)) ? p.name.text : '';
+        const constant = ts.isShorthandPropertyAssignment(p)
+            ? p.name.text
+            : ts.isPropertyAssignment(p) && ts.isIdentifier(p.initializer)
+                ? p.initializer.text
+                : '';
+        const d = declarations.get(constant);
+        if (!key || !d)
+            continue;
+        const description = ts
+            .getJSDocCommentsAndTags(d)
+            .map((doc) => (ts.isJSDoc(doc) ? (ts.getTextOfJSDocComment(doc.comment) ?? '') : ''))
+            .join(' ')
+            .replace(/\s+/g, ' ')
+            .trim();
+        docs.set(key, {
+            ...(description ? { description } : {}),
+            line: source.getLineAndCharacterOfPosition(d.parent.parent.getStart()).line + 1,
+        });
+    }
+    return docs;
+}
+//# sourceMappingURL=stylesheets.js.map

package/dist/stylesheets.js.map

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

package/dist/verification.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Attach test evidence to `oddkin.metadata.json` as `verified` facts (metadata-and-analyzer.md
+ * §3). Evidence is `conformance-result.v1` records whose configuration names the exact inputs
+ * tested (`manifest`, `sources` hashes). A fact is verified only when every required browser has
+ * a record for the current inputs and the case passed in each; stale, failed, or missing evidence
+ * leaves it unverified and is reported. Pure: callers read files and compute hashes.
+ */
+export interface ResultRecord {
+    readonly suite: {
+        readonly id: string;
+        readonly version: string;
+    };
+    readonly implementation: {
+        readonly tag: string;
+        readonly package?: string;
+    };
+    readonly configuration: Readonly<Record<string, string>>;
+    readonly date: string;
+    readonly results: readonly {
+        readonly case: string;
+        readonly state: 'passed' | 'failed' | 'not-executed';
+        readonly message?: string;
+    }[];
+}
+export interface VerificationInputs {
+    /** Hash of each input a record must match, e.g. `{ manifest, sources }`. */
+    readonly inputs: Readonly<Record<string, string>>;
+    /** Browsers that must all have passed a case for it to be verified. */
+    readonly browsers: readonly string[];
+    /** The test file that produced the records (recorded as the fact source). */
+    readonly test: string;
+    /** Tags that must have current evidence; a tag without any is reported missing in every browser. */
+    readonly require?: readonly string[];
+}
+export interface VerificationReport {
+    readonly verified: Readonly<Record<string, number>>;
+    readonly failed: readonly {
+        tag: string;
+        browser: string;
+        case: string;
+        message?: string;
+    }[];
+    readonly notExecuted: readonly {
+        tag: string;
+        case: string;
+    }[];
+    /** Records for other inputs than the current ones (ignored). */
+    readonly stale: readonly {
+        tag: string;
+        browser: string;
+    }[];
+    /** Required browsers without a current record, per tag. */
+    readonly missing: readonly {
+        tag: string;
+        browser: string;
+    }[];
+}
+export declare function attachVerification(metadata: Readonly<Record<string, unknown>>, records: readonly ResultRecord[], options: VerificationInputs): {
+    metadata: Record<string, unknown>;
+    report: VerificationReport;
+};
+//# sourceMappingURL=verification.d.ts.map

package/dist/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../src/verification.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAClE,QAAQ,CAAC,cAAc,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7E,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,cAAc,CAAC;QACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,EAAE,CAAC;CACL;AAED,MAAM,WAAW,kBAAkB;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oGAAoG;IACpG,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7F,QAAQ,CAAC,WAAW,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5D,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/D;AAsBD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC3C,OAAO,EAAE,SAAS,YAAY,EAAE,EAChC,OAAO,EAAE,kBAAkB,GAC1B;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,kBAAkB,CAAA;CAAE,CA8FnE"}

package/dist/verification.js

@@ -0,0 +1,115 @@
+/**
+ * Attach test evidence to `oddkin.metadata.json` as `verified` facts (metadata-and-analyzer.md
+ * §3). Evidence is `conformance-result.v1` records whose configuration names the exact inputs
+ * tested (`manifest`, `sources` hashes). A fact is verified only when every required browser has
+ * a record for the current inputs and the case passed in each; stale, failed, or missing evidence
+ * leaves it unverified and is reported. Pure: callers read files and compute hashes.
+ */
+const sortedKeys = (value) => Object.fromEntries(Object.entries(value).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)));
+/** Stable short id of a run's inputs (FNV-1a over the suite and input hashes). */
+function runId(suite, inputs) {
+    let hash = 0x811c9dc5;
+    for (const char of `${suite}\u0000${JSON.stringify(sortedKeys(inputs))}`) {
+        hash ^= char.charCodeAt(0);
+        hash = Math.imul(hash, 0x01000193) >>> 0;
+    }
+    return `run-${hash.toString(16).padStart(8, '0')}`;
+}
+export function attachVerification(metadata, records, options) {
+    const components = {
+        ...(metadata['components'] ?? {}),
+    };
+    const stale = [];
+    const groups = new Map();
+    for (const record of records) {
+        const browser = record.configuration['browser'] ?? 'unknown';
+        const tag = record.implementation.tag;
+        const current = Object.entries(options.inputs).every(([key, hash]) => record.configuration[key] === hash);
+        if (!current) {
+            stale.push({ tag, browser });
+            continue;
+        }
+        const suite = `${record.suite.id}@${record.suite.version}`;
+        const key = `${suite}\u0000${tag}`;
+        const group = groups.get(key) ?? {
+            suite,
+            tag,
+            ...(record.implementation.package ? { pkg: record.implementation.package } : {}),
+            byBrowser: new Map(),
+        };
+        groups.set(key, group);
+        const previous = group.byBrowser.get(browser);
+        if (!previous || previous.date < record.date)
+            group.byBrowser.set(browser, record);
+    }
+    const verified = {};
+    const failed = [];
+    const notExecuted = [];
+    const missing = [];
+    const evidenced = new Set([...groups.values()].map((g) => g.tag));
+    for (const tag of options.require ?? [])
+        if (!evidenced.has(tag))
+            for (const browser of options.browsers)
+                missing.push({ tag, browser });
+    const entries = new Map();
+    for (const group of [...groups.values()].sort((a, b) => a.tag === b.tag ? (a.suite < b.suite ? -1 : 1) : a.tag < b.tag ? -1 : 1)) {
+        const absent = options.browsers.filter((b) => !group.byBrowser.has(b));
+        for (const browser of absent)
+            missing.push({ tag: group.tag, browser });
+        if (absent.length)
+            continue;
+        const used = options.browsers.map((b) => [b, group.byBrowser.get(b)]);
+        const cases = new Set(used.flatMap(([, r]) => r.results.map((x) => x.case)));
+        const facts = [];
+        for (const id of [...cases].sort()) {
+            const outcomes = used.map(([browser, r]) => ({
+                browser,
+                result: r.results.find((x) => x.case === id),
+            }));
+            for (const { browser, result } of outcomes)
+                if (result?.state === 'failed')
+                    failed.push({
+                        tag: group.tag,
+                        browser,
+                        case: id,
+                        ...(result.message ? { message: result.message } : {}),
+                    });
+            if (outcomes.every((o) => o.result?.state === 'passed'))
+                facts.push(id);
+            else if (outcomes.some((o) => !o.result || o.result.state === 'not-executed'))
+                notExecuted.push({ tag: group.tag, case: id });
+        }
+        if (!components[`component:${group.tag}`] || !facts.length)
+            continue;
+        verified[group.tag] = (verified[group.tag] ?? 0) + facts.length;
+        const date = used.map(([, r]) => r.date).sort()[used.length - 1];
+        const list = entries.get(group.tag) ?? [];
+        list.push({
+            suite: group.suite,
+            provenance: 'verified',
+            source: { test: options.test, run: runId(group.suite, options.inputs), date },
+            conditions: {
+                browsers: used.map(([name, r]) => ({
+                    name,
+                    version: r.configuration['browserVersion'] ?? 'unknown',
+                })),
+                ...(group.pkg ? { package: group.pkg } : {}),
+                inputs: sortedKeys(options.inputs),
+            },
+            facts,
+        });
+        entries.set(group.tag, list);
+    }
+    // Replace any earlier evidence: what is attached now is exactly what the current records show.
+    for (const [id, component] of Object.entries(components)) {
+        const tag = component['tag'] ?? id.replace(/^component:/, '');
+        const { verification: _previous, ...rest } = component;
+        const list = entries.get(tag);
+        components[id] = list ? { ...rest, verification: list } : rest;
+    }
+    return {
+        metadata: { ...metadata, components },
+        report: { verified, failed, notExecuted, stale, missing },
+    };
+}
+//# sourceMappingURL=verification.js.map

package/dist/verification.js.map

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

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@oddkin/analyzer",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0-beta.0",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brianchristopherbrady/oddkin.git",
+    "directory": "packages/analyzer"
+  },
+  "description": "Node-only static analysis of Oddkin component libraries: Custom Elements Manifest and oddkin.metadata.json, without executing component code.",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=24.12"
+  },
+  "bin": {
+    "oddkin-analyze": "dist/bin.js",
+    "oddkin-impact": "dist/impact-bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./impact": {
+      "types": "./dist/impact.d.ts",
+      "default": "./dist/impact.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "typescript": "5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  }
+}