@brixies-mcp/server 0.0.0-stage → 1.12.8

package/lib/transforms.js

@@ -0,0 +1,185 @@
+/* Shared MCP/prepared-page transformations. No network or platform-specific APIs. */
+import postcss from "postcss";
+function generateRandomID() {
+  const chars = "abcdefghijklmnopqrstuvwxyz";
+  return Array.from({ length: 6 }, () => chars[Math.floor(Math.random() * chars.length)]).join("");
+}
+
+function generateUniqueIDs(count, existingIds) {
+  const used = new Set(existingIds);
+  const result = [];
+  while (result.length < count) {
+    const id = generateRandomID();
+    if (!used.has(id)) { used.add(id); result.push(id); }
+  }
+  return result;
+}
+
+// Return null for a valid block name, otherwise a validation message.
+function validateBemName(name) {
+  if (!name || !name.trim()) return "Name is empty.";
+  if (name.trim() === "grid") return "The word \"grid\" alone is reserved. Use something like \"blog-grid\".";
+  if (!/^[a-zA-Z0-9\-_]+$/.test(name.trim())) return "Use only letters, numbers, hyphens and underscores. No spaces or dots.";
+  return null;
+}
+
+// Discover owned CSS definitions without serializing/reformatting the stylesheet.
+function layoutCssTokens(parsed, oldName, newName) {
+  const definitions = new Set();
+  function collect(value, key = '') {
+    if (typeof value === 'string' && ['cssCode', '_cssCustom'].includes(key) && value.trim()) {
+      const root = postcss.parse(value);
+      root.walkDecls(d => { if (d.prop.startsWith('--')) definitions.add(d.prop); });
+      root.walkAtRules(a => {
+        if (/^(?:-webkit-)?keyframes$/i.test(a.name) || a.name.toLowerCase() === 'property') {
+          const token = a.params.trim().replace(/^(['"])(.*)\1$/, '$2');
+          if (/^(?:--)?[a-zA-Z_][a-zA-Z0-9_-]*$/.test(token)) definitions.add(token);
+        }
+      });
+    } else if (Array.isArray(value)) value.forEach(v => collect(v));
+    else if (value && typeof value === 'object') {
+      for (const [k,v] of Object.entries(value)) {
+        if (k === 'globalClasses') {
+          for (const c of v || []) if (typeof c.name === 'string' && isBlockClass(c.name, oldName)) collect(c);
+        } else collect(v,k);
+      }
+    }
+  }
+  collect(parsed);
+  const mapping = new Map();
+  for (const token of definitions) {
+    const prefix = token.startsWith('--') ? '--' : '';
+    const name = token.slice(prefix.length);
+    if (!isBlockClass(name, oldName)) continue;
+    const base = name.startsWith('card-' + oldName) ? 'card-' + oldName : oldName;
+    const target = prefix + (base === 'card-' + oldName ? 'card-' : '') + newName.trim() + name.slice(base.length);
+    if (target !== token && definitions.has(target)) throw new Error(`CSS name collision: ${target} is already defined. Choose another block name.`);
+    mapping.set(token,target);
+  }
+  return mapping;
+}
+
+// Preserve comment text and every byte outside literal identifiers. Quoted JS
+// references (setProperty/getPropertyValue/animationName) are included. Dynamic
+// string construction is not evaluated.
+function replaceLayoutTokens(value, mapping, key = '') {
+  if (!mapping.size) return value;
+  const replace = text => text.replace(/(?<![\w\\\u0080-\uFFFF-])(?:--)?[a-zA-Z_][a-zA-Z0-9_-]*(?![\w\\\u0080-\uFFFF-])/g, token => mapping.get(token) ?? token);
+  const parts = ['jsCode', 'code'].includes(key)
+    ? /\/\*[\s\S]*?\*\/|"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|\/\/[^\r\n]*|[^/"']+|[\s\S]/g
+    : /\/\*[\s\S]*?\*\/|"(?:\\[\s\S]|[^"\\])*"|'(?:\\[\s\S]|[^'\\])*'|[^/"']+|[\s\S]/g;
+  return value.replace(parts,
+    part => part.startsWith('/*') || (['jsCode', 'code'].includes(key) && part.startsWith('//')) ? part : replace(part));
+}
+
+// Assign new IDs to owned classes and rename their BEM references; preserve shared classes.
+function applyBemRename(jsonText, oldName, newName) {
+  const err = validateBemName(newName);
+  if (err) return { ok: false, error: err };
+  if (!oldName || oldName === 'unknown') return { ok: false, error: 'Missing source BEM block name; cannot rename reliably.' };
+  try {
+    const parsed = JSON.parse(jsonText);
+    const classes = parsed.globalClasses || [];
+    const layoutClasses = classes.filter(c => typeof c.name === 'string' && isBlockClass(c.name, oldName));
+    // Derive companion block roots from actual class definitions. Match exact
+    // roots or BEM suffixes, not arbitrary prefix text (e.g. animation names).
+    const roots = new Set([oldName, 'card-' + oldName]);
+    for (const cls of layoutClasses) roots.add(cls.name.split(/__|--/)[0]);
+    const escape = value => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const names = new RegExp('(?<![a-zA-Z0-9_-])(?:' + [...roots].sort((a,b) => b.length-a.length).map(escape).join('|') + ')(?=__|--|$|[^a-zA-Z0-9_-])', 'g');
+    const renameRoot = root => root.startsWith('card-' + oldName)
+      ? 'card-' + newName.trim() + root.slice(('card-' + oldName).length)
+      : newName.trim() + root.slice(oldName.length);
+    const cssTokens = layoutCssTokens(parsed, oldName, newName);
+    const newIds = generateUniqueIDs(layoutClasses.length, classes.map(c => c.id));
+    const idMap = new Map(layoutClasses.map((c, i) => [c.id, newIds[i]]));
+    function visit(value, field = '') {
+      if (typeof value === 'string') {
+        if (idMap.has(value)) return idMap.get(value);
+        return replaceLayoutTokens(value, cssTokens, field).replace(names, renameRoot);
+      }
+      if (Array.isArray(value)) return value.map(v => visit(v, field));
+      if (value && typeof value === 'object') return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, visit(val, key)]));
+      return value;
+    }
+    const renamed = visit(parsed);
+    // Shared definitions are opaque: never rename their settings, IDs or metadata.
+    renamed.globalClasses = classes.map(c => layoutClasses.includes(c) ? visit(c) : bxClone(c));
+    return { ok: true, json: JSON.stringify(renamed), count: layoutClasses.length };
+  } catch (error) { return { ok: false, error: `Invalid Bricks JSON: ${error.message}` }; }
+}
+
+
+
+function semverGreater(a, b) {
+  const pa = (a||'0').split('.').map(Number), pb = (b||'0').split('.').map(Number);
+  for (let i=0;i<3;i++) { if((pa[i]||0)>(pb[i]||0)) return true; if((pa[i]||0)<(pb[i]||0)) return false; }
+  return false;
+}
+function deepEqual(a,b) { return JSON.stringify(a)===JSON.stringify(b); }
+function bxClone(obj) { return JSON.parse(JSON.stringify(obj)); }
+function uniqueId(used) {
+  const ch='abcdefghijklmnopqrstuvwxyz'; let id;
+  do { id=Array.from({length:6},()=>ch[Math.floor(Math.random()*ch.length)]).join(''); } while(used.has(id));
+  return id;
+}
+// Merge layouts, remapping colliding IDs and retaining identical shared classes.
+function mergeSnippets(snippets) {
+  const out={content:[],source:'bricksCopiedElements',sourceUrl:'https://brixies.co',version:'0.0.0',globalClasses:[],globalElements:[]};
+  const usedN=new Set(), usedC=new Set(), cIdx=new Map();
+  function pushGC(gc,cMap) {
+    if(!gc||!gc.id) return;
+    let nid=gc.id;
+    if(usedC.has(nid)) {
+      const ex=out.globalClasses[cIdx.get(nid)];
+      if(deepEqual(ex,gc)){cMap[gc.id]=nid;return;}
+      nid=uniqueId(usedC);
+      const cl=bxClone(gc);cl.id=nid;out.globalClasses.push(cl);usedC.add(nid);cIdx.set(nid,out.globalClasses.length-1);
+    } else { const cl=bxClone(gc);out.globalClasses.push(cl);usedC.add(nid);cIdx.set(nid,out.globalClasses.length-1); }
+    cMap[gc.id]=nid;
+  }
+  for(const s of snippets) if(s&&semverGreater(s.version,out.version)) out.version=s.version;
+  if(out.version==='0.0.0') out.version='2.0.0';
+  for(const sn of snippets) {
+    if(!sn||typeof sn!=='object') continue;
+    const nodes=Array.isArray(sn.content)?sn.content:[];
+    const gC=Array.isArray(sn.globalClasses)?sn.globalClasses:[];
+    const gE=Array.isArray(sn.globalElements)?sn.globalElements:[];
+    const nMap=Object.create(null), cMap=Object.create(null);
+    for(const gc of gC) pushGC(gc,cMap);
+    for(const n of nodes) {
+      if(!n||!n.id) continue;
+      let nid=n.id; if(usedN.has(nid)) nid=uniqueId(usedN);
+      nMap[n.id]=nid; usedN.add(nid);
+    }
+    for(const n of nodes) {
+      if(!n||!n.id) continue;
+      const nd=bxClone(n); nd.id=nMap[n.id];
+      if(nd.parent&&nd.parent!==0&&nMap[nd.parent]) nd.parent=nMap[nd.parent];
+      if(Array.isArray(nd.children)&&nd.children.length) nd.children=nd.children.map(id=>nMap[id]||id);
+      if(nd.settings&&Array.isArray(nd.settings._cssGlobalClasses))
+        nd.settings._cssGlobalClasses=nd.settings._cssGlobalClasses.map(id=>cMap[id]||id);
+      const remapReferences = value => {
+        if (typeof value === 'string') {
+          if (nMap[value]) return nMap[value];
+          return value.replace(/brxe-([a-zA-Z0-9]{6})(?![a-zA-Z0-9_-])/g, (match, id) => nMap[id] ? 'brxe-' + nMap[id] : match);
+        }
+        if (Array.isArray(value)) return value.map(remapReferences);
+        if (value && typeof value === 'object') return Object.fromEntries(Object.entries(value).map(([key, val]) => [key, remapReferences(val)]));
+        return value;
+      };
+      if (nd.settings) nd.settings = remapReferences(nd.settings);
+      out.content.push(nd);
+    }
+    for(const ge of gE) out.globalElements.push(bxClone(ge));
+  }
+  return out;
+}
+
+function isBlockClass(name, blockName) {
+  return [blockName, `card-${blockName}`].some(base =>
+    name === base || name.startsWith(`${base}__`) || name.startsWith(`${base}-`));
+}
+
+
+export { applyBemRename, mergeSnippets, validateBemName, isBlockClass, bxClone };

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@brixies-mcp/server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.12.8",
+  "type": "module",
+  "description": "Brixies authenticated catalog MCP",
+  "main": "index.js",
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "test": "node test/migration.test.mjs && node test/rename.test.mjs && node test/requests.test.mjs && node test/preparations.test.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "acorn": "8.18.0",
+    "acorn-walk": "8.3.5",
+    "postcss": "8.5.28",
+    "postcss-selector-parser": "7.1.6",
+    "zod": "3.25.76"
+  },
+  "bin": {
+    "brixies-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "lib/"
+  ],
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "tag": "next",
+    "registry": "https://registry.npmjs.org/"
+  }
+}