@spec-engine/spec-engine 0.7.0 → 0.7.2

package/dist/impl.js

@@ -20,7 +20,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@spec-engine/spec-engine",
-    version: "0.7.0",
+    version: "0.7.2",
     description: "Cross-repo spec engine \u2014 durable requirements with permanent IDs, bound to code via @spec tags, checked in CI. Ships the spec CLI, the local coverage webapp (spec serve), and offline docs (spec docs).",
     license: "MIT",
     type: "module",
@@ -62,7 +62,7 @@ var init_package = __esm(() => {
       "@modelcontextprotocol/sdk": "1.29.0",
       "@spec-engine/platform-map": "0.5.0",
       citty: "0.2.2",
-      hono: "4.12.27",
+      hono: "4.13.11",
       zod: "3.25.76"
     },
     devDependencies: {
@@ -414,8 +414,25 @@ var init_config = __esm(() => {
 });
 
 // ../shared/src/ears.ts
-function reject(problem) {
-  return { ok: false, problem, expected: EARS_EXPECTED };
+function reject(problem, expected = SHAPE_EXPECTED) {
+  return { ok: false, problem, expected };
+}
+function onePromiseProblem(statement, response) {
+  if (/;\s/.test(response)) {
+    return 'joins a second clause with "; " after "shall" \u2014 split it into its own requirement';
+  }
+  if (/,\s+and\s+(?!shall\b)\S[^,;]*?\s+shall\b/i.test(response)) {
+    return 'joins a second clause with its own subject (", and <subject> shall") \u2014 split it into its own requirement';
+  }
+  const rationale = statement.match(RATIONALE_RE);
+  if (rationale) {
+    return `carries a rationale ("${rationale[1]}") \u2014 the reason belongs in the why field`;
+  }
+  return null;
+}
+function lint(clauses, statement) {
+  const problem = onePromiseProblem(statement, clauses.response);
+  return problem === null ? { ok: true, clauses } : reject(problem, ONE_PROMISE_EXPECTED);
 }
 function parseEarsStatement(raw) {
   const statement = raw.trim();
@@ -430,15 +447,12 @@ function parseEarsStatement(raw) {
     const m2 = statement.match(re);
     if (m2) {
       const [, condition = "", system = "", response = ""] = m2;
-      return {
-        ok: true,
-        clauses: {
-          pattern,
-          condition: condition.trim(),
-          system: system.trim().replace(/^the\s+/i, ""),
-          response: response.trim()
-        }
-      };
+      return lint({
+        pattern,
+        condition: condition.trim(),
+        system: system.trim().replace(/^the\s+/i, ""),
+        response: response.trim()
+      }, statement);
     }
     if (keyword === "If" && !/,\s*then\s/.test(statement)) {
       return reject('starts with "If" but has no ", then" \u2014 the failure clause never hands over to the system');
@@ -451,19 +465,16 @@ function parseEarsStatement(raw) {
     if (/,/.test(system)) {
       return reject('the clause before "shall" contains a comma but starts with no condition keyword (When/While/If/Where) \u2014 either drop the comma or lead with the condition');
     }
-    return {
-      ok: true,
-      clauses: {
-        pattern: "always",
-        condition: null,
-        system: system.trim().replace(/^the\s+/i, ""),
-        response: response.trim()
-      }
-    };
+    return lint({
+      pattern: "always",
+      condition: null,
+      system: system.trim().replace(/^the\s+/i, ""),
+      response: response.trim()
+    }, statement);
   }
   return reject('nothing follows "shall" \u2014 the observable result is missing');
 }
-var EARS_EXPECTED, CONDITIONAL, ALWAYS_RE;
+var EARS_EXPECTED, CONDITIONAL, ALWAYS_RE, SHAPE_EXPECTED, ONE_PROMISE_EXPECTED = "Expected one promise per statement: a second behavior is its own requirement, and the reason goes in the why.", RATIONALE_RE;
 var init_ears = __esm(() => {
   EARS_EXPECTED = [
     'When <trigger>, the <system> shall <result> \u2014 e.g. "When an unknown id is passed, spec resolve shall print [] and exit 0."',
@@ -480,6 +491,9 @@ var init_ears = __esm(() => {
     { keyword: "Where", pattern: "where", re: /^Where\s+(.+?),\s*(.+?)\s+shall\s+(.+)$/s }
   ];
   ALWAYS_RE = /^(.+?)\s+shall\s+(.+)$/s;
+  SHAPE_EXPECTED = `Expected one of:
+  ${EARS_EXPECTED}`;
+  RATIONALE_RE = /\b(because|so that|in order to)\b/i;
 });
 
 // ../shared/src/flags.ts
@@ -670,7 +684,8 @@ CREATE INDEX IF NOT EXISTS idx_term_citations_term ON term_citations(term_id);
 -- supersedes-via | amends-via), validated at parse time, never as a DB
 -- constraint. Exactly one index, on req_id; never on issue_id, which would
 -- treat the opaque payload as a lookup key.
--- @spec PROV-004
+-- @spec PROV-005
+-- @spec PROV-006
 CREATE TABLE IF NOT EXISTS provenance (
   id            INTEGER PRIMARY KEY AUTOINCREMENT,
   req_id        TEXT NOT NULL,
@@ -3790,7 +3805,7 @@ var init_proven = __esm(() => {
 
 // src/base/gitBase.ts
 function isSafeRef(ref) {
-  return /^[A-Za-z0-9._/-]+$/.test(ref);
+  return /^[A-Za-z0-9._/][A-Za-z0-9._/-]*$/.test(ref);
 }
 function gitRepoPrefix(platformDir) {
   const proc = Bun.spawnSync(["git", "rev-parse", "--show-prefix"], { cwd: platformDir });
@@ -3828,7 +3843,7 @@ function gitLsTree(platformDir, ref, dir) {
 function gitDiffNameStatus(platformDir, ref) {
   if (!isSafeRef(ref))
     return [];
-  const proc = Bun.spawnSync(["git", "diff", "--name-status", "--no-renames", "--relative", ref], {
+  const proc = Bun.spawnSync(["git", "diff", "--name-status", "--no-renames", "--relative", ref, "--"], {
     cwd: platformDir
   });
   if (proc.exitCode !== 0)
@@ -4136,8 +4151,7 @@ function rowsForDomain2(key, domain2) {
       source_file: specPaths("", key).rel,
       line: found >= 0 ? found + 1 : 0,
       req_id: req.id,
-      detail: `${result.problem}. Expected one of:
-  ${result.expected}`
+      detail: `${result.problem}. ${result.expected}`
     });
   }
   return rows;
@@ -4832,8 +4846,7 @@ async function judgeStatementGrammar(platformDir, key, statement) {
     severity: cfg.severity,
     key,
     message: `the statement does not match the domain's EARS shape \u2014 ${result.problem}.
-` + `Expected one of:
-  ${result.expected}`
+${result.expected}`
   };
 }
 function grammarWarningText(cmdName, v) {
@@ -5718,10 +5731,34 @@ async function newDomain(platformDir, key, options = {}) {
 async function listDomains(platformDir) {
   return { ok: true, domains: await domainsWithScope(platformDir) };
 }
+async function setDomainGrammar(platformDir, key, options) {
+  if (options.grammar === undefined && options.grammarSeverity === undefined) {
+    return fail("usage", "pass --grammar, --severity, or both");
+  }
+  const file = await readEnvelope(platformDir, key);
+  if (!file.ok)
+    return file;
+  const domain2 = { ...file.domain, ...definedFields(options) };
+  const res = await validateAndWrite(file.specPath, domain2, file.relFile);
+  if (!res.ok) {
+    return fail("invalid_domain_file", res.diagnostics.map((d) => d.detail).join(`
+`), {
+      diagnostics: res.diagnostics
+    });
+  }
+  return {
+    ok: true,
+    key,
+    grammar: domain2.grammar,
+    grammarSeverity: domain2.grammarSeverity,
+    file: file.relFile
+  };
+}
 var init_domain2 = __esm(() => {
   init_src();
   init_domains();
   init_constants();
+  init__envelope();
   init__result();
 });
 
@@ -5730,6 +5767,7 @@ var exports_domain = {};
 __export(exports_domain, {
   domainNewCommand: () => domainNewCommand,
   domainListCommand: () => domainListCommand,
+  domainGrammarCommand: () => domainGrammarCommand,
   domainCommand: () => domainCommand
 });
 import { defineCommand as defineCommand4 } from "citty";
@@ -5740,7 +5778,15 @@ function exitOnNewFailure(failure) {
   }
   exitOnFailure("spec domain new", failure);
 }
-var domainNewCommand, domainListCommand, domainCommand;
+function enumFlag(flag, value, allowed) {
+  if (value === undefined)
+    return;
+  if (allowed.includes(value))
+    return value;
+  console.error(`spec domain grammar: --${flag} must be one of ${allowed.join(", ")}`);
+  process.exit(EXIT.USAGE);
+}
+var domainNewCommand, domainListCommand, GRAMMARS, SEVERITIES, domainGrammarCommand, domainCommand;
 var init_domain3 = __esm(() => {
   init_domains();
   init_constants();
@@ -5808,6 +5854,55 @@ var init_domain3 = __esm(() => {
       }
     }
   });
+  GRAMMARS = ["ears", "freeform"];
+  SEVERITIES = ["warning", "error"];
+  domainGrammarCommand = defineCommand4({
+    meta: {
+      name: "grammar",
+      description: "Set a domain's statement grammar and its severity"
+    },
+    args: {
+      name: {
+        type: "positional",
+        required: true,
+        description: "Domain key (case-insensitive)"
+      },
+      platformDir: platformDirArg,
+      grammar: {
+        type: "string",
+        description: "ears | freeform"
+      },
+      severity: {
+        type: "string",
+        description: "warning | error \u2014 how STATEMENT_GRAMMAR and write-time judging treat a miss"
+      },
+      json: {
+        type: "boolean",
+        description: "Print { key, grammar, grammar_severity, file }"
+      }
+    },
+    async run({ args }) {
+      const platformDir = resolvePlatformDir(args);
+      const grammar = enumFlag("grammar", args.grammar, GRAMMARS);
+      const grammarSeverity = enumFlag("severity", args.severity, SEVERITIES);
+      const result = await setDomainGrammar(platformDir, normalizeDomainKey(args.name), {
+        grammar,
+        grammarSeverity
+      });
+      if (!result.ok)
+        exitOnFailure("spec domain grammar", result);
+      if (args.json) {
+        console.log(JSON.stringify({
+          key: result.key,
+          grammar: result.grammar ?? null,
+          grammar_severity: result.grammarSeverity ?? null,
+          file: result.file
+        }));
+        return;
+      }
+      console.log(`${result.file}: grammar ${result.grammar ?? "freeform"}, severity ${result.grammarSeverity ?? "warning"}`);
+    }
+  });
   domainCommand = defineCommand4({
     meta: {
       name: "domain",
@@ -5815,7 +5910,8 @@ var init_domain3 = __esm(() => {
     },
     subCommands: {
       new: domainNewCommand,
-      list: domainListCommand
+      list: domainListCommand,
+      grammar: domainGrammarCommand
     }
   });
 });
@@ -8440,6 +8536,20 @@ function jsonResult(value) {
 function errorResult(message) {
   return { content: [{ type: "text", text: message }], isError: true };
 }
+function amendFieldsOf(args) {
+  const fields = {};
+  if (args.text !== undefined)
+    fields.statement = args.text;
+  if (args.why !== undefined)
+    fields.why = args.why || null;
+  if (args.lives !== undefined)
+    fields.livesIn = args.lives;
+  if (args.relates !== undefined)
+    fields.relates = args.relates;
+  if (args.issue)
+    fields.issue = args.issue;
+  return fields;
+}
 function buildMcpServer(platformDir) {
   const server = new McpServer({ name: "spec", version: package_default.version });
   const fresh = (fn) => withIndex({ platformDir, build: "fresh" }, (h) => fn(h.storage));
@@ -8593,6 +8703,94 @@ function buildMcpServer(platformDir) {
     const r = await accept({ platformDir, id: req_id });
     return r.ok ? jsonResult({ id: r.id, file: r.file }) : errorResult(r.detail);
   });
+  server.registerTool("spec_req", {
+    title: "Author a requirement",
+    description: "Append a new requirement to a domain (Active, or Draft with draft: true). The same JSON as `spec req --text \u2026 --json`: { id, file }, plus clauses when the statement parses as EARS.",
+    inputSchema: {
+      domain: z4.string().min(1).describe("Domain key or unique case-insensitive prefix"),
+      text: z4.string().trim().min(1).describe("The requirement statement"),
+      why: z4.string().trim().default("").describe("What breaks without it"),
+      lives: z4.array(z4.string()).default([]).describe("livesIn paths"),
+      relates: z4.array(z4.string()).default([]).describe("Related requirement ids, each comma-split"),
+      issue: z4.string().trim().optional().describe("Originating ticket, recorded as created"),
+      draft: z4.boolean().default(false).describe("Author as Draft instead of Active")
+    }
+  }, async ({ domain: domain2, text, why, lives, relates, issue, draft }) => {
+    const allocated = await nextId(platformDir, domain2);
+    if (!allocated.ok)
+      return errorResult(allocated.detail);
+    const r = await mint({
+      platformDir,
+      key: allocated.key,
+      statement: text,
+      why,
+      livesIn: lives,
+      relates,
+      issue: issue || undefined,
+      status: draft ? "draft" : "active"
+    });
+    if (!r.ok)
+      return errorResult(r.detail);
+    for (const w of r.warnings)
+      console.error(`spec_req: ${w.text}`);
+    return jsonResult(r.clauses ? { id: r.id, file: r.file, clauses: r.clauses } : { id: r.id, file: r.file });
+  });
+  server.registerTool("spec_amend", {
+    title: "Amend a requirement in place",
+    description: "Revise an Active or Draft requirement's fields in place (same id, no version change); a shipped requirement's statement and why are superseded instead. The same JSON as `spec amend --json`.",
+    inputSchema: {
+      id: z4.string().describe("The requirement id to amend (KEY-NNN)"),
+      text: z4.string().trim().min(1).optional().describe("New statement"),
+      why: z4.string().trim().optional().describe("New why; empty clears it"),
+      lives: z4.array(z4.string()).optional().describe("Replacement livesIn list; empty clears"),
+      relates: z4.array(z4.string()).optional().describe("Replacement related ids, each comma-split; empty clears"),
+      issue: z4.string().trim().optional().describe("Ticket recorded as amends-via")
+    }
+  }, async ({ id, text, why, lives, relates, issue }) => {
+    if (!ID_RE.test(id))
+      return errorResult(`id must be a requirement id (KEY-NNN); got ${id}`);
+    const fields = amendFieldsOf({ text, why, lives, relates, issue });
+    if (Object.keys(fields).length === 0) {
+      return errorResult("nothing to amend \u2014 pass at least one of text, why, lives, relates");
+    }
+    const r = await amend({ platformDir, id, fields });
+    if (!r.ok)
+      return errorResult(r.detail);
+    for (const w of r.warnings)
+      console.error(`spec_amend: ${w.text}`);
+    return jsonResult({ id, file: r.file, fields_changed: r.fieldsChanged });
+  });
+  server.registerTool("spec_move", {
+    title: "Move a requirement to another domain",
+    description: "Mint the successor in newDomain carrying the source's fields, mark the source superseded, and return the retag worklist. The same JSON as `spec move --json`.",
+    inputSchema: {
+      id: z4.string().describe("The Active requirement id to move (KEY-NNN)"),
+      newDomain: z4.string().min(1).describe("The existing target domain key"),
+      text: z4.string().optional().describe("Successor statement (default: copied)"),
+      why: z4.string().optional().describe("Successor why (default: copied)"),
+      lives: z4.array(z4.string()).optional().describe("Successor livesIn list; empty clears (default: copied)")
+    }
+  }, async ({ id, newDomain: newDomain2, text, why, lives }) => {
+    if (!ID_RE.test(id))
+      return errorResult(`id must be a requirement id (KEY-NNN); got ${id}`);
+    const targetKey = normalizeDomainKey(newDomain2);
+    if (targetKey === "")
+      return errorResult(`newDomain must be a domain key; got ${newDomain2}`);
+    const r = await move({ platformDir, id, targetKey, statement: text, why, livesIn: lives }, coldFreshTags(platformDir));
+    if (!r.ok)
+      return errorResult(r.detail);
+    for (const w of r.warnings)
+      console.error(`spec_move: ${w.text}`);
+    return jsonResult({
+      old_id: r.oldId,
+      new_id: r.newId,
+      from_file: r.fromFile,
+      to_file: r.toFile,
+      source_spec_version: r.sourceSpecVersion,
+      target_spec_version: r.targetSpecVersion,
+      retag: r.retag
+    });
+  });
   server.registerPrompt("author_requirements", {
     title: "Author requirements from a brief",
     description: "Turn a vague brief/ticket into well-formed Spec Engine requirements: one requirement per testable promise, placed by domain charter, deduped via spec query, drafted to the GUARD template + cold-read rubric, minted with spec req. The engine returns a static playbook template \u2014 your model runs it.",
@@ -8629,8 +8827,11 @@ var init_mcp = __esm(() => {
   init_domains();
   init__index();
   init_accept();
+  init_amend();
   init_check();
   init_deprecate();
+  init_mint();
+  init_move();
   init_nextId();
   init_reads2();
   init_records();
@@ -12153,6 +12354,9 @@ function guarded(handler) {
     try {
       return await handler(c);
     } catch (err) {
+      if (err instanceof InvalidDomainFilesError) {
+        return c.json({ error: "invalid_domain_file", diagnostics: sortDiagnostics(err.diagnostics) }, 422);
+      }
       const info = describeStorageError(err);
       if (info === null)
         throw err;
@@ -12404,6 +12608,52 @@ function mountApi(app, storage2, platformDir = process.cwd(), bindHost = DEFAULT
       }, 201);
     });
   }));
+  app.post("/api/requirements/:id/move", guarded(async function moveRequirement(c) {
+    if (!featureEnabled("editor")) {
+      return c.json({ error: featureDisabledMessage("editor") }, 404);
+    }
+    const originReject = rejectCrossOrigin(c, bindHost);
+    if (originReject)
+      return originReject;
+    const headerReject = rejectBadWriteHeaders(c);
+    if (headerReject)
+      return headerReject;
+    const parsed = await readJsonBody(c);
+    if (!parsed.ok)
+      return parsed.res;
+    const body = parsed.body;
+    const id = c.req.param("id") ?? "";
+    if (!ID_RE.test(id))
+      return c.json({ error: "id must be a requirement id (KEY-NNN)" }, 400);
+    const targetKey = normalizeDomainKey(typeof body.newDomain === "string" ? body.newDomain : "");
+    if (targetKey === "")
+      return c.json({ error: "newDomain is required (a domain key)" }, 400);
+    return withWriteLock(async () => {
+      const r = await move({
+        platformDir,
+        id,
+        targetKey,
+        statement: typeof body.text === "string" ? body.text : undefined,
+        why: typeof body.why === "string" ? body.why : undefined,
+        livesIn: "lives" in body ? toStringList(body.lives) : undefined
+      }, async (reqId) => {
+        await runIndex({ platformDir, storage: storage2 });
+        return storage2.listTags({ req_id: reqId });
+      });
+      if (!r.ok)
+        return failureResponse(c, r);
+      return c.json({
+        ok: true,
+        old_id: r.oldId,
+        new_id: r.newId,
+        from_file: r.fromFile,
+        to_file: r.toFile,
+        source_spec_version: r.sourceSpecVersion,
+        target_spec_version: r.targetSpecVersion,
+        retag: r.retag
+      }, 201);
+    });
+  }));
   app.post("/api/requirements/:id/deprecate", guarded(async function deprecateRequirement(c) {
     if (!featureEnabled("editor")) {
       return c.json({ error: featureDisabledMessage("editor") }, 404);
@@ -12542,6 +12792,7 @@ var init_api = __esm(() => {
   init_amend();
   init_deprecate();
   init_mint();
+  init_move();
   init_reads2();
   init_records();
   init_supersede();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spec-engine/spec-engine",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Cross-repo spec engine — durable requirements with permanent IDs, bound to code via @spec tags, checked in CI. Ships the spec CLI, the local coverage webapp (spec serve), and offline docs (spec docs).",
   "license": "MIT",
   "type": "module",
@@ -42,7 +42,7 @@
     "@modelcontextprotocol/sdk": "1.29.0",
     "@spec-engine/platform-map": "0.5.0",
     "citty": "0.2.2",
-    "hono": "4.12.27",
+    "hono": "4.13.11",
     "zod": "3.25.76"
   },
   "devDependencies": {

package/dist/docs/_astro/Code.CAimF0uL.css

@@ -1 +0,0 @@
-@layer starlight.components{svg:where(.astro-lm5mbbcm){color:var(--sl-icon-color);font-size:var(--sl-icon-size, 1em);width:1em;height:1em}}@layer starlight.components{:root{--sl-badge-default-border: var(--sl-color-accent);--sl-badge-default-bg: var(--sl-color-accent-low);--sl-badge-default-text: #fff;--sl-badge-note-border: var(--sl-color-blue);--sl-badge-note-bg: var(--sl-color-blue-low);--sl-badge-note-text: #fff;--sl-badge-danger-border: var(--sl-color-red);--sl-badge-danger-bg: var(--sl-color-red-low);--sl-badge-danger-text: #fff;--sl-badge-success-border: var(--sl-color-green);--sl-badge-success-bg: var(--sl-color-green-low);--sl-badge-success-text: #fff;--sl-badge-caution-border: var(--sl-color-orange);--sl-badge-caution-bg: var(--sl-color-orange-low);--sl-badge-caution-text: #fff;--sl-badge-tip-border: var(--sl-color-purple);--sl-badge-tip-bg: var(--sl-color-purple-low);--sl-badge-tip-text: #fff}[data-theme=light]:root{--sl-badge-default-bg: var(--sl-color-accent-high);--sl-badge-note-bg: var(--sl-color-blue-high);--sl-badge-danger-bg: var(--sl-color-red-high);--sl-badge-success-bg: var(--sl-color-green-high);--sl-badge-caution-bg: var(--sl-color-orange-high);--sl-badge-tip-bg: var(--sl-color-purple-high)}.sl-badge:where(.astro-dr5neazu){display:inline-block;border:1px solid var(--sl-color-border-badge);border-radius:.25rem;font-family:var(--sl-font-system-mono);line-height:normal;color:var(--sl-color-text-badge);background-color:var(--sl-color-bg-badge);overflow-wrap:anywhere}.sidebar-content .sl-badge:where(.astro-dr5neazu){line-height:1;font-size:var(--sl-text-xs);padding:.125rem .375rem}.sidebar-content a[aria-current=page]>.sl-badge:where(.astro-dr5neazu){--sl-color-bg-badge: transparent;--sl-color-border-badge: currentColor;color:inherit}.default:where(.astro-dr5neazu){--sl-color-bg-badge: var(--sl-badge-default-bg);--sl-color-border-badge: var(--sl-badge-default-border);--sl-color-text-badge: var(--sl-badge-default-text)}.note:where(.astro-dr5neazu){--sl-color-bg-badge: var(--sl-badge-note-bg);--sl-color-border-badge: var(--sl-badge-note-border);--sl-color-text-badge: var(--sl-badge-note-text)}.danger:where(.astro-dr5neazu){--sl-color-bg-badge: var(--sl-badge-danger-bg);--sl-color-border-badge: var(--sl-badge-danger-border);--sl-color-text-badge: var(--sl-badge-danger-text)}.success:where(.astro-dr5neazu){--sl-color-bg-badge: var(--sl-badge-success-bg);--sl-color-border-badge: var(--sl-badge-success-border);--sl-color-text-badge: var(--sl-badge-success-text)}.tip:where(.astro-dr5neazu){--sl-color-bg-badge: var(--sl-badge-tip-bg);--sl-color-border-badge: var(--sl-badge-tip-border);--sl-color-text-badge: var(--sl-badge-tip-text)}.caution:where(.astro-dr5neazu){--sl-color-bg-badge: var(--sl-badge-caution-bg);--sl-color-border-badge: var(--sl-badge-caution-border);--sl-color-text-badge: var(--sl-badge-caution-text)}.small:where(.astro-dr5neazu){font-size:var(--sl-text-xs);padding:.125rem .25rem}.medium:where(.astro-dr5neazu){font-size:var(--sl-text-sm);padding:.175rem .35rem}.large:where(.astro-dr5neazu){font-size:var(--sl-text-base);padding:.225rem .45rem}.sl-markdown-content :is(h1,h2,h3,h4,h5,h6) .sl-badge:where(.astro-dr5neazu){vertical-align:middle}}@layer starlight.components{starlight-tabs:where(.astro-njbqzmfe){display:block}.tablist-wrapper:where(.astro-njbqzmfe){overflow-x:auto}:where(.astro-njbqzmfe)[role=tablist]{display:flex;list-style:none;border-bottom:2px solid var(--sl-color-gray-5);padding:0}.tab:where(.astro-njbqzmfe){display:flex}.tab:where(.astro-njbqzmfe)>:where(.astro-njbqzmfe)[role=tab]{--sl-tab-color-border: var(--sl-color-gray-5);display:flex;align-items:center;gap:.5rem;line-height:var(--sl-line-height-headings);padding:.275rem 1.25rem;text-decoration:none;box-shadow:0 2px 0 var(--sl-tab-color-border);color:var(--sl-color-gray-3);outline-offset:var(--sl-outline-offset-inside);overflow-wrap:initial}.tab:where(.astro-njbqzmfe) :where(.astro-njbqzmfe)[role=tab][aria-selected=true]{--sl-tab-color-border: var(--sl-color-text-accent);color:var(--sl-color-white);font-weight:600}.tablist-wrapper:where(.astro-njbqzmfe)~[role=tabpanel]{margin-top:1rem}}@layer starlight.components{.sl-steps{--bullet-size: calc(var(--sl-line-height) * 1rem);--bullet-margin: .375rem;list-style:none;counter-reset:steps-counter var(--sl-steps-start, 0);padding-inline-start:0}.sl-steps>li{counter-increment:steps-counter;position:relative;padding-inline-start:calc(var(--bullet-size) + 1rem);padding-bottom:1px;min-height:calc(var(--bullet-size) + var(--bullet-margin))}.sl-steps>li+li{margin-top:0}.sl-steps>li:before{content:counter(steps-counter);position:absolute;top:0;inset-inline-start:0;width:var(--bullet-size);height:var(--bullet-size);line-height:var(--bullet-size);font-size:var(--sl-text-xs);font-weight:600;text-align:center;color:var(--sl-color-white);background-color:var(--sl-color-gray-6);border-radius:99rem;box-shadow:inset 0 0 0 1px var(--sl-color-gray-5)}.sl-steps>li:after{--guide-width: 1px;content:"";position:absolute;top:calc(var(--bullet-size) + var(--bullet-margin));bottom:var(--bullet-margin);inset-inline-start:calc((var(--bullet-size) - var(--guide-width)) / 2);width:var(--guide-width);background-color:var(--sl-color-hairline-light)}}@layer starlight.content{.sl-steps>li>:first-child{--lh: calc(1em * var(--sl-line-height));--shift-y: calc(.5 * (var(--bullet-size) - var(--lh)));transform:translateY(var(--shift-y));margin-bottom:var(--shift-y)}.sl-steps>li>:first-child:where(h1,h2,h3,h4,h5,h6){--lh: calc(1em * var(--sl-line-height-headings))}@supports (--prop: 1lh){.sl-steps>li>:first-child{--lh: 1lh}}}@layer starlight.components{.sl-link-button:where(.astro-yiov523n){align-items:center;border:1px solid transparent;border-radius:999rem;display:inline-flex;font-size:var(--sl-text-sm);gap:.5em;line-height:1.1875;outline-offset:.25rem;padding:.4375rem 1.125rem;text-decoration:none}.sl-link-button:where(.astro-yiov523n).primary{background:var(--sl-color-text-accent);border-color:var(--sl-color-text-accent);color:var(--sl-color-black)}.sl-link-button:where(.astro-yiov523n).primary:hover{color:var(--sl-color-black)}.sl-link-button:where(.astro-yiov523n).secondary{border-color:inherit;color:var(--sl-color-white)}.sl-link-button:where(.astro-yiov523n).minimal{color:var(--sl-color-white);padding-inline:0}.sl-link-button:where(.astro-yiov523n) svg{flex-shrink:0}@media(min-width:50rem){.sl-link-button:where(.astro-yiov523n){font-size:var(--sl-text-base);padding:.9375rem 1.25rem}}.sl-markdown-content .sl-link-button:where(.astro-yiov523n){margin-inline-end:1rem}.sl-markdown-content .sl-link-button:where(.astro-yiov523n):not(:where(p *)){margin-block:1rem}}

package/dist/docs/_astro/MobileTableOfContents.astro_astro_type_script_index_0_lang.hwBsy0Mo.js

@@ -1 +0,0 @@
-import{S as r}from"./TableOfContents.astro_astro_type_script_index_0_lang.FuRcXuRY.js";class c extends r{set current(e){super.current=e;const t=this.querySelector(".display-current");t&&(t.textContent=e.textContent)}constructor(){super();const e=this.querySelector("details");if(!e)return;const t=()=>{e.open=!1};e.querySelectorAll("a").forEach(s=>{s.addEventListener("click",t)}),window.addEventListener("click",s=>{e.contains(s.target)||t()}),window.addEventListener("keydown",s=>{if(s.key==="Escape"&&e.open){const o=e.contains(document.activeElement);if(t(),o){const n=e.querySelector("summary");n&&n.focus()}}})}}customElements.define("mobile-starlight-toc",c);

package/dist/docs/_astro/Search.astro_astro_type_script_index_0_lang.lq3t8uE2.js

@@ -1 +0,0 @@
-const y=(function(){const r=typeof document<"u"&&document.createElement("link").relList;return r&&r.supports&&r.supports("modulepreload")?"modulepreload":"preload"})(),S=function(m){return"/"+m},g={},w=function(r,c,d){let p=Promise.resolve();if(c&&c.length>0){let f=function(n){return Promise.all(n.map(i=>Promise.resolve(i).then(s=>({status:"fulfilled",value:s}),s=>({status:"rejected",reason:s}))))};document.getElementsByTagName("link");const o=document.querySelector("meta[property=csp-nonce]"),t=o?.nonce||o?.getAttribute("nonce");p=f(c.map(n=>{if(n=S(n),n in g)return;g[n]=!0;const i=n.endsWith(".css"),s=i?'[rel="stylesheet"]':"";if(document.querySelector(`link[href="${n}"]${s}`))return;const e=document.createElement("link");if(e.rel=i?"stylesheet":y,i||(e.as="script"),e.crossOrigin="",e.href=n,t&&e.setAttribute("nonce",t),document.head.appendChild(e),i)return new Promise((l,a)=>{e.addEventListener("load",l),e.addEventListener("error",()=>a(new Error(`Unable to preload CSS for ${n}`)))})}))}function u(o){const t=new Event("vite:preloadError",{cancelable:!0});if(t.payload=o,window.dispatchEvent(t),!t.defaultPrevented)throw o}return p.then(o=>{for(const t of o||[])t.status==="rejected"&&u(t.reason);return r().catch(u)})},E={ranking:{pageLength:.1,termFrequency:.1,termSaturation:2,termSimilarity:9,diacriticSimilarity:.8}};class v extends HTMLElement{constructor(){super();const r=this.querySelector("button[data-open-modal]"),c=this.querySelector("button[data-close-modal]"),d=this.querySelector("dialog"),p=this.querySelector(".dialog-frame"),u=e=>{("href"in(e.target||{})||document.body.contains(e.target)&&!p.contains(e.target))&&t()},o=e=>{d.showModal(),document.body.toggleAttribute("data-search-modal-open",!0),this.querySelector("input")?.focus(),e?.stopPropagation(),window.addEventListener("click",u)},t=()=>d.close();r.addEventListener("click",o),r.disabled=!1,c.addEventListener("click",t),d.addEventListener("close",()=>{document.body.toggleAttribute("data-search-modal-open",!1),window.removeEventListener("click",u)}),window.addEventListener("keydown",e=>{(e.metaKey===!0||e.ctrlKey===!0)&&e.key==="k"&&(d.open?t():o(),e.preventDefault())});let f={};try{f=JSON.parse(this.dataset.translations||"{}")}catch{}const s=this.dataset.stripTrailingSlash!==void 0?e=>e.replace(/(.)\/(#.*)?$/,"$1$2"):e=>e;window.addEventListener("DOMContentLoaded",()=>{(window.requestIdleCallback||(l=>setTimeout(l,1)))(async()=>{const{PagefindUI:l}=await w(async()=>{const{PagefindUI:a}=await import("./ui-core.C8327L_n.js");return{PagefindUI:a}},[]);new l({...E,element:"#starlight__search",baseUrl:"/",bundlePath:"/".replace(/\/$/,"")+"/pagefind/",showImages:!1,translations:f,showSubResults:!0,processResult:a=>{a.url=s(a.url),a.sub_results=a.sub_results.map(h=>(h.url=s(h.url),h))}})})})}}customElements.define("site-search",v);export{w as _};

package/dist/docs/_astro/TableOfContents.astro_astro_type_script_index_0_lang.FuRcXuRY.js

@@ -1 +0,0 @@
-const m="_top";class H extends HTMLElement{constructor(){super(),this._current=this.querySelector('a[aria-current="true"]'),this.minH=parseInt(this.dataset.minH||"2",10),this.maxH=parseInt(this.dataset.maxH||"3",10),this.tocHeadingSelector=`h1#${m},:where(${[...Array.from({length:1+this.maxH-this.minH}).map((e,n)=>`h${this.minH+n}`)].join()})[id]`,this.onIdle=e=>(window.requestIdleCallback||(n=>setTimeout(n,1)))(e),this.init=()=>{const e=[...this.querySelectorAll("a")],n=t=>t.matches(this.tocHeadingSelector),i=t=>{if(!t)return null;const h=t;for(;t;){if(t.matches(".sl-markdown-content, main > *"))return document.getElementById(m);if(n(t))return t;const s=t.querySelector(this.tocHeadingSelector);if(s)return s;for(t=t.previousElementSibling;t?.lastElementChild;)t=t.lastElementChild;const o=i(t);if(o)return o}return i(h.parentElement)},c=t=>{for(const{isIntersecting:h,target:s}of t){if(!h)continue;const o=i(s);if(!o)continue;const l=e.find(g=>g.hash==="#"+encodeURIComponent(o.id));if(l){this.current=l;break}}},a=document.querySelectorAll([`main :where(${this.tocHeadingSelector})`,`main :where(${this.tocHeadingSelector}, .sl-heading-wrapper) ~ *:not(:has(${this.tocHeadingSelector}))`,`main .sl-markdown-content > *:not(:has(${this.tocHeadingSelector}))`,`main > *:not(:has(${this.tocHeadingSelector}))`].join());let r;const u=()=>{r||(r=new IntersectionObserver(c,{rootMargin:this.getRootMargin()}),a.forEach(t=>r.observe(t)))};u();let d;window.addEventListener("resize",()=>{r&&(r.disconnect(),r=void 0),clearTimeout(d),d=setTimeout(()=>this.onIdle(u),200)})},this.onIdle(()=>this.init())}set current(e){e!==this._current&&(this._current&&this._current.removeAttribute("aria-current"),e.setAttribute("aria-current","true"),this._current=e)}getRootMargin(){const e=document.querySelector("header")?.getBoundingClientRect().height||0,n=this.querySelector("summary")?.getBoundingClientRect().height||0,i=e+n+32,c=i+53,a=document.documentElement.clientHeight;return`-${i}px 0% ${c-a}px`}}customElements.define("starlight-toc",H);export{H as S};