@maltjoy/mcp-server 0.4.0 → 0.5.0

package/dist/tokens/query.js

@@ -0,0 +1,290 @@
+import { readFileSync } from 'fs';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { GROUP_ALIASES, USAGE_TOPICS, } from './types.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const DEFAULT_LIMIT = 8;
+const MAX_LIMIT = 25;
+let cachedCatalog = null;
+export function catalogPath() {
+    return join(__dirname, '../doc/design-tokens.json');
+}
+export function loadCatalog(path = catalogPath()) {
+    if (cachedCatalog && path === catalogPath()) {
+        return cachedCatalog;
+    }
+    const catalog = JSON.parse(readFileSync(path, 'utf-8'));
+    if (!catalog.tokens || !Array.isArray(catalog.tokens)) {
+        throw new Error('Invalid design-tokens.json: expected { tokens: TokenRecord[] }. Rebuild the MCP docs.');
+    }
+    if (path === catalogPath()) {
+        cachedCatalog = catalog;
+    }
+    return catalog;
+}
+export function resetCatalogCache() {
+    cachedCatalog = null;
+}
+function normalize(value) {
+    return value.trim().toLowerCase();
+}
+function searchableText(token) {
+    const docs = token.docs;
+    return [
+        token.name,
+        token.css,
+        token.description ?? '',
+        token.group,
+        ...(docs?.useFor ?? []),
+        ...(docs?.doNotUseFor ?? []),
+        ...(docs?.pairWith ?? []),
+        ...(docs?.replaces ?? []),
+        docs?.notes ?? '',
+        typeof token.value === 'string' ? token.value : JSON.stringify(token.value),
+    ]
+        .join(' ')
+        .toLowerCase();
+}
+function scoreToken(token, query) {
+    const q = normalize(query);
+    if (!q) {
+        return 0;
+    }
+    let score = 0;
+    const name = token.name.toLowerCase();
+    const css = token.css.toLowerCase();
+    const cssBare = css.replace(/^--/, '');
+    if (name === q || css === q || cssBare === q || css === `--${q}`) {
+        score += 100;
+    }
+    else if (name.endsWith(`.${q}`) || name.includes(`.${q}.`) || name.startsWith(`${q}.`)) {
+        score += 55;
+    }
+    else if (name.includes(q) || css.includes(q)) {
+        score += 35;
+    }
+    for (const intent of token.docs?.useFor ?? []) {
+        const intentNorm = intent.toLowerCase();
+        if (intentNorm === q) {
+            score += 80;
+        }
+        else if (intentNorm.includes(q) || q.includes(intentNorm)) {
+            score += 50;
+        }
+    }
+    if (token.description?.toLowerCase().includes(q)) {
+        score += 20;
+    }
+    for (const [wrong, instead] of Object.entries(token.docs?.useInstead ?? {})) {
+        if (wrong.toLowerCase().includes(q) || instead.toLowerCase().includes(q)) {
+            score += 15;
+        }
+    }
+    const words = q.split(/\s+/).filter((word) => word.length > 1);
+    const segments = name.split('.');
+    if (words.length > 0 && words.every((word) => segments.includes(word))) {
+        score += 45;
+    }
+    if (words.length > 1) {
+        const haystack = searchableText(token);
+        const matched = words.filter((word) => haystack.includes(word)).length;
+        score += Math.round((matched / words.length) * 25);
+    }
+    if (token.layer === 'semantic') {
+        score += 8;
+    }
+    if (token.docs) {
+        score += 4;
+    }
+    if (token.deprecated) {
+        score -= 40;
+    }
+    return score;
+}
+function toHit(token, score) {
+    return {
+        name: token.name,
+        css: token.css,
+        layer: token.layer,
+        domain: token.domain,
+        type: token.type,
+        description: token.description,
+        deprecated: token.deprecated,
+        useFor: token.docs?.useFor,
+        score,
+    };
+}
+export function searchTokens(input, catalog = loadCatalog()) {
+    const query = input.query?.trim() ?? '';
+    if (!query) {
+        return { query, count: 0, tokens: [] };
+    }
+    const limit = Math.min(Math.max(input.limit ?? DEFAULT_LIMIT, 1), MAX_LIMIT);
+    const layer = input.layer ?? 'semantic';
+    const hits = catalog.tokens
+        .filter((token) => {
+        if (!input.includeDeprecated && token.deprecated) {
+            return false;
+        }
+        if (layer !== 'all' && token.layer !== layer) {
+            return false;
+        }
+        if (input.domain && token.domain !== input.domain) {
+            return false;
+        }
+        return scoreToken(token, query) > 0;
+    })
+        .map((token) => ({ token, score: scoreToken(token, query) }))
+        .filter((entry) => entry.score > 0)
+        .sort((left, right) => right.score - left.score || left.token.name.localeCompare(right.token.name))
+        .slice(0, limit)
+        .map((entry) => toHit(entry.token, entry.score));
+    if (hits.length === 0 && layer === 'semantic') {
+        return searchTokens({ ...input, layer: 'all' }, catalog);
+    }
+    return { query, count: hits.length, tokens: hits };
+}
+function findToken(nameOrCss, catalog) {
+    const needle = nameOrCss.trim();
+    const lower = needle.toLowerCase();
+    return catalog.tokens.find((token) => {
+        return (token.name === needle ||
+            token.css === needle ||
+            token.name.toLowerCase() === lower ||
+            token.css.toLowerCase() === lower ||
+            token.css.toLowerCase() === `--${lower}` ||
+            token.css.toLowerCase() === `--joy-${lower}`);
+    });
+}
+export function getToken(nameOrCss, catalog = loadCatalog()) {
+    if (!nameOrCss || typeof nameOrCss !== 'string') {
+        return { error: 'Provide a token path (color.text.heading) or CSS name (--joy-color-text-heading).' };
+    }
+    const token = findToken(nameOrCss, catalog);
+    if (!token) {
+        return {
+            error: `Token "${nameOrCss}" not found. Use joy_search_tokens to find tokens by intent or name.`,
+        };
+    }
+    return token;
+}
+function resolveGroupPrefix(group) {
+    const trimmed = group.trim();
+    const alias = GROUP_ALIASES[trimmed.toLowerCase()];
+    return alias ?? trimmed;
+}
+export function getTokenGroup(input, catalog = loadCatalog()) {
+    if (!input.group || typeof input.group !== 'string') {
+        return {
+            error: 'Provide a group (text, background, border, spacing, color, forms, typography, …).',
+        };
+    }
+    const prefix = resolveGroupPrefix(input.group);
+    const matchesPrefix = (token) => token.name === prefix || token.name.startsWith(`${prefix}.`) || token.group === prefix;
+    const matchesMeta = (token, layer) => {
+        if (!input.includeDeprecated && token.deprecated) {
+            return false;
+        }
+        if (layer && token.layer !== layer) {
+            return false;
+        }
+        return matchesPrefix(token);
+    };
+    let tokens = catalog.tokens.filter((token) => matchesMeta(token, 'semantic'));
+    if (tokens.length === 0) {
+        tokens = catalog.tokens.filter((token) => matchesMeta(token));
+    }
+    if (tokens.length === 0) {
+        return {
+            error: `No tokens in group "${input.group}". Try text, background, border, spacing, color, forms, or typography.`,
+        };
+    }
+    return { group: prefix, count: tokens.length, tokens };
+}
+export function listDesignTokens(input = {}, catalog = loadCatalog()) {
+    const layer = input.layer ?? 'semantic';
+    const tokens = catalog.tokens
+        .filter((token) => {
+        if (!input.includeDeprecated && token.deprecated) {
+            return false;
+        }
+        if (layer !== 'all' && token.layer !== layer) {
+            return false;
+        }
+        if (input.domain && token.domain !== input.domain) {
+            return false;
+        }
+        return true;
+    })
+        .map((token) => toHit(token, 0));
+    return { layer, count: tokens.length, tokens };
+}
+const TOPIC_GUIDANCE = {
+    text: {
+        group: 'color.text',
+        chooseBy: [
+            'disabled → color.text.disabled',
+            'error / validation → color.text.error',
+            'page / overlay / section title → color.text.heading',
+            'control identifier / field label → color.text.label',
+            'helper, subtitle, placeholder → color.text.support',
+            'otherwise body / field value → color.text.default',
+        ],
+        notes: 'heading and label share a primitive; support and disabled share a primitive. Choose by role, not by hex. Prefer semantic tokens over primitives.',
+    },
+    background: {
+        group: 'color.background',
+        chooseBy: [
+            'loading shimmer → color.background.skeleton',
+            'disabled field / item fill → color.background.disabled',
+            'otherwise page / panel / card / input / overlay → color.background.default',
+        ],
+        notes: 'Not a generic white token. Button, tag, and checked-control disabled fills are not this token.',
+    },
+    border: {
+        group: 'color.border',
+        chooseBy: [
+            'disabled → color.border.disabled',
+            'invalid → color.border.error',
+            'invalid hover → color.border.error-hover',
+            'hover → color.border.hover',
+            'keyboard focus halo → form.field.focus.color',
+            'input focus stroke → color.border.focus',
+            'checked / open → color.border.selected',
+            'otherwise → color.border.default',
+        ],
+        notes: 'Focus stroke and keyboard halo are different tokens. Choose by role, not by hex.',
+    },
+    color: {
+        group: 'color',
+        chooseBy: [
+            'text: see joy_get_token_usage topic=text',
+            'background: see joy_get_token_usage topic=background',
+            'border: see joy_get_token_usage topic=border',
+        ],
+        notes: 'Always prefer semantic color roles. Do not use primitives (color.neutral.50) in product UI when a semantic token exists.',
+    },
+    spacing: {
+        group: 'core.spacing',
+        chooseBy: ['Use the primitive spacing scale (core.spacing.*). There is no semantic spacing layer yet.'],
+        notes: 'These are primitives. Prefer the named scale over raw px.',
+    },
+};
+export function getTokenUsage(topic, catalog = loadCatalog()) {
+    const normalized = topic?.trim().toLowerCase();
+    if (!USAGE_TOPICS.includes(normalized)) {
+        return {
+            error: `Unknown topic "${topic}". Use one of: ${USAGE_TOPICS.join(', ')}.`,
+        };
+    }
+    const guidance = TOPIC_GUIDANCE[normalized];
+    const group = getTokenGroup({ group: guidance.group }, catalog);
+    const tokens = 'tokens' in group ? group.tokens.filter((token) => token.layer === 'semantic' || normalized === 'spacing') : [];
+    return {
+        topic: normalized,
+        chooseBy: guidance.chooseBy,
+        notes: guidance.notes,
+        tokens,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/tokens/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/tokens/query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EACL,aAAa,EACb,YAAY,GAMb,MAAM,YAAY,CAAC;AAGpB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,aAAa,GAAG,CAAC,CAAC;AACxB,MAAM,SAAS,GAAG,EAAE,CAAC;AAErB,IAAI,aAAa,GAAwB,IAAI,CAAC;AAE9C,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,SAAS,EAAE,2BAA2B,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAI,GAAG,WAAW,EAAE;IAC9C,IAAI,aAAa,IAAI,IAAI,KAAK,WAAW,EAAE,EAAE,CAAC;QAC5C,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAiB,CAAC;IACxE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,uFAAuF,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,EAAE,EAAE,CAAC;QAC3B,aAAa,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,cAAc,CAAC,KAAkB;IACxC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,OAAO;QACL,KAAK,CAAC,IAAI;QACV,KAAK,CAAC,GAAG;QACT,KAAK,CAAC,WAAW,IAAI,EAAE;QACvB,KAAK,CAAC,KAAK;QACX,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,CAAC;QAC5B,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QACzB,IAAI,EAAE,KAAK,IAAI,EAAE;QACjB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC;KAC5E;SACE,IAAI,CAAC,GAAG,CAAC;SACT,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB,EAAE,KAAa;IACnD,MAAM,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEvC,IAAI,IAAI,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,GAAG,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;QACjE,KAAK,IAAI,GAAG,CAAC;IACf,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACzF,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;SAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,EAAE,CAAC;QAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;aAAM,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;QAC5E,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QACvE,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QACvE,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAC/B,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrB,KAAK,IAAI,EAAE,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,KAAkB,EAAE,KAAa;IAC9C,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM;QAC1B,KAAK;KACN,CAAC;AACJ,CAAC;AAUD,MAAM,UAAU,YAAY,CAAC,KAAwB,EAAE,OAAO,GAAG,WAAW,EAAE;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,aAAa,EAAE,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC;IAExC,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM;SACxB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;SAC5D,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;SAClC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;SAClG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;QAC9C,OAAO,YAAY,CAAC,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,SAAiB,EAAE,OAAqB;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IACnC,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QACnC,OAAO,CACL,KAAK,CAAC,IAAI,KAAK,MAAM;YACrB,KAAK,CAAC,GAAG,KAAK,MAAM;YACpB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK;YAClC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK;YACjC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,KAAK,KAAK,EAAE;YACxC,KAAK,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS,KAAK,EAAE,CAC7C,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,SAAiB,EACjB,OAAO,GAAG,WAAW,EAAE;IAEvB,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,EAAE,KAAK,EAAE,mFAAmF,EAAE,CAAC;IACxG,CAAC;IACD,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,KAAK,EAAE,UAAU,SAAS,sEAAsE;SACjG,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,OAAO,KAAK,IAAI,OAAO,CAAC;AAC1B,CAAC;AAOD,MAAM,UAAU,aAAa,CAC3B,KAAyB,EACzB,OAAO,GAAG,WAAW,EAAE;IAEvB,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO;YACL,KAAK,EAAE,mFAAmF;SAC3F,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/C,MAAM,aAAa,GAAG,CAAC,KAAkB,EAAE,EAAE,CAC3C,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC;IAEzF,MAAM,WAAW,GAAG,CAAC,KAAkB,EAAE,KAAkB,EAAE,EAAE;QAC7D,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YACnC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,IAAI,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IAC9E,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,uBAAuB,KAAK,CAAC,KAAK,wEAAwE;SAClH,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC;AAQD,MAAM,UAAU,gBAAgB,CAC9B,QAA+B,EAAE,EACjC,OAAO,GAAG,WAAW,EAAE;IAEvB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,UAAU,CAAC;IACxC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM;SAC1B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE;QAChB,IAAI,CAAC,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC7C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAEnC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,cAAc,GAGhB;IACF,IAAI,EAAE;QACJ,KAAK,EAAE,YAAY;QACnB,QAAQ,EAAE;YACR,gCAAgC;YAChC,uCAAuC;YACvC,qDAAqD;YACrD,qDAAqD;YACrD,oDAAoD;YACpD,mDAAmD;SACpD;QACD,KAAK,EAAE,kJAAkJ;KAC1J;IACD,UAAU,EAAE;QACV,KAAK,EAAE,kBAAkB;QACzB,QAAQ,EAAE;YACR,6CAA6C;YAC7C,wDAAwD;YACxD,4EAA4E;SAC7E;QACD,KAAK,EAAE,gGAAgG;KACxG;IACD,MAAM,EAAE;QACN,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE;YACR,kCAAkC;YAClC,8BAA8B;YAC9B,0CAA0C;YAC1C,4BAA4B;YAC5B,8CAA8C;YAC9C,yCAAyC;YACzC,wCAAwC;YACxC,kCAAkC;SACnC;QACD,KAAK,EAAE,kFAAkF;KAC1F;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE;YACR,0CAA0C;YAC1C,sDAAsD;YACtD,8CAA8C;SAC/C;QACD,KAAK,EAAE,0HAA0H;KAClI;IACD,OAAO,EAAE;QACP,KAAK,EAAE,cAAc;QACrB,QAAQ,EAAE,CAAC,2FAA2F,CAAC;QACvG,KAAK,EAAE,2DAA2D;KACnE;CACF,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,KAAa,EACb,OAAO,GAAG,WAAW,EAAE;IASvB,MAAM,UAAU,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,WAAW,EAAgB,CAAC;IAC7D,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,KAAK,EAAE,kBAAkB,KAAK,kBAAkB,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;SAC3E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU,IAAI,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/H,OAAO;QACL,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/tokens/types.d.ts

@@ -0,0 +1,44 @@
+export declare const DOCS_NAMESPACE = "com.maltjoy.docs";
+export type TokenLayer = 'primitive' | 'semantic';
+export type TokenDomain = 'color' | 'spacing' | 'radius' | 'elevation' | 'zIndex' | 'typography' | 'motion' | 'forms' | 'links' | 'other';
+export interface TokenDocs {
+    useFor?: string[];
+    doNotUseFor?: string[];
+    useInstead?: Record<string, string>;
+    pairWith?: string[];
+    replaces?: string[];
+    samePrimitiveAs?: string[];
+    notes?: string;
+}
+export interface TokenRecord {
+    name: string;
+    css: string;
+    value: unknown;
+    type?: string;
+    layer: TokenLayer;
+    domain: TokenDomain;
+    group: string;
+    description?: string;
+    deprecated: boolean;
+    docs?: TokenDocs;
+}
+export interface TokenCatalog {
+    generatedAt: string;
+    count: number;
+    tokens: TokenRecord[];
+}
+export interface TokenHit {
+    name: string;
+    css: string;
+    layer: TokenLayer;
+    domain: TokenDomain;
+    type?: string;
+    description?: string;
+    deprecated: boolean;
+    useFor?: string[];
+    score: number;
+}
+export declare const GROUP_ALIASES: Record<string, string>;
+export declare const USAGE_TOPICS: readonly ["text", "background", "border", "color", "spacing"];
+export type UsageTopic = (typeof USAGE_TOPICS)[number];
+//# sourceMappingURL=types.d.ts.map

package/dist/tokens/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tokens/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAElD,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,SAAS,GACT,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,CAAC;AAEZ,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBhD,CAAC;AAEF,eAAO,MAAM,YAAY,+DAAgE,CAAC;AAC1F,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/tokens/types.js

@@ -0,0 +1,23 @@
+export const DOCS_NAMESPACE = 'com.maltjoy.docs';
+export const GROUP_ALIASES = {
+    text: 'color.text',
+    background: 'color.background',
+    border: 'color.border',
+    overlay: 'color.overlay',
+    spacing: 'core.spacing',
+    radius: 'core.radius',
+    elevation: 'core.elevation',
+    zindex: 'core.zIndex',
+    'z-index': 'core.zIndex',
+    forms: 'form',
+    form: 'form',
+    links: 'link',
+    link: 'link',
+    typography: 'typography',
+    font: 'font',
+    motion: 'transition',
+    transition: 'transition',
+    color: 'color',
+};
+export const USAGE_TOPICS = ['text', 'background', 'border', 'color', 'spacing'];
+//# sourceMappingURL=types.js.map

package/dist/tokens/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tokens/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAyDjD,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,IAAI,EAAE,YAAY;IAClB,UAAU,EAAE,kBAAkB;IAC9B,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,cAAc;IACvB,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,gBAAgB;IAC3B,MAAM,EAAE,aAAa;IACrB,SAAS,EAAE,aAAa;IACxB,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC"}

package/dist/tools/get-token-group.d.ts

@@ -0,0 +1,26 @@
+export declare const getTokenGroupTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            group: {
+                type: string;
+                description: string;
+            };
+            includeDeprecated: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetTokenGroup(group: string, includeDeprecated?: boolean): {
+    group: string;
+    count: number;
+    tokens: import("../tokens/types.js").TokenRecord[];
+} | {
+    error: string;
+};
+//# sourceMappingURL=get-token-group.d.ts.map

package/dist/tools/get-token-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token-group.d.ts","sourceRoot":"","sources":["../../src/tools/get-token-group.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAmB7B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,OAAO;;;;;;EAE7E"}

package/dist/tools/get-token-group.js

@@ -0,0 +1,24 @@
+import { getTokenGroup } from '../tokens/query.js';
+export const getTokenGroupTool = {
+    name: 'joy_get_token_group',
+    description: 'Get all Joy tokens in a group. Use aliases like text, background, border, spacing, color, forms, typography. ' +
+        'Semantic groups are returned by default so you can compare sibling roles (heading vs label).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            group: {
+                type: 'string',
+                description: 'Group name or alias (text, background, border, spacing, color, forms, …)',
+            },
+            includeDeprecated: {
+                type: 'boolean',
+                description: 'Include deprecated aliases. Defaults to false.',
+            },
+        },
+        required: ['group'],
+    },
+};
+export function handleGetTokenGroup(group, includeDeprecated) {
+    return getTokenGroup({ group, includeDeprecated });
+}
+//# sourceMappingURL=get-token-group.js.map

