@urbicon-ui/shared-types 6.1.4

package/README.md

@@ -0,0 +1,63 @@
+# @urbicon-ui/shared-types
+
+Central TypeScript type definitions shared across the Urbicon UI monorepo. Pure types, zero runtime, zero dependencies.
+
+## Purpose
+
+Every Urbicon package (`blocks`, `table`, `docs`, `docs-gen`, `mcp-server`, `i18n`) consumes these types to stay consistent. The same `PropInfo` describes a component prop in `docs-gen` output, in `docs`' `ApiReference` component, and in the MCP server catalog.
+
+## Installation
+
+This package ships inside the Urbicon UI monorepo. Install from repo root:
+
+```bash
+bun install
+```
+
+## Exports
+
+Each subpath is consumable on its own so consumers pull in only what they need:
+
+| Subpath | Contents |
+|---|---|
+| `.` | Barrel — re-exports everything below except `documentation-core` |
+| `./documentation` | `ComponentMetadata`, `DeprecationInfo`, `ComponentBadge`, `SectionOrder`, `LLMConfig` |
+| `./docs-config` | `SvelteDocsConfig`, `DocsPlaygroundConfig`, `VariantsConfig`, `ExamplesConfig`, `ApiConfig`, `OverviewConfig`, `UsageConfig`, `DocsMetadata` |
+| `./components` | `ComponentInfo`, `ComponentStats`, `PropInfo`, `PropSource`, `PropExample`, `VariantInfo`, `VariantExample`, `InheritanceInfo`, `CrossReference`, `PackageInfo` |
+| `./examples` | `ComponentExample`, `UsagePattern`, `ExampleCollection`, `ExampleGroup` |
+| `./playground` | `PlaygroundConfig`, `ControlDefinition`, `ControlType`, `ControlOption`, `ControlCondition`, `CodeGenerator`, `CodeGeneratorConfig`, `ImportStatement`, `PlaygroundExample`, `PlaygroundMetadata`, `PlaygroundFeature` |
+| `./navigation` | `NavigationItem`, `NavigationMetadata`, `NavigationState`, `NavigationBadge`, `TableOfContents`, `TOCItem`, `TOCSettings`, `Breadcrumb`, `BreadcrumbItem`, `BreadcrumbSettings`, `SiteNavigation`, `NavigationContext`, `NavigationSearchResult`, `SearchMatch` |
+| `./globals` | Monorepo-wide branded types and constants |
+| `./utilities` | Helper types |
+
+## Usage
+
+```typescript
+import type { PropInfo, ComponentInfo } from '@urbicon-ui/shared-types/components';
+import type { PlaygroundConfig } from '@urbicon-ui/shared-types/playground';
+
+const button: ComponentInfo = {
+  name: 'Button',
+  props: [{ name: 'intent', type: 'ComponentIntent', required: false }],
+  // ...
+};
+```
+
+The root barrel export is convenient but pulls all namespaces in; prefer the subpath exports for smaller type-check surface.
+
+## Versioning
+
+Unified with the monorepo version (see root [CHANGELOG.md](../../CHANGELOG.md)). Breaking changes to exported types are treated as semver-major for the whole workspace.
+
+## Development
+
+```bash
+bun --filter='@urbicon-ui/shared-types' run build     # tsc build
+bun --filter='@urbicon-ui/shared-types' run check     # tsc --noEmit
+bun --filter='@urbicon-ui/shared-types' run dev       # watch mode
+```
+
+## Related
+
+- [Architecture Overview](../../docs/ARCHITECTURE.md) — how the type hub feeds docs-gen, docs, and mcp-server
+- [Component API Conventions](../../docs/COMPONENT-API-CONVENTIONS.md) — canonical prop patterns reflected in these types

package/dist/component.d.ts

