@tanqory/dev-mcp 0.0.0-stage → 0.1.0-alpha.1

package/src/theme.mjs

@@ -0,0 +1,91 @@
+/**
+ * The theme this server works on: found from the working directory the agent host started the server in (or
+ * TANQORY_THEME_DIR). No argument of any tool names a store or a directory outside it; the store comes from
+ * `tanqory.config.json` and the CLI's login.
+ */
+import { existsSync, readFileSync, statSync } from 'node:fs'
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'
+
+export const CONFIG_FILE = 'tanqory.config.json'
+export const THEME_PACKAGES = ['@tanqory/theme-abi', '@tanqory/theme-kit', '@tanqory/theme-conformance']
+
+const readJson = (p) => {
+  try {
+    return JSON.parse(readFileSync(p, 'utf8'))
+  } catch {
+    return null
+  }
+}
+
+const dependsOnKit = (pkg) =>
+  Boolean(pkg && ['dependencies', 'devDependencies'].some((f) => pkg[f] && pkg[f]['@tanqory/theme-kit']))
+
+/**
+ * Walk up from `start` to the theme root: the first directory with tanqory.config.json, else the first with a
+ * package.json that depends on @tanqory/theme-kit. Returns null when there is none (the docs tools still work).
+ */
+export function findThemeRoot(start) {
+  let dir = resolve(start)
+  for (;;) {
+    if (existsSync(join(dir, CONFIG_FILE))) return dir
+    if (dependsOnKit(readJson(join(dir, 'package.json')))) return dir
+    const up = dirname(dir)
+    if (up === dir) return null
+    dir = up
+  }
+}
+
+/** The installed package root of `name` as Node would resolve it from `root` (node_modules walk), or null. */
+export function installedPackageDir(root, name) {
+  if (!root) return null
+  let dir = root
+  for (;;) {
+    const p = join(dir, 'node_modules', ...name.split('/'))
+    if (existsSync(join(p, 'package.json'))) return p
+    const up = dirname(dir)
+    if (up === dir) return null
+    dir = up
+  }
+}
+
+/** Which source layout the theme uses, so the scaffold knows where a section goes. */
+export function detectLayout(root) {
+  if (!root) return 'none'
+  const theme = join(root, 'src', 'theme.tsx')
+  if (existsSync(theme) && /defineTheme\s*\(/.test(readFileSync(theme, 'utf8'))) return 'kit-headless'
+  if (existsSync(join(root, 'theme.config.ts'))) return 'nova-fork'
+  return 'unknown'
+}
+
+export function loadTheme(cwd) {
+  const root = findThemeRoot(process.env.TANQORY_THEME_DIR || cwd)
+  if (!root) return { root: null, config: null, pkg: null, layout: 'none', versions: {} }
+  const config = readJson(join(root, CONFIG_FILE))
+  const pkg = readJson(join(root, 'package.json'))
+  const versions = {}
+  for (const name of THEME_PACKAGES) {
+    const dir = installedPackageDir(root, name)
+    versions[name] = dir ? readJson(join(dir, 'package.json'))?.version ?? null : null
+  }
+  return { root, config, pkg, layout: detectLayout(root), versions }
+}
+
+/**
+ * Resolve a theme-relative path and refuse anything that escapes the theme root (`..`, absolute paths, symlinked
+ * parents are not followed here; writes only ever target paths the scaffold planned itself).
+ */
+export function insideTheme(root, rel) {
+  if (typeof rel !== 'string' || rel === '' || isAbsolute(rel)) return null
+  const abs = resolve(root, rel)
+  const r = relative(root, abs)
+  if (r === '' || r.startsWith('..') || isAbsolute(r) || r.split(sep).includes('..')) return null
+  return abs
+}
+
+export const isFile = (p) => {
+  try {
+    return statSync(p).isFile()
+  } catch {
+    return false
+  }
+}