@lynx-js/genui 0.0.1 → 0.0.3

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/styles/catalog/Modal.css

@@ -13,6 +13,7 @@
   align-items: center;
   justify-content: center;
   padding: 20px;
+  inset: 0;
   box-sizing: border-box;
 }
 

package/a2ui/styles/catalog/Text.css

@@ -67,15 +67,11 @@
   line-height: 1.5;
 }
 
-.text-weight-1 {
-  font-weight: 500;
-}
-
-.text-weight-1-5 {
+.text-emphasis-medium {
   font-weight: 600;
 }
 
-.text-weight-2 {
+.text-emphasis-strong {
   font-weight: 700;
 }
 

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

@@ -2,6 +2,7 @@ import type { ProjectReflection } from 'typedoc';
 export interface JsonSchema {
     $ref?: string;
     additionalProperties?: boolean | JsonSchema;
+    const?: unknown;
     default?: unknown;
     deprecated?: boolean;
     description?: string;
@@ -11,6 +12,7 @@ export interface JsonSchema {
     properties?: Record<string, JsonSchema>;
     required?: string[];
     type?: string;
+    unevaluatedProperties?: boolean | JsonSchema;
 }
 export interface CatalogComponent {
     filePath: string;
@@ -27,12 +29,13 @@ export interface ExtractCatalogFromTypeDocOptions {
     cwd?: string;
 }
 export interface WriteComponentCatalogOptions extends ExtractCatalogOptions {
+    catalogId?: string;
     outDir: string;
 }
 export interface A2UICatalog {
     catalogId: string;
     components?: Record<string, JsonSchema>;
-    functions?: FunctionDefinition[];
+    functions?: Record<string, JsonSchema>;
     theme?: Record<string, JsonSchema>;
 }
 export interface FunctionDefinition {
@@ -123,7 +126,7 @@ export interface CatalogArtifacts {
     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.
  */
@@ -138,3 +141,7 @@ export declare function createA2UICatalog(options: {
     functions?: FunctionDefinition[];
     theme?: Record<string, JsonSchema>;
 }): A2UICatalog;
+export declare function writeA2UICatalog(catalog: A2UICatalog, options: {
+    cwd?: string;
+    outDir: string;
+}): void;

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

@@ -95,9 +95,9 @@ export async function writeComponentCatalogs(options) {
 }
 export function writeCatalogComponents(components, options) {
     const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();
-    const outDir = path.resolve(cwd, options.outDir);
+    const catalogDir = getComponentCatalogDir(path.resolve(cwd, options.outDir));
     for (const component of components) {
-        const componentOutDir = path.join(outDir, component.name);
+        const componentOutDir = path.join(catalogDir, component.name);
         fs.mkdirSync(componentOutDir, { recursive: true });
         fs.writeFileSync(path.join(componentOutDir, 'catalog.json'), `${JSON.stringify({ [component.name]: component.schema }, null, 2)}\n`);
     }
@@ -108,7 +108,7 @@ export async function writeCatalogFunctionDefinitions(options) {
     return functions;
 }
 /**
- * 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.
  */
@@ -118,7 +118,11 @@ export async function writeCatalogArtifacts(options) {
     const components = extractCatalogComponentsFromTypeDocProject(project, cwdOptions);
     const functions = extractCatalogFunctionsFromTypeDocProject(project, cwdOptions);
     writeCatalogComponents(components, options);
-    writeCatalogFunctions(functions, options);
+    writeA2UICatalog(createA2UICatalog({
+        catalogId: options.catalogId ?? 'catalog.json',
+        components,
+        functions,
+    }), options);
     return { components, functions };
 }
 // Function names must be valid JavaScript identifiers so they're safe to
@@ -129,7 +133,7 @@ export function writeCatalogFunctions(functions, options) {
     if (functions.length === 0)
         return;
     const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();
-    const functionsDir = path.join(path.resolve(cwd, options.outDir), 'functions');
+    const functionsDir = path.join(getComponentCatalogDir(path.resolve(cwd, options.outDir)), 'functions');
     fs.mkdirSync(functionsDir, { recursive: true });
     for (const fn of functions) {
         if (!FUNCTION_NAME_RE.test(fn.name)) {
@@ -148,10 +152,52 @@ export function createA2UICatalog(options) {
     return {
         catalogId: options.catalogId,
         components: catalogComponents,
-        ...(options.functions ? { functions: options.functions } : {}),
+        ...(options.functions
+            ? { functions: createFunctionSchemas(options.functions) }
+            : {}),
         ...(options.theme ? { theme: options.theme } : {}),
     };
 }
+function createFunctionSchemas(functions) {
+    const seenNames = new Set();
+    const duplicateNames = new Set();
+    for (const fn of functions) {
+        if (seenNames.has(fn.name)) {
+            duplicateNames.add(fn.name);
+        }
+        seenNames.add(fn.name);
+    }
+    if (duplicateNames.size > 0) {
+        throw new Error(`[a2ui-catalog-extractor] Duplicate A2UI function name(s): ${[...duplicateNames].join(', ')}. Function names must be unique in a catalog.`);
+    }
+    return Object.fromEntries(functions.map(({ description, name, parameters, returnType }) => [
+        name,
+        {
+            type: 'object',
+            ...(description ? { description } : {}),
+            properties: {
+                call: { const: name },
+                args: stripSchemaDialect(parameters),
+                returnType: { const: returnType },
+            },
+            required: ['call', 'args'],
+            unevaluatedProperties: false,
+        },
+    ]));
+}
+function stripSchemaDialect(schema) {
+    const { $schema: _schema, ...rest } = schema;
+    return rest;
+}
+export function writeA2UICatalog(catalog, options) {
+    const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();
+    const outDir = path.resolve(cwd, options.outDir);
+    fs.mkdirSync(outDir, { recursive: true });
+    fs.writeFileSync(path.join(outDir, 'catalog.json'), `${JSON.stringify(catalog, null, 2)}\n`);
+}
+function getComponentCatalogDir(outDir) {
+    return path.join(outDir, 'catalog');
+}
 async function createTypeDocProject(options) {
     const cwd = options.cwd ? path.resolve(options.cwd) : process.cwd();
     // TypeDoc treats `entryPoints` as glob patterns and rejects Windows