@pixerate/editor 0.164.0 → 0.166.0

package/dist/{chunk-WI7QJA7A.cjs → chunk-UXETV2NC.cjs}

@@ -1,11 +1,15 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class;
 
-var _chunkM4MIZPQIcjs = require('./chunk-M4MIZPQI.cjs');
+var _chunkSJ2CPTQCcjs = require('./chunk-SJ2CPTQC.cjs');
 
 
 
 var _chunkA6QWKBJPcjs = require('./chunk-A6QWKBJP.cjs');
 
+
+
+var _chunk5UEFBM2Mcjs = require('./chunk-5UEFBM2M.cjs');
+
 // src/tokens/types.ts
 var TOKEN_TYPES = ["color", "number", "string", "boolean"];
 var TokenError = class extends Error {
@@ -1275,7 +1279,7 @@ function importW3CTokens(state, input, options = {}) {
 
 // src/tokens/editorDocument.ts
 function createTokensEditorDocument(store) {
-  return _chunkM4MIZPQIcjs.defineEditorDocument.call(void 0, {
+  return _chunkSJ2CPTQCcjs.defineEditorDocument.call(void 0, {
     kind: "tokens",
     get: () => store.toJSON(),
     load: (document, { history }) => {
@@ -1307,6 +1311,160 @@ function createTokensEditorDocument(store) {
   });
 }
 
+// src/tokens/style.ts
+function findVariable(state, ref) {
+  return _nullishCoalesce(getTokenVariable(state, ref), () => ( findTokenVariable(state, ref)));
+}
+function createTokenStyleSource(store) {
+  return {
+    resolve({ token, mode }) {
+      const state = store.getState();
+      const variable = findVariable(state, token);
+      if (!variable) return { ok: false, message: `there is no design token "${token}".` };
+      let modes;
+      if (mode !== void 0) {
+        const collection = getTokenCollection(state, variable.collectionId);
+        const found = findTokenMode(collection, mode);
+        if (!found) return { ok: false, message: `"${collection.name}" has no mode "${mode}"; its modes are ${collection.modes.map((m) => `"${m.name}"`).join(", ")}.` };
+        modes = { [collection.id]: found.id };
+      }
+      const resolved = resolveToken(state, variable.id, modes);
+      return resolved.ok ? { ok: true, value: resolved.value } : { ok: false, message: `"${token}" does not resolve: ${resolved.message}` };
+    },
+    subscribe: (listener) => store.subscribe(() => listener())
+  };
+}
+var profileOf = (profile) => profile;
+var requiredVariables = {
+  id: "required-variables",
+  description: `Every variable named in the profile's "required" list exists.`,
+  run(state, profile) {
+    const required = profileOf(profile).required;
+    if (!_optionalChain([required, 'optionalAccess', _23 => _23.length])) throw new Error('the profile has no "required" list.');
+    return required.filter((name) => !findVariable(state, name)).map((name) => ({ severity: "error", message: `The token set has no variable "${name}"; add it (house style requires it).`, target: { variable: name } }));
+  }
+};
+var namePattern = {
+  id: "name-pattern",
+  description: `Every variable name matches the profile's "namePattern" regular expression.`,
+  run(state, profile) {
+    const pattern = profileOf(profile).namePattern;
+    if (!pattern) throw new Error('the profile has no "namePattern".');
+    let re;
+    try {
+      re = new RegExp(pattern);
+    } catch (e4) {
+      throw new Error(`"namePattern" ${pattern} is not a valid regular expression.`);
+    }
+    return state.variables.filter((v) => !re.test(v.name)).map((v) => ({ severity: "warning", message: `Variable "${v.name}" does not match the naming pattern ${pattern}; rename it.`, target: { variableId: v.id } }));
+  }
+};
+var requiredModes = {
+  id: "required-modes",
+  description: `Every collection has the modes named in the profile's "modes" list (e.g. Light and Dark).`,
+  run(state, profile) {
+    const modes = profileOf(profile).modes;
+    if (!_optionalChain([modes, 'optionalAccess', _24 => _24.length])) throw new Error('the profile has no "modes" list.');
+    return state.collections.flatMap(
+      (c) => modes.filter((m) => !findTokenMode(c, m)).map((m) => ({ severity: "error", message: `Collection "${c.name}" has no "${m}" mode; add it.`, target: { collectionId: c.id } }))
+    );
+  }
+};
+var contrastPairs = {
+  id: "contrast-pairs",
+  description: `Each foreground / background pair in "contrastPairs" reaches its contrast ratio (default 4.5) in every mode of the foreground's collection.`,
+  run(state, profile) {
+    const pairs = profileOf(profile).contrastPairs;
+    if (!_optionalChain([pairs, 'optionalAccess', _25 => _25.length])) throw new Error('the profile has no "contrastPairs".');
+    const findings = [];
+    for (const { fg, bg, ratio = 4.5 } of pairs) {
+      const f = findVariable(state, fg);
+      const b = findVariable(state, bg);
+      if (!f || !b) {
+        findings.push({ severity: "error", message: `Contrast pair ${fg} on ${bg} names a variable the token set lacks (${!f ? fg : bg}).`, target: { variable: !f ? fg : bg } });
+        continue;
+      }
+      const collection = getTokenCollection(state, f.collectionId);
+      for (const mode of collection.modes) {
+        const modes = { [collection.id]: mode.id, [b.collectionId]: _nullishCoalesce(_optionalChain([findTokenMode, 'call', _26 => _26(getTokenCollection(state, b.collectionId), mode.name), 'optionalAccess', _27 => _27.id]), () => ( mode.id)) };
+        const fv = resolveToken(state, f.id, modes);
+        const bv = resolveToken(state, b.id, modes);
+        const fc = fv.ok && typeof fv.value === "string" ? _chunk5UEFBM2Mcjs.parseColor.call(void 0, fv.value) : null;
+        const bc = bv.ok && typeof bv.value === "string" ? _chunk5UEFBM2Mcjs.parseColor.call(void 0, bv.value) : null;
+        if (!fc || !bc) continue;
+        const r = _chunk5UEFBM2Mcjs.contrastRatio.call(void 0, fc, bc);
+        if (r < ratio) {
+          findings.push({
+            severity: "error",
+            message: `${f.name} on ${b.name} has contrast ${Math.round(r * 100) / 100}:1 in ${mode.name}; want at least ${ratio}:1, so darken or lighten one of them in that mode.`,
+            target: { variableId: f.id, modeId: mode.id }
+          });
+        }
+      }
+    }
+    return findings;
+  }
+};
+var tokensStyleDomain = {
+  id: "tokens",
+  title: "Design tokens",
+  description: "Rules for the token set itself: variables that must exist, a naming pattern, required modes and colour pairs that must reach a contrast ratio.",
+  profileSchema: {
+    type: "object",
+    properties: {
+      required: { type: "array", items: { type: "string", minLength: 1 }, description: 'Variable names that must exist, e.g. "brand/primary".' },
+      namePattern: { type: "string", minLength: 1, description: 'Regular expression every variable name must match, e.g. "^[a-z0-9-]+(/[a-z0-9-]+)*$".' },
+      modes: { type: "array", items: { type: "string", minLength: 1 }, description: 'Mode names every collection must have, e.g. ["Light", "Dark"].' },
+      contrastPairs: {
+        type: "array",
+        items: {
+          type: "object",
+          properties: {
+            fg: { type: "string", minLength: 1, description: "Foreground variable name or id." },
+            bg: { type: "string", minLength: 1, description: "Background variable name or id." },
+            ratio: { type: "number", minimum: 1, maximum: 21, description: "Smallest contrast ratio (default 4.5, WCAG AA for text)." }
+          },
+          required: ["fg", "bg"],
+          additionalProperties: false
+        },
+        description: "Colour pairs checked in every mode."
+      }
+    },
+    additionalProperties: false
+  },
+  checks: [requiredVariables, namePattern, requiredModes, contrastPairs]
+};
+function createTokensStyleToolProvider(store, styles, options = {}) {
+  if (!styles.domains.some((d) => d.id === "tokens")) throw new Error('The style resolver has no "tokens" domain; add tokensStyleDomain to its domains.');
+  const check = {
+    name: "check_tokens_style",
+    title: "Check token house style",
+    description: 'Checks the design-token set against the house style (see get_style with domain "tokens"): runs the checks its profile turns on (required-variables, name-pattern, required-modes, contrast-pairs). Returns findings with a severity, a sentence saying how to fix it, a target (variable id or name, mode id, collection id) and the layer that asked for it; plus the checks that ran and the ones skipped with the reason. Fix findings with get_tokens_document / load_tokens_document, then check again.',
+    inputSchema: { type: "object", properties: {}, additionalProperties: false },
+    annotations: { title: "Check token house style", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    handler: async () => {
+      const { style, ...report } = await styles.check("tokens", store.getState());
+      return {
+        ...report,
+        ok: report.findings.length === 0,
+        ...style.skills.length ? {} : { note: "No house style applies to design tokens." },
+        ...style.issues.length ? { issues: style.issues } : {}
+      };
+    }
+  };
+  return {
+    id: _nullishCoalesce(options.id, () => ( "tokens-style")),
+    namespace: _nullishCoalesce(options.namespace, () => ( "tokens")),
+    title: "Token house style",
+    description: "Check the design-token set against the house style.",
+    skill: "pixerate-tokens",
+    tools: [check]
+  };
+}
+
+
+
+
 
 
 
@@ -1361,4 +1519,4 @@ function createTokensEditorDocument(store) {
 
 
 
-exports.TOKEN_TYPES = TOKEN_TYPES; exports.TokenError = TokenError; exports.isTokenAlias = isTokenAlias; exports.EMPTY_TOKEN_STATE = EMPTY_TOKEN_STATE; exports.getTokenCollection = getTokenCollection; exports.getTokenVariable = getTokenVariable; exports.findTokenCollection = findTokenCollection; exports.findTokenVariable = findTokenVariable; exports.getCollectionVariables = getCollectionVariables; exports.getDefaultMode = getDefaultMode; exports.findTokenMode = findTokenMode; exports.getCurrentMode = getCurrentMode; exports.defaultTokenValue = defaultTokenValue; exports.coerceTokenLiteral = coerceTokenLiteral; exports.literalTokenType = literalTokenType; exports.formatTokenValue = formatTokenValue; exports.resolveToken = resolveToken; exports.resolveTokenValue = resolveTokenValue; exports.resolveTokenInMode = resolveTokenInMode; exports.checkTokenAlias = checkTokenAlias; exports.TOKEN_SCOPES_BY_TYPE = TOKEN_SCOPES_BY_TYPE; exports.isTokenScopeKnown = isTokenScopeKnown; exports.normalizeTokenScopes = normalizeTokenScopes; exports.isTokenInScope = isTokenInScope; exports.normalizeTokenName = normalizeTokenName; exports.defaultTokenId = defaultTokenId; exports.createTokenCollection = createTokenCollection; exports.renameTokenCollection = renameTokenCollection; exports.deleteTokenVariables = deleteTokenVariables; exports.deleteTokenCollection = deleteTokenCollection; exports.addTokenMode = addTokenMode; exports.renameTokenMode = renameTokenMode; exports.removeTokenMode = removeTokenMode; exports.moveTokenMode = moveTokenMode; exports.prepareTokenValue = prepareTokenValue; exports.createTokenVariable = createTokenVariable; exports.setTokenValue = setTokenValue; exports.renameTokenVariable = renameTokenVariable; exports.updateTokenVariable = updateTokenVariable; exports.parseTokenState = parseTokenState; exports.TokenStore = TokenStore; exports.createTokenStore = createTokenStore; exports.tokenSlug = tokenSlug; exports.getTokenCssName = getTokenCssName; exports.cssString = cssString; exports.formatTokenCssValue = formatTokenCssValue; exports.exportTokensCss = exportTokensCss; exports.getTokenCssVariables = getTokenCssVariables; exports.W3C_TOKENS_EXTENSION = W3C_TOKENS_EXTENSION; exports.exportW3CTokens = exportW3CTokens; exports.exportW3CTokensJson = exportW3CTokensJson; exports.importW3CTokens = importW3CTokens; exports.createTokensEditorDocument = createTokensEditorDocument;
+exports.TOKEN_TYPES = TOKEN_TYPES; exports.TokenError = TokenError; exports.isTokenAlias = isTokenAlias; exports.EMPTY_TOKEN_STATE = EMPTY_TOKEN_STATE; exports.getTokenCollection = getTokenCollection; exports.getTokenVariable = getTokenVariable; exports.findTokenCollection = findTokenCollection; exports.findTokenVariable = findTokenVariable; exports.getCollectionVariables = getCollectionVariables; exports.getDefaultMode = getDefaultMode; exports.findTokenMode = findTokenMode; exports.getCurrentMode = getCurrentMode; exports.defaultTokenValue = defaultTokenValue; exports.coerceTokenLiteral = coerceTokenLiteral; exports.literalTokenType = literalTokenType; exports.formatTokenValue = formatTokenValue; exports.resolveToken = resolveToken; exports.resolveTokenValue = resolveTokenValue; exports.resolveTokenInMode = resolveTokenInMode; exports.checkTokenAlias = checkTokenAlias; exports.TOKEN_SCOPES_BY_TYPE = TOKEN_SCOPES_BY_TYPE; exports.isTokenScopeKnown = isTokenScopeKnown; exports.normalizeTokenScopes = normalizeTokenScopes; exports.isTokenInScope = isTokenInScope; exports.normalizeTokenName = normalizeTokenName; exports.defaultTokenId = defaultTokenId; exports.createTokenCollection = createTokenCollection; exports.renameTokenCollection = renameTokenCollection; exports.deleteTokenVariables = deleteTokenVariables; exports.deleteTokenCollection = deleteTokenCollection; exports.addTokenMode = addTokenMode; exports.renameTokenMode = renameTokenMode; exports.removeTokenMode = removeTokenMode; exports.moveTokenMode = moveTokenMode; exports.prepareTokenValue = prepareTokenValue; exports.createTokenVariable = createTokenVariable; exports.setTokenValue = setTokenValue; exports.renameTokenVariable = renameTokenVariable; exports.updateTokenVariable = updateTokenVariable; exports.parseTokenState = parseTokenState; exports.TokenStore = TokenStore; exports.createTokenStore = createTokenStore; exports.tokenSlug = tokenSlug; exports.getTokenCssName = getTokenCssName; exports.cssString = cssString; exports.formatTokenCssValue = formatTokenCssValue; exports.exportTokensCss = exportTokensCss; exports.getTokenCssVariables = getTokenCssVariables; exports.W3C_TOKENS_EXTENSION = W3C_TOKENS_EXTENSION; exports.exportW3CTokens = exportW3CTokens; exports.exportW3CTokensJson = exportW3CTokensJson; exports.importW3CTokens = importW3CTokens; exports.createTokensEditorDocument = createTokensEditorDocument; exports.createTokenStyleSource = createTokenStyleSource; exports.tokensStyleDomain = tokensStyleDomain; exports.createTokensStyleToolProvider = createTokensStyleToolProvider;