puredocs_v2 1.0.0

package/LICENSE

@@ -0,0 +1,46 @@
+PureDocs Non-Commercial License v1.0
+
+Copyright (c) 2026 esurkov1
+
+1. Grant of Rights
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use,
+copy, modify, and distribute the Software for non-commercial purposes only,
+subject to the conditions below.
+
+2. Conditions
+
+- The above copyright notice and this license text must be included in all
+  copies or substantial portions of the Software.
+- Any modified version must clearly indicate that changes were made.
+- Distribution of modified versions must remain under this license.
+
+3. Commercial Use
+
+Commercial use is not permitted under this license.
+
+"Commercial use" means use of the Software in exchange for money, to provide a
+paid service, as part of a paid product, or in any activity primarily intended
+for commercial advantage or monetary compensation.
+
+For commercial licensing terms, contact the author:
+https://github.com/esurkov1
+
+4. Trademark
+
+This license does not grant permission to use the project name, brand, or logo
+except as necessary for fair attribution.
+
+5. Warranty Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+6. Limitation of Liability
+
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR
+OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,164 @@
+<p align="center">
+  <img src="apps/landing/assets/img/image1.png" alt="PureDocs — API Documentation Portal" width="720">
+</p>
+
+<h1 align="center">PureDocs</h1>
+
+<p align="center">
+  Beautiful, interactive API documentation from any OpenAPI 3.1 spec.<br>
+  One function call for Express or Fastify. One Web Component for everything else.
+</p>
+
+<p align="center">
+  <a href="https://esurkov1.github.io/puredocs/">puredocs.dev</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/puredocs"><img src="https://img.shields.io/npm/v/puredocs?color=2563EB&label=npm" alt="npm"></a>
+  <a href="https://github.com/esurkov1/puredocs"><img src="https://img.shields.io/github/stars/esurkov1/puredocs?style=flat&logo=github" alt="GitHub stars"></a>
+  <a href="https://github.com/esurkov1/puredocs/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-see%20LICENSE-blue" alt="License"></a>
+  <img src="https://img.shields.io/badge/OpenAPI-3.1-green" alt="OpenAPI 3.1">
+</p>
+
+---
+
+## Features
+
+- **Full OpenAPI 3.1** — paths, callbacks, webhooks, all HTTP methods, `$ref` resolution, `oneOf`/`anyOf`/`allOf`
+- **Express & Fastify** — add a `/docs` route in one function call
+- **Web Component** — drop `<pure-docs>` into React, Vue, Angular, Next.js, Nuxt, Svelte, or plain HTML
+- **Live Try It Console** — send real requests, configure environments, switch auth
+- **Smart Search** — Cmd+K to find endpoints, schemas, webhooks instantly
+- **Light & Dark Theme** — auto-detects system preference or set manually
+- **Full Auth Support** — Bearer, Basic, API Key, OAuth2, OpenID Connect
+- **Multi-Language Snippets** — auto-generated cURL, JavaScript, Python, Go, Rust
+- **JSON & YAML** — load specs in either format
+- **Zero Config** — works out of the box with sensible defaults
+
+---
+
+## Install
+
+```bash
+npm install puredocs
+```
+
+## Quick Start
+
+### Express
+
+```ts
+import express from 'express';
+import { pureDocs } from 'puredocs';
+
+const app = express();
+
+pureDocs.express(app, {
+  route: '/docs',
+  specUrl: '/openapi.json',
+});
+
+app.listen(3000);
+```
+
+### Fastify
+
+```ts
+import Fastify from 'fastify';
+import { pureDocs } from 'puredocs';
+
+const app = Fastify();
+
+pureDocs.fastify(app, {
+  route: '/docs',
+  specUrl: '/openapi.json',
+});
+
+await app.listen({ port: 3000 });
+```
+
+### HTML
+
+```html
+<pure-docs
+  spec-url="/openapi.json"
+  theme="auto"
+></pure-docs>
+
+<script type="module">
+  import 'puredocs/web';
+  import 'puredocs/style.css';
+</script>
+```
+
+### CDN (no bundler)
+
+```html
+<link rel="stylesheet" href="https://unpkg.com/puredocs/dist/puredocs.css" />
+
+<pure-docs spec-url="/openapi.json" theme="auto"></pure-docs>
+
+<script src="https://unpkg.com/puredocs/dist/puredocs.umd.js"></script>
+```
+
+### Raw HTML Generation
+
+```ts
+const html = pureDocs.html({
+  specUrl: '/openapi.json',
+  title: 'My API',
+  theme: 'auto',
+});
+// Returns a full self-contained HTML string — serve it however you want
+```
+
+---
+
+## Configuration
+
+### Web Component Attributes
+
+| Attribute | Type | Description |
+|-----------|------|-------------|
+| `spec-url` | `string` | OpenAPI spec URL (JSON or YAML) |
+| `spec-json` | `string` | Inline OpenAPI object as JSON string |
+| `theme` | `'light' \| 'dark' \| 'auto'` | Color theme (default: `auto`) |
+| `title` | `string` | Portal title |
+| `primary-color` | `string` | Accent color (hex) |
+
+### Server API Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `specUrl` | `string` | OpenAPI spec URL |
+| `spec` | `object` | Inline OpenAPI object |
+| `title` | `string` | Portal title |
+| `theme` | `'light' \| 'dark' \| 'auto'` | Color theme |
+| `primaryColor` | `string` | Accent color |
+| `route` | `string` | Route path (default: `/docs`) |
+
+---
+
+## Works with Any Framework
+
+PureDocs is a standard Web Component. It works in any framework that supports custom elements:
+
+- **React / Next.js** — `import 'puredocs/web'` then use `<pure-docs>` in JSX
+- **Vue / Nuxt** — add `isCustomElement` config, then use `<pure-docs>` in templates
+- **Angular** — add `CUSTOM_ELEMENTS_SCHEMA`, then use `<pure-docs>` in templates
+- **Svelte** — use `<pure-docs>` directly
+- **Plain HTML** — just add the `<script>` and `<link>` tags
+
+---
+
+## Development
+
+```bash
+bun run dev          # dev server with hot reload
+bun run build        # production build
+bun run typecheck    # type checking
+```
+
+## License
+
+See [LICENSE](./LICENSE).

