raffel 0.2.3 → 1.0.0-next.f81d4db

package/dist/docs/ui/styles.js

@@ -56,7 +56,7 @@ export function generateStyles(config) {
       line-height: 1.6;
     }
 
-    /* ========== HERO SECTION ========== */
+    /* ========== HERO SECTION (Docsify-inspired) ========== */
     .hero {
       ${heroBackgroundCSS}
       color: white;
@@ -64,34 +64,93 @@ export function generateStyles(config) {
       display: flex;
       align-items: center;
       justify-content: center;
-      padding: 40px;
+      padding: 60px 40px;
       text-align: center;
+      position: relative;
+    }
+
+    .hero::before {
+      content: '';
+      position: absolute;
+      inset: 0;
+      background: radial-gradient(ellipse at center, transparent 0%, rgba(0,0,0,0.15) 100%);
+      pointer-events: none;
     }
 
     .hero-content {
       max-width: 800px;
       margin: 0 auto;
+      position: relative;
+      z-index: 1;
     }
 
     .hero-logo {
-      height: 64px;
-      margin-bottom: 24px;
+      height: 120px;
+      margin-bottom: 32px;
+      filter: drop-shadow(0 4px 12px rgba(0,0,0,0.15));
     }
 
     .hero-title {
-      font-size: 48px;
+      font-size: 56px;
       font-weight: 700;
-      margin-bottom: 16px;
-      text-shadow: 0 2px 4px rgba(0,0,0,0.1);
+      margin-bottom: 8px;
+      text-shadow: 0 2px 8px rgba(0,0,0,0.15);
+      letter-spacing: -0.02em;
+    }
+
+    .hero-version {
+      display: inline-block;
+      font-size: 14px;
+      font-weight: 500;
+      background: rgba(255,255,255,0.2);
+      padding: 4px 12px;
+      border-radius: 100px;
+      margin-left: 12px;
+      vertical-align: middle;
+      backdrop-filter: blur(4px);
     }
 
     .hero-tagline {
-      font-size: 20px;
-      opacity: 0.9;
-      margin-bottom: 32px;
+      font-size: 22px;
+      opacity: 0.95;
+      margin-bottom: 28px;
       max-width: 600px;
       margin-left: auto;
       margin-right: auto;
+      line-height: 1.5;
+      font-weight: 300;
+    }
+
+    .hero-features {
+      list-style: none;
+      padding: 0;
+      margin: 0 auto 36px;
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px 24px;
+      justify-content: center;
+      max-width: 600px;
+    }
+
+    .hero-features li {
+      font-size: 16px;
+      opacity: 0.9;
+      display: flex;
+      align-items: center;
+      gap: 8px;
+    }
+
+    .hero-features li::before {
+      content: '✓';
+      display: inline-flex;
+      align-items: center;
+      justify-content: center;
+      width: 20px;
+      height: 20px;
+      background: rgba(255,255,255,0.2);
+      border-radius: 50%;
+      font-size: 12px;
+      font-weight: bold;
     }
 
     .hero-buttons {
@@ -106,24 +165,27 @@ export function generateStyles(config) {
       display: inline-flex;
       align-items: center;
       gap: 8px;
-      padding: 14px 28px;
-      border-radius: 8px;
+      padding: 14px 32px;
+      border-radius: 100px;
       font-size: 16px;
       font-weight: 600;
       text-decoration: none;
       cursor: pointer;
-      transition: all 0.2s;
-      border: 2px solid white;
+      transition: all 0.2s ease;
+      border: 2px solid rgba(255,255,255,0.8);
     }
 
     .hero-btn-primary {
       background: white;
       color: var(--primary-color);
+      border-color: white;
+      box-shadow: 0 4px 14px rgba(0,0,0,0.15);
     }
 
     .hero-btn-primary:hover {
-      background: rgba(255,255,255,0.9);
+      background: rgba(255,255,255,0.95);
       transform: translateY(-2px);
+      box-shadow: 0 6px 20px rgba(0,0,0,0.2);
     }
 
     .hero-btn-secondary {
@@ -132,7 +194,8 @@ export function generateStyles(config) {
     }
 
     .hero-btn-secondary:hover {
-      background: rgba(255,255,255,0.1);
+      background: rgba(255,255,255,0.15);
+      transform: translateY(-2px);
     }
 
     .hero-quicklinks {
@@ -144,36 +207,177 @@ export function generateStyles(config) {
     }
 
     .hero-quicklink {
-      background: rgba(255,255,255,0.15);
-      backdrop-filter: blur(10px);
-      border-radius: 12px;
-      padding: 20px;
+      background: rgba(255,255,255,0.12);
+      backdrop-filter: blur(12px);
+      border-radius: 16px;
+      padding: 24px;
       text-decoration: none;
       color: white;
       text-align: left;
-      transition: all 0.2s;
-      border: 1px solid rgba(255,255,255,0.2);
+      transition: all 0.25s ease;
+      border: 1px solid rgba(255,255,255,0.15);
     }
 
     .hero-quicklink:hover {
-      background: rgba(255,255,255,0.25);
+      background: rgba(255,255,255,0.2);
       transform: translateY(-4px);
+      box-shadow: 0 8px 24px rgba(0,0,0,0.15);
     }
 
     .hero-quicklink-icon {
-      font-size: 24px;
-      margin-bottom: 8px;
+      font-size: 28px;
+      margin-bottom: 12px;
     }
 
     .hero-quicklink-title {
-      font-size: 16px;
+      font-size: 17px;
       font-weight: 600;
-      margin-bottom: 4px;
+      margin-bottom: 6px;
     }
 
     .hero-quicklink-desc {
-      font-size: 13px;
+      font-size: 14px;
       opacity: 0.8;
+      line-height: 1.4;
+    }
+
+    /* GitHub Corner */
+    .github-corner {
+      position: absolute;
+      top: 0;
+      right: 0;
+      z-index: 10;
+    }
+    .github-corner svg {
+      fill: white;
+      color: var(--primary-color);
+      width: 80px;
+      height: 80px;
+    }
+    .github-corner:hover .octo-arm {
+      animation: octocat-wave 560ms ease-in-out;
+    }
+    @keyframes octocat-wave {
+      0%, 100% { transform: rotate(0); }
+      20%, 60% { transform: rotate(-25deg); }
+      40%, 80% { transform: rotate(10deg); }
+    }
+
+    /* ========== INTRODUCTION SECTION ========== */
+    .introduction {
+      background: var(--bg-color);
+      padding: 80px 40px;
+      max-width: 100%;
+    }
+
+    .introduction-content {
+      max-width: 900px;
+      margin: 0 auto;
+      font-size: 1.1em;
+      line-height: 1.8;
+    }
+
+    .introduction-content h1 {
+      font-size: 2.5em;
+      margin-bottom: 24px;
+      color: var(--text-color);
+      font-weight: 700;
+      border-bottom: 2px solid var(--border-color);
+      padding-bottom: 16px;
+    }
+
+    .introduction-content h2 {
+      font-size: 1.8em;
+      margin: 48px 0 16px;
+      color: var(--text-color);
+      font-weight: 600;
+    }
+
+    .introduction-content h3 {
+      font-size: 1.4em;
+      margin: 32px 0 12px;
+      color: var(--text-color);
+      font-weight: 600;
+    }
+
+    .introduction-content p {
+      margin-bottom: 16px;
+      color: var(--text-muted);
+    }
+
+    .introduction-content ul,
+    .introduction-content ol {
+      margin: 16px 0;
+      padding-left: 24px;
+    }
+
+    .introduction-content li {
+      margin-bottom: 8px;
+      color: var(--text-muted);
+    }
+
+    .introduction-content pre {
+      background: var(--code-bg);
+      border-radius: 8px;
+      padding: 20px;
+      overflow-x: auto;
+      margin: 24px 0;
+    }
+
+    .introduction-content code {
+      font-family: 'JetBrains Mono', 'Fira Code', monospace;
+      font-size: 0.9em;
+    }
+
+    .introduction-content p code {
+      background: var(--code-bg);
+      padding: 2px 6px;
+      border-radius: 4px;
+    }
+
+    .introduction-content blockquote {
+      border-left: 4px solid var(--primary-color);
+      padding: 16px 24px;
+      margin: 24px 0;
+      background: var(--hover-bg);
+      border-radius: 0 8px 8px 0;
+    }
+
+    .introduction-content blockquote p {
+      margin: 0;
+    }
+
+    .introduction-content a {
+      color: var(--primary-color);
+      text-decoration: none;
+    }
+
+    .introduction-content a:hover {
+      text-decoration: underline;
+    }
+
+    .introduction-content table {
+      width: 100%;
+      border-collapse: collapse;
+      margin: 24px 0;
+    }
+
+    .introduction-content th,
+    .introduction-content td {
+      border: 1px solid var(--border-color);
+      padding: 12px 16px;
+      text-align: left;
+    }
+
+    .introduction-content th {
+      background: var(--code-bg);
+      font-weight: 600;
+    }
+
+    .introduction-content hr {
+      border: none;
+      border-top: 1px solid var(--border-color);
+      margin: 48px 0;
     }
 
     /* ========== LAYOUT ========== */
@@ -1550,8 +1754,14 @@ export function generateStyles(config) {
       }
       .sidebar.mobile-open { display: block; }
       .hero { padding: 40px 24px; min-height: 100vh; }
-      .hero-title { font-size: 32px; }
-      .hero-tagline { font-size: 16px; }
+      .hero-logo { height: 80px; margin-bottom: 24px; }
+      .hero-title { font-size: 36px; }
+      .hero-version { font-size: 12px; margin-left: 8px; }
+      .hero-tagline { font-size: 17px; margin-bottom: 20px; }
+      .hero-features { flex-direction: column; align-items: center; gap: 12px; }
+      .hero-features li { font-size: 15px; }
+      .hero-btn { padding: 12px 24px; font-size: 15px; }
+      .github-corner svg { width: 60px; height: 60px; }
       .main { padding: 24px; }
     }
 

package/dist/docs/ui/styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../src/docs/ui/styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAOxC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAA;IAElD,OAAO;;yBAEgB,YAAY;yBACZ,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8C/C,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqnEtB,CAAA;AACH,CAAC"}
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../../../src/docs/ui/styles.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAOxC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,MAAM,EAAE,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAA;IAElD,OAAO;;yBAEgB,YAAY;yBACZ,WAAW,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA8C/C,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAu0EtB,CAAA;AACH,CAAC"}

package/dist/docs/ui/types.d.ts

@@ -20,24 +20,38 @@ export interface UIConfig {
     sidebar?: SidebarConfig;
 }
 /**
- * Hero section configuration
+ * Hero section configuration (Docsify-inspired cover page)
  */
 export interface HeroConfig {
+    /** Override title from spec.info.title */
     title?: string;
+    /** Version badge next to title */
+    version?: string;
+    /** Tagline/description below title */
     tagline?: string;
+    /** Feature list bullets */
+    features?: string[];
+    /** Background style */
     background?: 'gradient' | 'solid' | 'pattern' | 'image';
+    /** Custom background image URL */
     backgroundImage?: string;
+    /** Custom background color (for solid) */
+    backgroundColor?: string;
+    /** Call-to-action buttons */
     buttons?: Array<{
         text: string;
         href?: string;
         primary?: boolean;
     }>;
+    /** Quick links grid below buttons */
     quickLinks?: Array<{
         title: string;
         description?: string;
         href: string;
         icon?: string;
     }>;
+    /** GitHub corner link */
+    github?: string;
 }
 /**
  * Sidebar configuration

package/dist/docs/ui/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/docs/ui/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,SAAS,CAAC,EAAE,CAAC,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAA;KACxD,CAAA;IACD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IACvD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/docs/ui/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAA;QACjB,SAAS,CAAC,EAAE,CAAC,YAAY,GAAG,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAC,EAAE,CAAA;KACxD,CAAA;IACD,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,uBAAuB;IACvB,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAA;IACvD,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,6BAA6B;IAC7B,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,OAAO,CAAA;KAClB,CAAC,CAAA;IACF,qCAAqC;IACrC,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,EAAE,MAAM,CAAA;QACb,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAC,CAAA;IACF,yBAAyB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,EAAE,MAAM,CAAA;IAChB,EAAE,CAAC,EAAE,QAAQ,CAAA;IACb,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAA;CACvB"}

package/dist/docs/usd-middleware.d.ts

@@ -10,7 +10,7 @@
 import type { Registry } from '../core/index.js';
 import type { SchemaRegistry } from '../validation/index.js';
 import type { LoadedChannel, LoadedRestResource } from '../server/fs-routes/index.js';
-import type { USDDocument } from '../usd/index.js';
+import type { USDDocument, USDDocumentation, USDTagGroup, USDPathItem, USDSchema, USDSecurityScheme, USDParameter, USDResponse, USDRequestBody, USDExample } from '../usd/index.js';
 import type { OpenAPIDocument } from '../usd/export/openapi.js';
 import { type USDGeneratorOptions, type USDGeneratorProtocolConfig } from './generators/usd-generator.js';
 import type { LoadedTcpHandler } from './generators/tcp-generator.js';
@@ -54,12 +54,7 @@ export interface USDMiddlewareConfig {
     /** External documentation */
     externalDocs?: USDGeneratorOptions['externalDocs'];
     /** Tag groups for hierarchical organization (like Redoc) */
-    tagGroups?: Array<{
-        name: string;
-        tags: string[];
-        description?: string;
-        expanded?: boolean;
-    }>;
+    tagGroups?: USDTagGroup[];
     /** UI configuration */
     ui?: {
         theme?: 'light' | 'dark' | 'auto';
@@ -113,6 +108,36 @@ export interface USDMiddlewareConfig {
     jsonrpc?: USDGeneratorOptions['jsonrpc'];
     /** gRPC generation options */
     grpc?: USDGeneratorOptions['grpc'];
+    /** Documentation customization (portable with the spec) */
+    documentation?: USDDocumentation;
+    /**
+     * External paths to merge into the generated document.
+     * Useful for injecting paths from plugins (e.g. s3db.js, auth routes).
+     * Keys are OpenAPI path strings (e.g. '/users/{id}').
+     */
+    externalPaths?: Record<string, USDPathItem>;
+    /**
+     * External components to merge into the generated document.
+     * Each key is shallow-merged with the generated components of the same type.
+     */
+    externalComponents?: {
+        schemas?: Record<string, USDSchema>;
+        securitySchemes?: Record<string, USDSecurityScheme | {
+            $ref: string;
+        }>;
+        parameters?: Record<string, USDParameter | {
+            $ref: string;
+        }>;
+        responses?: Record<string, USDResponse | {
+            $ref: string;
+        }>;
+        requestBodies?: Record<string, USDRequestBody | {
+            $ref: string;
+        }>;
+        examples?: Record<string, USDExample | {
+            $ref: string;
+        }>;
+    };
 }
 /**
  * USD documentation handlers

package/dist/docs/usd-middleware.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usd-middleware.d.ts","sourceRoot":"","sources":["../../src/docs/usd-middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usd-middleware.d.ts","sourceRoot":"","sources":["../../src/docs/usd-middleware.ts"],"names":[],"mappings":"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"}

package/dist/docs/usd-middleware.js

@@ -18,7 +18,7 @@ import { generateUIHTML } from './ui/index.js';
  * Create USD documentation handlers
  */
 export function createUSDHandlers(ctx, config = {}) {
-    const { basePath = '/docs', info, servers, protocols, contentTypes, securitySchemes, defaultSecurity, tags, externalDocs, jsonrpc, grpc, ui, includeErrorSchemas = true, includeStreamEventSchemas = true, } = config;
+    const { basePath = '/docs', info, servers, protocols, contentTypes, securitySchemes, defaultSecurity, tags, externalDocs, jsonrpc, grpc, ui, documentation, includeErrorSchemas = true, includeStreamEventSchemas = true, externalPaths, externalComponents, } = config;
     // Cache for generated documents
     let cachedUSD = null;
     let cachedOpenAPI = null;
@@ -51,10 +51,14 @@ export function createUSDHandlers(ctx, config = {}) {
             defaultSecurity,
             tags,
             externalDocs,
+            documentation,
+            tagGroups: config.tagGroups,
             jsonrpc,
             grpc,
             includeErrorSchemas,
             includeStreamEventSchemas,
+            externalPaths,
+            externalComponents,
         });
         cachedUSD = result.document;
         return cachedUSD;

package/dist/docs/usd-middleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"usd-middleware.js","sourceRoot":"","sources":["../../src/docs/usd-middleware.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usd-middleware.js","sourceRoot":"","sources":["../../src/docs/usd-middleware.ts"],"names":[],"mappings":"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"}

package/dist/dx/index.d.ts

@@ -9,4 +9,6 @@
 export { createHealthCheckProcedures, CommonProbes, type HealthCheckConfig, type HealthProbe, type HealthProbeGroupConfig, type ProbeResult, type HealthResponse, type HealthCheckState, type HealthCheckProcedure, type HealthCheckProcedures, } from './health/index.js';
 export { createHttpLoggingMiddleware, createDevLoggingMiddleware, createTinyLoggingMiddleware, createProductionHttpLoggingMiddleware, withHttpLogging, LOG_FORMATS, type HttpLoggingMiddleware, type HttpLoggingConfig, type LogFormat, type LogContext, } from './logging/index.js';
 export { createUSDHandlers, type USDMiddlewareConfig, type USDHandlers, type USDMiddlewareContext, generateOpenAPI, generateOpenAPIJson, generateOpenAPIYaml, type OpenAPIDocument, type OpenAPIInfo, type OpenAPIServer, type OpenAPIPathItem, type OpenAPIOperation, type OpenAPIResponse, type OpenAPISecurityScheme, type OpenAPITag, type GeneratorOptions, } from '../docs/index.js';
+export { createServerScenario, } from './scenarios.js';
+export type { DevelopmentScenario, DevelopmentScenarioInput, DevelopmentScenarioOutput, } from './scenarios.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/dx/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,2BAA2B,EAC3B,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,qCAAqC,EACrC,eAAe,EACf,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,2BAA2B,EAC3B,YAAY,EACZ,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,qCAAqC,EACrC,eAAe,EACf,WAAW,EACX,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,UAAU,GAChB,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EACL,iBAAiB,EACjB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,oBAAoB,GACrB,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAA"}

package/dist/dx/index.js

@@ -12,4 +12,5 @@ export { createHealthCheckProcedures, CommonProbes, } from './health/index.js';
 export { createHttpLoggingMiddleware, createDevLoggingMiddleware, createTinyLoggingMiddleware, createProductionHttpLoggingMiddleware, withHttpLogging, LOG_FORMATS, } from './logging/index.js';
 // === Documentation (USD) ===
 export { createUSDHandlers, generateOpenAPI, generateOpenAPIJson, generateOpenAPIYaml, } from '../docs/index.js';
+export { createServerScenario, } from './scenarios.js';
 //# sourceMappingURL=index.js.map

package/dist/dx/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8BAA8B;AAC9B,OAAO,EACL,2BAA2B,EAC3B,YAAY,GASb,MAAM,mBAAmB,CAAA;AAE1B,+BAA+B;AAC/B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,qCAAqC,EACrC,eAAe,EACf,WAAW,GAKZ,MAAM,oBAAoB,CAAA;AAE3B,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EAIjB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GAUpB,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/dx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,8BAA8B;AAC9B,OAAO,EACL,2BAA2B,EAC3B,YAAY,GASb,MAAM,mBAAmB,CAAA;AAE1B,+BAA+B;AAC/B,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,qCAAqC,EACrC,eAAe,EACf,WAAW,GAKZ,MAAM,oBAAoB,CAAA;AAE3B,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EAIjB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,GAUpB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,oBAAoB,GACrB,MAAM,gBAAgB,CAAA"}

package/dist/dx/logging/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dx/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,YAAY,CAAA;AAG/D,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAmB1C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,IAAI,KACb,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,GAAE,iBAAsB,GAAG,qBAAqB,CAwDjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACnD,qBAAqB,CAKvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACnD,qBAAqB,CAKvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAC1C,qBAAqB,CASvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,iBAAsB,IAGpD,CAAC,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,EAAE,SAAS,CAAC,KAAG,CAAC,CAOtF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dx/logging/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAc,MAAM,YAAY,CAAA;AAI/D,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAqB1C;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAClC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,MAAM,IAAI,KACb,IAAI,CAAA;AAET;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,GAAE,iBAAsB,GAAG,qBAAqB,CAwDjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACnD,qBAAqB,CAKvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,CAAC,GACnD,qBAAqB,CAKvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,CACnD,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAC1C,qBAAqB,CASvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,GAAE,iBAAsB,IAGpD,CAAC,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,EAAE,SAAS,CAAC,KAAG,CAAC,CAOtF"}

package/dist/dx/logging/index.js

@@ -5,6 +5,7 @@
  * Supports Apache combined, common, dev, tiny, and custom format strings.
  */
 import { compileFormat, getFormatString } from './formats.js';
+import { createLogger } from '../../utils/logger.js';
 export * from './types.js';
 export { LOG_FORMATS } from './formats.js';
 /**
@@ -15,12 +16,13 @@ const DEFAULTS = {
     immediate: false,
     redactHeaders: ['authorization', 'cookie', 'set-cookie', 'x-api-key', 'x-auth-token'],
 };
+const defaultLoggerInstance = createLogger('http-logging');
 /**
- * Default logger using console.
+ * Default logger wrapper for HTTP logging format.
  */
 const defaultLogger = {
-    info: (message) => console.log(message),
-    error: (message) => console.error(message),
+    info: (message) => defaultLoggerInstance.info(message),
+    error: (message) => defaultLoggerInstance.error(message),
 };
 /**
  * Create HTTP request logging middleware.

package/dist/dx/logging/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dx/logging/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dx/logging/index.ts"],"names":[],"mappings":"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"}

package/dist/dx/scenarios.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Developer-friendly scenario presets for multi-protocol server bootstrapping.
+ *
+ * These helpers generate `createServer()` configuration objects for
+ * common combinations used during development.
+ */
+import type { ProtocolAliasMode, SinglePortProtocolKind, SinglePortConfig, ServerOptions, GrpcOptions } from '../server/types.js';
+export type DevelopmentScenario = 'api' | 'realtime' | 'rpc' | 'dev' | 'full';
+export interface DevelopmentScenarioInput {
+    port: number;
+    host?: string;
+    basePath?: string;
+    websocketPath?: string;
+    jsonrpcPath?: string;
+    graphqlPath?: string;
+    tcpPort?: number;
+    grpc?: GrpcOptions | boolean;
+    protocolAliasMode?: ProtocolAliasMode;
+    singlePort?: SinglePortConfig | boolean;
+    singlePortProtocols?: SinglePortProtocolKind[];
+}
+export type DevelopmentScenarioOutput = ServerOptions & {
+    scenario: DevelopmentScenario;
+};
+export declare function createServerScenario(scenario: DevelopmentScenario, input: DevelopmentScenarioInput): DevelopmentScenarioOutput;
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/dx/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../../src/dx/scenarios.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACZ,MAAM,oBAAoB,CAAA;AAE3B,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AAE7E,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAA;IAC5B,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;IACrC,UAAU,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAA;IACvC,mBAAmB,CAAC,EAAE,sBAAsB,EAAE,CAAA;CAC/C;AAED,MAAM,MAAM,yBAAyB,GAAG,aAAa,GAAG;IAAE,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAA;AAuBzF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,wBAAwB,GAC9B,yBAAyB,CA8F3B"}