@sightmap/sightmap 0.1.0

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/parse.ts","../src/validate.ts","../src/diagnostics.ts","../src/merge.ts","../src/loadDirectory.ts","../src/routeMatch.ts","../src/resolver.ts","../src/match.ts","../src/explain.ts","../src/lintRules/duplicateName.ts","../src/lintRules/duplicateRoute.ts","../src/lintRules/routeShadowing.ts","../src/lintRules/unknownSource.ts","../src/lintRules/selectorSyntax.ts","../src/lint.ts"],"sourcesContent":["import yaml from \"js-yaml\";\nimport type { SightmapFragment } from \"./sightmap.js\";\nimport type { Component } from \"./types.js\";\n\nexport interface ParseOptions {\n  /** Optional source file path; recorded on the fragment for canonical-order merging. */\n  sourceFile?: string;\n}\n\n/**\n * Parse a single sightmap file (YAML string or pre-parsed object).\n * Throws on parse error, missing version, or version mismatch.\n * Normalizes `selector: string` to `selector: [string]` everywhere.\n */\nexport function parse(input: string | object, opts: ParseOptions = {}): SightmapFragment {\n  let doc: unknown;\n  if (typeof input === \"string\") {\n    try {\n      doc = yaml.load(input);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      throw new Error(`YAML parse error: ${msg}`);\n    }\n  } else {\n    // Shallow-clone caller's object so we don't mutate it.\n    doc = { ...input };\n  }\n\n  if (doc === null || typeof doc !== \"object\" || Array.isArray(doc)) {\n    throw new Error(\"Expected sightmap document to be an object at the root\");\n  }\n\n  const obj = doc as Record<string, unknown>;\n  if (obj[\"version\"] === undefined) {\n    throw new Error(\"Missing required `version` field\");\n  }\n  if (obj[\"version\"] !== 1) {\n    throw new Error(`Unsupported version: ${String(obj[\"version\"])} (expected 1)`);\n  }\n\n  // Normalize selectors recursively. Spread each view to avoid mutating\n  // shared view objects when the caller passed a pre-parsed input.\n  if (Array.isArray(obj[\"components\"])) {\n    obj[\"components\"] = (obj[\"components\"] as Component[]).map(normalizeComponent);\n  }\n  if (Array.isArray(obj[\"views\"])) {\n    obj[\"views\"] = (obj[\"views\"] as Array<Record<string, unknown>>).map((v) => {\n      const out = { ...v };\n      if (Array.isArray(out[\"components\"])) {\n        out[\"components\"] = (out[\"components\"] as Component[]).map(normalizeComponent);\n      }\n      return out;\n    });\n  }\n\n  const fragment = {\n    ...obj,\n    __brand: \"SightmapFragment\" as const,\n    ...(opts.sourceFile !== undefined ? { __sourceFile: opts.sourceFile } : {}),\n  } as SightmapFragment;\n  return fragment;\n}\n\nfunction normalizeComponent(c: Component): Component {\n  const sel = c.selector;\n  const normalized: Component = {\n    ...c,\n    selector: typeof sel === \"string\" ? [sel] : (sel as [string, ...string[]]),\n  };\n  if (Array.isArray(c.children)) {\n    normalized.children = c.children.map(normalizeComponent);\n  }\n  return normalized;\n}\n","import yaml from \"js-yaml\";\nimport { Ajv2020 } from \"ajv/dist/2020.js\";\nimport type { ValidateResult, SightmapFragment } from \"./sightmap.js\";\nimport {\n  PARSE_ERROR,\n  SCHEMA_VALIDATION_FAILED,\n  UNKNOWN_VERSION,\n  type Diagnostic,\n} from \"./diagnostics.js\";\nimport { parse } from \"./parse.js\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { resolve, dirname } from \"node:path\";\n\nconst __dirname = dirname(fileURLToPath(import.meta.url));\n// Resolve the vendored schema in two contexts:\n// - Production (published package): bundled file lives at dist/index.js, schema at dist/vendored/.\n// - Dev (vitest, source files): validate.ts lives at src/, schema at ../vendored/.\nconst schemaCandidates = [\n  resolve(__dirname, \"./vendored/sightmap.schema.json\"),\n  resolve(__dirname, \"../vendored/sightmap.schema.json\"),\n];\nconst schemaPath = schemaCandidates.find((p) => existsSync(p));\nif (schemaPath === undefined) {\n  throw new Error(\n    `vendored sightmap.schema.json not found. Looked in: ${schemaCandidates.join(\", \")}`,\n  );\n}\nconst schema = JSON.parse(readFileSync(schemaPath, \"utf8\")) as unknown;\n\nconst ajv = new Ajv2020({ allErrors: true, strict: false });\nconst ajvValidate = ajv.compile(schema as object);\n\nexport interface ValidateOptions {\n  sourceFile?: string;\n}\n\nexport function validate(input: string | object, opts: ValidateOptions = {}): ValidateResult {\n  const diagnostics: Diagnostic[] = [];\n  let doc: unknown;\n\n  if (typeof input === \"string\") {\n    try {\n      doc = yaml.load(input);\n    } catch (err) {\n      const e = err as { message?: string; mark?: { line?: number; column?: number } };\n      diagnostics.push({\n        severity: \"error\",\n        code: PARSE_ERROR,\n        message: e.message ?? \"YAML parse error\",\n        ...(opts.sourceFile !== undefined ? { file: opts.sourceFile } : {}),\n        ...(e.mark\n          ? { loc: { line: (e.mark.line ?? 0) + 1, column: (e.mark.column ?? 0) + 1 } }\n          : {}),\n      });\n      return { ok: false, diagnostics };\n    }\n  } else {\n    doc = input;\n  }\n\n  if (doc === null || typeof doc !== \"object\" || Array.isArray(doc)) {\n    diagnostics.push({\n      severity: \"error\",\n      code: SCHEMA_VALIDATION_FAILED,\n      message: \"Expected document root to be an object\",\n      ...(opts.sourceFile !== undefined ? { file: opts.sourceFile } : {}),\n    });\n    return { ok: false, diagnostics };\n  }\n\n  const obj = doc as Record<string, unknown>;\n  if (obj[\"version\"] !== 1) {\n    diagnostics.push({\n      severity: \"error\",\n      code: UNKNOWN_VERSION,\n      message:\n        obj[\"version\"] === undefined\n          ? \"Missing required `version` field\"\n          : `Unsupported version: ${String(obj[\"version\"])} (expected 1)`,\n      ...(opts.sourceFile !== undefined ? { file: opts.sourceFile } : {}),\n      path: \"/version\",\n    });\n    return { ok: false, diagnostics };\n  }\n\n  const ok = ajvValidate(obj);\n  if (!ok) {\n    for (const e of ajvValidate.errors ?? []) {\n      diagnostics.push({\n        severity: \"error\",\n        code: SCHEMA_VALIDATION_FAILED,\n        message: `${e.instancePath || \"(root)\"} ${e.message ?? \"\"}`.trim(),\n        ...(opts.sourceFile !== undefined ? { file: opts.sourceFile } : {}),\n        ...(e.instancePath ? { path: e.instancePath } : {}),\n      });\n    }\n    return { ok: false, diagnostics };\n  }\n\n  // Schema-valid: now run parse() (which normalizes selectors and brands).\n  let value: SightmapFragment;\n  try {\n    value = parse(obj, opts.sourceFile !== undefined ? { sourceFile: opts.sourceFile } : {});\n  } catch (err) {\n    diagnostics.push({\n      severity: \"error\",\n      code: SCHEMA_VALIDATION_FAILED,\n      message: err instanceof Error ? err.message : String(err),\n      ...(opts.sourceFile !== undefined ? { file: opts.sourceFile } : {}),\n    });\n    return { ok: false, diagnostics };\n  }\n  return { ok: true, value };\n}\n","export type Severity = \"error\" | \"warning\" | \"info\";\n\nexport interface Diagnostic {\n  severity: Severity;\n  code: string;\n  message: string;\n  file?: string;\n  path?: string;\n  loc?: { line: number; column: number };\n  source?: string;\n}\n\n// Stable, kebab-case codes. Renames require an SEP.\nexport const PARSE_ERROR = \"parse-error\";\nexport const SCHEMA_VALIDATION_FAILED = \"schema-validation-failed\";\nexport const UNKNOWN_VERSION = \"unknown-version\";\nexport const MERGE_COLLISION_VIEW = \"merge-collision-view\";\nexport const MERGE_COLLISION_COMPONENT = \"merge-collision-component\";\nexport const DUPLICATE_VIEW_NAME = \"duplicate-view-name\";\nexport const DUPLICATE_ROUTE = \"duplicate-route\";\nexport const ROUTE_SHADOWING = \"route-shadowing\";\nexport const UNKNOWN_SOURCE = \"unknown-source\";\nexport const SELECTOR_SYNTAX = \"selector-syntax\";\n","import type { SightmapFragment, Sightmap } from \"./sightmap.js\";\nimport type { View, Component, Request } from \"./types.js\";\nimport {\n  MERGE_COLLISION_VIEW,\n  MERGE_COLLISION_COMPONENT,\n  type Diagnostic,\n} from \"./diagnostics.js\";\n\n/**\n * Merge fragments into a queryable Sightmap.\n *\n * Canonical order: fragments are sorted by `__sourceFile` (code-point order; locale-independent\n * for cross-environment determinism). Fragments without a `__sourceFile` sort first, and ES2019\n * sort stability preserves their input order. Within each fragment, declaration order is\n * preserved. The merged collection's order = (sourceFile order, then declaration order).\n *\n * Duplicate view names produce `merge-collision-view` warnings; duplicate global component\n * names produce `merge-collision-component`. The first occurrence wins.\n *\n * Returned arrays are fresh, but element objects (View/Component/Request) are shared with\n * the input fragments — callers must not mutate them.\n */\nexport function merge(fragments: SightmapFragment[]): Sightmap {\n  const sorted = [...fragments].sort((a, b) => {\n    const aFile = a.__sourceFile ?? \"\";\n    const bFile = b.__sourceFile ?? \"\";\n    return aFile < bFile ? -1 : aFile > bFile ? 1 : 0;\n  });\n\n  const views: View[] = [];\n  const globalComponents: Component[] = [];\n  const globalRequests: Request[] = [];\n  const fileMemory: { memory: string[]; sourceFile: string }[] = [];\n  const diagnostics: Diagnostic[] = [];\n\n  const seenViewNames = new Map<string, string>(); // name → sourceFile\n  const seenComponentNames = new Map<string, string>();\n\n  for (const f of sorted) {\n    const file = f.__sourceFile ?? \"<unknown>\";\n\n    for (const v of f.views ?? []) {\n      const prev = seenViewNames.get(v.name);\n      if (prev !== undefined) {\n        diagnostics.push({\n          severity: \"warning\",\n          code: MERGE_COLLISION_VIEW,\n          message: `View name \"${v.name}\" defined in both \"${prev}\" and \"${file}\"; first occurrence wins.`,\n          file,\n        });\n      } else {\n        seenViewNames.set(v.name, file);\n      }\n      views.push(v); // keep all views; first-match-wins is enforced at resolve time\n    }\n\n    for (const c of f.components ?? []) {\n      const prev = seenComponentNames.get(c.name);\n      if (prev !== undefined) {\n        diagnostics.push({\n          severity: \"warning\",\n          code: MERGE_COLLISION_COMPONENT,\n          message: `Component name \"${c.name}\" defined in both \"${prev}\" and \"${file}\"; first occurrence wins.`,\n          file,\n        });\n      } else {\n        seenComponentNames.set(c.name, file);\n      }\n      globalComponents.push(c);\n    }\n\n    for (const r of f.requests ?? []) {\n      globalRequests.push(r);\n    }\n\n    if (Array.isArray(f.memory) && f.memory.length > 0) {\n      fileMemory.push({ memory: [...f.memory], sourceFile: file });\n    }\n  }\n\n  return {\n    version: 1,\n    views,\n    globalComponents,\n    globalRequests,\n    fileMemory,\n    diagnostics,\n    __brand: \"Sightmap\",\n  };\n}\n","import { readFile, readdir } from \"node:fs/promises\";\nimport { join, extname, relative, resolve } from \"node:path\";\nimport { merge } from \"./merge.js\";\nimport { validate } from \"./validate.js\";\nimport type { Sightmap, SightmapFragment } from \"./sightmap.js\";\nimport type { Diagnostic } from \"./diagnostics.js\";\n\nexport interface LoadDirectoryOptions {\n  /** Optional root for `file` fields in diagnostics. Default: the directory passed in. */\n  diagnosticRoot?: string;\n}\n\n/**\n * Recursively load all *.yaml/*.yml files under `dir`, validate each, and merge.\n *\n * Files that fail validation contribute their diagnostics to the merged Sightmap's\n * `diagnostics` array but are otherwise skipped. This keeps loadDirectory total —\n * a single bad file doesn't abort the whole load.\n */\nexport async function loadDirectory(\n  dir: string,\n  opts: LoadDirectoryOptions = {},\n): Promise<Sightmap> {\n  const absDir = resolve(dir);\n  const root = opts.diagnosticRoot !== undefined ? resolve(opts.diagnosticRoot) : absDir;\n\n  const files = await collectYamlFiles(absDir);\n  files.sort(); // alphabetical canonical order\n\n  const fragments: SightmapFragment[] = [];\n  const loadDiagnostics: Diagnostic[] = [];\n\n  for (const file of files) {\n    const relPath = relative(root, file);\n    const text = await readFile(file, \"utf8\");\n    const r = validate(text, { sourceFile: relPath });\n    if (r.ok) {\n      fragments.push(r.value);\n    } else {\n      loadDiagnostics.push(...r.diagnostics);\n    }\n  }\n\n  const merged = merge(fragments);\n  return {\n    ...merged,\n    diagnostics: [...loadDiagnostics, ...merged.diagnostics],\n  };\n}\n\nasync function collectYamlFiles(dir: string): Promise<string[]> {\n  const out: string[] = [];\n  const entries = await readdir(dir, { withFileTypes: true });\n  for (const e of entries) {\n    const p = join(dir, e.name);\n    if (e.isDirectory()) {\n      out.push(...(await collectYamlFiles(p)));\n    } else if (e.isFile()) {\n      const ext = extname(p).toLowerCase();\n      if (ext === \".yaml\" || ext === \".yml\") out.push(p);\n    }\n  }\n  return out;\n}\n","/**\n * Canonicalize a URL or pathname for matching.\n * - Accepts absolute URL or pathname.\n * - Strips scheme, host, query string, and fragment.\n * - Normalizes trailing slashes (except for the root \"/\").\n */\nexport function canonicalizeUrl(input: string): string {\n  let s = input;\n  // Strip absolute prefix.\n  const protoMatch = /^[a-z][a-z0-9+.-]*:\\/\\/[^/]*/i.exec(s);\n  if (protoMatch) {\n    s = s.slice(protoMatch[0].length) || \"/\";\n  }\n  // Strip fragment.\n  const hash = s.indexOf(\"#\");\n  if (hash !== -1) s = s.slice(0, hash);\n  // Strip query.\n  const q = s.indexOf(\"?\");\n  if (q !== -1) s = s.slice(0, q);\n  // Trailing slash.\n  if (s.length > 1 && s.endsWith(\"/\")) s = s.slice(0, -1);\n  return s;\n}\n\n/**\n * Test whether a glob route pattern matches a URL pathname.\n * Pattern syntax (per spec):\n *   - Literal segments match themselves\n *   - \"*\" matches exactly one path segment\n *   - \"**\" matches any depth of segments\n *   - \":param\" segments normalize to \"*\"\n *   - Matching is case-sensitive\n *   - Trailing slashes ignored\n */\nexport function routeMatch(pattern: string, url: string): boolean {\n  const p = normalizePattern(pattern);\n  const u = canonicalizeUrl(url);\n  const patternSegs = splitSegments(p);\n  const urlSegs = splitSegments(u);\n  return matchSegs(patternSegs, urlSegs);\n}\n\nfunction normalizePattern(p: string): string {\n  // Replace \":param\" segments with \"*\"\n  let s = p\n    .split(\"/\")\n    .map((seg) => (seg.startsWith(\":\") ? \"*\" : seg))\n    .join(\"/\");\n  if (s.length > 1 && s.endsWith(\"/\")) s = s.slice(0, -1);\n  return s;\n}\n\nfunction splitSegments(path: string): string[] {\n  if (path === \"/\" || path === \"\") return [];\n  const trimmed = path.startsWith(\"/\") ? path.slice(1) : path;\n  return trimmed.split(\"/\");\n}\n\nfunction matchSegs(pattern: string[], url: string[]): boolean {\n  if (pattern.length === 0 && url.length === 0) return true;\n  if (pattern.length === 0) return false;\n\n  const head = pattern[0]!;\n  const rest = pattern.slice(1);\n\n  if (head === \"**\") {\n    // Match zero or more segments.\n    if (rest.length === 0) return true;\n    for (let i = 0; i <= url.length; i++) {\n      if (matchSegs(rest, url.slice(i))) return true;\n    }\n    return false;\n  }\n\n  if (url.length === 0) return false;\n  if (head === \"*\" || head === url[0]) {\n    return matchSegs(rest, url.slice(1));\n  }\n  return false;\n}\n","import type {\n  Sightmap,\n  MatchResult,\n  ExplainHit,\n  ResolvedView,\n  ResolvedComponent,\n  ResolvedRequest,\n} from \"./sightmap.js\";\nimport type { View, Component, Request } from \"./types.js\";\nimport { routeMatch } from \"./routeMatch.js\";\n\nexport function resolveByUrl(\n  sightmap: Sightmap,\n  url: string,\n  method?: string,\n): MatchResult {\n  // First-match-wins on views.\n  let matchedView: View | null = null;\n  for (const v of sightmap.views) {\n    if (routeMatch(v.route, url)) {\n      matchedView = v;\n      break;\n    }\n  }\n\n  const components: ResolvedComponent[] = [];\n  for (const c of sightmap.globalComponents) {\n    components.push(...flattenComponent(c, [], \"global\", undefined));\n  }\n  if (matchedView !== null && Array.isArray(matchedView.components)) {\n    for (const c of matchedView.components) {\n      components.push(...flattenComponent(c, [], \"view-scoped\", matchedView.name));\n    }\n  }\n\n  const requests: ResolvedRequest[] = [];\n  const requestPool: Request[] = [\n    ...sightmap.globalRequests,\n    ...((matchedView?.requests ?? [])),\n  ];\n  for (const req of requestPool) {\n    if (!routeMatch(req.route, url)) continue;\n    if (method !== undefined && req.method !== undefined && req.method !== method) continue;\n    requests.push(toResolvedRequest(req));\n  }\n\n  const memory: string[] = [];\n  for (const fm of sightmap.fileMemory) memory.push(...fm.memory);\n  if (matchedView?.memory) memory.push(...matchedView.memory);\n\n  return {\n    view: matchedView !== null ? toResolvedView(matchedView) : null,\n    components,\n    requests,\n    memory,\n  };\n}\n\nexport function resolveByName(sightmap: Sightmap, name: string): ExplainHit[] {\n  const hits: ExplainHit[] = [];\n  for (const v of sightmap.views) {\n    if (v.name === name) hits.push({ type: \"view\", matchedAs: \"name\", entry: toResolvedView(v) });\n  }\n  for (const c of sightmap.globalComponents) {\n    for (const rc of flattenComponent(c, [], \"global\", undefined)) {\n      if (rc.name === name) hits.push({ type: \"component\", matchedAs: \"name\", entry: rc });\n    }\n  }\n  for (const v of sightmap.views) {\n    for (const c of v.components ?? []) {\n      for (const rc of flattenComponent(c, [], \"view-scoped\", v.name)) {\n        if (rc.name === name) hits.push({ type: \"component\", matchedAs: \"name\", entry: rc });\n      }\n    }\n  }\n  for (const r of sightmap.globalRequests) {\n    if (r.name === name) hits.push({ type: \"request\", matchedAs: \"name\", entry: toResolvedRequest(r) });\n  }\n  for (const v of sightmap.views) {\n    for (const r of v.requests ?? []) {\n      if (r.name === name) hits.push({ type: \"request\", matchedAs: \"name\", entry: toResolvedRequest(r) });\n    }\n  }\n  return hits;\n}\n\nexport function resolveBySourcePath(sightmap: Sightmap, path: string): ExplainHit[] {\n  const hits: ExplainHit[] = [];\n  for (const v of sightmap.views) {\n    if (v.source === path) hits.push({ type: \"view\", matchedAs: \"path\", entry: toResolvedView(v) });\n  }\n  for (const c of sightmap.globalComponents) {\n    for (const rc of flattenComponent(c, [], \"global\", undefined)) {\n      if (rc.source === path) hits.push({ type: \"component\", matchedAs: \"path\", entry: rc });\n    }\n  }\n  for (const v of sightmap.views) {\n    for (const c of v.components ?? []) {\n      for (const rc of flattenComponent(c, [], \"view-scoped\", v.name)) {\n        if (rc.source === path) hits.push({ type: \"component\", matchedAs: \"path\", entry: rc });\n      }\n    }\n  }\n  for (const r of sightmap.globalRequests) {\n    if (r.source === path) hits.push({ type: \"request\", matchedAs: \"path\", entry: toResolvedRequest(r) });\n  }\n  return hits;\n}\n\nfunction flattenComponent(\n  c: Component,\n  parentChain: string[],\n  scope: \"global\" | \"view-scoped\",\n  scopedToView: string | undefined,\n): ResolvedComponent[] {\n  const out: ResolvedComponent[] = [];\n  const selector = Array.isArray(c.selector) ? c.selector : [c.selector as unknown as string];\n  out.push({\n    name: c.name,\n    selector,\n    ...(c.source !== undefined ? { source: c.source } : {}),\n    ...(c.description !== undefined ? { description: c.description } : {}),\n    memory: c.memory ? [...c.memory] : [],\n    parentChain: [...parentChain],\n    scope,\n    ...(scopedToView !== undefined ? { scopedToView } : {}),\n    definedIn: { file: \"<unknown>\" },\n  });\n  for (const child of c.children ?? []) {\n    out.push(...flattenComponent(child, [...parentChain, c.name], scope, scopedToView));\n  }\n  return out;\n}\n\nfunction toResolvedView(v: View): ResolvedView {\n  return {\n    name: v.name,\n    route: v.route,\n    ...(v.source !== undefined ? { source: v.source } : {}),\n    ...(v.description !== undefined ? { description: v.description } : {}),\n    memory: v.memory ? [...v.memory] : [],\n    definedIn: { file: \"<unknown>\" },\n  };\n}\n\nfunction toResolvedRequest(r: Request): ResolvedRequest {\n  return {\n    name: r.name,\n    route: r.route,\n    ...(r.method !== undefined ? { method: r.method } : {}),\n    ...(r.source !== undefined ? { source: r.source } : {}),\n    ...(r.description !== undefined ? { description: r.description } : {}),\n    ...(r.request !== undefined ? { request: { fields: r.request.fields ?? [] } } : {}),\n    ...(r.response !== undefined ? { response: { fields: r.response.fields ?? [] } } : {}),\n    ...(r.headers !== undefined ? { headers: r.headers } : {}),\n    memory: r.memory ? [...r.memory] : [],\n    definedIn: { file: \"<unknown>\" },\n  };\n}\n","import type { Sightmap, MatchResult } from \"./sightmap.js\";\nimport { resolveByUrl } from \"./resolver.js\";\n\nexport interface MatchOptions {\n  url: string;\n  method?: string;\n}\n\nexport function match(sightmap: Sightmap, opts: MatchOptions): MatchResult {\n  return resolveByUrl(sightmap, opts.url, opts.method);\n}\n","import type { Sightmap, ExplainResult, ExplainHit, ExplainMatchedAs } from \"./sightmap.js\";\nimport { resolveByName, resolveBySourcePath } from \"./resolver.js\";\n\nexport interface ExplainOptions {\n  by?: \"name\" | \"path\";\n  type?: \"view\" | \"component\" | \"request\";\n}\n\nexport function explain(\n  sightmap: Sightmap,\n  query: string,\n  opts: ExplainOptions = {},\n): ExplainResult {\n  const byName = opts.by === \"path\" ? [] : resolveByName(sightmap, query);\n  const byPath = opts.by === \"name\" ? [] : resolveBySourcePath(sightmap, query);\n\n  // Merge: when an entry appears in both lookups, label as \"name-and-path\".\n  // Use entry identity (type + name) as the dedup key.\n  const key = (h: ExplainHit): string => `${h.type}:${h.entry.name}`;\n  const namedKeys = new Set(byName.map(key));\n  const pathKeys = new Set(byPath.map(key));\n\n  const merged: ExplainHit[] = [];\n  for (const h of byName) {\n    if (pathKeys.has(key(h))) {\n      merged.push(withMatchedAs(h, \"name-and-path\"));\n    } else {\n      merged.push(h);\n    }\n  }\n  for (const h of byPath) {\n    if (!namedKeys.has(key(h))) {\n      merged.push(h);\n    }\n    // (entries already in both have been pushed above with \"name-and-path\".)\n  }\n\n  const filtered =\n    opts.type !== undefined ? merged.filter((h) => h.type === opts.type) : merged;\n  return { query, hits: filtered };\n}\n\nfunction withMatchedAs(h: ExplainHit, matchedAs: ExplainMatchedAs): ExplainHit {\n  switch (h.type) {\n    case \"view\":\n      return { type: \"view\", matchedAs, entry: h.entry };\n    case \"component\":\n      return { type: \"component\", matchedAs, entry: h.entry };\n    case \"request\":\n      return { type: \"request\", matchedAs, entry: h.entry };\n  }\n}\n","import type { Sightmap } from \"../sightmap.js\";\nimport { DUPLICATE_VIEW_NAME, type Diagnostic } from \"../diagnostics.js\";\n\nexport function duplicateName(sightmap: Sightmap): Diagnostic[] {\n  const seen = new Map<string, number>();\n  const out: Diagnostic[] = [];\n  sightmap.views.forEach((v) => {\n    const count = (seen.get(v.name) ?? 0) + 1;\n    seen.set(v.name, count);\n    if (count > 1) {\n      out.push({\n        severity: \"warning\",\n        code: DUPLICATE_VIEW_NAME,\n        message: `Duplicate view name \"${v.name}\" (occurrence ${count}).`,\n      });\n    }\n  });\n  return out;\n}\n","import type { Sightmap } from \"../sightmap.js\";\nimport { DUPLICATE_ROUTE, type Diagnostic } from \"../diagnostics.js\";\n\nexport function duplicateRoute(sightmap: Sightmap): Diagnostic[] {\n  const seen = new Map<string, string>(); // route → first-view-name\n  const out: Diagnostic[] = [];\n  for (const v of sightmap.views) {\n    const prev = seen.get(v.route);\n    if (prev !== undefined) {\n      out.push({\n        severity: \"warning\",\n        code: DUPLICATE_ROUTE,\n        message: `Route \"${v.route}\" is defined by both \"${prev}\" and \"${v.name}\". Only \"${prev}\" will match.`,\n      });\n    } else {\n      seen.set(v.route, v.name);\n    }\n  }\n  return out;\n}\n","import type { Sightmap } from \"../sightmap.js\";\nimport { ROUTE_SHADOWING, type Diagnostic } from \"../diagnostics.js\";\nimport { routeMatch } from \"../routeMatch.js\";\n\n/**\n * Detect later views whose canonical \"representative URL\" would also be matched\n * by an earlier view's route — i.e. they're unreachable.\n *\n * Representative URL: the route with `*` and `:param` replaced by `__seg__`,\n * and `**` segments dropped. This produces a concrete URL that matches the\n * route precisely (assuming no over-broad earlier route).\n */\nexport function routeShadowing(sightmap: Sightmap): Diagnostic[] {\n  const out: Diagnostic[] = [];\n  const views = sightmap.views;\n  for (let j = 1; j < views.length; j++) {\n    const later = views[j]!;\n    const representative = makeRepresentativeUrl(later.route);\n    for (let i = 0; i < j; i++) {\n      const earlier = views[i]!;\n      if (earlier.route === later.route) continue; // duplicate-route covers this\n      if (routeMatch(earlier.route, representative)) {\n        out.push({\n          severity: \"warning\",\n          code: ROUTE_SHADOWING,\n          message: `Route \"${later.route}\" (view \"${later.name}\") is shadowed by earlier route \"${earlier.route}\" (view \"${earlier.name}\"); first-match-wins makes it unreachable.`,\n        });\n        break; // only report the first shadower\n      }\n    }\n  }\n  return out;\n}\n\nfunction makeRepresentativeUrl(route: string): string {\n  const result = route\n    .split(\"/\")\n    .filter((seg) => seg !== \"**\")\n    .map((seg) => {\n      if (seg === \"*\") return \"__seg__\";\n      if (seg.startsWith(\":\")) return \"__seg__\";\n      return seg;\n    })\n    .join(\"/\")\n    .replace(/^\\/+/, \"/\");\n  return result || \"/\";\n}\n","import { stat } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { Sightmap } from \"../sightmap.js\";\nimport type { Component } from \"../types.js\";\nimport { UNKNOWN_SOURCE, type Diagnostic } from \"../diagnostics.js\";\n\nexport interface UnknownSourceOptions {\n  /** Filesystem root for resolving `source:` paths. Defaults to process.cwd(). */\n  root?: string;\n}\n\nexport async function unknownSource(\n  sightmap: Sightmap,\n  opts: UnknownSourceOptions = {},\n): Promise<Diagnostic[]> {\n  const root = opts.root ?? process.cwd();\n  const out: Diagnostic[] = [];\n  const seen = new Set<string>();\n\n  const check = async (source: string | undefined, label: string): Promise<void> => {\n    if (source === undefined) return;\n    if (seen.has(source)) return;\n    seen.add(source);\n    try {\n      await stat(resolve(root, source));\n    } catch {\n      out.push({\n        severity: \"warning\",\n        code: UNKNOWN_SOURCE,\n        message: `${label}: source path \"${source}\" does not exist on disk (relative to ${root}).`,\n      });\n    }\n  };\n\n  for (const v of sightmap.views) {\n    await check(v.source, `view \"${v.name}\"`);\n    for (const c of v.components ?? []) {\n      await walkComponent(c, `component \"${c.name}\"`, check);\n    }\n  }\n  for (const c of sightmap.globalComponents) {\n    await walkComponent(c, `component \"${c.name}\"`, check);\n  }\n  for (const r of sightmap.globalRequests) {\n    await check(r.source, `request \"${r.name}\"`);\n  }\n\n  return out;\n}\n\nasync function walkComponent(\n  c: Component,\n  label: string,\n  check: (source: string | undefined, label: string) => Promise<void>,\n): Promise<void> {\n  await check(c.source, label);\n  for (const child of c.children ?? []) {\n    await walkComponent(child, `component \"${child.name}\"`, check);\n  }\n}\n","import { parse as parseSelector } from \"css-what\";\nimport type { Sightmap } from \"../sightmap.js\";\nimport type { Component } from \"../types.js\";\nimport { SELECTOR_SYNTAX, type Diagnostic } from \"../diagnostics.js\";\n\nexport function selectorSyntax(sightmap: Sightmap): Diagnostic[] {\n  const out: Diagnostic[] = [];\n  const visit = (c: Component, scope: string): void => {\n    const selectors: string[] = Array.isArray(c.selector)\n      ? c.selector\n      : [c.selector as unknown as string];\n    selectors.forEach((sel, i) => {\n      try {\n        parseSelector(sel);\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        out.push({\n          severity: \"warning\",\n          code: SELECTOR_SYNTAX,\n          message: `${scope}: selector at index ${i} (\"${sel}\") failed to parse: ${msg}`,\n        });\n      }\n    });\n    for (const child of c.children ?? []) visit(child, `component \"${child.name}\"`);\n  };\n\n  for (const c of sightmap.globalComponents) visit(c, `component \"${c.name}\"`);\n  for (const v of sightmap.views) {\n    for (const c of v.components ?? []) visit(c, `component \"${c.name}\"`);\n  }\n  return out;\n}\n","import type { Sightmap } from \"./sightmap.js\";\nimport type { Diagnostic } from \"./diagnostics.js\";\nimport { duplicateName } from \"./lintRules/duplicateName.js\";\nimport { duplicateRoute } from \"./lintRules/duplicateRoute.js\";\nimport { routeShadowing } from \"./lintRules/routeShadowing.js\";\nimport { unknownSource } from \"./lintRules/unknownSource.js\";\nimport { selectorSyntax } from \"./lintRules/selectorSyntax.js\";\n\nexport interface LintOptions {\n  /** Per-rule enable/disable. Default: all rules enabled. */\n  rules?: Record<string, boolean>;\n  /** Filesystem root for `unknown-source`. Defaults to process.cwd(). */\n  root?: string;\n}\n\nexport async function lint(sightmap: Sightmap, opts: LintOptions = {}): Promise<Diagnostic[]> {\n  const enabled = (code: string): boolean => opts.rules?.[code] !== false;\n  const out: Diagnostic[] = [];\n  if (enabled(\"duplicate-view-name\")) out.push(...duplicateName(sightmap));\n  if (enabled(\"duplicate-route\")) out.push(...duplicateRoute(sightmap));\n  if (enabled(\"route-shadowing\")) out.push(...routeShadowing(sightmap));\n  if (enabled(\"selector-syntax\")) out.push(...selectorSyntax(sightmap));\n  if (enabled(\"unknown-source\")) {\n    out.push(...(await unknownSource(sightmap, opts.root !== undefined ? { root: opts.root } : {})));\n  }\n  return out;\n}\n"],"mappings":"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","names":["yaml","yaml","resolve","resolve","resolve","resolve"]}