package/dist/api/http-client.d.ts

@@ -0,0 +1,14 @@
+import type { TryItResponse } from '../core/types';
+interface RequestConfig {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: string | FormData;
+    /** Timeout in ms */
+    timeout?: number;
+}
+/** Execute an HTTP request for the Try It console */
+export declare function executeRequest(config: RequestConfig): Promise<TryItResponse>;
+/** Build full URL from base, path, and parameters */
+export declare function buildRequestUrl(baseUrl: string, pathTemplate: string, pathParams: Record<string, string>, queryParams: Record<string, string>): string;
+export {};

package/dist/api/snippets.d.ts

@@ -0,0 +1,15 @@
+interface SnippetParams {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string;
+}
+type Language = 'curl' | 'javascript' | 'python' | 'go' | 'rust';
+export interface Snippet {
+    language: Language;
+    label: string;
+    code: string;
+}
+/** Generate code snippets for multiple languages */
+export declare function generateSnippets(params: SnippetParams): Snippet[];
+export {};

package/dist/components/app.d.ts

@@ -0,0 +1,7 @@
+import type { PortalConfig } from '../core/types';
+/** Get current portal config */
+export declare function getCurrentConfig(): PortalConfig | null;
+/** Mount the full portal app into the container */
+export declare function mountApp(container: HTMLElement, config: PortalConfig): void;
+/** Unmount the portal */
+export declare function unmountApp(): void;

package/dist/components/layout/empty-state-page.d.ts

@@ -0,0 +1,11 @@
+export interface EmptyStateOptions {
+    title: string;
+    message?: string;
+    icon?: string;
+    variant?: 'loading' | 'error' | 'empty';
+}
+/**
+ * Helper for loading/error/empty pages.
+ * Returns ready page for render(pageSlotEl, createEmptyStatePage(...)).
+ */
+export declare function createEmptyStatePage(opts: EmptyStateOptions): HTMLElement;

package/dist/components/layout/page-layout.d.ts

@@ -0,0 +1,9 @@
+export interface ContentAreaLayout {
+    page: HTMLElement;
+    main: HTMLElement;
+    aside: HTMLElement;
+}
+/** Layout: page (main + aside). */
+export declare function createContentArea(): ContentAreaLayout;
+/** Enable/disable aside in page layout. */
+export declare function setContentAreaAside(page: HTMLElement, hasAside: boolean): void;

package/dist/components/modals/auth-modal.d.ts