package/dist/tools/get-token-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token-group.js","sourceRoot":"","sources":["../../src/tools/get-token-group.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,+GAA+G;QAC/G,8FAA8F;IAChG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,0EAA0E;aACxF;YACD,iBAAiB,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,iBAA2B;IAC5E,OAAO,aAAa,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/dist/tools/get-token-usage.d.ts

@@ -0,0 +1,24 @@
+export declare const getTokenUsageTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            topic: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetTokenUsage(topic: string): {
+    topic: "color" | "spacing" | "text" | "background" | "border";
+    chooseBy: string[];
+    notes: string;
+    tokens: import("../tokens/types.js").TokenRecord[];
+} | {
+    error: string;
+};
+//# sourceMappingURL=get-token-usage.d.ts.map

package/dist/tools/get-token-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token-usage.d.ts","sourceRoot":"","sources":["../../src/tools/get-token-usage.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAiB7B,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM;;;;;;;EAEhD"}

package/dist/tools/get-token-usage.js

@@ -0,0 +1,22 @@
+import { getTokenUsage } from '../tokens/query.js';
+export const getTokenUsageTool = {
+    name: 'joy_get_token_usage',
+    description: 'Get usage rules for a Joy token topic (text, background, border, color, spacing). ' +
+        'Returns a decision tree and the relevant semantic tokens with do/don\'t. ' +
+        'Call this when choosing between similar color roles.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            topic: {
+                type: 'string',
+                enum: ['text', 'background', 'border', 'color', 'spacing'],
+                description: 'Usage topic',
+            },
+        },
+        required: ['topic'],
+    },
+};
+export function handleGetTokenUsage(topic) {
+    return getTokenUsage(topic);
+}
+//# sourceMappingURL=get-token-usage.js.map

