raffel 1.1.82 → 1.1.83

package/dist/docs/ui/assets/raffel-docs.js

@@ -61,7 +61,12 @@ let searchQuery = '';
 let routeState = parseRouteHash();
 let activePagePath = resolveDocsAlias(routeState.pagePath);
 let activeHeadingId = routeState.headingId;
-const docsPlugins = [], themeStorageKey = 'raffel-docs-theme';
+const docsPlugins = [];
+const themeStorageKey = 'raffel-docs-theme';
+const sidebarWidthStorageKey = 'raffel-docs-sidebar-width';
+const defaultSidebarWidth = 280;
+const defaultSidebarMinWidth = 220;
+const defaultSidebarMaxWidth = 560;
 const docsStatePollMs = 10000;
 const docsStateRevisionNoticeMs = 15000;
 let docsStateSnapshot = {
@@ -949,6 +954,92 @@ function getGrpcMethodType(method) {
 function byId(id) {
     return doc?.getElementById(id);
 }
+function finiteSidebarNumber(value, fallback) {
+    if (value === null || value === undefined || value === '')
+        return fallback;
+    const numeric = Number(value);
+    return Number.isFinite(numeric) ? numeric : fallback;
+}
+function sidebarWidthLimits() {
+    const min = Math.max(180, Math.round(finiteSidebarNumber(sidebarConfig.minWidth, defaultSidebarMinWidth)));
+    const configuredMax = Math.max(min, Math.round(finiteSidebarNumber(sidebarConfig.maxWidth, defaultSidebarMaxWidth)));
+    const viewportMax = Math.max(min, Math.floor(finiteSidebarNumber(win.innerWidth, 1440) * 0.6));
+    const max = Math.min(configuredMax, viewportMax);
+    const initial = Math.max(min, Math.min(max, Math.round(finiteSidebarNumber(sidebarConfig.width, defaultSidebarWidth))));
+    return { min, max, initial };
+}
+function initSidebarResize() {
+    const app = byId('docs');
+    const handle = byId('sidebarResizer');
+    if (!app || !handle || app.dataset?.sidebarHidden === 'true')
+        return;
+    let limits = sidebarWidthLimits();
+    const stored = finiteSidebarNumber(win.localStorage?.getItem?.(sidebarWidthStorageKey), limits.initial);
+    let width = Math.max(limits.min, Math.min(limits.max, Math.round(stored)));
+    let dragging = false;
+    const applyWidth = (nextWidth, persist = false) => {
+        limits = sidebarWidthLimits();
+        width = Math.max(limits.min, Math.min(limits.max, Math.round(nextWidth)));
+        app.style?.setProperty?.('--sidebar-width', `${width}px`);
+        handle.setAttribute?.('aria-valuemin', String(limits.min));
+        handle.setAttribute?.('aria-valuemax', String(limits.max));
+        handle.setAttribute?.('aria-valuenow', String(width));
+        if (persist)
+            win.localStorage?.setItem?.(sidebarWidthStorageKey, String(width));
+    };
+    applyWidth(width);
+    if (sidebarConfig.resizable === false) {
+        handle.hidden = true;
+        return;
+    }
+    const widthFromPointer = (event) => {
+        const left = Number(app.getBoundingClientRect?.().left ?? 0);
+        return Number(event.clientX ?? width) - left;
+    };
+    const finishResize = (event) => {
+        if (!dragging)
+            return;
+        dragging = false;
+        doc.documentElement?.classList?.remove?.('sidebar-is-resizing');
+        if (event?.pointerId !== undefined)
+            handle.releasePointerCapture?.(event.pointerId);
+        applyWidth(width, true);
+    };
+    handle.addEventListener?.('pointerdown', (event) => {
+        if (event.button !== undefined && event.button !== 0)
+            return;
+        dragging = true;
+        handle.setPointerCapture?.(event.pointerId);
+        doc.documentElement?.classList?.add?.('sidebar-is-resizing');
+        applyWidth(widthFromPointer(event));
+        event.preventDefault?.();
+    });
+    handle.addEventListener?.('pointermove', (event) => {
+        if (!dragging)
+            return;
+        applyWidth(widthFromPointer(event));
+    });
+    handle.addEventListener?.('pointerup', finishResize);
+    handle.addEventListener?.('pointercancel', finishResize);
+    handle.addEventListener?.('dblclick', () => applyWidth(limits.initial, true));
+    handle.addEventListener?.('keydown', (event) => {
+        const step = event.shiftKey ? 32 : 16;
+        let next = null;
+        if (event.key === 'ArrowLeft')
+            next = width - step;
+        else if (event.key === 'ArrowRight')
+            next = width + step;
+        else if (event.key === 'Home')
+            next = limits.min;
+        else if (event.key === 'End')
+            next = limits.max;
+        if (next === null)
+            return;
+        event.preventDefault?.();
+        applyWidth(next, true);
+    });
+    win.addEventListener?.('resize', () => applyWidth(width));
+}
 function renderProtocolTabs() {
     const container = byId('protocolTabs');
     if (!container)
@@ -1124,6 +1215,7 @@ function renderDocsPagesNav(nav) {
         wrapper.className = `tag-group docs-pages-group${hasActiveDocPage || sidebarConfig.expandAll ? '' : ' collapsed'}`;
         const header = doc.createElement('div');
         header.className = 'tag-group-header';
+        header.title = String(groupLabel);
         header.innerHTML = `<span class="tag-group-arrow">▼</span>${esc(groupLabel)}<span class="tag-group-count">${allPages.length}</span>`;
         const inner = doc.createElement('div');
         inner.className = 'tag-group-items';
@@ -1183,6 +1275,7 @@ function appendSidebarGroup(nav, title, items) {
     group.className = 'tag-group';
     const header = doc.createElement('div');
     header.className = 'tag-group-header';
+    header.title = title;
     header.innerHTML = `<span class="tag-group-arrow">▼</span>${esc(title)}<span class="tag-group-count">${items.length}</span>`;
     const itemContainer = doc.createElement('div');
     itemContainer.className = 'tag-group-items';
@@ -1196,6 +1289,7 @@ function appendSidebarGroup(nav, title, items) {
     for (const item of items) {
         const el = doc.createElement('div');
         el.className = `nav-item${item.active ? ' active' : ''}`;
+        el.title = item.label;
         const isHome = item.path === '/' || item.path === '';
         el.innerHTML = isHome
             ? `<span class="docs-sidebar-home">${HOME_ICON_SVG}<span class="nav-item-path">${esc(item.label)}</span></span>`
@@ -1213,6 +1307,7 @@ function appendSidebarGroup(nav, title, items) {
                 childEl.type = 'button';
                 childEl.className = `nav-subitem nav-subitem-level-${child.level}${child.id === activeHeadingId ? ' active' : ''}`;
                 childEl.textContent = child.title;
+                childEl.title = child.title;
                 childEl.onclick = (event) => {
                     event.stopPropagation();
                     setDocsPage(activePagePath || item.label, child.id);
@@ -1329,8 +1424,6 @@ function schemaConstraintChips(schema) {
     if (!schema || typeof schema !== 'object')
         return [];
     const chips = [];
-    if (schema.format)
-        chips.push(`format: ${schema.format}`);
     if (typeof schema.minLength === 'number')
         chips.push(`min length: ${schema.minLength}`);
     if (typeof schema.maxLength === 'number')
@@ -1392,6 +1485,125 @@ function appendConstraintChips(row, schema) {
     });
     row.appendChild(wrap);
 }
+function formatContractExample(value) {
+    if (typeof value === 'string')
+        return value;
+    const json = JSON.stringify(value);
+    return json === undefined ? String(value) : json;
+}
+function collectContractExamples(owner, schema) {
+    const examples = [];
+    if (owner?.example !== undefined)
+        examples.push(owner.example);
+    Object.values(owner?.examples ?? {}).forEach((example) => {
+        if (example && typeof example === 'object' && 'value' in example)
+            examples.push(example.value);
+    });
+    if (schema?.example !== undefined)
+        examples.push(schema.example);
+    if (Array.isArray(schema?.examples))
+        examples.push(...schema.examples);
+    const seen = new Set();
+    return examples.filter(value => {
+        const key = formatContractExample(value);
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+function contractSchemaType(rawSchema, schema) {
+    const refName = rawSchema?.$ref ? String(rawSchema.$ref).split('/').pop() : '';
+    const type = Array.isArray(schema?.type)
+        ? schema.type.join(' | ')
+        : schema?.type || (refName ? 'object' : 'any');
+    if (type === 'array') {
+        const items = resolveSchema(schema?.items);
+        const itemType = items?.type || (schema?.items?.$ref ? String(schema.items.$ref).split('/').pop() : 'any');
+        const itemFormat = items?.format ? ` <${items.format}>` : '';
+        return { type, label: `array of ${itemType}${itemFormat}` };
+    }
+    const format = schema?.format ? ` <${schema.format}>` : '';
+    const reference = refName ? ` <${refName}>` : '';
+    return { type, label: `${type}${format}${reference}` };
+}
+function appendContractDescription(parent, description, className) {
+    if (!description)
+        return;
+    const desc = doc.createElement('div');
+    desc.className = `${className} markdown-content`;
+    desc.innerHTML = parseMarkdown(description);
+    parent.appendChild(desc);
+}
+function appendContractExamples(parent, examples, prefix = '') {
+    examples.forEach((value, index) => {
+        const line = doc.createElement('div');
+        line.className = 'schema-tree-example';
+        const label = examples.length > 1 ? `Example ${index + 1}:` : 'Example:';
+        const rendered = prefix ? `${prefix}${formatContractExample(value)}` : formatContractExample(value);
+        line.innerHTML = `<span>${label}</span><code>${esc(rendered)}</code>`;
+        parent.appendChild(line);
+    });
+}
+function createContractRow(name, rawSchema, required, options = {}) {
+    const schema = resolveSchema(rawSchema) ?? {};
+    const nestedSchema = schema.type === 'object' && schema.properties
+        ? rawSchema
+        : schema.type === 'array' && resolveSchema(schema.items)?.properties
+            ? schema.items
+            : null;
+    const row = doc.createElement('div');
+    row.className = `schema-tree-row${nestedSchema ? ' schema-tree-row-expandable' : ''}`;
+    const key = doc.createElement('div');
+    key.className = 'schema-tree-key';
+    let toggle = null;
+    if (nestedSchema) {
+        toggle = doc.createElement('button');
+        toggle.type = 'button';
+        toggle.className = 'schema-tree-toggle';
+        toggle.setAttribute('aria-expanded', 'false');
+        toggle.setAttribute('aria-label', `Expand ${name}`);
+        toggle.textContent = '›';
+        key.appendChild(toggle);
+    }
+    const nameEl = doc.createElement('code');
+    nameEl.className = 'schema-tree-name';
+    nameEl.textContent = name;
+    key.appendChild(nameEl);
+    const state = doc.createElement('span');
+    state.className = required ? 'schema-tree-required' : 'schema-tree-optional';
+    state.textContent = required ? 'required' : 'optional';
+    key.appendChild(state);
+    if (options.deprecated) {
+        const deprecated = doc.createElement('span');
+        deprecated.className = 'schema-tree-deprecated';
+        deprecated.textContent = 'deprecated';
+        key.appendChild(deprecated);
+    }
+    const details = doc.createElement('div');
+    details.className = 'schema-tree-details';
+    const schemaType = contractSchemaType(rawSchema, schema);
+    const type = doc.createElement('div');
+    type.className = `schema-tree-type type-text-${esc(schemaType.type)}`;
+    type.textContent = schemaType.label;
+    details.appendChild(type);
+    appendContractExamples(details, collectContractExamples(options.owner, schema), options.examplePrefix ?? '');
+    appendContractDescription(details, options.description ?? schema.description, 'schema-tree-description');
+    appendConstraintChips(details, schema);
+    if (schema.type === 'array' && schema.items) {
+        const items = resolveSchema(schema.items);
+        if (Array.isArray(items?.enum) && items.enum.length > 0) {
+            const label = doc.createElement('div');
+            label.className = 'schema-tree-items-label';
+            label.textContent = 'Items';
+            details.appendChild(label);
+            appendConstraintChips(details, items);
+        }
+    }
+    row.appendChild(key);
+    row.appendChild(details);
+    return { row, toggle, nestedSchema };
+}
 // Render a JSON value as a Python literal (for the Python request sample).
 function pyLiteral(value) {
     if (value === null || value === undefined)
@@ -1804,9 +2016,18 @@ function renderResponseSamples(responses, endpoint) {
     wrap.appendChild(contents);
     return wrap;
 }
-function renderSchemaTree(parent, schema, depth = 0) {
+function renderSchemaTree(parent, schema, depth = 0, refStack = new Set()) {
     if (!schema)
         return;
+    const pointer = schema.$ref ? String(schema.$ref) : '';
+    if (pointer && refStack.has(pointer)) {
+        const recursive = doc.createElement('div');
+        recursive.className = 'schema-tree-row schema-tree-unresolved';
+        recursive.textContent = `Recursive schema: ${pointer.split('/').pop()}`;
+        parent.appendChild(recursive);
+        return;
+    }
+    const nextRefStack = pointer ? new Set([...refStack, pointer]) : refStack;
     schema = resolveSchema(schema);
     const div = doc.createElement('div');
     div.className = depth === 0 ? 'schema-tree schema-tree-root' : 'schema-tree schema-tree-nested';
@@ -1819,34 +2040,35 @@ function renderSchemaTree(parent, schema, depth = 0) {
     }
     else if (schema.type === 'object' && schema.properties) {
         Object.entries(schema.properties).forEach(([key, prop]) => {
-            const row = doc.createElement('div');
-            row.className = 'schema-tree-row';
-            const type = prop.type || 'any';
-            const required = schema.required?.includes(key) ? '<span class="schema-tree-required">*</span>' : '';
-            row.innerHTML = `<div class="schema-tree-property">${esc(key)}${required}<span class="schema-type type-${esc(prop.type || 'null')}">${esc(type)}</span></div>`;
-            if (prop.description) {
-                const desc = doc.createElement('div');
-                desc.className = 'schema-tree-description';
-                desc.textContent = prop.description;
-                row.appendChild(desc);
-            }
-            appendConstraintChips(row, prop);
-            div.appendChild(row);
-            if (prop.type === 'object' && prop.properties) {
-                renderSchemaTree(div, prop, depth + 1);
-            }
-            else if (prop.type === 'array' && prop.items?.properties) {
-                renderSchemaTree(div, prop.items, depth + 1);
+            const contract = createContractRow(key, prop, schema.required?.includes(key) === true);
+            div.appendChild(contract.row);
+            if (contract.nestedSchema && contract.toggle) {
+                const children = doc.createElement('div');
+                children.className = 'schema-tree-children collapsed';
+                renderSchemaTree(children, contract.nestedSchema, depth + 1, nextRefStack);
+                contract.toggle.onclick = () => {
+                    const collapsed = children.classList.toggle('collapsed');
+                    contract.toggle.classList.toggle('open', !collapsed);
+                    contract.toggle.setAttribute('aria-expanded', String(!collapsed));
+                    contract.toggle.setAttribute('aria-label', `${collapsed ? 'Expand' : 'Collapse'} ${key}`);
+                };
+                div.appendChild(children);
             }
         });
     }
     else if (schema.type === 'array' && schema.items) {
-        const row = doc.createElement('div');
-        row.className = 'schema-tree-row';
-        row.innerHTML = `<span class="schema-tree-label">array</span> <span class="schema-tree-meta">of ${esc(schema.items.type || 'object')}</span>`;
-        div.appendChild(row);
-        if (schema.items.properties) {
-            renderSchemaTree(div, schema.items, depth + 1);
+        const contract = createContractRow('items', schema.items, true);
+        div.appendChild(contract.row);
+        if (contract.nestedSchema && contract.toggle) {
+            const children = doc.createElement('div');
+            children.className = 'schema-tree-children collapsed';
+            renderSchemaTree(children, contract.nestedSchema, depth + 1, nextRefStack);
+            contract.toggle.onclick = () => {
+                const collapsed = children.classList.toggle('collapsed');
+                contract.toggle.classList.toggle('open', !collapsed);
+                contract.toggle.setAttribute('aria-expanded', String(!collapsed));
+            };
+            div.appendChild(children);
         }
     }
     else {
@@ -1867,28 +2089,17 @@ function renderParamGroup(title, params) {
     heading.textContent = title;
     group.appendChild(heading);
     const list = doc.createElement('div');
-    list.className = 'http-params';
+    list.className = 'http-params schema-tree schema-tree-root';
     params.forEach(param => {
-        const item = doc.createElement('div');
-        item.className = 'http-param';
         const schema = param.schema || {};
-        const typeName = schema.type === 'array' ? `${schema.items?.type || 'any'}[]` : (schema.type || 'string');
-        const head = doc.createElement('div');
-        head.className = 'http-param-head';
-        head.innerHTML = `<span class="http-param-name">${esc(param.name)}</span>` +
-            `<span class="schema-type type-${esc(schema.type || 'string')}">${esc(typeName)}</span>` +
-            (param.required ? '<span class="http-param-required">required</span>' : '') +
-            (param.deprecated ? '<span class="http-param-deprecated">deprecated</span>' : '');
-        item.appendChild(head);
-        const description = param.description || schema.description;
-        if (description) {
-            const desc = doc.createElement('div');
-            desc.className = 'http-param-desc';
-            desc.textContent = description;
-            item.appendChild(desc);
-        }
-        appendConstraintChips(item, schema);
-        list.appendChild(item);
+        const contract = createContractRow(param.name, schema, param.required === true, {
+            owner: param,
+            description: param.description || schema.description,
+            deprecated: param.deprecated,
+            examplePrefix: `${param.name}=`,
+        });
+        contract.row.classList.add('http-param');
+        list.appendChild(contract.row);
     });
     group.appendChild(list);
     return group;
@@ -1903,7 +2114,7 @@ function renderResponseAccordion(status, resp, openByDefault) {
     acc.className = `response-accordion${openByDefault ? ' open' : ''}`;
     const header = doc.createElement('button');
     header.type = 'button';
-    header.className = 'response-accordion-header';
+    header.className = `response-accordion-header ${statusClass}`;
     header.innerHTML = `<span class="response-accordion-caret">▶</span>` +
         `<span class="response-status-dot ${statusClass}"></span>` +
         `<span class="response-status-code">${esc(status)}</span>` +
@@ -1918,14 +2129,16 @@ function renderResponseAccordion(status, resp, openByDefault) {
         sub.textContent = 'Response Headers';
         block.appendChild(sub);
         const list = doc.createElement('div');
-        list.className = 'http-params';
+        list.className = 'http-params schema-tree schema-tree-root';
         Object.entries(resp.headers).forEach(([name, def]) => {
-            const item = doc.createElement('div');
-            item.className = 'http-param';
             const hschema = def.schema || {};
-            item.innerHTML = `<div class="http-param-head"><span class="http-param-name">${esc(name)}</span><span class="schema-type type-${esc(hschema.type || 'string')}">${esc(hschema.type || 'string')}</span></div>` +
-                (def.description ? `<div class="http-param-desc">${esc(def.description)}</div>` : '');
-            list.appendChild(item);
+            const contract = createContractRow(name, hschema, def.required === true, {
+                owner: def,
+                description: def.description,
+                deprecated: def.deprecated,
+            });
+            contract.row.classList.add('http-param');
+            list.appendChild(contract.row);
         });
         block.appendChild(list);
         body.appendChild(block);
@@ -3745,6 +3958,7 @@ function init() {
     const intro = byId('introductionContent');
     if (intro && introductionMarkdown)
         intro.innerHTML = parseMarkdown(introductionMarkdown);
+    initSidebarResize();
     bindEvents();
     renderFooter();
     render();

package/dist/docs/ui/assets/sidebar-tree.js

@@ -15,6 +15,7 @@ function appendSidebarItem(parent, item, depth, deps) {
         group.className = `tag-group docs-sidebar-group docs-sidebar-depth-${depth}${expanded ? '' : ' collapsed'}`;
         const header = deps.doc.createElement('div');
         header.className = `tag-group-header${active ? ' active' : ''}`;
+        header.title = title;
         header.innerHTML = `<span class="tag-group-arrow">▼</span>${deps.esc(title)}<span class="tag-group-count">${countLeaves(children)}</span>`;
         const childContainer = deps.doc.createElement('div');
         childContainer.className = 'tag-group-items';
@@ -42,6 +43,7 @@ function appendSidebarItem(parent, item, depth, deps) {
 function createPageItem(item, title, active, depth, deps) {
     const element = deps.doc.createElement('div');
     element.className = `nav-item docs-page-nav-item docs-sidebar-page docs-sidebar-depth-${depth}${active ? ' active' : ''}`;
+    element.title = title;
     const normalizedPath = item.path ? deps.normalizeDocsPath(item.path) : '';
     const isHome = depth === 0 && (normalizedPath === '/' || normalizedPath === '');
     element.innerHTML = isHome
@@ -76,6 +78,7 @@ function appendActivePageHeadings(parent, path, deps) {
         childElement.type = 'button';
         childElement.className = `nav-subitem nav-subitem-level-${child.level}${child.id === deps.activeHeadingId ? ' active' : ''}`;
         childElement.textContent = child.title;
+        childElement.title = child.title;
         childElement.onclick = (event) => {
             event.stopPropagation();
             deps.setDocsPage(deps.activePagePath || path, child.id);

package/dist/docs/ui/html-shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-shell.d.ts","sourceRoot":"","sources":["../../../src/docs/ui/html-shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG/D;;GAEG;AACH,wBAAgB,eAAe,CAC7B,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,EAC9C,MAAM,EAAE,UAAU,GAAG,SAAS,GAC7B,UAAU,GAAG,SAAS,CAgBxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAIvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUpF;AAiBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EACtB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAmDR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EAAE,GAClB,MAAM,CAgBR;AAeD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CA4BR"}
+{"version":3,"file":"html-shell.d.ts","sourceRoot":"","sources":["../../../src/docs/ui/html-shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG/D;;GAEG;AACH,wBAAgB,eAAe,CAC7B,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,EAC9C,MAAM,EAAE,UAAU,GAAG,SAAS,GAC7B,UAAU,GAAG,SAAS,CAgBxB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,MAAM,CAIvE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUpF;AAiBD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EACtB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,MAAM,CAmDR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,OAAO,EAAE,GAClB,MAAM,CAgBR;AAeD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,CAAC,SAAS,CAAC,EAC5B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,MAAM,CAyCR"}

package/dist/docs/ui/html-shell.js

@@ -158,6 +158,19 @@ export function generateAppContainer(logo, title, sidebar, footer) {
       </div>
       <div class="protocol-tabs" id="protocolTabs"></div>
       <nav class="sidebar-nav" id="sidebarNav"></nav>
+      <button
+        type="button"
+        class="sidebar-resizer"
+        id="sidebarResizer"
+        role="separator"
+        aria-label="Resize navigation sidebar"
+        aria-controls="sidebarNav"
+        aria-orientation="vertical"
+        aria-valuemin="220"
+        aria-valuemax="560"
+        aria-valuenow="280"
+        title="Drag to resize the sidebar; use arrow keys for precise control"
+      ></button>
     </aside>
     <main class="main-shell">
       <div class="main" id="mainContent"></div>

package/dist/docs/ui/html-shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"html-shell.js","sourceRoot":"","sources":["../../../src/docs/ui/html-shell.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,gBAA8C,EAC9C,MAA8B;IAE9B,MAAM,OAAO,GAAG,gBAAgB,EAAE,IAAI,CAAA;IACtC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;QAAE,OAAO,SAAS,CAAA;IAEzC,OAAO;QACL,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,OAAO,EAAE,KAAK;QACtC,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO;QAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO;QAC5C,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ;QAC/C,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,OAAO,EAAE,UAAU;QACrD,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,OAAO,EAAE,eAAe;QACpE,eAAe,EAAE,MAAM,EAAE,eAAe,IAAI,OAAO,EAAE,eAAe;QACpE,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,OAAO,EAAE,OAAO;QAC5C,UAAU,EAAE,MAAM,EAAE,UAAU,IAAI,OAAO,EAAE,UAAU;QACrD,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM;KAC1C,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA8B;IAC7D,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,EAAE,CAAA;IACjC,MAAM,KAAK,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAA;IAC9E,OAAO,4CAA4C,UAAU,CAAC,KAAK,CAAC,MAAM,CAAA;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CAAC,YAAgC;IAC1E,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAA;IAE5B,OAAO;;;;;;GAMN,CAAA;AACH,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAAC,GAAW;IACvC,OAAO;eACM,UAAU,CAAC,GAAG,CAAC;;;;;;;GAO3B,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAsB,EACtB,IAAwB,EACxB,KAAa,EACb,OAAgB,EAChB,UAAmB;IAEnB,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAA;IAEpB,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,OAAO;QACzC,CAAC,CAAC,8BAA8B,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,IAAI,EAAE,CAAC,SAAS;QAClF,CAAC,CAAC,EAAE,CAAA;IAEN,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;QAC5D,CAAC,CAAC;UACI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACtE;QACR,CAAC,CAAC,EAAE,CAAA;IAEN,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACzD,CAAC,CAAC;UACI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;qBACb,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,qBAAqB,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,oBAAoB;cAClH,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;;SAEzB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;aACN;QACT,CAAC,CAAC,EAAE,CAAA;IAEN,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAClE,CAAC,CAAC;UACI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;qBACjB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;cAC5B,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oCAAoC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;gDAChD,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;cACxD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,oCAAoC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE;;SAErG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;aACN;QACT,CAAC,CAAC,EAAE,CAAA;IAEN,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAEvE,OAAO;;MAEH,UAAU;MACV,UAAU,IAAI,EAAE;;QAEd,IAAI,CAAC,CAAC,CAAC,+BAA+B,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;+BACnD,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,GAAG,WAAW;QACpE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QAC7E,YAAY;QACZ,WAAW;QACX,cAAc;;;GAGnB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAwB,EACxB,KAAa,EACb,QAAmB;IAEnB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAErD,OAAO;;;QAGD,IAAI,CAAC,CAAC,CAAC,aAAa,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;cAC9C,UAAU,CAAC,KAAK,CAAC;;iCAEE,KAAK;;;;;;GAMnC,CAAA;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAa;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAA;IACpC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QAC7E,OAAO,gCAAgC,YAAY,aAAa,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,0CAA0C,UAAU,kBAAkB,CAAA;IAC9J,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAA;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,4CAA4C,CAAC,CAAC,CAAC,EAAE,CAAA;IAChF,OAAO,iCAAiC,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;AACpG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAwB,EACxB,KAAa,EACb,OAA4B,EAC5B,MAA0B;IAE1B,MAAM,aAAa,GAAG,OAAO,EAAE,IAAI,KAAK,IAAI,CAAA;IAC5C,OAAO;;6BAEoB,aAAa,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,oCAAoC,aAAa,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;2BACtH,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,IAAI,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;;;YAGvF,IAAI,CAAC,CAAC,CAAC,aAAa,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE;gBACpD,UAAU,CAAC,KAAK,CAAC;;UAEvB,OAAO,EAAE,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC;;;;SAI7B,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;IAUV,MAAM,CAAC,CAAC,CAAC,uDAAuD,CAAC,CAAC,CAAC,EAAE;;GAEtE,CAAA;AACH,CAAC"}
+{"version":3,"file":"html-shell.js","sourceRoot":"","sources":["../../../src/docs/ui/html-shell.ts"],"names":[],"mappings":"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"}