@@ -0,0 +1,17 @@
+import type { OperationSecurityInfo, SecurityRequirement, SecurityScheme } from '../../core/types';
+/** Open authentication settings modal */
+export declare function openAuthModal(securitySchemes: Record<string, SecurityScheme>, portalRoot?: HTMLElement, initialScheme?: string): void;
+/** Get human-readable configured scheme label for display */
+export declare function getSchemeStatusLabel(name: string, scheme: SecurityScheme): string;
+/** Check if a specific scheme is configured */
+export declare function isSchemeConfigured(name: string): boolean;
+/** Check if operation's auth requirements are satisfied (token/schemes configured) */
+export declare function isOperationAuthConfigured(security: OperationSecurityInfo | SecurityRequirement[] | undefined, securitySchemes: Record<string, SecurityScheme>): boolean;
+/** Resolve auth headers for an operation's security requirements */
+export declare function resolveAuthHeaders(security: OperationSecurityInfo | SecurityRequirement[] | undefined, securitySchemes: Record<string, SecurityScheme>): Record<string, string>;
+/** Resolve auth query params for an operation's security requirements */
+export declare function resolveAuthQuery(security: OperationSecurityInfo | SecurityRequirement[] | undefined, securitySchemes: Record<string, SecurityScheme>): Record<string, string>;
+/** Resolve auth cookie values for an operation's security requirements */
+export declare function resolveAuthCookies(security: OperationSecurityInfo | SecurityRequirement[] | undefined, securitySchemes: Record<string, SecurityScheme>): Record<string, string>;
+/** Get placeholder header value for display (when no token configured) */
+export declare function getAuthHeaderPlaceholder(security: OperationSecurityInfo | SecurityRequirement[] | undefined, securitySchemes: Record<string, SecurityScheme>): Record<string, string>;

package/dist/components/modals/modal-base.d.ts

@@ -0,0 +1,15 @@
+export interface ModalBaseOptions {
+    overlayClass: string;
+    modalClass: string;
+    role?: string;
+    ariaLabel: string;
+    dataOverlayAttr: string;
+    onClose?: () => void;
+}
+export interface ModalBase {
+    overlay: HTMLElement;
+    modal: HTMLElement;
+    mount: (target?: ParentNode | null) => void;
+    close: () => void;
+}
+export declare function createModalBase(options: ModalBaseOptions): ModalBase;

package/dist/components/modals/search-modal.d.ts

@@ -0,0 +1,6 @@
+/** Render and show the search modal */
+export declare function showSearchModal(): void;
+/** Close the search modal */
+export declare function closeSearchModal(): void;
+/** Setup global keyboard shortcut for search */
+export declare function setupSearchShortcut(): () => void;

package/dist/components/nav/route-nav.d.ts

@@ -0,0 +1,2 @@
+import type { RouteInfo } from '../../core/types';
+export declare function renderRouteNavigation(currentRoute: RouteInfo): HTMLElement | null;

package/dist/components/nav/sidebar.d.ts

@@ -0,0 +1,13 @@
+import type { PortalConfig } from '../../core/types';
+import type { RouteInfo } from '../../core/types';
+/** Update active state of items and expand group with active route */
+export declare function updateSidebarActiveState(container: HTMLElement, currentRoute: RouteInfo): void;
+/**
+ * Lightweight update: patch only auth-related elements in the sidebar
+ * (lock icons on endpoints + top auth button) without full re-render.
+ */
+export declare function updateSidebarAuthState(container: HTMLElement): void;
+/** Render the sidebar navigation */
+export declare function renderSidebar(container: HTMLElement, config: PortalConfig): void;
+/** Update the sidebar env <select> value to match current activeEnvironment */
+export declare function updateSidebarEnvironment(container: HTMLElement): void;

package/dist/components/pages/endpoint.d.ts

@@ -0,0 +1,3 @@
+import type { SpecOperation } from '../../core/types';
+/** Render an endpoint detail page. Main block divided into 2 parts: doc | Try It + Code Examples */
+export declare function renderEndpoint(pageSlot: HTMLElement, asideSlot: HTMLElement, operation: SpecOperation): Promise<void>;

package/dist/components/pages/overview.d.ts

@@ -0,0 +1,2 @@
+/** Render the API overview page */
+export declare function renderOverview(pageSlot: HTMLElement, _asideSlot: HTMLElement): Promise<void>;

