@mseep/dembrandt 0.19.5

package/dist/package.json

@@ -0,0 +1,106 @@
+{
+  "name": "@mseep/dembrandt",
+  "version": "0.19.5",
+  "description": "Extract design tokens and publicly visible CSS information from any website",
+  "mcpName": "io.github.dembrandt/dembrandt",
+  "main": "dist/index.js",
+  "type": "module",
+  "bin": {
+    "dembrandt": "dist/index.js",
+    "dembrandt-mcp": "dist/mcp-server.js"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./dtcg": "./dist/lib/dtcg/validate.js",
+    "./drift": {
+      "types": "./dist/lib/drift.d.ts",
+      "default": "./dist/lib/drift.js"
+    },
+    "./report": {
+      "types": "./dist/lib/formatters/html.d.ts",
+      "default": "./dist/lib/formatters/html.js"
+    },
+    "./normalize": "./dist/lib/normalize.js",
+    "./types": {
+      "types": "./dist/lib/types.d.ts",
+      "default": "./dist/lib/types.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "scripts": {
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build",
+    "test": "npm run build && node --test dist/test/*.test.js",
+    "install-browser": "node tools/install-browser.mjs",
+    "qa:baseline": "npm run build && node test/qa.mjs --baseline",
+    "qa:diff": "npm run build && node test/qa.mjs --diff",
+    "qa:site": "npm run build && node test/qa.mjs --site",
+    "gold:label": "npm run build && node tools/gold-label.mjs",
+    "gold:run": "npm run build && node tools/gold-run.mjs",
+    "gold:judge": "npm run build && node tools/gold-ai-judge.mjs",
+    "gold:tune": "node tools/gold-tune.mjs",
+    "gold:cluster": "node tools/gold-cluster.mjs",
+    "gold:analyze": "node tools/gold-analyze.mjs",
+    "build": "tsc && cp package.json dist/package.json",
+    "lint": "eslint ."
+  },
+  "keywords": [
+    "design-tokens",
+    "design-system",
+    "branding",
+    "css-analysis",
+    "cli",
+    "playwright",
+    "mseep",
+    "mcp-server"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dembrandt/dembrandt.git"
+  },
+  "bugs": {
+    "url": "https://github.com/dembrandt/dembrandt/issues"
+  },
+  "homepage": "https://dembrandt.com",
+  "author": "thevangelist <info@esajuhana.com>",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "ora": "^7.0.1",
+    "playwright-core": "^1.60.0"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "playwright": "^1.60.0",
+    "zod": "4.3.6"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    },
+    "playwright": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "10.0.1",
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "@types/node": "25.9.2",
+    "eslint": "10.4.1",
+    "playwright": "^1.57.0",
+    "playwright-core": "1.60.0",
+    "typescript": "6.0.3",
+    "typescript-eslint": "8.60.1",
+    "zod": "4.3.6"
+  },
+  "publisher": "mseep"
+}

package/dist/test/_vitest-shim.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Minimal vitest-compatible shim over node:test + node:assert, so the DTCG
+ * validator's upstream test suite (written for vitest) runs verbatim under the
+ * project's node:test runner. Only the three matchers that suite actually uses
+ * are implemented (toBe, toContain, toHaveLength); no .not.
+ */
+import { describe, it } from 'node:test';
+export { describe, it };
+export declare function expect(actual: any): {
+    toBe(expected: any): void;
+    toContain(expected: any): void;
+    toHaveLength(length: number): void;
+};

package/dist/test/_vitest-shim.js

@@ -0,0 +1,23 @@
+/**
+ * Minimal vitest-compatible shim over node:test + node:assert, so the DTCG
+ * validator's upstream test suite (written for vitest) runs verbatim under the
+ * project's node:test runner. Only the three matchers that suite actually uses
+ * are implemented (toBe, toContain, toHaveLength); no .not.
+ */
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+export { describe, it };
+export function expect(actual) {
+    return {
+        toBe(expected) {
+            assert.strictEqual(actual, expected);
+        },
+        toContain(expected) {
+            assert.ok(actual != null && typeof actual.includes === 'function' && actual.includes(expected), `expected ${JSON.stringify(actual)} to contain ${JSON.stringify(expected)}`);
+        },
+        toHaveLength(length) {
+            assert.strictEqual(actual?.length, length);
+        },
+    };
+}
+//# sourceMappingURL=_vitest-shim.js.map

package/dist/test/_vitest-shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_vitest-shim.js","sourceRoot":"","sources":["../../test/_vitest-shim.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;AAExB,MAAM,UAAU,MAAM,CAAC,MAAW;IAChC,OAAO;QACL,IAAI,CAAC,QAAa;YAChB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvC,CAAC;QACD,SAAS,CAAC,QAAa;YACrB,MAAM,CAAC,EAAE,CACP,MAAM,IAAI,IAAI,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EACpF,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAC5E,CAAC;QACJ,CAAC;QACD,YAAY,CAAC,MAAc;YACzB,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/test/cli.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/cli.test.js

