@lynx-js/genui 0.0.2 → 0.0.4

package/a2ui/styles/catalog/DateTimeInput.css

@@ -51,7 +51,6 @@
 }
 
 .datetime-input-icon,
-.datetime-dialog-close-icon,
 .datetime-calendar-nav-icon,
 .datetime-time-stepper-icon {
   font-family: var(--a2ui-icon-font-family);
@@ -79,7 +78,11 @@
   justify-content: center;
   width: 100%;
   height: 100%;
-  padding: 20px;
+  padding: 24px;
+  top: 0;
+  right: 0;
+  bottom: 0;
+  left: 0;
   box-sizing: border-box;
 }
 
@@ -101,10 +104,11 @@
 .datetime-dialog-content {
   display: flex;
   flex-direction: column;
-  gap: 16px;
+  gap: 12px;
   width: 100%;
   max-width: 380px;
-  padding: 18px;
+  max-height: 82%;
+  padding: 16px;
   border-width: 1px;
   border-style: solid;
   border-color: var(--a2ui-color-border-strong);
@@ -112,6 +116,7 @@
   background-color: var(--a2ui-color-surface-strong);
   box-shadow: 0 16px 40px var(--a2ui-color-overlay);
   box-sizing: border-box;
+  overflow-y: auto;
   transition: opacity 0.18s ease, transform 0.18s ease;
 }
 
@@ -127,7 +132,6 @@
   transform: translateY(8px);
 }
 
-.datetime-dialog-header,
 .datetime-calendar-header,
 .datetime-dialog-actions {
   display: flex;
@@ -135,21 +139,11 @@
   align-items: center;
 }
 
-.datetime-dialog-header,
 .datetime-calendar-header {
   justify-content: space-between;
   gap: 12px;
 }
 
-.datetime-dialog-title {
-  min-width: 0;
-  color: var(--a2ui-color-on-surface);
-  font-size: 17px;
-  font-weight: 700;
-  line-height: 1.4;
-}
-
-.datetime-dialog-close,
 .datetime-calendar-nav {
   display: flex;
   align-items: center;
@@ -162,12 +156,10 @@
   color: var(--a2ui-color-text-muted);
 }
 
-.datetime-dialog-close.ui-active,
 .datetime-calendar-nav.ui-active {
   background-color: var(--a2ui-color-secondary);
 }
 