package/dist/components/pages/tag-page.d.ts

@@ -0,0 +1,2 @@
+/** Render a tag page — list of group operations */
+export declare function renderTagPage(pageSlot: HTMLElement, _asideSlot: HTMLElement, tagName: string): void;

package/dist/components/pages/webhook.d.ts

@@ -0,0 +1,3 @@
+import type { SpecWebhook } from '../../core/types';
+/** Render a webhook detail page — similar to endpoint but marked as Webhook, no Try It */
+export declare function renderWebhookPage(pageSlot: HTMLElement, webhook: SpecWebhook): Promise<void>;

package/dist/components/shared/connection-settings.d.ts

@@ -0,0 +1,2 @@
+import type { SecurityScheme } from '../../core/types';
+export declare function createConnectionSettingsSections(securitySchemes: Record<string, SecurityScheme>, portalRoot?: HTMLElement): HTMLElement[];

package/dist/components/shared/copy-button.d.ts

@@ -0,0 +1,12 @@
+export interface CopyButtonOptions {
+    getText: () => string | Promise<string>;
+    ariaLabel?: string;
+    copiedAriaLabel?: string;
+    className?: string;
+    onCopied?: () => void;
+}
+/**
+ * Shared icon button with copy/check feedback.
+ * Keeps copy interaction consistent across endpoint/try-it panels.
+ */
+export declare function createCopyButton(options: CopyButtonOptions): HTMLButtonElement;

package/dist/components/shared/editor-panel.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Auto-resize a plain textarea to fit its content.
+ * Used for response body/headers textareas (NOT the editor panel).
+ */
+export declare function autoResizeTextarea(ta: HTMLTextAreaElement): void;
+export declare function createEditorPanel(initialValue: string, lang: string, options?: {
+    dataField?: string;
+    onInput?: () => void;
+}): {
+    wrap: HTMLElement;
+    textarea: HTMLTextAreaElement;
+    setValue: (v: string, highlightLang?: string) => void;
+    syncLayout: () => void;
+};

package/dist/components/shared/example-picker.d.ts

@@ -0,0 +1,20 @@
+import type { SpecMediaType, SpecParameter } from '../../core/types';
+export interface ParamExampleSet {
+    name: string;
+    summary?: string;
+    values: Record<string, string>;
+}
+/** Extract example sets from path/query parameters (for GET, DELETE etc.) */
+export declare function extractParamExampleSets(params: SpecParameter[]): ParamExampleSet[];
+export interface ExampleOption {
+    name: string;
+    summary?: string;
+    description?: string;
+    value: unknown;
+}
+/** Extract named examples from a media type, with schema fallback */
+export declare function extractExamples(mediaType: SpecMediaType): ExampleOption[];
+/** Get display label for example, without duplicating summary/description */
+export declare function getExampleLabel(ex: ExampleOption): string;
+/** Format an example value as pretty JSON string */
+export declare function formatExampleValue(value: unknown): string;

package/dist/components/shared/responses.d.ts

@@ -0,0 +1,27 @@
+import type { SpecMediaType, SpecResponseHeader, SchemaObject } from '../../core/types';
+export interface CollapsibleCategoryOptions {
+    title: string;
+    content: HTMLElement;
+    expanded?: boolean;
+    trailing?: HTMLElement;
+    counter?: number | string;
+}
+export interface SchemaBodyContent {
+    content: HTMLElement;
+    contentType: string;
+    schemaType: string;
+    itemsCount: number;
+}
+export interface ResponseTabData {
+    body: SchemaBodyContent;
+    headers: HTMLElement | null;
+    headersCount: number;
+}
+export declare function createSchemaBodyContent(contentType: string, mediaType: SpecMediaType | undefined, emptyText: string): SchemaBodyContent;
+export declare function createBodyCategoryTrailing(body: SchemaBodyContent): HTMLElement;
+export declare function getSchemaTopLevelCount(schema: SchemaObject): number;
+export declare function createCollapsibleCategory(options: CollapsibleCategoryOptions): {
+    root: HTMLElement;
+};
+export declare function renderResponseHeadersList(headers: Record<string, SpecResponseHeader>): HTMLElement | null;
+export declare function renderResponseCategories(data: ResponseTabData): HTMLElement;

package/dist/components/shared/schema-viewer.d.ts