@@ -0,0 +1,185 @@
+import type { DeprecationInfo } from './documentation.js';
+import type { ComponentDocumentation } from './documentation-core.js';
+/**
+ * Component maturity / stability classifier — drives the Editorial
+ * stability badge in the doc-page header. Defaults to `'stable'` when
+ * the `@stability` JSDoc tag is omitted, on the assumption that most
+ * shipped components are stable and the noise of a `BETA` badge on
+ * every page is not what we want.
+ */
+export type ComponentStability = 'experimental' | 'beta' | 'stable' | 'deprecated';
+/**
+ * All the information that can be extracted and inferred from a component
+ */
+export interface ComponentInfo {
+    /** Component name */
+    name: string;
+    /** Package name */
+    packageName: string;
+    /** Path to component file */
+    filePath: string;
+    /** Version */
+    version?: string;
+    /** Component description */
+    description: string;
+    /** Deprecation information */
+    deprecated?: DeprecationInfo;
+    /** Experimental status */
+    experimental?: boolean;
+    /** Version since when available */
+    since?: string;
+    /**
+     * Maturity classifier — extracted from `@stability {experimental|beta|stable|deprecated}`
+     * JSDoc. Drives the Editorial `[STABLE]` / `[BETA]` / etc. badge.
+     * Defaults to `'stable'` if the tag is missing.
+     */
+    stability?: ComponentStability;
+    /**
+     * GitHub blob URL for the component's source file — built at
+     * generation time from `filePath`. Drives the Editorial `source ↗`
+     * link in the doc-page header.
+     */
+    sourceHref?: string;
+    /** Category tags (e.g. form, layout, feedback) — extracted from @tag JSDoc */
+    tags?: string[];
+    /** Related component names — extracted from @related JSDoc */
+    relatedComponents?: string[];
+    /** Component properties */
+    props: PropInfo[];
+    /** Available variants */
+    variants: VariantInfo[];
+    /** Inheritance information */
+    inheritance: InheritanceInfo[];
+    /** Component statistics */
+    stats: ComponentStats;
+    /** Component documentation */
+    documentation?: ComponentDocumentation;
+}
+/**
+ * Property information (from docs-gen)
+ */
+export interface PropInfo {
+    /** Property name */
+    name: string;
+    /** TypeScript type */
+    type: string;
+    /** Whether property is required */
+    required: boolean;
+    /** Property description */
+    description: string;
+    /** Default value */
+    defaultValue?: string;
+    /** Where this prop comes from */
+    source: PropSource;
+    /** Usage examples */
+    examples?: PropExample[];
+    /** Deprecation info */
+    deprecated?: DeprecationInfo;
+    /** Experimental flag */
+    experimental?: boolean;
+    /** Version since available */
+    since?: string;
+    /** Values */
+    values?: string[];
+    /** See also */
+    seeAlso?: string;
+    /**
+     * When the host type is a discriminated union (e.g.
+     * `type Foo = A | B`), this records the variants in which the prop
+     * actually exists. The `propName` points at the discriminator
+     * property; `values` lists the discriminator values for which this
+     * prop is applicable. Omit means the prop is unconditional.
+     */
+    conditionalOn?: {
+        propName: string;
+        values: string[];
+    };
+}
+/**
+ * Source of a property
+ */
+export interface PropSource {
+    type: 'direct' | 'inherited' | 'variant';
+    name?: string;
+    package?: string;
+    url?: string;
+}
+/**
+ * Property usage example
+ */
+export interface PropExample {
+    title: string;
+    code: string;
+    description?: string;
+}
+/**
+ * Variant information (from docs-gen)
+ */
+export interface VariantInfo {
+    /** Variant name */
+    name: string;
+    /** Available values */
+    values: string[];
+    /** Default value */
+    defaultValue?: string;
+    /** Variant examples */
+    examples?: VariantExample[];
+}
+/**
+ * Example for a specific variant
+ */
+export interface VariantExample {
+    value: string;
+    label: string;
+    description?: string;
+    code?: string;
+}
+/**
+ * Inheritance information (from docs-gen)
+ */
+export interface InheritanceInfo {
+    /** Type name */
+    typeName: string;
+    /** Source package/module */
+    source: string;
+    /** Inherited properties */
+    props: PropInfo[];
+    /** Documentation URL */
+    url?: string;
+}
+/**
+ * Component statistics (enhanced from docs-gen + shared-types)
+ */
+export interface ComponentStats {
+    /** Total number of props */
+    totalProps: number;
+    /** Direct props (not inherited) */
+    directProps: number;
+    /** Variant-related props */
+    variantProps: number;
+    /** Inherited props */
+    inheritedProps: number;
+    /** Last updated timestamp */
+    lastUpdated?: string;
+}
+/**
+ * Cross-reference to other components or types (from docs-gen)
+ */
+export interface CrossReference {
+    type: 'component' | 'type' | 'external';
+    name: string;
+    package: string;
+    url?: string;
+    description?: string;
+}
+/**
+ * Package information (from docs-gen)
+ */
+export interface PackageInfo {
+    name: string;
+    version: string;
+    description?: string;
+    homepage?: string;
+    repository?: string;
+}
+//# sourceMappingURL=component.d.ts.map

