@dsgraph/report 0.0.0-stage → 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adam Reznik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,8 @@
-# Temporary Holding Version
+# @dsgraph/report
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Formatters for changesets and findings: `text`, `markdown`, `json`. Propagated value changes are listed under the direct change that caused them; values are shown as hex, px, ΔE.
+
+```ts
+import { formatChangeset, formatFindings } from '@dsgraph/report'
+console.log(formatChangeset(changeset, { format: 'markdown' }))
+```

package/dist/changeset.d.ts

@@ -0,0 +1,18 @@
+import type { Changeset, Impact } from '@dsgraph/core';
+import { formatValue } from './values.js';
+export type Format = 'text' | 'markdown' | 'json';
+export interface ChangesetFormatOptions {
+    format?: Format;
+    /** Token types by id (from the head graph) for value formatting. */
+    types?: Map<string, string | null>;
+    /** Max propagated targets listed under a cause. */
+    maxPropagated?: number;
+    /** Where the changes reach into a project's code (`impactOf`); adds the places under each change. */
+    impact?: Impact;
+    /** Max places listed under a change. */
+    maxSites?: number;
+}
+/** Formats a changeset. Propagated value changes are listed under the direct change that caused them. */
+export declare function formatChangeset(cs: Changeset, opts?: ChangesetFormatOptions): string;
+export { formatValue };
+//# sourceMappingURL=changeset.d.ts.map

package/dist/changeset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeset.d.ts","sourceRoot":"","sources":["../src/changeset.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,SAAS,EAAE,MAAM,EAAS,MAAM,eAAe,CAAA;AACnF,OAAO,EAAyC,WAAW,EAAc,MAAM,aAAa,CAAA;AAE5F,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;AAmEjD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oEAAoE;IACpE,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;IAClC,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAYD,yGAAyG;AACzG,wBAAgB,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,GAAE,sBAA2B,GAAG,MAAM,CA8ExF;AAcD,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/changeset.js