@@ -0,0 +1,24 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { spawnSync } from 'node:child_process';
+import { fileURLToPath } from 'node:url';
+// Browser-free CLI plumbing tests: arg parsing, exit codes, help output. These
+// run before any extraction, so they need no browser. Import resolution is now
+// covered by tsc/build (an unresolved import fails compilation), so there is no
+// separate runtime module-load test here.
+const indexJs = fileURLToPath(new URL('../index.js', import.meta.url));
+function run(args, opts = {}) {
+    return spawnSync('node', [indexJs, ...args], { encoding: 'utf8', ...opts });
+}
+test('--version exits 0 and prints a semver', () => {
+    const r = run(['--version']);
+    assert.equal(r.status, 0);
+    assert.match(r.stdout.trim(), /^\d+\.\d+\.\d+/);
+});
+test('--help exits 0 and shows the extraction usage', () => {
+    const r = run(['--help']);
+    assert.equal(r.status, 0);
+    assert.match(r.stdout, /Extract design tokens/);
+    assert.match(r.stdout, /--dtcg/);
+});
+//# sourceMappingURL=cli.test.js.map

package/dist/test/cli.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.test.js","sourceRoot":"","sources":["../../test/cli.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,+EAA+E;AAC/E,+EAA+E;AAC/E,gFAAgF;AAChF,0CAA0C;AAE1C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEvE,SAAS,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE;IAC1B,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IACjD,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,+CAA+C,EAAE,GAAG,EAAE;IACzD,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC"}

package/dist/test/colors.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/colors.test.js

@@ -0,0 +1,64 @@
+import assert from 'node:assert/strict';
+import { test } from 'node:test';
+import { hexToRgb, relativeLuminance, computeWcag, convertColor, deltaE, deltaE2000 } from '../lib/colors.js';
+test('hexToRgb parses 6, 3, and 8 digit hex', () => {
+    assert.deepEqual(hexToRgb('#ff0000'), { r: 255, g: 0, b: 0 });
+    assert.deepEqual(hexToRgb('#abc'), { r: 170, g: 187, b: 204 });
+    const withAlpha = hexToRgb('#ff000080');
+    assert.equal(withAlpha.r, 255);
+    assert.ok(Math.abs(withAlpha.a - 128 / 255) < 1e-9);
+});
+test('hexToRgb returns null for non-hex or malformed input', () => {
+    assert.equal(hexToRgb('rgb(0,0,0)'), null);
+    assert.equal(hexToRgb('#ff'), null);
+    assert.equal(hexToRgb(''), null);
+});
+test('relativeLuminance bounds: white ~1, black 0, invalid null', () => {
+    assert.ok(Math.abs(relativeLuminance('#ffffff') - 1) < 1e-6);
+    assert.equal(relativeLuminance('#000000'), 0);
+    assert.equal(relativeLuminance('not-a-color'), null);
+});
+test('deltaE (CIE76): 0 for identical, 999 for unparseable', () => {
+    assert.equal(deltaE('#ff0000', '#ff0000'), 0);
+    assert.equal(deltaE('garbage', '#fff'), 999);
+});
+test('deltaE2000: 0 identical, small for tiny shift, large for opposite hues', () => {
+    assert.equal(deltaE2000('#ff0000', '#ff0000'), 0);
+    assert.ok(deltaE2000('#ff0000', '#fe0000') < 1);
+    assert.ok(deltaE2000('#ff0000', '#0000ff') > 40);
+});
+test('deltaE2000 accepts rgb() input and matches hex', () => {
+    assert.equal(deltaE2000('rgb(255,0,0)', '#ff0000'), 0);
+});
+test('deltaE2000 returns 100 when a color cannot be parsed', () => {
+    assert.equal(deltaE2000('garbage', '#ffffff'), 100);
+});
+test('computeWcag: black on white is 21:1 and passes AA + AAA', () => {
+    const pairs = computeWcag([
+        { normalized: '#000000' },
+        { normalized: '#ffffff' },
+    ]);
+    assert.equal(pairs.length, 1);
+    assert.equal(pairs[0].ratio, 21);
+    assert.equal(pairs[0].aa, true);
+    assert.equal(pairs[0].aaa, true);
+    assert.equal(pairs[0].fg, '#ffffff'); // lighter is foreground here
+    assert.equal(pairs[0].bg, '#000000');
+});
+test('computeWcag ignores non-hex palette entries', () => {
+    const pairs = computeWcag([
+        { normalized: '#000000' },
+        { normalized: 'rgb(255,255,255)' }, // filtered: not hex
+    ]);
+    assert.equal(pairs.length, 0);
+});
+test('convertColor normalizes rgb, hsl, and hex to lowercase hex', () => {
+    assert.equal(convertColor('rgb(255,0,0)').hex, '#ff0000');
+    assert.equal(convertColor('hsl(0, 100%, 50%)').hex, '#ff0000');
+    assert.equal(convertColor('#ABC').hex, '#aabbcc');
+});
+test('convertColor flags alpha and returns null for junk', () => {
+    assert.equal(convertColor('rgba(0, 0, 0, 0.5)').hasAlpha, true);
+    assert.equal(convertColor('not-a-color'), null);
+});
+//# sourceMappingURL=colors.test.js.map