@@ -0,0 +1,17 @@
+import type { SchemaObject, SpecParameter } from '../../core/types';
+export interface SchemaBodyResult {
+    body: HTMLElement;
+    toggleCollapse: () => void;
+    isExpanded: () => boolean;
+    hasExpandable: boolean;
+}
+/** Render only the schema tree body (no card wrapper). For custom headers (e.g. Responses). */
+export declare function renderSchemaBody(schema: SchemaObject): SchemaBodyResult;
+/** Render an expandable schema tree viewer */
+export declare function renderSchemaViewer(schema: SchemaObject, title?: string | HTMLElement): HTMLElement;
+export interface ParametersCardOptions {
+    headerTitle: string;
+    withEnumAndDefault?: boolean;
+}
+/** Parameters in the same style as schema (flat list). */
+export declare function renderParametersCard(params: SpecParameter[], options: ParametersCardOptions): HTMLElement;

package/dist/components/shared/summary.d.ts

@@ -0,0 +1,5 @@
+export interface SnapshotMetric {
+    label: string;
+    value: string | number;
+}
+export declare function createSummaryLine(metrics: SnapshotMetric[], methodCounts: Record<string, number>, emptyText?: string): HTMLElement;

package/dist/components/shared/try-it.d.ts

@@ -0,0 +1,20 @@
+import type { SpecOperation } from '../../core/types';
+export interface InitialResponseExample {
+    statusCode: string;
+    statusText: string;
+    body: string;
+}
+export interface TryItConfig {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    body?: string | FormData;
+}
+/** Collect current request config from Try It form (path, query, headers, body) */
+export declare function collectRequestConfig(container: HTMLElement, operation: SpecOperation): TryItConfig;
+/** Render the Try It interactive console */
+export declare function renderTryIt(operation: SpecOperation, container: HTMLElement, initialResponse?: InitialResponseExample | null, options?: {
+    onConfigChange?: (config: TryItConfig) => void;
+    extraContent?: HTMLElement;
+}): void;
+export declare function createHeaderRow(name: string, value: string): HTMLElement;

package/dist/components/ui/badge.d.ts

@@ -0,0 +1,24 @@
+export type BadgeSize = 's' | 'm' | 'l';
+export type BadgeKind = 'method' | 'status' | 'webhook' | 'required' | 'chip';
+export type BadgeColor = 'default' | 'transparent' | 'primary' | 'green' | 'blue' | 'orange' | 'purple' | 'red';
+export interface BadgeProps {
+    text: string;
+    kind?: BadgeKind;
+    color?: BadgeColor;
+    size?: BadgeSize;
+    /** @deprecated All badges are monospace by default. */
+    mono?: boolean;
+    className?: string;
+    method?: string;
+    statusCode?: string;
+}
+/** Unified Badge primitive (`.badge` + kind + size + optional modifiers). */
+export declare function createBadge(props: BadgeProps): HTMLElement;
+/** Tab button based on badge. Used for Body/Headers, Code Example, etc. */
+export declare function createTab(text: string, options?: {
+    active?: boolean;
+    context?: boolean;
+}): HTMLButtonElement;
+/** Tab button with response code (200, 404, etc.). Inherits badge + status styles. */
+export declare function createResponseCodeTab(code: string, active?: boolean): HTMLButtonElement;
+export declare function setResponseCodeTabActive(btn: HTMLElement, active: boolean): void;

package/dist/components/ui/breadcrumb.d.ts

@@ -0,0 +1,12 @@
+export interface BreadcrumbItem {
+    label: string;
+    href?: string;
+    className?: string;
+    onClick?: (e: Event) => void;
+}
+export interface BreadcrumbOptions {
+    className?: string;
+    leading?: HTMLElement[];
+    trailing?: HTMLElement[];
+}
+export declare function createBreadcrumb(items: BreadcrumbItem[], options?: BreadcrumbOptions): HTMLElement;

package/dist/components/ui/button.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Unified Button primitive.
+ * Variants: 'primary' | 'secondary' | 'ghost' | 'icon'
+ * Uses CSS classes: `.btn` + utility/modifier classes.
+ */
+export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'icon';
+export interface ButtonProps {
+    variant?: ButtonVariant;
+    label?: string;
+    icon?: string;
+    ariaLabel?: string;
+    disabled?: boolean;
+    className?: string;
+    onClick?: (e: Event) => void;
+}
+export declare function getButtonClasses(variant?: ButtonVariant): string[];
+export declare function createButton(props: ButtonProps): HTMLButtonElement;