@@ -0,0 +1,163 @@
+import { formatDelta, formatSide, formatSource, formatValue, formatWhen } from './values.js';
+const LEVEL_TITLE = {
+    major: 'Breaking (major)',
+    minor: 'Minor',
+    patch: 'Patch',
+    none: 'No impact',
+};
+const typeOf = (c) => {
+    const side = (c.after ?? c.before);
+    if (side && typeof side === 'object' && 'type' in side)
+        return side.type ?? null;
+    return null;
+};
+/** One line describing a change; `type` comes from the head token when known. */
+function describe(c, types, code) {
+    const t = types.get(c.target) ?? typeOf(c);
+    const where = formatWhen(c.when);
+    switch (c.kind) {
+        case 'token.added':
+            return `added ${code(c.target)}`;
+        case 'token.removed': {
+            const maybe = c.possibleRenames?.length
+                ? ` — possibly renamed to ${c.possibleRenames.map(code).join(' or ')}`
+                : '';
+            return `removed ${code(c.target)}${maybe}`;
+        }
+        case 'token.renamed':
+            return `renamed ${code(c.from ?? '?')} → ${code(c.target)}${c.confidence < 0.8 ? ` (likely, ${Math.round(c.confidence * 100)}%)` : ''}`;
+        case 'token.value-changed': {
+            const delta = formatDelta(c.delta);
+            return `${code(c.target)}${where}: ${formatSide(t, c.before)} → ${formatSide(t, c.after)}${delta ? ` (${delta})` : ''}`;
+        }
+        case 'token.notation-changed':
+            return `${code(c.target)}${where}: same value, written differently`;
+        case 'token.alias-retargeted':
+            return `${code(c.target)}${where}: now ${formatSide(t, c.after)}, same value`;
+        case 'token.type-changed':
+            return `${code(c.target)}: type ${String(c.before)} → ${String(c.after)}`;
+        case 'token.missing-in-context':
+            return `${code(c.target)} is no longer defined${where}`;
+        case 'token.contexts-changed':
+            return `${code(c.target)}: depends on ${JSON.stringify(c.before)} → ${JSON.stringify(c.after)}`;
+        case 'token.deprecated': {
+            const d = c.after;
+            return `deprecated ${code(c.target)}${d?.replacement ? ` — use ${code(d.replacement)}` : d?.reason ? ` — ${d.reason}` : ''}`;
+        }
+        case 'token.undeprecated':
+            return `no longer deprecated ${code(c.target)}`;
+        case 'token.description-changed':
+            return `${code(c.target)}: description changed`;
+        case 'token.extensions-changed':
+            return `${code(c.target)}: $extensions changed`;
+        case 'group.extends-changed':
+            return `group ${code(c.target)}: $extends ${String(c.before ?? '—')} → ${String(c.after ?? '—')}`;
+        case 'context.added':
+        case 'context.removed':
+            return `${c.kind === 'context.added' ? 'added' : 'removed'} context ${code(c.target)}`;
+        case 'modifier.added':
+        case 'modifier.removed':
+            return `${c.kind === 'modifier.added' ? 'added' : 'removed'} modifier ${code(c.target)}`;
+        default:
+            return `${c.kind} ${code(c.target)}`;
+    }
+}
+const plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+/** `src/button.css:12, src/card.scss:4 and 3 more` */
+function sitesLine(ci, max, code) {
+    const listed = ci.sites.slice(0, max).map((s) => code(`${s.file}:${s.line}`));
+    const more = ci.sites.length > max ? ` and ${ci.sites.length - max} more` : '';
+    const verb = ci.effect === 'breaks' ? 'breaks' : 'changes';
+    return `${verb} ${plural(ci.sites.length, 'place')} in the code: ${listed.join(', ')}${more}`;
+}
+/** Formats a changeset. Propagated value changes are listed under the direct change that caused them. */
+export function formatChangeset(cs, opts = {}) {
+    const format = opts.format ?? 'text';
+    if (format === 'json')
+        return `${JSON.stringify(opts.impact ? { ...cs, impact: opts.impact } : cs, null, 2)}\n`;
+    const md = format === 'markdown';
+    const code = (s) => (md ? `\`${s}\`` : s);
+    const types = opts.types ?? new Map();
+    const max = opts.maxPropagated ?? 5;
+    const maxSites = opts.maxSites ?? 5;
+    const impactBy = new Map((opts.impact?.changes ?? []).map((ci) => [ci.change, ci]));
+    const propagatedBy = new Map();
+    for (const c of cs.changes)
+        for (const cause of c.cause)
+            propagatedBy.set(cause, [...(propagatedBy.get(cause) ?? []), c]);
+    const shown = cs.changes.filter((c) => !(c.origin === 'propagated' && c.cause.length > 0));
+    const counts = cs.summary.counts;
+    const summary = [
+        counts.removed ? `${counts.removed} removed` : '',
+        counts.renamed ? `${counts.renamed} renamed` : '',
+        counts.changed
+            ? `${counts.changed} changed${counts.propagated ? ` (+${counts.propagated} through references)` : ''}`
+            : '',
+        counts.added ? `${counts.added} added` : '',
+        counts.deprecated ? `${counts.deprecated} deprecated` : '',
+    ].filter(Boolean);
+    const lines = [];
+    const title = cs.changes.length === 0 ? 'no changes' : `suggested bump: ${cs.summary.level}`;
+    if (md) {
+        lines.push(`## dsgraph diff — ${title}`, '');
+        lines.push(`${formatSource(cs.base.source)} → ${formatSource(cs.head.source)}`, '');
+        if (summary.length)
+            lines.push(`**${summary.join(' · ')}**`, '');
+        if (opts.impact)
+            lines.push(impactSummary(opts.impact), '');
+    }
+    else {
+        lines.push(`dsgraph diff — ${title}`, `${formatSource(cs.base.source)} → ${formatSource(cs.head.source)}`);
+        if (summary.length)
+            lines.push(summary.join(' · '));
+        if (opts.impact)
+            lines.push(impactSummary(opts.impact));
+        lines.push('');
+    }
+    for (const level of ['major', 'minor', 'patch', 'none']) {
+        const group = shown.filter((c) => c.level === level);
+        if (group.length === 0)
+            continue;
+        const collapsible = md && (level === 'patch' || level === 'none');
+        if (collapsible)
+            lines.push(`<details><summary>${LEVEL_TITLE[level]} (${group.length})</summary>`, '');
+        else
+            lines.push(md ? `### ${LEVEL_TITLE[level]} (${group.length})` : `${LEVEL_TITLE[level]} (${group.length})`, '');
+        for (const c of group) {
+            lines.push(`${md ? '- ' : '  '}${describe(c, types, code)}`);
+            const via = propagatedBy.get(c.id);
+            if (via?.length) {
+                const names = [...new Set(via.map((p) => p.target))];
+                const listed = names.slice(0, max).map(code).join(', ');
+                lines.push(`${md ? '  - ' : '      '}affects ${listed}${names.length > max ? ` and ${names.length - max} more` : ''}`);
+            }
+            const ci = impactBy.get(c.id);
+            if (ci)
+                lines.push(`${md ? '  - ' : '      '}${sitesLine(ci, maxSites, code)}`);
+        }
+        lines.push('');
+        if (collapsible)
+            lines.push('</details>', '');
+    }
+    if (cs.contexts.partial)
+        lines.push(md
+            ? '> Some contexts were not fully compared (too many permutations).'
+            : 'Note: some contexts were not fully compared.', '');
+    return `${lines
+        .join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trimEnd()}\n`;
+}
+function impactSummary(impact) {
+    if (impact.breaks === 0 && impact.looksDifferent === 0)
+        return 'In the code: nothing uses the changed tokens.';
+    const parts = [
+        impact.breaks ? `${plural(impact.breaks, 'place')} ${impact.breaks === 1 ? 'breaks' : 'break'}` : '',
+        impact.looksDifferent
+            ? `${plural(impact.looksDifferent, 'place')} ${impact.looksDifferent === 1 ? 'looks' : 'look'} different`
+            : '',
+    ].filter(Boolean);
+    return `In the code: ${parts.join(', ')} (${plural(impact.files.length, 'file')}).`;
+}
+export { formatValue };
+//# sourceMappingURL=changeset.js.map