package/dist/test/colors.test.js.map

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

package/dist/test/compare.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/compare.test.js

@@ -0,0 +1,57 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { resolveCompare } from '../lib/compare.js';
+/**
+ * resolveCompare dispatches `--compare <arg>` on file-vs-id with injectable deps,
+ * so both backends are exercised without a real filesystem or network: a local
+ * file diffs here; a baseline id POSTs to the App and uses its returned report.
+ */
+function fixture(overrides = {}) {
+    return {
+        url: 'https://example.com/',
+        extractedAt: 't',
+        colors: { palette: [{ normalized: '#133174', count: 40, confidence: 'high' }], semantic: { primary: '#133174' }, cssVariables: {} },
+        typography: { styles: [], sources: {} },
+        spacing: { scaleType: 'base-8', commonValues: [] },
+        borderRadius: { values: [] },
+        borders: {}, shadows: [],
+        components: { buttons: [], inputs: [], links: [], badges: [] },
+        breakpoints: [], iconSystem: [], frameworks: [],
+        ...overrides,
+    };
+}
+test('local file path: diffs against the file here', async () => {
+    const baseline = fixture();
+    const candidate = fixture({ colors: { palette: [{ normalized: '#0a0a0a', count: 40, confidence: 'high' }], semantic: {}, cssVariables: {} } });
+    const r = await resolveCompare('baseline.json', candidate, {
+        isFile: () => true,
+        readFile: () => JSON.stringify(baseline),
+    });
+    assert.equal(r.mode, 'local');
+    assert.equal(r.source, 'baseline.json');
+    assert.equal(r.report.status, 'drift');
+});
+test('baseline id path: POSTs candidate to the App and returns its report', async () => {
+    const candidate = fixture();
+    let captured = null;
+    const fakeReport = { score: 7, status: 'stable', threshold: 10, summary: { changed: 0, added: 0, removed: 0 }, categories: [], changes: [] };
+    const fetchFn = (async (url, init) => {
+        captured = { url, body: JSON.parse(init.body) };
+        return { ok: true, json: async () => ({ drift: fakeReport }) };
+    });
+    const r = await resolveCompare('dembrandt.com', candidate, {
+        isFile: () => false,
+        fetchFn,
+        api: 'https://app.example.com/',
+    });
+    assert.equal(captured.url, 'https://app.example.com/api/app/drift');
+    assert.equal(captured.body.baselineId, 'dembrandt.com');
+    assert.ok(captured.body.candidate.colors, 'sends the candidate extraction');
+    assert.equal(r.mode, 'platform');
+    assert.equal(r.report.score, 7);
+});
+test('baseline id path: surfaces a platform error', async () => {
+    const fetchFn = (async () => ({ ok: false, status: 404, statusText: 'Not Found', json: async () => ({ error: 'baseline not found: nope' }) }));
+    await assert.rejects(() => resolveCompare('nope', fixture(), { isFile: () => false, fetchFn, api: 'https://app.example.com' }), /platform compare failed \(404\): baseline not found: nope/);
+});
+//# sourceMappingURL=compare.test.js.map

package/dist/test/compare.test.js.map

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

package/dist/test/drift.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/drift.test.js