package/dist/tools/get-token-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token-usage.js","sourceRoot":"","sources":["../../src/tools/get-token-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EACT,oFAAoF;QACpF,2EAA2E;QAC3E,sDAAsD;IACxD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;gBAC1D,WAAW,EAAE,aAAa;aAC3B;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB;CACF,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC"}

package/dist/tools/get-token.d.ts

@@ -0,0 +1,18 @@
+export declare const getTokenTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handleGetToken(name: string): import("../tokens/types.js").TokenRecord | {
+    error: string;
+};
+//# sourceMappingURL=get-token.d.ts.map

package/dist/tools/get-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token.d.ts","sourceRoot":"","sources":["../../src/tools/get-token.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;CAexB,CAAC;AAEF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM;;EAE1C"}

package/dist/tools/get-token.js

@@ -0,0 +1,20 @@
+import { getToken } from '../tokens/query.js';
+export const getTokenTool = {
+    name: 'joy_get_token',
+    description: 'Get one Joy design token by path (color.text.heading) or CSS name (--joy-color-text-heading). ' +
+        'Returns value, layer, and usage docs (useFor, doNotUseFor, pairWith, replaces).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Token path or CSS custom property',
+            },
+        },
+        required: ['name'],
+    },
+};
+export function handleGetToken(name) {
+    return getToken(name);
+}
+//# sourceMappingURL=get-token.js.map