package/dist/component.d.ts.map

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

package/dist/component.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=component.js.map

package/dist/component.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.js","sourceRoot":"","sources":["../src/component.ts"],"names":[],"mappings":""}

package/dist/docs-config.d.ts

@@ -0,0 +1,120 @@
+import type { ComponentBadge, ComponentMetadata, LLMConfig } from './documentation.js';
+import type { ControlDefinition } from './playground.js';
+/**
+ * Configuration exported from docs.svelte files
+ * Used for build-time processing and auto-section generation
+ */
+export interface SvelteDocsConfig {
+    /** Configuration for auto-generated sections */
+    generation?: {
+        /** Interactive playground configuration */
+        playground?: DocsPlaygroundConfig;
+        /** Variants showcase configuration */
+        variants?: VariantsConfig;
+        /** Examples section - false means we provide custom */
+        examples?: boolean | ExamplesConfig;
+        /** API reference configuration */
+        api?: ApiConfig;
+        /** Overview section configuration */
+        overview?: OverviewConfig;
+        /** Usage notes configuration */
+        usage?: boolean | UsageConfig;
+    };
+    /** LLM-specific configuration (extends shared config) */
+    llm?: LLMConfig;
+    /** Component metadata (extends shared metadata) */
+    meta?: DocsMetadata;
+}
+/**
+ * Playground configuration for docs generation
+ * Simple configuration for auto-generating playground sections
+ */
+export interface DocsPlaygroundConfig {
+    /** Props to feature in the playground */
+    featured?: string[];
+    /** Props to exclude from playground */
+    exclude?: string[];
+    /** Default values for playground */
+    defaults?: Record<string, unknown>;
+    /** Additional/override controls for the playground */
+    controls?: ControlDefinition[];
+    /** Enable/disable playground */
+    enabled?: boolean;
+    /** Section order */
+    order?: number;
+}
+/**
+ * Variants showcase configuration
+ */
+export interface VariantsConfig {
+    /** Variants to exclude from showcase */
+    exclude?: string[];
+    /** How to group variants (by intent, size, etc.) */
+    groupBy?: string;
+    /** Maximum variants to show per group */
+    limit?: number;
+    /** Enable/disable variants section */
+    enabled?: boolean;
+    /** Section order */
+    order?: number;
+}
+/**
+ * Examples section configuration
+ */
+export interface ExamplesConfig {
+    /** Enable/disable examples section */
+    enabled?: boolean;
+    /** Section order */
+    order?: number;
+    /** Maximum examples to show */
+    limit?: number;
+}
+/**
+ * API reference configuration
+ */
+export interface ApiConfig {
+    /** Show inherited properties */
+    showInheritance?: boolean;
+    /** Group properties by category */
+    groupBy?: 'type' | 'category' | 'alphabetical';
+    /** Show deprecated properties */
+    showDeprecated?: boolean;
+    /** Enable/disable API section */
+    enabled?: boolean;
+    /** Section order */
+    order?: number;
+}
+/**
+ * Overview section configuration
+ */
+export interface OverviewConfig {
+    /** Show component stats */
+    showStats?: boolean;
+    /** Show tier badges */
+    showBadges?: boolean;
+    /** Enable/disable overview section */
+    enabled?: boolean;
+    /** Section order */
+    order?: number;
+}
+/**
+ * Usage notes configuration
+ */
+export interface UsageConfig {
+    /** Enable/disable usage notes section */
+    enabled?: boolean;
+    /** Section order */
+    order?: number;
+}
+/**
+ * Docs-specific metadata (extends shared ComponentMetadata)
+ */
+export interface DocsMetadata extends Partial<ComponentMetadata> {
+    /** Component title (defaults to component name) */
+    title?: string;
+    /** Show table of contents */
+    showToc?: boolean;
+    /** Custom badges to display */
+    badges?: ComponentBadge[];
+}
+//# sourceMappingURL=docs-config.d.ts.map