package/dist/vendored/sightmap.schema.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/sightmap/spec/main/spec/v1/sightmap.schema.json",
+  "title": "Sightmap v1",
+  "description": "A sightmap file: one YAML document under .sightmap/ describing views, components, requests, and memory entries. See https://github.com/sightmap/spec/blob/main/spec/v1/schema.md for the human-readable reference.",
+  "type": "object",
+  "required": ["version"],
+  "additionalProperties": false,
+  "properties": {
+    "version": {
+      "const": 1,
+      "description": "Must be 1 for files that conform to this version of the spec."
+    },
+    "memory": {
+      "$ref": "#/$defs/memory",
+      "description": "File-level memory entries — surfaced whenever any definition from this file is active."
+    },
+    "views": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/view" }
+    },
+    "components": {
+      "type": "array",
+      "description": "Global components — matched against every view.",
+      "items": { "$ref": "#/$defs/component" }
+    },
+    "requests": {
+      "type": "array",
+      "description": "Global requests — matched against every view.",
+      "items": { "$ref": "#/$defs/request" }
+    }
+  },
+  "$defs": {
+    "memory": {
+      "type": "array",
+      "description": "Freeform notes surfaced to agents at runtime in the [Guide] section.",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "selector": {
+      "description": "A CSS selector, or a list of alternative selectors tried in order.",
+      "oneOf": [
+        { "type": "string", "minLength": 1 },
+        {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        }
+      ]
+    },
+    "view": {
+      "type": "object",
+      "required": ["name", "route"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "route": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Glob pattern matched against the URL pathname. * matches one segment, ** matches any depth."
+        },
+        "description": { "type": "string" },
+        "source": { "type": "string" },
+        "memory": { "$ref": "#/$defs/memory" },
+        "components": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/component" }
+        },
+        "requests": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/request" }
+        }
+      }
+    },
+    "component": {
+      "type": "object",
+      "required": ["name", "selector"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "selector": { "$ref": "#/$defs/selector" },
+        "source": { "type": "string" },
+        "description": { "type": "string" },
+        "memory": { "$ref": "#/$defs/memory" },
+        "children": {
+          "type": "array",
+          "description": "Nested components. Selectors are scoped to the parent's matched subtree.",
+          "items": { "$ref": "#/$defs/component" }
+        }
+      }
+    },
+    "request": {
+      "type": "object",
+      "required": ["name", "route"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "route": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Glob pattern. Express-style :param segments normalize to *."
+        },
+        "method": {
+          "type": "string",
+          "description": "HTTP method filter. Case-insensitive; commonly GET, POST, PUT, PATCH, DELETE."
+        },
+        "description": { "type": "string" },
+        "source": { "type": "string" },
+        "request": { "$ref": "#/$defs/payload" },
+        "response": { "$ref": "#/$defs/payload" },
+        "headers": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "memory": { "$ref": "#/$defs/memory" }
+      }
+    },
+    "payload": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "fields": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/field" }
+        }
+      }
+    },
+    "field": {
+      "type": "object",
+      "required": ["name"],
+      "additionalProperties": false,
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "type": { "type": "string" },
+        "description": { "type": "string" }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@sightmap/sightmap",
+  "version": "0.1.0",
+  "description": "Library and CLI for the Sightmap spec — parse, validate, merge, match, explain, lint.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sightmap/sightmap-js.git",
+    "directory": "packages/sightmap"
+  },
+  "homepage": "https://sightmap.org",
+  "keywords": [
+    "sightmap",
+    "agent",
+    "yaml",
+    "cli",
+    "sdk"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "sightmap": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.19.39",
+    "json-schema-to-typescript": "^15.0.4",
+    "tsup": "^8.5.1",
+    "typescript": "~5.7.3",
+    "vitest": "^2.1.9"
+  },
+  "dependencies": {
+    "ajv": "^8.20.0",
+    "commander": "^12.1.0",
+    "css-what": "^6.2.2",
+    "js-yaml": "^4.1.1"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prebuild": "node scripts/generate-types.mjs"
+  }
+}