package/dist/tools/get-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-token.js","sourceRoot":"","sources":["../../src/tools/get-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,eAAe;IACrB,WAAW,EACT,gGAAgG;QAChG,iFAAiF;IACnF,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mCAAmC;aACjD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/tools/list-design-tokens.d.ts

@@ -1,21 +1,30 @@
+import { type ListDesignTokensInput } from '../tokens/query.js';
 export declare const listDesignTokensTool: {
     name: string;
     description: string;
     inputSchema: {
         type: string;
-        properties: {};
+        properties: {
+            layer: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            domain: {
+                type: string;
+                enum: string[];
+            };
+            includeDeprecated: {
+                type: string;
+                description: string;
+            };
+        };
         required: never[];
     };
 };
-export interface DesignTokensByDomain {
-    colors: Record<string, string>;
-    spacing: Record<string, string>;
-    typography: Record<string, string>;
-    radius: Record<string, string>;
-    elevation: Record<string, string>;
-    zIndex: Record<string, string>;
-    transitions: Record<string, string>;
-    forms: Record<string, string>;
-}
-export declare function handleListDesignTokens(): DesignTokensByDomain;
+export declare function handleListDesignTokens(args?: ListDesignTokensInput): {
+    layer: string;
+    count: number;
+    tokens: import("../tokens/types.js").TokenHit[];
+};
 //# sourceMappingURL=list-design-tokens.d.ts.map