@@ -0,0 +1,53 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { computeDrift } from '../lib/drift.js';
+/**
+ * Low-confidence tokens are single-use, margin-of-detection elements the
+ * extractor is unsure about; they surface inconsistently between two
+ * extractions of the same design. computeDrift must ignore them so they never
+ * produce phantom drift.
+ */
+function fixture(overrides = {}) {
+    return {
+        url: 'https://example.com/',
+        extractedAt: 't',
+        colors: { palette: [{ normalized: '#133174', count: 40, confidence: 'high' }], semantic: { primary: '#133174' }, cssVariables: {} },
+        typography: { styles: [], sources: {} },
+        spacing: { scaleType: 'base-8', commonValues: [] },
+        borderRadius: { values: [] },
+        borders: {}, shadows: [],
+        components: { buttons: [], inputs: [], links: [], badges: [] },
+        breakpoints: [], iconSystem: [], frameworks: [],
+        ...overrides,
+    };
+}
+test('a low-confidence shadow present in one extraction but not the other is not drift', () => {
+    const withShadow = fixture({
+        shadows: [{ shadow: 'rgb(128, 128, 128) 0px 0px 5px 0px', count: 1, confidence: 'low' }],
+    });
+    const without = fixture({ shadows: [] });
+    const report = computeDrift(withShadow, without);
+    assert.equal(report.status, 'stable');
+    assert.equal(report.summary.removed, 0);
+    assert.equal(report.changes.filter((c) => c.category === 'shadow').length, 0);
+});
+test('a low-confidence radius present in one extraction but not the other is not drift', () => {
+    const withRadius = fixture({
+        borderRadius: { values: [{ value: '2px', count: 1, confidence: 'low' }] },
+    });
+    const without = fixture({ borderRadius: { values: [] } });
+    const report = computeDrift(withRadius, without);
+    assert.equal(report.status, 'stable');
+    assert.equal(report.changes.filter((c) => c.category === 'radius').length, 0);
+});
+test('a high-confidence radius change is still real drift', () => {
+    const base = fixture({
+        borderRadius: { values: [{ value: '4px', count: 20, confidence: 'high' }] },
+    });
+    const changed = fixture({
+        borderRadius: { values: [{ value: '12px', count: 20, confidence: 'high' }] },
+    });
+    const report = computeDrift(base, changed);
+    assert.ok(report.changes.some((c) => c.category === 'radius'), 'high-confidence radius change must be reported');
+});
+//# sourceMappingURL=drift.test.js.map

package/dist/test/drift.test.js.map

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

package/dist/test/dtcg-formatter.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test/dtcg-formatter.test.js

@@ -0,0 +1,48 @@
+import { describe, it, expect } from './_vitest-shim.js';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import { toDtcgTokens } from '../lib/formatters/dtcg.js';
+import { validateTokensObject } from '../lib/dtcg/validate.js';
+import { SCHEMA_VERSION } from '../lib/version.js';
+/**
+ * End-to-end guard: the DTCG formatter's own output must satisfy the DTCG
+ * validator. The validator does not run at extraction time (index.ts emits
+ * toDtcgTokens output unchecked), so this is the only gate that catches a
+ * formatter regression emitting a malformed token.
+ *
+ * The fixture is a small synthetic extraction, not a saved real crawl: it is
+ * hand-built to exercise all six exporters (color, typography, spacing, radius,
+ * border, shadow) in a few dozen lines, so it stays readable and is trivially
+ * edited when the contract changes. Any new token type the formatter emits is
+ * covered here as long as the fixture exercises it.
+ */
+const fixturesDir = join(dirname(fileURLToPath(import.meta.url)), '../../test/fixtures');
+function loadFixture(name) {
+    return JSON.parse(readFileSync(join(fixturesDir, name), 'utf8'));
+}
+const FIXTURE = 'extraction-synthetic.sample.json';
+describe('DTCG formatter output is spec-valid', () => {
+    it(`${FIXTURE} is pinned to the current output contract`, () => {
+        // A fixture from an older schema would validate a historical extraction
+        // shape, not what the formatter sees today. Fail loudly when it drifts so
+        // the fixture gets updated instead of silently rotting.
+        const fixture = loadFixture(FIXTURE);
+        expect(fixture.meta.schemaVersion).toBe(SCHEMA_VERSION);
+    });
+    it(`${FIXTURE} -> toDtcgTokens -> validateTokensObject passes`, () => {
+        const tokens = toDtcgTokens(loadFixture(FIXTURE));
+        const result = validateTokensObject(tokens);
+        // join() surfaces the actual validator errors in the failure message.
+        expect(result.errors.join('; ')).toBe('');
+        expect(result.valid).toBe(true);
+    });
+    it('exercises all six exporters', () => {
+        const tokens = toDtcgTokens(loadFixture(FIXTURE));
+        for (const group of ['color', 'typography', 'spacing', 'radius', 'border', 'shadow']) {
+            // present means the exporter ran and emitted at least one token group
+            expect(typeof tokens[group]).toBe('object');
+        }
+    });
+});
+//# sourceMappingURL=dtcg-formatter.test.js.map

package/dist/test/dtcg-formatter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtcg-formatter.test.js","sourceRoot":"","sources":["../../test/dtcg-formatter.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAEzF,SAAS,WAAW,CAAC,IAAI;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAEnD,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,GAAG,OAAO,2CAA2C,EAAE,GAAG,EAAE;QAC7D,wEAAwE;QACxE,0EAA0E;QAC1E,wDAAwD;QACxD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,GAAG,OAAO,iDAAiD,EAAE,GAAG,EAAE;QACnE,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;QAC5C,sEAAsE;QACtE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAClD,KAAK,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;YACrF,sEAAsE;YACtE,MAAM,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/dtcg-validate.test.d.ts

@@ -0,0 +1 @@
+export {};