babelfhir-ts 1.4.3 → 1.5.0

package/README.md

@@ -233,6 +233,8 @@ Options:
   --no-client              Skip FHIR client generation (client generated by default)
   --schema <format>        Generate schema files alongside outputs (supported: zod)
   --dicomweb               Generate DICOMweb helpers typed to ImagingStudy profiles in the IG
+  --prefab                 Generate Prefab UI render functions per profile (@maxhealth.tech/prefab)
+  --prefab-styles <path>   Path to styles module (.ts/.js) copied into the generated prefab/ folder
   --recursive              (update only) Recursively search subdirectories for lib/ folders
   --force                  (update only) Force regeneration even if version and flags haven't changed
   --outDir <dir>           Output directory (alias for second positional argument)

package/out/src/generator/emitters/prefab/prefabEmitter.js

@@ -0,0 +1,160 @@
+/**
+ * Prefab UI emitter — writes per-profile render functions and the shared
+ * `prefab/` runtime files (fhirFormat.ts, styles.ts, index.ts).
+ *
+ * Called twice per generation pipeline:
+ *   - {@link writePrefabProfile} once per processed profile during sdProcessor emission
+ *   - {@link finalizePrefabOutput} once after all profiles, to drop shared files + barrel
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { generatePrefabRenderer } from './prefabRenderer.js';
+import { FHIR_FORMAT_TS, DEFAULT_STYLES_TS, REGISTER_FHIR_PIPES_TS, buildPrefabIndexTs, } from './prefabRuntimeAssets.js';
+import { logger } from '../../../logger.js';
+const log = logger.withTag('prefab');
+/** In-memory registry of profiles for which we've written renderer files. outputDir → (interfaceName → resourceType) */
+const emittedProfiles = new Map();
+function prefabDirFor(outputDir) {
+    return path.join(outputDir, 'prefab');
+}
+function ensurePrefabDir(outputDir) {
+    const dir = prefabDirFor(outputDir);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Emit `prefab/<InterfaceName>Prefab.ts` for a single profile.
+ * Registers the profile so {@link finalizePrefabOutput} can build the barrel.
+ */
+export function writePrefabProfile(outputDir, interfaceName, fields, resourceType) {
+    const dir = ensurePrefabDir(outputDir);
+    const { code, fieldCount } = generatePrefabRenderer(interfaceName, fields);
+    const filePath = path.join(dir, `${interfaceName}Prefab.ts`);
+    fs.writeFileSync(filePath, code);
+    let map = emittedProfiles.get(outputDir);
+    if (!map) {
+        map = new Map();
+        emittedProfiles.set(outputDir, map);
+    }
+    map.set(interfaceName, resourceType ?? interfaceName);
+    log.debug(`Emitted prefab renderer for ${interfaceName} (${fieldCount} fields)`);
+}
+/**
+ * Write shared runtime assets (`fhirFormat.ts`, `styles.ts`, `index.ts`) and
+ * the barrel exporting every profile renderer.
+ *
+ * When `prefabStylesPath` is provided, its contents are copied verbatim as
+ * `prefab/styles.ts` so the user's theme travels with the generated package.
+ */
+export function finalizePrefabOutput(outputDir, opts = {}) {
+    const profileMap = emittedProfiles.get(outputDir);
+    if (!profileMap || profileMap.size === 0) {
+        log.debug('finalizePrefabOutput: no profiles emitted, skipping');
+        return;
+    }
+    const names = [...profileMap.keys()];
+    const dir = ensurePrefabDir(outputDir);
+    fs.writeFileSync(path.join(dir, 'fhirFormat.ts'), FHIR_FORMAT_TS);
+    fs.writeFileSync(path.join(dir, 'registerFhirPipes.ts'), REGISTER_FHIR_PIPES_TS);
+    fs.writeFileSync(path.join(dir, 'styles.ts'), resolveStylesContent(opts.prefabStylesPath));
+    fs.writeFileSync(path.join(dir, 'index.ts'), buildPrefabIndexTs(names));
+    fs.writeFileSync(path.join(dir, 'mcpViews.ts'), buildMcpViewsTs(profileMap));
+    log.success(`Generated prefab UI renderers for ${names.length} profile(s)${opts.prefabStylesPath ? ` (using styles from ${opts.prefabStylesPath})` : ''}`);
+}
+/**
+ * Resolve the styles file content.
+ *   - If `prefabStylesPath` is given and exists, its contents are returned.
+ *   - Otherwise, the baked-in default is returned.
+ */
+function resolveStylesContent(prefabStylesPath) {
+    if (!prefabStylesPath)
+        return DEFAULT_STYLES_TS;
+    const resolved = path.resolve(prefabStylesPath);
+    if (!fs.existsSync(resolved)) {
+        log.warn(`--prefab-styles file not found: ${resolved} — falling back to defaults`);
+        return DEFAULT_STYLES_TS;
+    }
+    try {
+        return fs.readFileSync(resolved, 'utf8');
+    }
+    catch (err) {
+        log.warn(`Failed to read --prefab-styles file: ${err.message} — using defaults`);
+        return DEFAULT_STYLES_TS;
+    }
+}
+/** Test / CI helper: reset the in-memory registry between generations. */
+export function resetPrefabState() {
+    emittedProfiles.clear();
+}
+// ── MCP View Registry generator ──────────────────────────────────────────────
+/**
+ * Lower-case the first character(s) of a name, preserving acronym runs.
+ * Mirrors the same logic in prefabRenderer.ts.
+ */
+function lowerFirst(name) {
+    if (!name)
+        return name;
+    let i = 0;
+    while (i < name.length && name[i] >= 'A' && name[i] <= 'Z')
+        i++;
+    if (i <= 1)
+        return name.charAt(0).toLowerCase() + name.slice(1);
+    const acronymEnd = i === name.length ? i : i - 1;
+    return name.slice(0, acronymEnd).toLowerCase() + name.slice(acronymEnd);
+}
+/**
+ * Build the `mcpViews.ts` source — a `FhirViewRegistry` that maps FHIR
+ * resource types to their generated prefab table/detail components.
+ *
+ * When multiple profiles target the same base resource type (e.g.
+ * CHCorePatient and CHCorePatientEPR both extend Patient), the first
+ * one wins. Users can override via programmatic API if needed.
+ */
+function buildMcpViewsTs(profiles) {
+    // Group by resource type — first profile per type wins
+    const byResourceType = new Map();
+    for (const [interfaceName, resourceType] of profiles) {
+        if (!byResourceType.has(resourceType)) {
+            byResourceType.set(resourceType, interfaceName);
+        }
+    }
+    const imports = [];
+    const tableEntries = [];
+    const detailEntries = [];
+    for (const [resourceType, interfaceName] of byResourceType) {
+        const varBase = lowerFirst(interfaceName);
+        imports.push(`import { ${varBase}Table, ${varBase}Detail } from './${interfaceName}Prefab.js';`);
+        tableEntries.push(`  ${JSON.stringify(resourceType)}: (resources) => ${varBase}Table(resources as any),`);
+        detailEntries.push(`  ${JSON.stringify(resourceType)}: (resource) => ${varBase}Detail(resource as any),`);
+    }
+    return `/**
+ * AUTO-GENERATED by babelfhir-ts --prefab — do not edit.
+ *
+ * FhirViewRegistry mapping FHIR resource types to profile-specific
+ * prefab components. Pass to \`createFhirMcpServer({ views })\` for
+ * rich, profile-aware UIs instead of generic auto-layout.
+ *
+ * @see https://babelfhir-ts.dev/generated-code
+ */
+
+import type { FhirViewRegistry } from '@babelfhir-ts/mcp';
+${imports.join('\n')}
+
+const TABLE_MAP: Record<string, (resources: unknown[]) => unknown> = {
+${tableEntries.join('\n')}
+};
+
+const DETAIL_MAP: Record<string, (resource: unknown) => unknown> = {
+${detailEntries.join('\n')}
+};
+
+export const views: FhirViewRegistry = {
+  table: (type, resources) => TABLE_MAP[type]?.(resources),
+  detail: (resource) => {
+    const type = (resource as { resourceType?: string }).resourceType;
+    return type ? DETAIL_MAP[type]?.(resource) : undefined;
+  },
+};
+`;
+}