package/dist/docs-config.d.ts.map

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

package/dist/docs-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=docs-config.js.map

package/dist/docs-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-config.js","sourceRoot":"","sources":["../src/docs-config.ts"],"names":[],"mappings":""}

package/dist/documentation-core.d.ts

@@ -0,0 +1,217 @@
+import type { ComponentInfo } from './component.js';
+import type { ComponentBadge, LLMConfig } from './documentation.js';
+import type { ComponentExample, UsagePattern } from './examples.js';
+import type { NavigationItem } from './navigation.js';
+import type { PlaygroundConfig } from './playground.js';
+/**
+ * Documentation section for generation pipeline
+ * Used for rendering and processing documentation sections
+ */
+export interface DocumentationSection {
+    /** Unique section ID */
+    id: string;
+    /** Section title */
+    title: string;
+    /** Section type - primary categorization */
+    type: SectionType;
+    /** Display order */
+    order: number;
+    /** Section content */
+    content: SectionContent;
+}
+/**
+ * Available section types
+ */
+export type SectionType = 'overview' | 'playground' | 'examples' | 'variants' | 'api' | 'types' | 'accessibility' | 'custom' | 'text';
+/**
+ * Union type for different section content types
+ * Content type is inferred from DocumentationSection.type
+ */
+export type SectionContent = ExampleContent | PlaygroundContent | TextContent | ApiContent | VariantsContent | CustomContent;
+/**
+ * Example section content
+ */
+export interface ExampleContent {
+    examples: ComponentExample[];
+    showCategories?: boolean;
+    groupByCategory?: boolean;
+}
+/**
+ * Playground section content
+ */
+export interface PlaygroundContent {
+    config: PlaygroundConfig;
+    showCodePreview?: boolean;
+    showInlineControls?: boolean;
+}
+/**
+ * Text/markdown section content
+ */
+export interface TextContent {
+    content: string;
+    format?: 'markdown' | 'html' | 'plain';
+    variables?: Record<string, unknown>;
+}
+/**
+ * API reference section content. `props` is typed as `unknown[]` because
+ * this base type ships without a runtime dependency on docs-gen's PropInfo.
+ */
+export interface ApiContent {
+    props: unknown[];
+    showInherited?: boolean;
+    groupByCategory?: boolean;
+    showExamples?: boolean;
+}
+/**
+ * Variants showcase section content. `variants` is typed as `unknown[]`
+ * because this base type ships without a runtime dependency on docs-gen's
+ * VariantInfo.
+ */
+export interface VariantsContent {
+    variants: unknown[];
+    showExamples?: boolean;
+    showCombinations?: boolean;
+}
+/**
+ * Custom section content
+ */
+export interface CustomContent {
+    content: string;
+    template?: string;
+    variables?: Record<string, unknown>;
+}
+/**
+ * Complete component documentation structure.
+ * Either auto-generated or manually created.
+ */
+export interface ComponentDocumentation {
+    /** Component identifier */
+    component: string;
+    /** Display title */
+    title: string;
+    /** Component description */
+    description: string;
+    /** Display badges */
+    badges?: ComponentBadge[];
+    /** Auto-generated sections configuration */
+    autoSections: AutoSectionsConfig;
+    /** Custom sections */
+    customSections?: CustomSection[];
+    /** Section structure and ordering */
+    sectionStructure?: SectionStructure;
+    /** Navigation items */
+    navigation?: NavigationItem[];
+    /** LLM-specific settings */
+    llmSettings: LLMSettings;
+    /** Documentation metadata */
+    metadata?: DocumentationMetadata;
+    /** Documentation sections (for docs-gen compatibility) */
+    sections?: DocumentationSection[];
+}
+/**
+ * Configuration for auto-generated sections
+ */
+export interface AutoSectionsConfig {
+    /** Interactive playground */
+    playground: boolean;
+    /** Basic usage examples */
+    basicUsage: boolean;
+    /** Variants showcase */
+    variants: boolean;
+    /** Size variations */
+    sizes: boolean;
+    /** Intent variations */
+    intents: boolean;
+    /** Mint micro-interactions */
+    mint: boolean | string | string[];
+    /** API reference */
+    api: boolean;
+    /** Accessibility section */
+    accessibility: boolean;
+}
+/**
+ * Custom documentation section
+ */
+export interface CustomSection {
+    /** Unique section ID */
+    id: string;
+    /** Section title */
+    title: string;
+    /** Section subtitle */
+    subtitle?: string;
+    /** Section content (markdown/HTML) */
+    content: string;
+    /** Include in LLM output */
+    includeLLM?: boolean;
+    /** Order within parent section */
+    order?: number;
+    /** Parent section ID */
+    parentSection?: string;
+}
+/**
+ * Section structure and ordering
+ */
+export interface SectionStructure {
+    /** Custom section order */
+    order?: string[];
+    /** Custom parent section configurations */
+    customParents?: Record<string, ParentSectionConfig>;
+}
+/**
+ * Parent section configuration
+ */
+export interface ParentSectionConfig {
+    /** Section title */
+    title: string;
+    /** Section subtitle */
+    subtitle?: string;
+    /** Section ID (auto-generated if not provided) */
+    id?: string;
+}
+/**
+ * LLM generation settings
+ */
+export interface LLMSettings extends LLMConfig {
+    /** Include playground section */
+    includePlayground: boolean;
+    /** Include complex examples */
+    includeComplexExamples: boolean;
+    /** Include full API reference */
+    includeFullAPI: boolean;
+    /** Maximum examples per section */
+    maxExamplesPerSection: number;
+    /** Content simplification level */
+    simplificationLevel?: 'none' | 'basic' | 'aggressive';
+}
+/**
+ * Documentation metadata
+ */
+export interface DocumentationMetadata {
+    /** Last updated timestamp */
+    lastUpdated?: string;
+    /** Documentation version */
+    version?: string;
+    /** Contributors */
+    contributors?: string[];
+    /** Review status */
+    reviewStatus?: 'draft' | 'review' | 'approved';
+    /** Related components */
+    relatedComponents?: string[];
+}
+/**
+ * Complete documentation files structure
+ */
+export interface ComponentDocumentationFiles {
+    /** Component examples */
+    examples: ComponentExample[];
+    /** Playground configuration */
+    playground: PlaygroundConfig;
+    /** Main documentation content */
+    content: ComponentDocumentation;
+    /** Usage patterns */
+    patterns?: UsagePattern[];
+    /** Associated component info */
+    component?: ComponentInfo;
+}
+export type { ComponentExample, PlaygroundConfig, UsagePattern };
+//# sourceMappingURL=documentation-core.d.ts.map