package/dist/tools/list-design-tokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list-design-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/list-design-tokens.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB;;;;;;;;CAQhC,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,wBAAgB,sBAAsB,IAAI,oBAAoB,CAI7D"}
+{"version":3,"file":"list-design-tokens.d.ts","sourceRoot":"","sources":["../../src/tools/list-design-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGlF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;CAwBhC,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,qBAA0B;;;;EAMtE"}

package/dist/tools/list-design-tokens.js

@@ -1,19 +1,33 @@
-import { readFileSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-const __dirname = dirname(fileURLToPath(import.meta.url));
+import { listDesignTokens } from '../tokens/query.js';
 export const listDesignTokensTool = {
     name: 'joy_list_design_tokens',
-    description: 'Lists all available Joy design tokens (CSS custom properties) organized by domain (colors, spacing, typography, radius, elevation, zIndex, transitions, forms).',
+    description: 'List Joy design tokens as compact summaries. Defaults to the semantic layer only. ' +
+        'Pass layer=primitive or a domain to narrow. Prefer joy_search_tokens when you know the intent.',
     inputSchema: {
         type: 'object',
-        properties: {},
-        required: []
-    }
+        properties: {
+            layer: {
+                type: 'string',
+                enum: ['semantic', 'primitive', 'all'],
+                description: 'Defaults to semantic',
+            },
+            domain: {
+                type: 'string',
+                enum: ['color', 'spacing', 'radius', 'elevation', 'zIndex', 'typography', 'motion', 'forms', 'links'],
+            },
+            includeDeprecated: {
+                type: 'boolean',
+                description: 'Include deprecated aliases. Defaults to false.',
+            },
+        },
+        required: [],
+    },
 };
-export function handleListDesignTokens() {
-    const tokensFilePath = resolve(__dirname, '../../dist/doc/design-tokens.json');
-    const fileContent = readFileSync(tokensFilePath, 'utf-8');
-    return JSON.parse(fileContent);
+export function handleListDesignTokens(args = {}) {
+    return listDesignTokens({
+        layer: args.layer,
+        domain: args.domain,
+        includeDeprecated: args.includeDeprecated,
+    });
 }
 //# sourceMappingURL=list-design-tokens.js.map