package/dist/changeset.js.map

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

package/dist/findings.d.ts

@@ -0,0 +1,29 @@
+import type { Finding, Severity } from '@dsgraph/core';
+import type { Format } from './changeset.js';
+export interface FindingGroup {
+    rule: string;
+    severity: Severity;
+    /** The message with quoted values replaced by `"…"`; the message itself for a group of one. */
+    pattern: string;
+    findings: Finding[];
+    /** The file shared by every finding, if any. */
+    file?: string;
+}
+/** Groups repeated findings: same rule, same severity, same message up to quoted values and numbers. Order is kept. */
+export declare function groupFindings(findings: readonly Finding[]): FindingGroup[];
+/** What tells one finding of a group from another: its token, else the quoted values of its message. */
+export declare function findingLabel(f: Finding): string;
+export interface FindingsFormatOptions {
+    format?: Format;
+    /**
+     * Collapse repeated findings (default true). Text lists `examples` labels per group;
+     * Markdown puts every finding of a group into a `<details>` block, up to `maxListed`.
+     */
+    group?: boolean;
+    examples?: number;
+    maxListed?: number;
+    /** Markdown: start with the `## dsgraph check — …` heading (default true). */
+    heading?: boolean;
+}
+export declare function formatFindings(findings: readonly Finding[], opts?: FindingsFormatOptions): string;
+//# sourceMappingURL=findings.d.ts.map

package/dist/findings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings.d.ts","sourceRoot":"","sources":["../src/findings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAS5C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,+FAA+F;IAC/F,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAOD,uHAAuH;AACvH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,YAAY,EAAE,CAgB1E;AAYD,wGAAwG;AACxG,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAG/C;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAUD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,GAAE,qBAA0B,GAAG,MAAM,CAyErG"}

package/dist/findings.js