package/dist/documentation-core.d.ts.map

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

package/dist/documentation-core.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=documentation-core.js.map

package/dist/documentation-core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation-core.js","sourceRoot":"","sources":["../src/documentation-core.ts"],"names":[],"mappings":""}

package/dist/documentation.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Component metadata (shared across all packages)
+ */
+export interface ComponentMetadata {
+    version?: string;
+    description: string;
+    tags: string[];
+    deprecated?: DeprecationInfo;
+    experimental?: boolean;
+    since?: string;
+}
+export interface DeprecationInfo {
+    message: string;
+    since: string;
+    alternative?: string;
+    removeIn?: string;
+}
+/**
+ * Badge configuration (used in multiple packages)
+ */
+export interface ComponentBadge {
+    label: string;
+    intent?: 'primary' | 'secondary' | 'success' | 'warning' | 'danger' | 'info';
+    variant?: 'filled' | 'outlined' | 'soft';
+}
+/**
+ * Section ordering concept
+ */
+export interface SectionOrder {
+    id: string;
+    order: number;
+}
+/**
+ * Basic LLM configuration (shared between docs generators)
+ */
+export interface LLMConfig {
+    include?: boolean;
+    maxSections?: number;
+    priority?: string[];
+    excludeTypes?: string[];
+    simplifyContent?: boolean;
+}
+export type { DeprecationInfo as ComponentDeprecationInfo };
+//# sourceMappingURL=documentation.d.ts.map

package/dist/documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentation.d.ts","sourceRoot":"","sources":["../src/documentation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7E,OAAO,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAGD,YAAY,EAAE,eAAe,IAAI,wBAAwB,EAAE,CAAC"}