npm - @emeryld/rrroutes-contract - Versions diffs - 2.7.12 → 2.8.0 - Mend

@emeryld/rrroutes-contract 2.7.12 → 2.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +5 -5
package/dist/index.cjs +9 -1364
package/dist/index.cjs.map +1 -1
package/dist/index.d.ts +0 -1
package/dist/index.mjs +8 -1337
package/dist/index.mjs.map +1 -1
package/package.json +3 -10
package/bin/rrroutes-export-finalized-leaves.mjs +0 -14
package/dist/export/defaultViewerTemplate.d.ts +0 -1
package/dist/export/exportFinalizedLeaves.cli.d.ts +0 -14
package/dist/export/exportFinalizedLeaves.d.ts +0 -62
package/dist/export/extractLeafSourceByAst.d.ts +0 -38
package/dist/export/flattenSchema.d.ts +0 -12
package/dist/export/index.d.ts +0 -7
package/dist/export/schemaIntrospection.d.ts +0 -47
package/dist/export/serializeLeafContract.d.ts +0 -31
package/tools/finalized-leaves-viewer.html +0 -1551

package/tools/finalized-leaves-viewer.html DELETED Viewed

@@ -1,1551 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Finalized Leaves Viewer</title>
-    <style>
-      :root {
-        --bg: #212121;
-        --surface: #2a2a2a;
-        --surface-2: #353535;
-        --border: #4a4a4a;
-        --text: #fffafa;
-        --muted: #c8c2c2;
-        --accent: #a764d3;
-        --schema-accent: #fbbd23;
-        --ok: #1f8f4e;
-        --danger: #d12b2b;
-      }
-      * {
-        box-sizing: border-box;
-      }
-      body {
-        margin: 0;
-        font-family: 'Iosevka Web', 'SFMono-Regular', Menlo, Consolas, monospace;
-        color: var(--text);
-        background: var(--bg);
-      }
-      mark {
-        background: #00e5ff;
-        color: #0f1416;
-        border-radius: 2px;
-        padding: 0 1px;
-      }
-      .wrap {
-        max-width: 1200px;
-        margin: 0 auto;
-        padding: 20px;
-      }
-      .card {
-        background: var(--surface);
-        border: 1px solid var(--border);
-        border-radius: 6px;
-        padding: 12px;
-      }
-      .controls {
-        display: grid;
-        gap: 14px;
-      }
-      .primary-row {
-        display: grid;
-        gap: 10px;
-        grid-template-columns: minmax(220px, 0.9fr) minmax(300px, 1.4fr) minmax(220px, 1fr);
-        align-items: end;
-      }
-      .control-block {
-        display: grid;
-        gap: 6px;
-      }
-      .control-label {
-        font-size: 12px;
-        color: var(--muted);
-      }
-      .quick-toggles {
-        display: flex;
-        flex-wrap: wrap;
-        gap: 8px;
-        align-items: center;
-      }
-      .scope-row {
-        border-top: 1px solid var(--border);
-        padding-top: 12px;
-        display: grid;
-        gap: 10px;
-      }
-      .scope-actions {
-        display: flex;
-        flex-wrap: wrap;
-        gap: 8px;
-      }
-      .scope-groups {
-        display: grid;
-        gap: 10px;
-      }
-      .scope-group {
-        display: grid;
-        gap: 6px;
-      }
-      .scope-group-title {
-        font-size: 12px;
-        color: var(--muted);
-      }
-      .scope-group-chips {
-        display: flex;
-        flex-wrap: wrap;
-        gap: 6px;
-      }
-      .field-item {
-        display: inline-flex;
-        align-items: center;
-        gap: 6px;
-        padding: 3px 0;
-      }
-      input[type='text'],
-      select {
-        width: 100%;
-        border: 1px solid var(--border);
-        border-radius: 4px;
-        padding: 8px 10px;
-        font: inherit;
-        background: var(--surface-2);
-        color: var(--text);
-      }
-      button {
-        border: 1px solid var(--border);
-        border-radius: 6px;
-        padding: 7px 10px;
-        font: inherit;
-        background: var(--surface-2);
-        color: var(--text);
-        cursor: pointer;
-      }
-      button:hover {
-        background: var(--surface-2);
-      }
-      .meta {
-        color: var(--muted);
-        font-size: 12px;
-      }
-      #results {
-        margin-top: 14px;
-        display: grid;
-        gap: 0;
-      }
-      details.leaf {
-        border-top: 1px solid var(--border);
-        padding: 10px 2px;
-      }
-      summary {
-        cursor: pointer;
-        font-weight: 700;
-        color: var(--accent);
-      }
-      .leaf-content {
-        display: grid;
-        gap: 4px;
-        margin-top: 10px;
-        margin-left: 16px;
-        padding-left: 12px;
-        border-left: 2px solid var(--border);
-      }
-      .section {
-        border-top: 1px solid var(--border);
-        padding: 10px 0 2px;
-      }
-      .section h3 {
-        margin: 0 0 8px;
-        font-size: 13px;
-      }
-      .grid-2 {
-        display: grid;
-        gap: 6px;
-        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
-      }
-      .grid-3 {
-        display: grid;
-        gap: 6px;
-        grid-template-columns: repeat(3, minmax(0, 1fr));
-      }
-      .kv {
-        border-bottom: 1px dashed var(--border);
-        padding: 4px 0 6px;
-      }
-      .kv .k {
-        font-size: 11px;
-        color: var(--muted);
-      }
-      .kv .k a {
-        color: inherit;
-        text-decoration: underline;
-        text-underline-offset: 2px;
-      }
-      .kv .v {
-        margin-top: 2px;
-        word-break: break-word;
-      }
-      .chips {
-        display: flex;
-        gap: 6px;
-        flex-wrap: wrap;
-      }
-      .chips.filters {
-        margin-top: 2px;
-      }
-      .chip {
-        border: 1px solid var(--border);
-        border-radius: 4px;
-        padding: 2px 6px;
-        font-size: 12px;
-        background: var(--surface-2);
-      }
-      .chip-btn {
-        cursor: pointer;
-      }
-      .chip.ok {
-        border-color: #b5e4c8;
-        color: var(--ok);
-        background: #effbf4;
-      }
-      .pill-toggle {
-        border: 1px solid var(--border);
-        border-radius: 999px;
-        padding: 6px 12px;
-        font-size: 12px;
-        background: var(--surface-2);
-        color: var(--text);
-      }
-      .pill-toggle[aria-pressed='true'] {
-        border-color: var(--accent);
-        background: rgba(167, 100, 211, 0.25);
-        color: #f0d8ff;
-      }
-      .scope-action {
-        font-size: 12px;
-        padding: 5px 10px;
-      }
-      .field-chip {
-        font-size: 12px;
-        padding: 5px 10px;
-        border-radius: 999px;
-      }
-      .field-chip[aria-pressed='true'] {
-        border-color: var(--schema-accent);
-        background: rgba(251, 189, 35, 0.22);
-        color: #ffe7aa;
-      }
-      .advanced-panel {
-        border-top: 1px solid var(--border);
-        padding-top: 10px;
-      }
-      .advanced-panel > summary {
-        color: var(--text);
-        font-size: 13px;
-      }
-      .advanced-content {
-        margin-top: 10px;
-        display: flex;
-        flex-wrap: wrap;
-        gap: 12px;
-        align-items: center;
-      }
-      .advanced-content .field-item {
-        padding: 0;
-      }
-      .active-filters-row {
-        border-top: 1px solid var(--border);
-        padding-top: 10px;
-        display: grid;
-        gap: 6px;
-      }
-      .active-filters-title {
-        color: var(--muted);
-        font-size: 12px;
-      }
-      .icon-row {
-        display: flex;
-        gap: 6px;
-        margin-top: 2px;
-      }
-      .icon-badge {
-        display: inline-flex;
-        align-items: center;
-        justify-content: center;
-        width: 18px;
-        height: 18px;
-        border: 1px solid var(--border);
-        border-radius: 4px;
-        font-size: 11px;
-        background: var(--surface-2);
-      }
-      .icon-badge.feed {
-        width: auto;
-        min-width: 46px;
-        padding: 2px 8px;
-        font-weight: 700;
-        border-color: var(--schema-accent);
-        color: var(--schema-accent);
-        background: rgba(251, 189, 35, 0.15);
-      }
-      .icon-badge.warn {
-        border-color: #f2d5d5;
-        color: #a02424;
-        background: #fff4f4;
-      }
-      .empty {
-        color: var(--muted);
-      }
-      .mono {
-        font-family: inherit;
-      }
-      .schema-block {
-        border-top: 1px solid var(--border);
-        padding: 8px 0 2px;
-        margin-bottom: 6px;
-      }
-      .schema-block:last-child {
-        margin-bottom: 0;
-      }
-      .schema-header {
-        font-weight: 700;
-        margin-bottom: 6px;
-      }
-      .schema-tree details {
-        margin-left: 12px;
-        border-left: 1px solid var(--border);
-        padding-left: 8px;
-      }
-      .tree-row {
-        display: grid;
-        grid-template-columns: 1fr auto;
-        gap: 8px;
-        padding: 3px 0;
-        align-items: center;
-      }
-      .schema-tree summary .tree-row {
-        display: grid;
-        vertical-align: middle;
-      }
-      .schema-tree > .tree-row {
-        margin-left: 18px;
-      }
-      .tree-name {
-        display: inline-flex;
-        align-items: baseline;
-        gap: 2px;
-      }
-      .tree-col-muted {
-        color: var(--muted);
-        font-size: 12px;
-      }
-      .required-star {
-        color: var(--danger);
-        font-weight: 700;
-      }
-      .tree-pill {
-        border: 1px solid var(--schema-accent);
-        border-radius: 4px;
-        padding: 1px 6px;
-        font-size: 11px;
-        background: rgba(251, 189, 35, 0.15);
-        color: var(--schema-accent);
-      }
-      .schema-tree details > summary {
-        color: var(--schema-accent);
-        list-style: none;
-        display: grid;
-        grid-template-columns: 12px 1fr;
-        align-items: center;
-        column-gap: 6px;
-      }
-      .schema-tree details > summary::-webkit-details-marker {
-        display: none;
-      }
-      .schema-tree details > summary::marker {
-        content: '';
-      }
-      .schema-tree details > summary::before {
-        content: '▸';
-        display: inline-block;
-        grid-column: 1;
-        width: 12px;
-        text-align: center;
-      }
-      .schema-tree details > summary > .tree-row {
-        grid-column: 2;
-      }
-      .schema-tree details[open] > summary::before {
-        content: '▾';
-      }
-      input[type='checkbox'] {
-        accent-color: var(--accent);
-      }
-      @media (max-width: 720px) {
-        .primary-row {
-          grid-template-columns: 1fr;
-          align-items: stretch;
-        }
-        .grid-3 {
-          grid-template-columns: 1fr;
-        }
-      }
-    </style>
-  </head>
-  <body>
-    <div class="wrap">
-      <h1>Finalized Leaves Viewer</h1>
-      <div class="card controls">
-        <div class="primary-row">
-          <label class="control-block">
-            <span class="control-label">Load export JSON file</span>
-            <input id="fileInput" type="file" accept="application/json,.json" />
-          </label>
-          <label class="control-block">
-            <span class="control-label">Search text</span>
-            <input id="searchInput" type="text" placeholder="Type to search..." />
-          </label>
-          <div class="control-block">
-            <span class="control-label">Quick filters</span>
-            <div class="quick-toggles">
-              <button id="caseSensitive" class="pill-toggle" type="button" aria-pressed="false">
-                Case sensitive
-              </button>
-              <button id="regexSearch" class="pill-toggle" type="button" aria-pressed="false">
-                Regex
-              </button>
-            </div>
-          </div>
-        </div>
-        <div class="scope-row">
-          <div class="scope-actions">
-            <button id="selectAllFields" class="scope-action" type="button">All</button>
-            <button id="clearAllFields" class="scope-action" type="button">None</button>
-            <button id="coreFields" class="scope-action" type="button">Core</button>
-            <button id="schemasOnlyFields" class="scope-action" type="button">Schema</button>
-            <button id="sourceOnlyFields" class="scope-action" type="button">Source</button>
-          </div>
-          <div id="fieldChipGroups" class="scope-groups"></div>
-        </div>
-        <details class="advanced-panel">
-          <summary>Advanced filters</summary>
-          <div class="advanced-content">
-            <label class="field-item">
-              <span>type match</span>
-              <select id="typeMatchMode">
-                <option value="contains" selected>contains</option>
-                <option value="exact">exact</option>
-              </select>
-            </label>
-            <button
-              id="schemaRowsMatchOnly"
-              class="pill-toggle"
-              type="button"
-              aria-pressed="false"
-            >
-              Schema rows match only
-            </button>
-            <button id="resetFilters" type="button">Reset filters</button>
-          </div>
-        </details>
-        <div class="active-filters-row">
-          <div class="active-filters-title">Active filters</div>
-          <div id="activeFilterChips" class="chips filters"></div>
-        </div>
-        <div id="status" class="meta">Load a JSON export to begin.</div>
-      </div>
-      <div id="results"></div>
-    </div>
-    <!--__FINALIZED_LEAVES_BAKED_PAYLOAD__-->
-    <script>
-      const SEARCH_FIELDS = [
-        { id: 'method', label: 'method', get: (leaf) => [leaf.method] },
-        { id: 'path', label: 'path', get: (leaf) => [leaf.path] },
-        { id: 'key', label: 'key', get: (leaf) => [leaf.key] },
-        { id: 'summary', label: 'summary', get: (leaf) => [leaf.cfg?.summary] },
-        {
-          id: 'description',
-          label: 'description',
-          get: (leaf) => [leaf.cfg?.description],
-        },
-        { id: 'docsGroup', label: 'docsGroup', get: (leaf) => [leaf.cfg?.docsGroup] },
-        { id: 'tags', label: 'tags', get: (leaf) => leaf.cfg?.tags || [] },
-        { id: 'stability', label: 'stability', get: (leaf) => [leaf.cfg?.stability] },
-        { id: 'docsMeta', label: 'docsMeta', get: (leaf) => [leaf.cfg?.docsMeta] },
-        {
-          id: 'sourceDefinition',
-          label: 'source definition',
-          get: (leaf, schemaFlatByLeaf, payload) => {
-            const source = payload?.sourceByLeaf?.[leaf.key]?.definition
-            if (!source) return []
-            return [`${source.file}:${source.line}:${source.column}`]
-          },
-        },
-        {
-          id: 'sourceSchemas',
-          label: 'source schemas',
-          get: (leaf, schemaFlatByLeaf, payload) => {
-            const schemas = payload?.sourceByLeaf?.[leaf.key]?.schemas
-            if (!schemas || typeof schemas !== 'object') return []
-            return Object.values(schemas).flatMap((schema) => {
-              if (!schema || typeof schema !== 'object') return []
-              const tokens = []
-              if (schema.sourceName) tokens.push(schema.sourceName)
-              if (schema.tag) tokens.push(schema.tag)
-              tokens.push(`${schema.file}:${schema.line}:${schema.column}`)
-              return tokens
-            })
-          },
-        },
-        {
-          id: 'types',
-          label: 'types',
-          get: (leaf, schemaFlatByLeaf) => schemaTypeTokens(schemaFlatByLeaf?.[leaf.key]),
-        },
-        {
-          id: 'params',
-          label: 'params',
-          get: (leaf, schemaFlatByLeaf) =>
-            schemaSectionToSearchTokens(schemaFlatByLeaf?.[leaf.key], 'params'),
-        },
-        {
-          id: 'query',
-          label: 'query',
-          get: (leaf, schemaFlatByLeaf) =>
-            schemaSectionToSearchTokens(schemaFlatByLeaf?.[leaf.key], 'query'),
-        },
-        {
-          id: 'body',
-          label: 'body',
-          get: (leaf, schemaFlatByLeaf) =>
-            schemaSectionToSearchTokens(schemaFlatByLeaf?.[leaf.key], 'body'),
-        },
-        {
-          id: 'output',
-          label: 'output',
-          get: (leaf, schemaFlatByLeaf) =>
-            schemaSectionToSearchTokens(schemaFlatByLeaf?.[leaf.key], 'output'),
-        },
-      ]
-      const SCHEMA_SECTIONS = ['params', 'query', 'body', 'output']
-      const SCHEMA_FIELD_IDS = new Set(SCHEMA_SECTIONS)
-      const SOURCE_FIELD_IDS = new Set(['sourceDefinition', 'sourceSchemas'])
-      const SCHEMA_SCOPE_FIELD_IDS = new Set([...SCHEMA_SECTIONS, 'types'])
-      const CORE_FIELD_IDS = new Set(
-        SEARCH_FIELDS.map((field) => field.id).filter(
-          (id) => !SCHEMA_SCOPE_FIELD_IDS.has(id) && !SOURCE_FIELD_IDS.has(id),
-        ),
-      )
-      const FIELD_GROUPS = [
-        {
-          id: 'core',
-          label: 'Core fields',
-          fieldIds: SEARCH_FIELDS.filter((field) => CORE_FIELD_IDS.has(field.id)).map(
-            (field) => field.id,
-          ),
-        },
-        {
-          id: 'schema',
-          label: 'Schema fields',
-          fieldIds: SEARCH_FIELDS.filter((field) => SCHEMA_SCOPE_FIELD_IDS.has(field.id)).map(
-            (field) => field.id,
-          ),
-        },
-        {
-          id: 'source',
-          label: 'Source fields',
-          fieldIds: SEARCH_FIELDS.filter((field) => SOURCE_FIELD_IDS.has(field.id)).map(
-            (field) => field.id,
-          ),
-        },
-      ]
-      const state = {
-        payload: null,
-        leaves: [],
-        selectedFieldIds: new Set(SEARCH_FIELDS.map((field) => field.id)),
-      }
-      const fileInput = document.getElementById('fileInput')
-      const searchInput = document.getElementById('searchInput')
-      const caseSensitiveToggle = document.getElementById('caseSensitive')
-      const regexSearchToggle = document.getElementById('regexSearch')
-      const typeMatchModeInput = document.getElementById('typeMatchMode')
-      const schemaRowsMatchOnlyToggle = document.getElementById('schemaRowsMatchOnly')
-      const fieldChipGroups = document.getElementById('fieldChipGroups')
-      const activeFilterChips = document.getElementById('activeFilterChips')
-      const selectAllFieldsBtn = document.getElementById('selectAllFields')
-      const clearAllFieldsBtn = document.getElementById('clearAllFields')
-      const coreFieldsBtn = document.getElementById('coreFields')
-      const schemasOnlyFieldsBtn = document.getElementById('schemasOnlyFields')
-      const sourceOnlyFieldsBtn = document.getElementById('sourceOnlyFields')
-      const resetFiltersBtn = document.getElementById('resetFilters')
-      const statusEl = document.getElementById('status')
-      const resultsEl = document.getElementById('results')
-      const URL_PARAM_KEY = 'filters'
-      let isHydratingFromUrl = false
-      function escapeHtml(value) {
-        return String(value)
-          .replace(/&/g, '&amp;')
-          .replace(/</g, '&lt;')
-          .replace(/>/g, '&gt;')
-          .replace(/"/g, '&quot;')
-          .replace(/'/g, '&#39;')
-      }
-      function escapeRegExp(value) {
-        return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
-      }
-      function isPressed(button) {
-        return button?.getAttribute('aria-pressed') === 'true'
-      }
-      function setPressed(button, pressed) {
-        if (!button) return
-        button.setAttribute('aria-pressed', pressed ? 'true' : 'false')
-      }
-      function togglePressed(button) {
-        const next = !isPressed(button)
-        setPressed(button, next)
-        return next
-      }
-      function createSearchEngine(queryRaw, options) {
-        const query = queryRaw || ''
-        const caseSensitive = Boolean(options.caseSensitive)
-        const regex = Boolean(options.regex)
-        if (!query) {
-          return {
-            active: false,
-            query,
-            caseSensitive,
-            regex,
-            error: null,
-            test: () => true,
-            highlight: (text) => escapeHtml(text ?? ''),
-          }
-        }
-        if (regex) {
-          try {
-            const flags = caseSensitive ? 'g' : 'gi'
-            const rx = new RegExp(query, flags)
-            return {
-              active: true,
-              query,
-              caseSensitive,
-              regex,
-              error: null,
-              test: (text) => {
-                const source = String(text ?? '')
-                const probe = new RegExp(rx.source, rx.flags)
-                return probe.test(source)
-              },
-              highlight: (text) => {
-                const source = String(text ?? '')
-                return escapeHtml(source).replace(
-                  new RegExp(rx.source, rx.flags),
-                  (m) => `<mark>${m}</mark>`,
-                )
-              },
-            }
-          } catch (error) {
-            return {
-              active: true,
-              query,
-              caseSensitive,
-              regex,
-              error: error instanceof Error ? error.message : 'Invalid regex',
-              test: () => false,
-              highlight: (text) => escapeHtml(text ?? ''),
-            }
-          }
-        }
-        const needle = caseSensitive ? query : query.toLowerCase()
-        const flags = caseSensitive ? 'g' : 'gi'
-        const safe = escapeRegExp(query)
-        return {
-          active: true,
-          query,
-          caseSensitive,
-          regex,
-          error: null,
-          test: (text) => {
-            const source = String(text ?? '')
-            const hay = caseSensitive ? source : source.toLowerCase()
-            return hay.includes(needle)
-          },
-          highlight: (text) =>
-            escapeHtml(String(text ?? '')).replace(
-              new RegExp(safe, flags),
-              (m) => `<mark>${m}</mark>`,
-            ),
-        }
-      }
-      function toTokens(value) {
-        if (value === null || value === undefined) return []
-        if (typeof value === 'string') return [value]
-        if (typeof value === 'number' || typeof value === 'boolean') return [String(value)]
-        if (Array.isArray(value)) return value.flatMap((item) => toTokens(item))
-        if (typeof value === 'object') return [JSON.stringify(value)]
-        return []
-      }
-      function flatSchemaToSearchTokens(flatSchema) {
-        if (!flatSchema || typeof flatSchema !== 'object') return []
-        const tokens = new Set()
-        Object.entries(flatSchema).forEach(([path, info]) => {
-          if (path) {
-            tokens.add(path)
-            path.split('.').forEach((segment) => {
-              if (segment) tokens.add(segment)
-            })
-          }
-          if (info && typeof info === 'object') {
-            tokens.add(JSON.stringify(info))
-            if (info.type) tokens.add(String(info.type))
-            if (info.kind) tokens.add(String(info.kind))
-            if (info.description) tokens.add(String(info.description))
-            if (Array.isArray(info.enumValues)) {
-              info.enumValues.forEach((value) => tokens.add(String(value)))
-            }
-          } else if (info !== null && info !== undefined) {
-            tokens.add(String(info))
-          }
-        })
-        tokens.add(JSON.stringify(flatSchema))
-        return Array.from(tokens)
-      }
-      function schemaSectionToSearchTokens(flatSchema, sectionName) {
-        if (!flatSchema || typeof flatSchema !== 'object') return []
-        const sectionEntries = Object.entries(flatSchema).filter(
-          ([path]) => path === sectionName || path.startsWith(`${sectionName}.`),
-        )
-        if (sectionEntries.length === 0) return []
-        return flatSchemaToSearchTokens(Object.fromEntries(sectionEntries))
-      }
-      function schemaTypeTokens(flatSchema) {
-        if (!flatSchema || typeof flatSchema !== 'object') return []
-        const tokens = new Set()
-        Object.values(flatSchema).forEach((info) => {
-          if (!info || typeof info !== 'object') return
-          if (info.type) tokens.add(String(info.type))
-          if (info.kind) tokens.add(String(info.kind))
-          if (Array.isArray(info.enumValues)) {
-            info.enumValues.forEach((value) => tokens.add(String(value)))
-          }
-        })
-        return Array.from(tokens)
-      }
-      function schemaEntryTokens(path, info) {
-        const tokens = new Set()
-        if (path) {
-          tokens.add(path)
-          path.split('.').forEach((segment) => {
-            if (segment) tokens.add(segment)
-          })
-        }
-        if (info && typeof info === 'object') {
-          tokens.add(JSON.stringify(info))
-          if (info.type) tokens.add(String(info.type))
-          if (info.kind) tokens.add(String(info.kind))
-          if (info.description) tokens.add(String(info.description))
-          if (Array.isArray(info.enumValues)) {
-            info.enumValues.forEach((value) => tokens.add(String(value)))
-          }
-        } else if (info !== null && info !== undefined) {
-          tokens.add(String(info))
-        }
-        return Array.from(tokens)
-      }
-      function schemaEntryMatchesActiveFilter(sectionName, fullPath, info, engine, selectedIds) {
-        if (!engine.active) return true
-        let matched = false
-        if (selectedIds.includes(sectionName)) {
-          matched = schemaEntryTokens(fullPath, info).some((token) => engine.test(token))
-        }
-        if (!matched && selectedIds.includes('types')) {
-          const typeTokens = []
-          if (info && typeof info === 'object') {
-            if (info.type) typeTokens.push(String(info.type))
-            if (info.kind) typeTokens.push(String(info.kind))
-            if (Array.isArray(info.enumValues)) {
-              info.enumValues.forEach((value) => typeTokens.push(String(value)))
-            }
-          }
-          if (typeMatchModeInput.value === 'exact' && !engine.regex) {
-            const needle = engine.caseSensitive ? engine.query : engine.query.toLowerCase()
-            const normalized = engine.caseSensitive
-              ? typeTokens
-              : typeTokens.map((token) => token.toLowerCase())
-            matched = normalized.includes(needle)
-          } else {
-            matched = typeTokens.some((token) => engine.test(token))
-          }
-        }
-        return matched
-      }
-      function matchesLeaf(leaf, engine, selectedIds) {
-        if (!engine.active) return true
-        if (selectedIds.length === 0) return false
-        const schemaFlatByLeaf = state.payload?.schemaFlatByLeaf || {}
-        const payload = state.payload || {}
-        return SEARCH_FIELDS.some((field) => {
-          if (!selectedIds.includes(field.id)) return false
-          const tokens = toTokens(field.get(leaf, schemaFlatByLeaf, payload))
-          if (field.id === 'types' && typeMatchModeInput.value === 'exact' && !engine.regex) {
-            const needle = engine.caseSensitive ? engine.query : engine.query.toLowerCase()
-            const normalized = engine.caseSensitive
-              ? tokens
-              : tokens.map((token) => String(token).toLowerCase())
-            return normalized.includes(needle)
-          }
-          return tokens.some((token) => engine.test(token))
-        })
-      }
-      function el(tag, className, text) {
-        const node = document.createElement(tag)
-        if (className) node.className = className
-        if (text !== undefined) node.textContent = text
-        return node
-      }
-      function setHighlighted(node, text, engine) {
-        node.innerHTML = engine.highlight(text ?? '')
-      }
-      function kv(key, value, engine) {
-        const box = el('div', 'kv')
-        box.appendChild(el('div', 'k', key))
-        const valueNode = el('div', 'v mono')
-        setHighlighted(valueNode, value === undefined ? '—' : String(value), engine)
-        box.appendChild(valueNode)
-        return box
-      }
-      function renderSchemaSummary(name, schema, engine) {
-        const row = el('div', 'kv')
-        row.appendChild(el('div', 'k', name))
-        const valueNode = el('div', 'v mono')
-        if (!schema) {
-          setHighlighted(valueNode, 'not defined', engine)
-          row.appendChild(valueNode)
-          return row
-        }
-        const parts = [schema.kind]
-        if (schema.optional) parts.push('optional')
-        if (schema.nullable) parts.push('nullable')
-        if (Array.isArray(schema.enumValues) && schema.enumValues.length > 0) {
-          parts.push(`enum: ${schema.enumValues.join('|')}`)
-        }
-        if (schema.properties) {
-          parts.push(`properties: ${Object.keys(schema.properties).length}`)
-        }
-        setHighlighted(valueNode, parts.join(' | '), engine)
-        row.appendChild(valueNode)
-        return row
-      }
-      function sourceHref(source) {
-        if (!source || !source.file) return undefined
-        const normalizedPath = String(source.file).replace(/\\/g, '/')
-        const platform =
-          (navigator.userAgentData && navigator.userAgentData.platform) ||
-          navigator.platform ||
-          ''
-        const isWindows = /win/i.test(platform)
-        const vscodePath = isWindows
-          ? normalizedPath.replace(/^\/+/, '')
-          : normalizedPath.startsWith('/')
-            ? normalizedPath
-            : `/${normalizedPath}`
-        const line = Number.isFinite(source.line) ? source.line : 1
-        const column = Number.isFinite(source.column) ? source.column : 1
-        return `vscode://file/${encodeURI(vscodePath)}:${line}:${column}`
-      }
-      function sourceDisplay(source) {
-        if (!source || !source.file) return '—'
-        const line = Number.isFinite(source.line) ? source.line : 1
-        const column = Number.isFinite(source.column) ? source.column : 1
-        return `${source.file}:${line}:${column}`
-      }
-      function createSourceRow(key, source, engine) {
-        const box = el('div', 'kv')
-        const keyNode = el('div', 'k')
-        const valueNode = el('div', 'v mono')
-        if (!source || !source.file) {
-          setHighlighted(keyNode, key, engine)
-          box.appendChild(keyNode)
-          setHighlighted(valueNode, '—', engine)
-          box.appendChild(valueNode)
-          return box
-        }
-        const href = sourceHref(source)
-        const keyLink = document.createElement('a')
-        keyLink.href = href
-        keyLink.target = '_blank'
-        keyLink.rel = 'noopener noreferrer'
-        keyLink.innerHTML = engine.highlight(key)
-        keyNode.appendChild(keyLink)
-        setHighlighted(valueNode, sourceDisplay(source), engine)
-        box.appendChild(keyNode)
-        box.appendChild(valueNode)
-        return box
-      }
-      function splitFlatSchemaBySection(flatSchema) {
-        const result = {
-          params: {},
-          query: {},
-          body: {},
-          output: {},
-        }
-        if (!flatSchema) return result
-        Object.entries(flatSchema).forEach(([path, info]) => {
-          const section = SCHEMA_SECTIONS.find(
-            (name) => path === name || path.startsWith(`${name}.`),
-          )
-          if (!section) return
-          result[section][path] = info
-        })
-        return result
-      }
-      const SCHEMA_SOURCE_KEYS_BY_SECTION = {
-        params: 'paramsSchema',
-        query: 'querySchema',
-        body: 'bodySchema',
-        output: 'outputSchema',
-      }
-      function getSchemaSource(source, sectionName) {
-        const schemaKey = SCHEMA_SOURCE_KEYS_BY_SECTION[sectionName]
-        if (!schemaKey || !source?.schemas || typeof source.schemas !== 'object') {
-          return {
-            schemaKey,
-            sourceValue: undefined,
-          }
-        }
-        return {
-          schemaKey,
-          sourceValue: source.schemas[schemaKey],
-        }
-      }
-      function createTreeNode(name = '') {
-        return {
-          name,
-          info: null,
-          fullPath: null,
-          children: {},
-        }
-      }
-      function buildSchemaTree(entries, sectionName) {
-        const root = createTreeNode(sectionName)
-        Object.entries(entries)
-          .sort(([a], [b]) => a.localeCompare(b))
-          .forEach(([fullPath, info]) => {
-            const trimmed = fullPath === sectionName ? '' : fullPath.slice(sectionName.length + 1)
-            const segments = trimmed ? trimmed.split('.') : []
-            let current = root
-            segments.forEach((segment) => {
-              if (!current.children[segment]) {
-                current.children[segment] = createTreeNode(segment)
-              }
-              current = current.children[segment]
-            })
-            current.info = info
-            current.fullPath = fullPath
-          })
-        return root
-      }
-      function renderTreeNode(node, engine, isRoot) {
-        const childKeys = Object.keys(node.children)
-        const hasChildren = childKeys.length > 0
-        const hasInfo = Boolean(node.info)
-        const appendNameCell = (row) => {
-          const nameWrap = el('span', 'mono tree-name')
-          const nameNode = el('span')
-          setHighlighted(nameNode, node.name, engine)
-          nameWrap.appendChild(nameNode)
-          if (node.info && !node.info.optional) {
-            const star = el('span', 'required-star', '*')
-            nameWrap.appendChild(star)
-          }
-          if (node.info?.nullable) {
-            nameWrap.appendChild(el('span', 'tree-col-muted', '-'))
-          }
-          row.appendChild(nameWrap)
-        }
-        const appendTypeCell = (row, info) => {
-          const type = el('span', 'tree-pill')
-          setHighlighted(type, info?.type || info?.kind || '—', engine)
-          row.appendChild(type)
-        }
-        if (isRoot || hasChildren) {
-          const details = el('details')
-          details.open = true
-          const summary = el('summary')
-          const row = el('div', 'tree-row')
-          appendNameCell(row)
-          appendTypeCell(row, hasInfo ? node.info : null)
-          summary.appendChild(row)
-          details.appendChild(summary)
-          const container = el('div', 'schema-tree')
-          childKeys
-            .sort((a, b) => a.localeCompare(b))
-            .forEach((key) => container.appendChild(renderTreeNode(node.children[key], engine, false)))
-          details.appendChild(container)
-          return details
-        }
-        const row = el('div', 'tree-row')
-        appendNameCell(row)
-        appendTypeCell(row, node.info)
-        return row
-      }
-      function renderSeparatedSchemas(flatSchema, engine, selectedIds, source) {
-        if (!flatSchema || typeof flatSchema !== 'object') return null
-        const section = el('div', 'section')
-        section.appendChild(el('h3', '', 'Schemas (separated by section)'))
-        const grouped = splitFlatSchemaBySection(flatSchema)
-        let hasAnySchemaEntries = false
-        const limitToMatchedRows = isPressed(schemaRowsMatchOnlyToggle) && engine.active
-        SCHEMA_SECTIONS.forEach((sectionName) => {
-          const rawEntries = grouped[sectionName]
-          if (!rawEntries || Object.keys(rawEntries).length === 0) return
-          const entries = limitToMatchedRows
-            ? Object.fromEntries(
-                Object.entries(rawEntries).filter(([fullPath, info]) =>
-                  schemaEntryMatchesActiveFilter(sectionName, fullPath, info, engine, selectedIds),
-                ),
-              )
-            : rawEntries
-          if (Object.keys(entries).length === 0) return
-          hasAnySchemaEntries = true
-          const block = el('div', 'schema-block')
-          const header = el('div', 'schema-header mono')
-          setHighlighted(header, sectionName, engine)
-          block.appendChild(header)
-          const schemaSource = getSchemaSource(source, sectionName)
-          if (schemaSource.sourceValue) {
-            block.appendChild(
-              createSourceRow(
-                schemaSource.schemaKey || `${sectionName}Schema`,
-                schemaSource.sourceValue,
-                engine,
-              ),
-            )
-          }
-          const tree = buildSchemaTree(entries, sectionName)
-          block.appendChild(renderTreeNode(tree, engine, true))
-          section.appendChild(block)
-        })
-        return hasAnySchemaEntries ? section : null
-      }
-      function renderLeaf(leaf, engine, selectedIds) {
-        const details = el('details', 'leaf')
-        const summary = el('summary')
-        setHighlighted(summary, `${String(leaf.method || '').toUpperCase()} ${leaf.path || ''}`, engine)
-        details.appendChild(summary)
-        const content = el('div', 'leaf-content')
-        const cfg = leaf.cfg || {}
-        const flatSchema = state.payload?.schemaFlatByLeaf?.[leaf.key]
-        const overview = el('div', 'section')
-        overview.appendChild(el('h3', '', 'Overview'))
-        const topGrid = el('div', 'grid-3')
-        topGrid.appendChild(kv('group', cfg.docsGroup, engine))
-        topGrid.appendChild(
-          kv('tags', cfg.tags && cfg.tags.length > 0 ? cfg.tags.join(', ') : undefined, engine),
-        )
-        topGrid.appendChild(kv('stability', cfg.stability, engine))
-        overview.appendChild(topGrid)
-        overview.appendChild(kv('summary', cfg.summary, engine))
-        overview.appendChild(kv('description', cfg.description, engine))
-        const iconRow = el('div', 'icon-row')
-        if (cfg.feed) {
-          const feed = el('span', 'icon-badge feed')
-          feed.title = 'Feed endpoint'
-          setHighlighted(feed, 'Feed', engine)
-          iconRow.appendChild(feed)
-        }
-        if (cfg.deprecated) {
-          const deprecated = el('span', 'icon-badge warn')
-          deprecated.title = 'Deprecated'
-          setHighlighted(deprecated, 'D', engine)
-          iconRow.appendChild(deprecated)
-        }
-        if (cfg.docsHidden) {
-          const hidden = el('span', 'icon-badge warn')
-          hidden.title = 'Hidden'
-          setHighlighted(hidden, 'H', engine)
-          iconRow.appendChild(hidden)
-        }
-        if (iconRow.childNodes.length > 0) {
-          overview.appendChild(iconRow)
-        }
-        content.appendChild(overview)
-        const files = el('div', 'section')
-        if (Array.isArray(cfg.bodyFiles) && cfg.bodyFiles.length > 0) {
-          files.appendChild(el('h3', '', 'Body Files'))
-          const chips = el('div', 'chips')
-          cfg.bodyFiles.forEach((file) => {
-            const chip = el('span', 'chip ok')
-            setHighlighted(chip, `${file.name} (max ${file.maxCount})`, engine)
-            chips.appendChild(chip)
-          })
-          files.appendChild(chips)
-          content.appendChild(files)
-        }
-        const sourceByLeaf = state.payload?.sourceByLeaf || {}
-        const source = sourceByLeaf[leaf.key]
-        if (source?.definition) {
-          overview.appendChild(createSourceRow('definition', source.definition, engine))
-        }
-        const separatedSchemas = renderSeparatedSchemas(flatSchema, engine, selectedIds, source)
-        if (separatedSchemas) {
-          content.appendChild(separatedSchemas)
-        }
-        details.appendChild(content)
-        return details
-      }
-      function renderResults() {
-        const engine = createSearchEngine(searchInput.value.trim(), {
-          caseSensitive: isPressed(caseSensitiveToggle),
-          regex: isPressed(regexSearchToggle),
-        })
-        if (engine.error) {
-          statusEl.textContent = `Invalid regex: ${engine.error}`
-          resultsEl.innerHTML = ''
-          resultsEl.appendChild(el('div', 'empty', 'Fix the regex to continue.'))
-          renderActiveFilterChips({
-            selectedIds: selectedFieldIds(),
-            hasRegexError: true,
-          })
-          return
-        }
-        const selectedIds = selectedFieldIds()
-        const filtered = state.leaves.filter((leaf) => matchesLeaf(leaf, engine, selectedIds))
-        statusEl.textContent = `${filtered.length} / ${state.leaves.length} routes matched.`
-        resultsEl.innerHTML = ''
-        renderActiveFilterChips({ selectedIds, hasRegexError: false })
-        if (filtered.length === 0) {
-          resultsEl.appendChild(el('div', 'empty', 'No matches.'))
-          syncFilterStateToUrl()
-          return
-        }
-        filtered.forEach((leaf) => {
-          resultsEl.appendChild(renderLeaf(leaf, engine, selectedIds))
-        })
-        syncFilterStateToUrl()
-      }
-      function selectedFieldIds() {
-        return SEARCH_FIELDS.filter((field) => state.selectedFieldIds.has(field.id)).map(
-          (field) => field.id,
-        )
-      }
-      function renderFieldChips() {
-        fieldChipGroups.innerHTML = ''
-        FIELD_GROUPS.forEach((group) => {
-          const groupWrap = el('div', 'scope-group')
-          groupWrap.appendChild(el('div', 'scope-group-title', group.label))
-          const chipsWrap = el('div', 'scope-group-chips')
-          group.fieldIds.forEach((fieldId) => {
-            const field = SEARCH_FIELDS.find((item) => item.id === fieldId)
-            if (!field) return
-            const chip = document.createElement('button')
-            chip.type = 'button'
-            chip.className = 'field-chip'
-            chip.textContent = field.label
-            setPressed(chip, state.selectedFieldIds.has(field.id))
-            chip.addEventListener('click', () => {
-              if (state.selectedFieldIds.has(field.id)) {
-                state.selectedFieldIds.delete(field.id)
-              } else {
-                state.selectedFieldIds.add(field.id)
-              }
-              renderFieldChips()
-              renderResults()
-            })
-            chipsWrap.appendChild(chip)
-          })
-          groupWrap.appendChild(chipsWrap)
-          fieldChipGroups.appendChild(groupWrap)
-        })
-      }
-      function setFieldSelection(allowedIds, options = {}) {
-        const { rerender = true } = options
-        state.selectedFieldIds = new Set(
-          SEARCH_FIELDS.map((field) => field.id).filter((id) => allowedIds.has(id)),
-        )
-        renderFieldChips()
-        if (rerender) renderResults()
-      }
-      function resetFiltersToDefault() {
-        searchInput.value = ''
-        setPressed(caseSensitiveToggle, false)
-        setPressed(regexSearchToggle, false)
-        typeMatchModeInput.value = 'contains'
-        setPressed(schemaRowsMatchOnlyToggle, false)
-        setFieldSelection(new Set(SEARCH_FIELDS.map((field) => field.id)), { rerender: false })
-        renderResults()
-      }
-      function renderActiveFilterChips({ selectedIds, hasRegexError }) {
-        activeFilterChips.innerHTML = ''
-        const searchValue = searchInput.value.trim()
-        const chipModels = []
-        if (searchValue) {
-          chipModels.push({
-            text: `search: ${searchValue}`,
-            onClick: () => {
-              searchInput.value = ''
-              renderResults()
-            },
-          })
-        }
-        if (typeMatchModeInput.value === 'exact') {
-          chipModels.push({
-            text: 'type mode: exact',
-            onClick: () => {
-              typeMatchModeInput.value = 'contains'
-              renderResults()
-            },
-          })
-        }
-        if (isPressed(schemaRowsMatchOnlyToggle)) {
-          chipModels.push({
-            text: 'schema rows: matched only',
-            onClick: () => {
-              setPressed(schemaRowsMatchOnlyToggle, false)
-              renderResults()
-            },
-          })
-        }
-        if (isPressed(caseSensitiveToggle)) {
-          chipModels.push({
-            text: 'case sensitive',
-            onClick: () => {
-              setPressed(caseSensitiveToggle, false)
-              renderResults()
-            },
-          })
-        }
-        if (isPressed(regexSearchToggle)) {
-          chipModels.push({
-            text: 'regex',
-            onClick: () => {
-              setPressed(regexSearchToggle, false)
-              renderResults()
-            },
-          })
-        }
-        if (hasRegexError) chipModels.push({ text: 'regex error' })
-        const allIds = SEARCH_FIELDS.map((field) => field.id)
-        if (selectedIds.length !== allIds.length) {
-          chipModels.push({
-            text: `fields: ${selectedIds.join(', ') || 'none'}`,
-            onClick: () => setFieldSelection(new Set(allIds)),
-          })
-        }
-        if (chipModels.length === 0) {
-          activeFilterChips.appendChild(el('span', 'empty', 'No active filters'))
-          return
-        }
-        chipModels.forEach((chipModel) => {
-          const chip = document.createElement(chipModel.onClick ? 'button' : 'span')
-          chip.className = chipModel.onClick ? 'chip chip-btn' : 'chip'
-          chip.textContent = chipModel.text
-          if (chipModel.onClick) {
-            chip.type = 'button'
-            chip.addEventListener('click', chipModel.onClick)
-          }
-          activeFilterChips.appendChild(chip)
-        })
-      }
-      function collectFilterState() {
-        return {
-          search: searchInput.value,
-          caseSensitive: isPressed(caseSensitiveToggle),
-          regex: isPressed(regexSearchToggle),
-          typeMatchMode: typeMatchModeInput.value === 'exact' ? 'exact' : 'contains',
-          schemaRowsMatchOnly: isPressed(schemaRowsMatchOnlyToggle),
-          selectedFields: selectedFieldIds(),
-        }
-      }
-      function syncFilterStateToUrl() {
-        if (isHydratingFromUrl) return
-        const data = collectFilterState()
-        const params = new URLSearchParams(window.location.hash.replace(/^#/, ''))
-        const serialized = encodeURIComponent(JSON.stringify(data))
-        params.set(URL_PARAM_KEY, serialized)
-        const nextHash = params.toString()
-        if (window.location.hash !== `#${nextHash}`) {
-          window.location.hash = nextHash
-        }
-      }
-      function hydrateFilterStateFromUrl() {
-        const params = new URLSearchParams(window.location.hash.replace(/^#/, ''))
-        const raw = params.get(URL_PARAM_KEY)
-        if (!raw) return
-        try {
-          const parsed = JSON.parse(decodeURIComponent(raw))
-          isHydratingFromUrl = true
-          if (typeof parsed.search === 'string') searchInput.value = parsed.search
-          setPressed(caseSensitiveToggle, Boolean(parsed.caseSensitive))
-          setPressed(regexSearchToggle, Boolean(parsed.regex))
-          if (parsed.typeMatchMode === 'exact' || parsed.typeMatchMode === 'contains') {
-            typeMatchModeInput.value = parsed.typeMatchMode
-          }
-          setPressed(schemaRowsMatchOnlyToggle, Boolean(parsed.schemaRowsMatchOnly))
-          if (Array.isArray(parsed.selectedFields)) {
-            setFieldSelection(new Set(parsed.selectedFields), { rerender: false })
-          }
-        } catch (error) {
-          // Ignore malformed hash state.
-        } finally {
-          isHydratingFromUrl = false
-        }
-      }
-      async function handleFile(file) {
-        const text = await file.text()
-        const parsed = JSON.parse(text)
-        if (!parsed || !Array.isArray(parsed.leaves)) {
-          throw new Error('Invalid export file: expected top-level "leaves" array.')
-        }
-        state.payload = parsed
-        state.leaves = parsed.leaves
-        renderResults()
-      }
-      function initializeFromBakedPayload() {
-        const baked = window.__FINALIZED_LEAVES_PAYLOAD
-        if (!baked || !Array.isArray(baked.leaves)) return
-        state.payload = baked
-        state.leaves = baked.leaves
-        statusEl.textContent = `Loaded baked payload with ${state.leaves.length} routes.`
-        renderResults()
-      }
-      fileInput.addEventListener('change', async (event) => {
-        const file = event.target.files?.[0]
-        if (!file) return
-        try {
-          await handleFile(file)
-        } catch (error) {
-          statusEl.textContent = error instanceof Error ? error.message : String(error)
-          resultsEl.innerHTML = ''
-        }
-      })
-      searchInput.addEventListener('input', renderResults)
-      caseSensitiveToggle.addEventListener('click', () => {
-        togglePressed(caseSensitiveToggle)
-        renderResults()
-      })
-      regexSearchToggle.addEventListener('click', () => {
-        togglePressed(regexSearchToggle)
-        renderResults()
-      })
-      typeMatchModeInput.addEventListener('change', renderResults)
-      schemaRowsMatchOnlyToggle.addEventListener('click', () => {
-        togglePressed(schemaRowsMatchOnlyToggle)
-        renderResults()
-      })
-      selectAllFieldsBtn.addEventListener('click', () =>
-        setFieldSelection(new Set(SEARCH_FIELDS.map((field) => field.id))),
-      )
-      clearAllFieldsBtn.addEventListener('click', () => setFieldSelection(new Set()))
-      coreFieldsBtn.addEventListener('click', () => setFieldSelection(CORE_FIELD_IDS))
-      schemasOnlyFieldsBtn.addEventListener('click', () => setFieldSelection(SCHEMA_SCOPE_FIELD_IDS))
-      sourceOnlyFieldsBtn.addEventListener('click', () => setFieldSelection(SOURCE_FIELD_IDS))
-      resetFiltersBtn.addEventListener('click', resetFiltersToDefault)
-      renderFieldChips()
-      hydrateFilterStateFromUrl()
-      initializeFromBakedPayload()
-      renderResults()
-    </script>
-  </body>
-</html>