@@ -0,0 +1,105 @@
+import { formatWhen } from './values.js';
+const ICON = { error: '✖', warning: '▲', info: '•' };
+/** Findings of one rule whose messages differ only in quoted values (`Color "…" is a string`). */
+/** `file:line` when a finding points into code, the file alone otherwise. */
+const where = (loc) => `${loc.file}${loc.line ? `:${loc.line}` : ''}`;
+const QUOTED = /"[^"]*"/g;
+/** What differs between repeated messages: quoted values and numbers (`steps 0 and 1`). */
+const VARIABLE = /"[^"]*"|\b\d+(?:\.\d+)?\b/g;
+const mask = (part) => (part.startsWith('"') ? '"…"' : '…');
+/** Groups repeated findings: same rule, same severity, same message up to quoted values and numbers. Order is kept. */
+export function groupFindings(findings) {
+    const groups = new Map();
+    for (const f of findings) {
+        const pattern = f.message.replace(VARIABLE, mask);
+        const key = `${f.severity}\u0000${f.rule}\u0000${pattern}`;
+        const g = groups.get(key);
+        if (g)
+            g.findings.push(f);
+        else
+            groups.set(key, { rule: f.rule, severity: f.severity, pattern, findings: [f] });
+    }
+    for (const g of groups.values()) {
+        g.pattern = restoreShared(g.findings.map((f) => f.message));
+        const files = new Set(g.findings.map((f) => f.loc?.file));
+        const [file] = files;
+        if (files.size === 1 && file)
+            g.file = file;
+    }
+    return [...groups.values()];
+}
+/** Masks only the values that differ between messages; a shared one stays (`use "px"`, `2025.10`). */
+function restoreShared(messages) {
+    const parts = messages.map((m) => m.match(VARIABLE) ?? []);
+    let i = 0;
+    return messages[0].replace(VARIABLE, (q) => {
+        const k = i++;
+        return parts.every((ps) => ps[k] === q) ? q : mask(q);
+    });
+}
+/** What tells one finding of a group from another: its token, else the quoted values of its message. */
+export function findingLabel(f) {
+    const subject = f.nodes[0] ?? f.message.match(QUOTED)?.join(' ') ?? f.message;
+    return `${subject}${formatWhen(f.when)}`;
+}
+const summaryOf = (findings) => {
+    const counts = { error: 0, warning: 0, info: 0 };
+    for (const f of findings)
+        counts[f.severity]++;
+    return `${counts.error} errors · ${counts.warning} warnings · ${counts.info} info`;
+};
+const cell = (s) => s.replace(/\|/g, '\\|');
+export function formatFindings(findings, opts = {}) {
+    const format = opts.format ?? 'text';
+    if (format === 'json')
+        return `${JSON.stringify(findings, null, 2)}\n`;
+    const grouped = opts.group ?? true;
+    const md = format === 'markdown';
+    if (findings.length === 0)
+        return md ? '## dsgraph check — no findings\n' : 'dsgraph check — no findings\n';
+    const summary = summaryOf(findings);
+    const head = opts.heading === false ? '' : `## dsgraph check — ${summary}\n\n`;
+    if (md) {
+        if (!grouped) {
+            const rows = findings.map((f) => `| ${ICON[f.severity]} ${f.severity} | \`${f.rule}\` | ${cell(f.message)}${formatWhen(f.when)} | ${f.loc?.file ? `\`${where(f.loc)}\`` : ''} |`);
+            return `${head}| | Rule | Finding | File |\n|---|---|---|---|\n${rows.join('\n')}\n`;
+        }
+        const groups = groupFindings(findings);
+        const max = opts.maxListed ?? 50;
+        const rows = groups.map((g) => `| ${ICON[g.severity]} ${g.severity} | \`${g.rule}\` | ${g.findings.length} | ${cell(g.pattern)}${g.findings.length === 1 ? formatWhen(g.findings[0].when) : ''} | ${g.findings.length === 1 && g.findings[0].loc?.file ? `\`${where(g.findings[0].loc)}\`` : g.file ? `\`${g.file}\`` : ''} |`);
+        const details = groups
+            .filter((g) => g.findings.length > 1)
+            .map((g) => {
+            const items = g.findings
+                .slice(0, max)
+                .map((f) => `- ${cell(f.message)}${formatWhen(f.when)}${f.loc?.line ? ` — \`${where(f.loc)}\`` : f.nodes[0] ? ` — \`${f.nodes[0]}\`` : ''}`);
+            if (g.findings.length > max)
+                items.push(`- … and ${g.findings.length - max} more`);
+            return `<details><summary>${ICON[g.severity]} <code>${g.rule}</code> — ${g.findings.length} × ${escapeHtml(g.pattern)}</summary>\n\n${items.join('\n')}\n\n</details>`;
+        });
+        return `${head}| | Rule | Count | Finding | File |\n|---|---|---|---|---|\n${rows.join('\n')}\n${details.length ? `\n${details.join('\n\n')}\n` : ''}`;
+    }
+    const line = (severity, rule, text) => `${ICON[severity]} ${severity.padEnd(7)} ${rule.padEnd(30)} ${text}`;
+    if (!grouped)
+        return `dsgraph check — ${summary}\n\n${findings
+            .map((f) => line(f.severity, f.rule, `${f.message}${formatWhen(f.when)}${f.loc?.file ? `  (${where(f.loc)})` : ''}`))
+            .join('\n')}\n`;
+    const examples = opts.examples ?? 3;
+    const indent = ' '.repeat(41);
+    const lines = [];
+    for (const g of groupFindings(findings)) {
+        const n = g.findings.length;
+        const file = g.file ? `  (${g.file})` : '';
+        if (n === 1) {
+            const f = g.findings[0];
+            lines.push(line(f.severity, f.rule, `${f.message}${formatWhen(f.when)}${f.loc?.file ? `  (${where(f.loc)})` : ''}`));
+            continue;
+        }
+        lines.push(line(g.severity, g.rule, `${n}× ${g.pattern}${file}`));
+        const labels = g.findings.slice(0, examples).map(findingLabel);
+        lines.push(`${indent}${labels.join(', ')}${n > examples ? `, … and ${n - examples} more` : ''}`);
+    }
+    return `dsgraph check — ${summary}\n\n${lines.join('\n')}\n`;
+}
+const escapeHtml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+//# sourceMappingURL=findings.js.map

package/dist/findings.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { type ChangesetFormatOptions, type Format, formatChangeset } from './changeset.js';
+export { type FindingGroup, type FindingsFormatOptions, findingLabel, formatFindings, groupFindings, } from './findings.js';
+export { formatDelta, formatSide, formatSource, formatValue, formatWhen } from './values.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,sBAAsB,EAAE,KAAK,MAAM,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { formatChangeset } from './changeset.js';
+export { findingLabel, formatFindings, groupFindings, } from './findings.js';
+export { formatDelta, formatSide, formatSource, formatValue, formatWhen } from './values.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EAGL,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA"}

package/dist/values.d.ts

@@ -0,0 +1,12 @@
+import { type SourceMeta } from '@dsgraph/core';
+/**
+ * Short human-readable form of a canonical value. Never throws: a value that does not have the
+ * shape of its type (a source error) is shown as it is.
+ */
+export declare function formatValue(type: string | null, value: unknown): string;
+/** Value of a changeset side (`{ raw, value }`) with the alias it came from, if any. */
+export declare function formatSide(type: string | null, side: unknown): string;
+export declare function formatDelta(delta: Record<string, unknown> | undefined): string;
+export declare function formatSource(s: SourceMeta): string;
+export declare const formatWhen: (when: Record<string, string> | null | undefined) => string;
+//# sourceMappingURL=values.d.ts.map

package/dist/values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.d.ts","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,KAAK,UAAU,EAAE,MAAM,eAAe,CAAA;AAQ5E;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,CAMvE;AA8CD,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAKrE;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAqB9E;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAMlD;AAED,eAAO,MAAM,UAAU,SAAU,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,KAAG,MAKrE,CAAA"}

package/dist/values.js

@@ -0,0 +1,112 @@
+import { colorToHex } from '@dsgraph/core';
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+const plain = (value) => typeof value === 'string' || typeof value === 'number' ? String(value) : JSON.stringify(value);
+/**
+ * Short human-readable form of a canonical value. Never throws: a value that does not have the
+ * shape of its type (a source error) is shown as it is.
+ */
+export function formatValue(type, value) {
+    try {
+        return formatTyped(type, value);
+    }
+    catch {
+        return plain(value);
+    }
+}
+function formatTyped(type, value) {
+    if (value === null || value === undefined)
+        return '—';
+    switch (type) {
+        case 'color': {
+            if (!isObj(value) || !Array.isArray(value.components))
+                return plain(value);
+            const c = value;
+            const hex = colorToHex(c);
+            const alpha = c.alpha < 1 ? ` ${Math.round(c.alpha * 100)}%` : '';
+            return c.space === 'srgb' ? `${hex}${alpha}` : `${hex}${alpha} (${c.space})`;
+        }
+        case 'dimension':
+        case 'duration': {
+            const d = value;
+            return `${d.value}${d.unit}`;
+        }
+        case 'fontFamily':
+            return value.join(', ');
+        case 'cubicBezier':
+            return `cubic-bezier(${value.join(', ')})`;
+        case 'shadow':
+            return value
+                .map((l) => [
+                l.inset ? 'inset' : '',
+                ...['offsetX', 'offsetY', 'blur', 'spread'].map((k) => formatValue('dimension', l[k])),
+                formatValue('color', l.color),
+            ]
+                .filter(Boolean)
+                .join(' '))
+                .join(', ');
+        case 'border': {
+            const b = value;
+            return `${formatValue('dimension', b.width)} ${typeof b.style === 'string' ? b.style : 'dashed'} ${formatValue('color', b.color)}`;
+        }
+        case 'typography': {
+            const t = value;
+            return `${formatValue('fontWeight', t.fontWeight)} ${formatValue('dimension', t.fontSize)}/${t.lineHeight ?? '—'} ${formatValue('fontFamily', t.fontFamily)}`;
+        }
+        default:
+            return plain(value);
+    }
+}
+/** Value of a changeset side (`{ raw, value }`) with the alias it came from, if any. */
+export function formatSide(type, side) {
+    if (!isObj(side))
+        return formatValue(type, side);
+    const v = formatValue(type, side.value);
+    const raw = typeof side.raw === 'string' && /^\{[^{}]+\}$/.test(side.raw) ? ` ← ${side.raw}` : '';
+    return `${v}${raw}`;
+}
+export function formatDelta(delta) {
+    if (!delta)
+        return '';
+    const parts = [];
+    if (typeof delta.deltaEOK === 'number')
+        parts.push(`ΔE ${delta.deltaEOK}`);
+    if (typeof delta.deltaAlpha === 'number')
+        parts.push(`α ${delta.deltaAlpha > 0 ? '+' : ''}${delta.deltaAlpha}`);
+    if (typeof delta.px === 'number')
+        parts.push(`${delta.px > 0 ? '+' : ''}${delta.px}px`);
+    if (typeof delta.ms === 'number')
+        parts.push(`${delta.ms > 0 ? '+' : ''}${delta.ms}ms`);
+    if (typeof delta.by === 'number')
+        parts.push(`${delta.by > 0 ? '+' : ''}${delta.by}`);
+    if (Array.isArray(delta.fields))
+        parts.push(`changed: ${delta.fields.join(', ')}`);
+    for (const [k, one] of [
+        ['layers', 'layer'],
+        ['stops', 'stop'],
+    ]) {
+        const d = delta[k];
+        // A list holds the indices that changed; a string is a count change ("1 → 2").
+        if (Array.isArray(d))
+            parts.push(`${d.length === 1 ? one : k} ${d.map((i) => Number(i) + 1).join(', ')}`);
+        else if (d !== undefined)
+            parts.push(`${k}: ${String(d)}`);
+    }
+    if (delta.unit !== undefined)
+        parts.push(`unit: ${String(delta.unit)}`);
+    return parts.join(', ');
+}
+export function formatSource(s) {
+    if (s.kind === 'npm')
+        return `npm:${s.package}@${s.version}`;
+    if (s.kind === 'github')
+        return `github:${s.repo}@${s.ref}${s.commit ? ` (${s.commit.slice(0, 7)})` : ''}${s.path ? `/${s.path}` : ''}`;
+    if (s.path)
+        return s.path;
+    return s.kind;
+}
+export const formatWhen = (when) => when && Object.keys(when).length > 0
+    ? ` (${Object.entries(when)
+        .map(([k, v]) => `${k}: ${v}`)
+        .join(', ')})`
+    : '';
+//# sourceMappingURL=values.js.map

package/dist/values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../src/values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAmB,MAAM,eAAe,CAAA;AAE5E,MAAM,KAAK,GAAG,CAAC,CAAU,EAAgC,EAAE,CACzD,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;AAE1D,MAAM,KAAK,GAAG,CAAC,KAAc,EAAU,EAAE,CACvC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;AAEhG;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAmB,EAAE,KAAc;IAC7D,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;IACrB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,IAAmB,EAAE,KAAc;IACtD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAA;IACrD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;gBAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;YAC1E,MAAM,CAAC,GAAG,KAA8B,CAAA;YACxC,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YACzB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;YACjE,OAAO,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,KAAK,GAAG,CAAA;QAC9E,CAAC;QACD,KAAK,WAAW,CAAC;QACjB,KAAK,UAAU,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,KAAwC,CAAA;YAClD,OAAO,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;QAC9B,CAAC;QACD,KAAK,YAAY;YACf,OAAQ,KAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvC,KAAK,aAAa;YAChB,OAAO,gBAAiB,KAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAA;QAC1D,KAAK,QAAQ;YACX,OAAQ,KAAwC;iBAC7C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACT;gBACE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;gBACtB,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtF,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC;aAC9B;iBACE,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC,CACb;iBACA,IAAI,CAAC,IAAI,CAAC,CAAA;QACf,KAAK,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,KAAgC,CAAA;YAC1C,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAA;QACpI,CAAC;QACD,KAAK,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,GAAG,KAAgC,CAAA;YAC1C,OAAO,GAAG,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,IAAI,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,GAAG,IAAI,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC,EAAE,CAAA;QAC/J,CAAC;QACD;YACE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;IACvB,CAAC;AACH,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,IAAmB,EAAE,IAAa;IAC3D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAChD,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,GAAG,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACjG,OAAO,GAAG,CAAC,GAAG,GAAG,EAAE,CAAA;AACrB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAA0C;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC1E,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;QACtC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAA;IACvE,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;IACvF,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;IACvF,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;IACrF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAClF,KAAK,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI;QACrB,CAAC,QAAQ,EAAE,OAAO,CAAC;QACnB,CAAC,OAAO,EAAE,MAAM,CAAC;KACT,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;QAClB,+EAA+E;QAC/E,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;aACpG,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;IAC5D,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAa;IACxC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,OAAO,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;IAC5D,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;QACrB,OAAO,UAAU,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAChH,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,IAAI,CAAA;IACzB,OAAO,CAAC,CAAC,IAAI,CAAA;AACf,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAA+C,EAAU,EAAE,CACpF,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;IAClC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;SACtB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;SAC7B,IAAI,CAAC,IAAI,CAAC,GAAG;IAClB,CAAC,CAAC,EAAE,CAAA"}

package/package.json

@@ -1,6 +1,32 @@
 {
   "name": "@dsgraph/report",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "description": "Formatters for dsgraph changesets and findings: text, Markdown, JSON.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/specsure/specsure.git",
+    "directory": "packages/dsgraph-report"
+  },
+  "homepage": "https://github.com/specsure/specsure/tree/main/packages/dsgraph-report#readme",
+  "bugs": {
+    "url": "https://github.com/specsure/specsure/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "dependencies": {
+    "@dsgraph/core": "0.3.0"
+  }
+}