package/dist/components/ui/card.d.ts

@@ -0,0 +1,25 @@
+export interface CardProps {
+    /** If true — creates a simple card (`.card.simple`), otherwise structural (`.card`) */
+    simple?: boolean;
+    /** Interactive flag (adds interactive) */
+    interactive?: boolean;
+    /** Active flag (adds active) */
+    active?: boolean;
+    /** Additional classes */
+    className?: string;
+    /** Click handler */
+    onClick?: (e: Event) => void;
+}
+/** Creates a simple or structural card */
+export declare function createCard(props?: CardProps): HTMLElement;
+/** Creates header for structural card */
+export declare function createCardHeader(...children: (HTMLElement | string)[]): HTMLElement;
+/** Creates body for structural card */
+export declare function createCardBody(variant?: 'default' | 'code' | 'no-padding'): HTMLElement;
+export interface CardHeaderRowOptions {
+    title: string | HTMLElement;
+    leading?: HTMLElement | string;
+    trailing?: HTMLElement | string | number;
+    className?: string;
+}
+export declare function createCardHeaderRow(options: CardHeaderRowOptions): HTMLElement;

package/dist/components/ui/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * UI Primitives — unified re-exports.
+ */
+export { createSelect } from './select';
+export type { SelectOption, SelectProps } from './select';
+export { createInput } from './input';
+export type { InputProps } from './input';
+export { createButton } from './button';
+export type { ButtonVariant, ButtonProps } from './button';
+export { createCard, createCardHeader, createCardBody } from './card';
+export { createCardHeaderRow } from './card';
+export type { CardProps, CardHeaderRowOptions } from './card';
+export { createBadge, createTab, createResponseCodeTab, setResponseCodeTabActive } from './badge';
+export type { BadgeProps, BadgeKind, BadgeSize, BadgeColor } from './badge';
+export { createSection, createSectionTitleWrap } from './section';
+export type { SectionOptions } from './section';
+export { createBreadcrumb } from './breadcrumb';
+export type { BreadcrumbItem, BreadcrumbOptions } from './breadcrumb';
+export { createLockIcon } from './lock-icon';
+export type { CreateLockIconOptions } from './lock-icon';

package/dist/components/ui/input.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Unified Input primitive.
+ * Base styles — by input tag (forms.css).
+ */
+export type InputModifier = 'filled' | 'invalid';
+export interface InputProps {
+    type?: string;
+    placeholder?: string;
+    value?: string;
+    ariaLabel?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    modifiers?: InputModifier[];
+    dataAttrs?: Record<string, string>;
+    className?: string;
+    onInput?: (value: string) => void;
+    onChange?: (value: string) => void;
+}
+export declare function createInput(props: InputProps): HTMLInputElement;

package/dist/components/ui/lock-icon.d.ts

@@ -0,0 +1,8 @@
+export interface CreateLockIconOptions {
+    configured: boolean;
+    variant?: 'tag' | 'nav' | 'endpoint';
+    label?: string;
+    title?: string;
+}
+/** Common factory for lock/unlock icons in navigation, cards, and endpoint */
+export declare function createLockIcon(options: CreateLockIconOptions): HTMLElement;

package/dist/components/ui/section.d.ts

@@ -0,0 +1,8 @@
+export interface SectionOptions {
+    title?: string;
+    titleEl?: HTMLElement;
+    badge?: string | number | HTMLElement;
+    className?: string;
+}
+export declare function createSectionTitleWrap(title: string | HTMLElement, badge?: string | number | HTMLElement): HTMLElement;
+export declare function createSection(options: SectionOptions, ...children: (HTMLElement | string)[]): HTMLElement;

package/dist/components/ui/select.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Unified Select primitive.
+ * Base styles — by select tag (forms.css).
+ * variant: inline → data-variant="inline"
+ */
+export interface SelectOption {
+    value: string;
+    label: string;
+}
+export interface SelectProps {
+    options: SelectOption[];
+    value?: string;
+    ariaLabel?: string;
+    onChange?: (value: string) => void;
+    className?: string;
+    variant?: 'default' | 'inline';
+    invalid?: boolean;
+    dataAttrs?: Record<string, string>;
+}
+export declare function createSelect(props: SelectProps): HTMLSelectElement;