-.datetime-dialog-close-icon,
 .datetime-calendar-nav-icon {
   color: inherit;
   font-size: 20px;
@@ -176,7 +168,7 @@
 .datetime-calendar {
   display: flex;
   flex-direction: column;
-  gap: 10px;
+  gap: 8px;
   width: 100%;
   min-width: 0;
 }
@@ -201,7 +193,7 @@
   display: flex;
   align-items: center;
   justify-content: center;
-  height: 24px;
+  height: 20px;
 }
 
 .datetime-weekday-text {
@@ -212,14 +204,14 @@
 }
 
 .datetime-month {
-  grid-template-rows: 40px 40px 40px 40px 40px 40px;
+  grid-template-rows: 34px 34px 34px 34px 34px 34px;
 }
 
 .datetime-day {
   display: flex;
   align-items: center;
   justify-content: center;
-  margin: 2px;
+  margin: 1px;
   border-width: 1px;
   border-style: solid;
   border-color: transparent;
@@ -262,7 +254,7 @@
 .datetime-time {
   display: flex;
   flex-direction: column;
-  gap: 10px;
+  gap: 8px;
   width: 100%;
   min-width: 0;
 }
@@ -279,7 +271,7 @@
   flex-direction: row;
   align-items: center;
   justify-content: center;
-  gap: 12px;
+  gap: 10px;
 }
 
 .datetime-time-field {
@@ -287,7 +279,7 @@
   flex-direction: column;
   align-items: center;
   justify-content: center;
-  width: 72px;
+  width: 66px;
   min-width: 0;
   overflow: hidden;
   border-width: 1px;
@@ -299,16 +291,16 @@
 
 .datetime-time-value {
   color: var(--a2ui-color-on-surface);
-  font-size: 24px;
+  font-size: 22px;
   font-weight: 700;
-  line-height: 1.4;
+  line-height: 1.3;
 }
 
 .datetime-time-separator {
   color: var(--a2ui-color-text-muted);
-  font-size: 24px;
+  font-size: 22px;
   font-weight: 700;
-  line-height: 1.4;
+  line-height: 1.3;
 }
 
 .datetime-time-stepper {
@@ -316,7 +308,7 @@
   align-items: center;
   justify-content: center;
   width: 100%;
-  height: 30px;
+  height: 24px;
   color: var(--a2ui-color-text-muted);
 }
 
@@ -326,7 +318,7 @@
 
 .datetime-time-stepper-icon {
   color: inherit;
-  font-size: 22px;
+  font-size: 20px;
 }
 
 .datetime-dialog-actions {

package/a2ui/styles/catalog/Loading.css

@@ -0,0 +1,61 @@
+@import "../theme.css";
+
+.loading {
+  --a2ui-loading-base: var(--a2ui-color-surface-muted);
+  --a2ui-loading-glow: rgba(255, 255, 255, 0.34);
+  --a2ui-loading-highlight: var(--a2ui-color-border-strong);
+
+  display: flex;
+  flex-direction: column;
+  align-items: stretch;
+  justify-content: center;
+  flex-shrink: 0;
+  gap: 10px;
+}
+
+.loading-inline {
+  width: 100%;
+  min-height: 14px;
+}
+
+.loading-block {
+  width: 100%;
+  min-height: 48px;
+  padding: 6px 0;
+}
+
+.loading-skeleton {
+  height: 14px;
+  border-radius: 999px;
+  background: linear-gradient(
+    90deg,
+    var(--a2ui-loading-base) 0%,
+    var(--a2ui-loading-glow) 30%,
+    var(--a2ui-loading-highlight) 50%,
+    var(--a2ui-loading-glow) 70%,
+    var(--a2ui-loading-base) 100%
+  );
+  background-size: 220% 100%;
+  animation-name: a2ui-loading-shimmer;
+  animation-duration: 1200ms;
+  animation-timing-function: ease-in-out;
+  animation-iteration-count: infinite;
+}
+
+.loading-skeleton-primary {
+  width: 96%;
+}
+
+.loading-skeleton-secondary {
+  width: 68%;
+}
+
+@keyframes a2ui-loading-shimmer {
+  0% {
+    background-position: 120% 0;
+  }
+
+  100% {
+    background-position: -120% 0;
+  }
+}

package/a2ui-catalog-extractor/README.md

@@ -69,7 +69,7 @@ Then add a script to your package:
 ```json
 {
   "scripts": {
-    "build:catalog": "genui a2ui generate catalog --catalog-dir src/catalog --out-dir dist/catalog"
+    "build:catalog": "genui a2ui generate catalog --catalog-dir src/catalog --out-dir dist"
   }
 }
 ```
@@ -132,13 +132,15 @@ extractor that this interface should become a catalog component named
 Run:
 
 ```bash
-genui a2ui generate catalog --catalog-dir src/catalog --out-dir dist/catalog
+genui a2ui generate catalog --catalog-dir src/catalog --out-dir dist
 ```
 
 The extractor scans the catalog directory, finds interfaces marked with
 `@a2uiCatalog`, and writes one file per component:
 
 ```text
+dist/
+  catalog.json
 dist/catalog/
   QuickStartCard/
     catalog.json
@@ -405,13 +407,18 @@ genui a2ui generate catalog [options]
 | `--catalog-dir <dir>`   | Directory to scan for source files. Repeatable.                              | `src/catalog`  |
 | `--source <path>`       | Source file or directory to scan. Repeatable.                                | None           |
 | `--typedoc-json <file>` | Read an existing TypeDoc JSON project instead of running TypeDoc conversion. | None           |
-| `--out-dir <dir>`       | Directory where component catalog files are written.                         | `dist/catalog` |
+| `--out-dir <dir>`       | Root directory where catalog artifacts are written.                          | `dist`         |
+| `--catalog-id <id>`     | Catalog ID written to the full catalog file.                                 | `catalog.json` |
 | `--version`, `-v`       | Print the package version.                                                   | None           |
 | `--help`, `-h`          | Print usage.                                                                 | None           |
 
 `--source` and `--catalog-dir` can be used together. The extractor merges
 all inputs, removes duplicates, sorts them, and then runs TypeDoc.
 
+The extractor writes both per-component files such as
+`dist/catalog/QuickStartCard/catalog.json` and a full catalog file at
+`dist/catalog.json`.
+
 The scanner accepts `.ts`, `.tsx`, `.js`, `.jsx`, `.mts`, and `.cts`
 files. It ignores `.d.ts`, `node_modules`, `dist`, and `.turbo`.
 
@@ -437,7 +444,7 @@ const components = await extractCatalogComponents({
 
 await writeComponentCatalogs({
   sourceFiles: ['src/catalog/QuickStartCard.tsx'],
-  outDir: 'dist/catalog',
+  outDir: 'dist',
 });
 ```
 
@@ -448,7 +455,7 @@ directory:
 await writeComponentCatalogs({
   cwd: process.cwd(),
   sourceFiles: ['src/catalog/QuickStartCard.tsx'],
-  outDir: 'dist/catalog',
+  outDir: 'dist',
 });
 ```
 
@@ -480,14 +487,14 @@ const projectJson = JSON.parse(
 const components = extractCatalogComponentsFromTypeDocJson(projectJson);
 
 writeCatalogComponents(components, {
-  outDir: 'dist/catalog',
+  outDir: 'dist',
 });
 ```
 
 The equivalent CLI command is:
 
 ```bash
-genui a2ui generate catalog --typedoc-json typedoc.json --out-dir dist/catalog
+genui a2ui generate catalog --typedoc-json typedoc.json --out-dir dist
 ```
 
 ### Create a full A2UI catalog object

package/a2ui-catalog-extractor/dist/cli.d.ts

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 interface CliOptions {
+    catalogId?: string;
     catalogDirs: string[];
     help: boolean;
     outDir: string;

package/a2ui-catalog-extractor/dist/cli.js

@@ -6,7 +6,7 @@ import * as fs from 'node:fs';
 import { createRequire } from 'node:module';
 import * as path from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { extractCatalogComponentsFromTypeDocJson, extractCatalogFunctionsFromTypeDocJson, findCatalogSourceFiles, writeCatalogArtifacts, writeCatalogComponents, writeCatalogFunctions, } from './index.js';
+import { createA2UICatalog, extractCatalogComponentsFromTypeDocJson, extractCatalogFunctionsFromTypeDocJson, findCatalogSourceFiles, writeA2UICatalog, writeCatalogArtifacts, writeCatalogComponents, } from './index.js';
 const usage = `Usage: a2ui-catalog-extractor [options]
 
 Options:
@@ -15,19 +15,20 @@ Options:
   --typedoc-json <file>
                        Read an existing TypeDoc JSON project instead of
                        running TypeDoc conversion.
-  --out-dir <dir>      Output directory for component catalog.json files.
+  --out-dir <dir>      Output root directory for catalog artifacts.
+  --catalog-id <id>    Catalog ID written to the full catalog.json file.
   --version            Print the package version.
   --help               Print this help message.
 
 Defaults:
   --catalog-dir src/catalog
-  --out-dir dist/catalog
+  --out-dir dist
 `;
 export function parseCliArgs(args) {
     const options = {
         catalogDirs: [],
         help: false,
-        outDir: 'dist/catalog',
+        outDir: 'dist',
         sourceInputs: [],
         version: false,
     };
@@ -48,6 +49,9 @@ export function parseCliArgs(args) {
             case '--out-dir':
                 options.outDir = readValue(args, ++index, arg);
                 break;
+            case '--catalog-id':
+                options.catalogId = readValue(args, ++index, arg);
+                break;
             case '--help':
             case '-h':
                 options.help = true;
@@ -87,7 +91,11 @@ export async function runCli(args, cwd = process.cwd()) {
             cwd,
             outDir: options.outDir,
         });
-        writeCatalogFunctions(functions, {
+        writeA2UICatalog(createA2UICatalog({
+            catalogId: options.catalogId ?? 'catalog.json',
+            components,
+            functions,
+        }), {
             cwd,
             outDir: options.outDir,
         });
@@ -111,6 +119,7 @@ export async function runCli(args, cwd = process.cwd()) {
         cwd,
         outDir: options.outDir,
         sourceFiles: uniqueSourceFiles,
+        ...(options.catalogId ? { catalogId: options.catalogId } : {}),
     });
     printGeneratedComponents(components);
     printGeneratedFunctions(functions);
@@ -137,7 +146,7 @@ function printGeneratedComponents(components) {
 function printGeneratedFunctions(functions) {
     if (functions.length === 0)
         return;
-    console.info(`Generated ${functions.length} A2UI function definition files.`);
+    console.info(`Generated ${functions.length} A2UI function definitions.`);
     for (const fn of functions) {
         console.info(`Generated function definition for ${fn.name}`);
     }

package/a2ui-catalog-extractor/dist/cli.js.map

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

package/a2ui-catalog-extractor/dist/index.d.ts

@@ -1,7 +1,11 @@
 import type { ProjectReflection } from 'typedoc';
+/**
+ * JSON Schema subset emitted for A2UI component props and function arguments.
+ */
 export interface JsonSchema {
     $ref?: string;
     additionalProperties?: boolean | JsonSchema;
+    const?: unknown;
     default?: unknown;
     deprecated?: boolean;
     description?: string;
@@ -11,30 +15,51 @@ export interface JsonSchema {
     properties?: Record<string, JsonSchema>;
     required?: string[];
     type?: string;
+    unevaluatedProperties?: boolean | JsonSchema;
 }
+/**
+ * Component schema discovered from an interface annotated with `@a2uiCatalog`.
+ */
 export interface CatalogComponent {
     filePath: string;
     interfaceName: string;
     name: string;
     schema: JsonSchema;
 }
+/**
+ * Source and compiler inputs used when extracting catalog metadata.
+ */
 export interface ExtractCatalogOptions {
     cwd?: string;
     sourceFiles: string[];
     tsconfig?: string;
 }
+/**
+ * Options used when extracting catalog metadata from an existing TypeDoc
+ * project reflection.
+ */
 export interface ExtractCatalogFromTypeDocOptions {
     cwd?: string;
 }
+/**
+ * Options for writing extracted catalog artifacts to disk.
+ */
 export interface WriteComponentCatalogOptions extends ExtractCatalogOptions {
+    catalogId?: string;
     outDir: string;
 }
+/**
+ * Full catalog manifest consumed by A2UI agents and renderers.
+ */
 export interface A2UICatalog {
     catalogId: string;
     components?: Record<string, JsonSchema>;
-    functions?: FunctionDefinition[];
+    functions?: Record<string, JsonSchema>;
     theme?: Record<string, JsonSchema>;
 }
+/**
+ * Serializable definition for a client-side function exposed to an agent.
+ */
 export interface FunctionDefinition {
     description?: string;
     name: string;
@@ -45,9 +70,15 @@ export interface FunctionDefinition {
 export interface CatalogFunction extends FunctionDefinition {
     filePath: string;
 }
+/**
+ * Minimal TypeDoc project shape accepted by the extractor.
+ */
 export interface TypeDocProject {
     children?: TypeDocReflection[];
 }
+/**
+ * Minimal TypeDoc reflection shape used while walking declarations.
+ */
 export interface TypeDocReflection {
     children?: TypeDocReflection[];
     comment?: TypeDocComment;
@@ -63,6 +94,9 @@ export interface TypeDocReflection {
     sources?: TypeDocSource[];
     type?: TypeDocType;
 }
+/**
+ * Minimal TypeDoc function or method signature shape used by the extractor.
+ */
 export interface TypeDocSignature {
     comment?: TypeDocComment;
     kind?: number;
@@ -71,21 +105,33 @@ export interface TypeDocSignature {
     parameters?: TypeDocReflection[];
     type?: TypeDocType;
 }
+/**
+ * Source location metadata supplied by TypeDoc.
+ */
 export interface TypeDocSource {
     character?: number;
     fileName?: string;
     fullFileName?: string;
     line?: number;
 }
+/**
+ * TypeDoc comment shape used to read summary text and custom tags.
+ */
 export interface TypeDocComment {
     blockTags?: TypeDocCommentTag[];
     modifierTags?: Iterable<string> | Record<string, boolean>;
     summary?: TypeDocCommentDisplayPart[];
 }
+/**
+ * Custom or standard block tag parsed from a TypeDoc comment.
+ */
 export interface TypeDocCommentTag {
     content?: TypeDocCommentDisplayPart[];
     tag: string;
 }
+/**
+ * Text, code, or link fragment inside a TypeDoc comment.
+ */
 export interface TypeDocCommentDisplayPart {
     code?: string;
     content?: TypeDocCommentDisplayPart[];
@@ -94,6 +140,9 @@ export interface TypeDocCommentDisplayPart {
     target?: unknown;
     text?: string;
 }
+/**
+ * Minimal TypeDoc type node shape used for schema conversion.
+ */
 export interface TypeDocType {
     declaration?: TypeDocReflection;
     elementType?: TypeDocType;
@@ -105,36 +154,82 @@ export interface TypeDocType {
     types?: TypeDocType[];
     value?: bigint | boolean | number | string | null;
 }
+/**
+ * Find supported source files under a file or directory path.
+ */
 export declare function findCatalogSourceFiles(inputPath: string): string[];
+/**
+ * Run TypeDoc over source files and extract A2UI component schemas.
+ */
 export declare function extractCatalogComponents(options: ExtractCatalogOptions): Promise<CatalogComponent[]>;
+/**
+ * Extract A2UI component schemas from an already converted TypeDoc project.
+ */
 export declare function extractCatalogComponentsFromTypeDocProject(project: ProjectReflection | TypeDocProject, options?: ExtractCatalogFromTypeDocOptions): CatalogComponent[];
+/**
+ * Extract A2UI component schemas from a serialized TypeDoc JSON project.
+ */
 export declare function extractCatalogComponentsFromTypeDocJson(project: TypeDocProject, options?: ExtractCatalogFromTypeDocOptions): CatalogComponent[];
+/**
+ * Run TypeDoc over source files and extract A2UI function definitions.
+ */
 export declare function extractCatalogFunctions(options: ExtractCatalogOptions): Promise<CatalogFunction[]>;
+/**
+ * Extract A2UI function definitions from an already converted TypeDoc project.
+ */
 export declare function extractCatalogFunctionsFromTypeDocProject(project: ProjectReflection | TypeDocProject, options?: ExtractCatalogFromTypeDocOptions): CatalogFunction[];
+/**
+ * Extract A2UI function definitions from a serialized TypeDoc JSON project.
+ */
 export declare function extractCatalogFunctionsFromTypeDocJson(project: TypeDocProject, options?: ExtractCatalogFromTypeDocOptions): CatalogFunction[];
+/**
+ * Extract component schemas and write one `catalog.json` per component.
+ */
 export declare function writeComponentCatalogs(options: WriteComponentCatalogOptions): Promise<CatalogComponent[]>;
+/**
+ * Write component schema artifacts that were already extracted.
+ */
 export declare function writeCatalogComponents(components: CatalogComponent[], options: {
     cwd?: string;
     outDir: string;
 }): void;
+/**
+ * Extract A2UI function definitions and write one JSON artifact per function.
+ */
 export declare function writeCatalogFunctionDefinitions(options: WriteComponentCatalogOptions): Promise<CatalogFunction[]>;
+/**
+ * Component and function artifacts produced by a single extraction pass.
+ */
 export interface CatalogArtifacts {
     components: CatalogComponent[];
     functions: CatalogFunction[];
 }
 /**
- * Bootstrap TypeDoc once and emit both component and function catalog files.
+ * Bootstrap TypeDoc once and emit component manifests plus the full catalog.
  * Preferred entry point for the CLI — running the conversion twice doubles
  * cold-start latency on large catalogs.
  */
 export declare function writeCatalogArtifacts(options: WriteComponentCatalogOptions): Promise<CatalogArtifacts>;
+/**
+ * Write function definition artifacts that were already extracted.
+ */
 export declare function writeCatalogFunctions(functions: CatalogFunction[], options: {
     cwd?: string;
     outDir: string;
 }): void;
+/**
+ * Build a full A2UI catalog manifest from component and function artifacts.
+ */
 export declare function createA2UICatalog(options: {
     catalogId: string;
     components: CatalogComponent[] | Record<string, JsonSchema>;
     functions?: FunctionDefinition[];
     theme?: Record<string, JsonSchema>;
 }): A2UICatalog;
+/**
+ * Write a full A2UI catalog manifest as `catalog.json`.
+ */
+export declare function writeA2UICatalog(catalog: A2UICatalog, options: {
+    cwd?: string;
+    outDir: string;
+}): void;