@openuji/vocab-build 0.1.0

package/README.md

@@ -0,0 +1,221 @@
+# @openuji/vocab-build
+
+Generate publishable semantic web vocabulary assets from JSON-LD schema source files.
+
+## Features
+
+- 🎯 **Dual Mode Support**: Editor's Draft (ED) and Technical Report (TR) versioned snapshots
+- 📦 **Complete Asset Generation**: JSON-LD contexts, Turtle/RDF vocabularies, and HTML documentation
+- 🔒 **TR Immutability**: Prevents accidental overwrites of published snapshots
+- 🎨 **Modern HTML Output**: Responsive, accessible vocabulary pages with copy-to-clipboard
+- 🔄 **Redirect Manifests**: Support for Netlify, Cloudflare, and generic JSON formats
+- ✅ **Full Validation**: Zod-based schema validation with detailed error messages
+
+## Installation
+
+```bash
+npm install @openuji/vocab-build
+# or
+pnpm add @openuji/vocab-build
+```
+
+## CLI Usage
+
+### Build Command
+
+Build vocabulary assets in Editor's Draft mode:
+
+```bash
+vocab-build build \
+  --input vocab.core.jsonld \
+  --out dist \
+  --module core \
+  --mode ED
+```
+
+Build a Technical Report snapshot:
+
+```bash
+vocab-build build \
+  --input vocab.core.jsonld \
+  --out dist \
+  --module core \
+  --mode TR \
+  --version 1.0.0
+```
+
+### Validate Command
+
+Validate a vocabulary source file:
+
+```bash
+vocab-build validate --input vocab.core.jsonld
+```
+
+### Release Command
+
+Convenience command for releasing a TR version:
+
+```bash
+vocab-build release --input vocab.core.jsonld
+```
+
+### CLI Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-i, --input <path>` | Path to vocab source file (required) | - |
+| `-o, --out <dir>` | Output directory | `dist` |
+| `-m, --module <core\|ui>` | Module name (required) | - |
+| `--mode <ED\|TR>` | Build mode (required) | - |
+| `-v, --version <semver>` | Version for TR mode (x.y.z) | - |
+| `-f, --force` | Overwrite existing TR snapshot | `false` |
+| `-b, --base-url <url>` | Base URL for deployment | - |
+| `-r, --redirects <type>` | Redirect type (none\|netlify\|cloudflare\|json) | `netlify` |
+| `-s, --strict` | Fail on unknown fields | `false` |
+
+## Library API
+
+```typescript
+import { buildVocab, validateVocab } from '@openuji/vocab-build';
+
+const result = await buildVocab({
+  input: 'vocab.core.jsonld',
+  output: 'dist',
+  module: 'core',
+  mode: 'ED',
+});
+
+if (result.success) {
+  console.log('Generated files:', result.files);
+} else {
+  console.error('Errors:', result.errors);
+}
+```
+
+## Input Format
+
+Vocabulary source files use an extended JSON-LD format:
+
+```json
+{
+  "module": "core",
+  "namespace": "https://ujm.specs.openuji.org/ns#",
+  "docBase": "https://ujm.specs.openuji.org/ns",
+  "title": "User Journey Map Core Vocabulary",
+  "description": "Core vocabulary for defining user journey maps",
+  "status": "ED",
+  "updated": "2025-12-23",
+  "terms": [
+    {
+      "id": "Journey",
+      "kind": "Class",
+      "label": "Journey",
+      "comment": "A complete user journey"
+    },
+    {
+      "id": "start",
+      "kind": "Property",
+      "label": "start",
+      "comment": "The starting step",
+      "domain": "https://ujm.specs.openuji.org/ns#Journey",
+      "range": "https://ujm.specs.openuji.org/ns#Step"
+    }
+  ],
+  "context": {
+    "Journey": {
+      "@id": "https://ujm.specs.openuji.org/ns#Journey",
+      "@type": "@id"
+    }
+  }
+}
+```
+
+### Required Fields
+
+- `module`: `"core"` or `"ui"`
+- `namespace`: Base IRI ending in `#`
+- `docBase`: Base document IRI without `#`
+- `title`, `description`: Human-readable strings
+- `status`: `"ED"` or `"TR"`
+- `terms`: Array of term definitions
+
+### ED-Specific
+
+- `updated`: ISO date string (YYYY-MM-DD)
+
+### TR-Specific
+
+- `version`: SemVer string (x.y.z)
+
+### Term Definition
+
+- `id`: Fragment name (valid identifier)
+- `kind`: `"Class"` or `"Property"`
+- `label`, `comment`: Human-readable strings
+- `domain`, `range`: Optional IRIs
+- `deprecated`: Optional boolean
+- `seeAlso`: Optional array of URLs
+
+## Output Structure
+
+### For `core` module:
+
+```
+dist/
+  ns/
+    index.html           # Latest HTML
+    ns.ttl              # Latest Turtle
+  contexts/
+    core.jsonld         # Latest JSON-LD context
+  ED/
+    core/
+      index.html        # Editor's Draft
+  TR/
+    core/
+      1.0.0/
+        index.html      # TR snapshot
+        context.jsonld
+        ns.ttl
+  _redirects           # Optional redirect manifest
+```
+
+### For `ui` module:
+
+```
+dist/
+  ui/
+    index.html
+    ui.ttl
+  contexts/
+    ui.jsonld
+  ED/
+    ui/
+      index.html
+  TR/
+    ui/
+      1.0.0/
+        index.html
+        context.jsonld
+        ui.ttl
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm build
+
+# Run tests
+pnpm test
+
+# Type check
+pnpm typecheck
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { buildVocab, validateVocab } from './index.js';
+import { readFile } from 'fs/promises';
+const program = new Command();
+program
+    .name('vocab-build')
+    .description('Generate publishable semantic web vocabulary assets from JSON-LD schema source files')
+    .version('0.1.0');
+/**
+ * Build command
+ */
+program
+    .command('build')
+    .description('Build vocabulary assets')
+    .requiredOption('-i, --input <path>', 'Path to vocab source file')
+    .option('-o, --out <dir>', 'Output directory', 'dist')
+    .requiredOption('-m, --module <core|ui>', 'Module name (core or ui)')
+    .requiredOption('--mode <ED|TR>', 'Build mode (ED or TR)')
+    .option('-v, --version <semver>', 'Version for TR mode (x.y.z)')
+    .option('-f, --force', 'Overwrite existing TR snapshot', false)
+    .option('-b, --base-url <url>', 'Base URL for deployment')
+    .option('-g, --git', 'Use git commit hash and date', false)
+    .option('-r, --redirects <type>', 'Redirect type (none|netlify|cloudflare|json)', 'netlify')
+    .option('-s, --strict', 'Fail on unknown fields', false)
+    .action(async (options) => {
+    const config = {
+        input: options.input,
+        output: options.out,
+        module: options.module,
+        mode: options.mode,
+        version: options.version,
+        force: options.force,
+        baseUrl: options.baseUrl,
+        git: options.git,
+        redirects: options.redirects,
+        strict: options.strict,
+    };
+    console.log('🏗️  Building vocabulary...');
+    console.log(`   Input: ${config.input}`);
+    console.log(`   Module: ${config.module}`);
+    console.log(`   Mode: ${config.mode}`);
+    if (config.version) {
+        console.log(`   Version: ${config.version}`);
+    }
+    const result = await buildVocab(config);
+    if (result.success) {
+        console.log('\n✅ Build successful!\n');
+        console.log('Generated files:');
+        result.files.forEach(file => console.log(`   - ${file}`));
+    }
+    else {
+        console.error('\n❌ Build failed:\n');
+        result.errors?.forEach(error => console.error(`   ${error}`));
+        process.exit(1);
+    }
+});
+/**
+ * Validate command
+ */
+program
+    .command('validate')
+    .description('Validate vocabulary source file')
+    .requiredOption('-i, --input <path>', 'Path to vocab source file')
+    .action(async (options) => {
+    console.log('🔍 Validating vocabulary source...');
+    console.log(`   Input: ${options.input}`);
+    const result = await validateVocab(options.input);
+    if (result.success) {
+        console.log('\n✅ Validation successful!');
+    }
+    else {
+        console.error('\n❌ Validation failed:\n');
+        result.errors?.forEach(error => console.error(`   ${error}`));
+        process.exit(1);
+    }
+});
+/**
+ * Release command (convenience)
+ */
+program
+    .command('release')
+    .description('Release a new TR version (builds TR + updates latest + generates redirects)')
+    .requiredOption('-i, --input <path>', 'Path to vocab source file')
+    .option('-o, --out <dir>', 'Output directory', 'dist')
+    .option('-b, --base-url <url>', 'Base URL for deployment')
+    .action(async (options) => {
+    console.log('🚀 Releasing vocabulary...');
+    // Read source to get version and module
+    const sourceContent = await readFile(options.input, 'utf-8');
+    const sourceData = JSON.parse(sourceContent);
+    if (!sourceData.version) {
+        console.error('❌ Source file must include a version for release');
+        process.exit(1);
+    }
+    if (sourceData.status !== 'TR') {
+        console.error('❌ Source file status must be "TR" for release');
+        process.exit(1);
+    }
+    const config = {
+        input: options.input,
+        output: options.out,
+        module: sourceData.module,
+        mode: 'TR',
+        version: sourceData.version,
+        baseUrl: options.baseUrl,
+        redirects: 'netlify',
+        force: false,
+        git: false,
+        strict: false,
+    };
+    const result = await buildVocab(config);
+    if (result.success) {
+        console.log('\n✅ Release successful!\n');
+        console.log(`Released ${config.module} v${config.version}`);
+        console.log('\nGenerated files:');
+        result.files.forEach(file => console.log(`   - ${file}`));
+    }
+    else {
+        console.error('\n❌ Release failed:\n');
+        result.errors?.forEach(error => console.error(`   ${error}`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/generate/context.d.ts

@@ -0,0 +1,10 @@
+import type { VocabSource } from '../model.js';
+/**
+ * Generate JSON-LD context from vocabulary source
+ */
+export declare function generateContext(source: VocabSource): object;
+/**
+ * Format JSON-LD context with Prettier for consistent output
+ */
+export declare function formatContext(context: object): Promise<string>;
+//# sourceMappingURL=context.d.ts.map

package/dist/generate/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/generate/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAG/D;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAiC3D;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpE"}

package/dist/generate/context.js

@@ -0,0 +1,48 @@
+import prettier from 'prettier';
+/**
+ * Generate JSON-LD context from vocabulary source
+ */
+export function generateContext(source) {
+    const context = {
+        '@version': 0.1,
+    };
+    // Add custom context mappings if provided
+    if (source.context) {
+        Object.assign(context, source.context);
+    }
+    else {
+        // Auto-generate context from terms if not provided
+        for (const term of source.terms) {
+            context[term.id] = {
+                '@id': `${source.namespace}${term.id}`,
+            };
+        }
+    }
+    // Sort keys for deterministic output
+    const sortedContext = {};
+    const keys = Object.keys(context).sort((a, b) => {
+        // Put @version first
+        if (a === '@version')
+            return -1;
+        if (b === '@version')
+            return 1;
+        return a.localeCompare(b);
+    });
+    for (const key of keys) {
+        sortedContext[key] = context[key];
+    }
+    return {
+        '@context': sortedContext,
+    };
+}
+/**
+ * Format JSON-LD context with Prettier for consistent output
+ */
+export async function formatContext(context) {
+    return prettier.format(JSON.stringify(context, null, 2), {
+        parser: 'json',
+        printWidth: 80,
+        tabWidth: 2,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/generate/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/generate/context.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAmB;IAC/C,MAAM,OAAO,GAA4B;QACrC,UAAU,EAAE,GAAG;KAClB,CAAC;IAEF,0CAA0C;IAC1C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACJ,mDAAmD;QACnD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG;gBACf,KAAK,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,EAAE;aACzC,CAAC;QACN,CAAC;IACL,CAAC;IAED,qCAAqC;IACrC,MAAM,aAAa,GAA4B,EAAE,CAAC;IAClD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC5C,qBAAqB;QACrB,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IAED,OAAO;QACH,UAAU,EAAE,aAAa;KAC5B,CAAC;AACN,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IAC/C,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,CAAC;KACd,CAAC,CAAC;AACP,CAAC"}

package/dist/generate/html.d.ts

@@ -0,0 +1,11 @@
+import type { VocabSource } from '../model.js';
+export interface HTMLOptions {
+    mode: 'ED' | 'TR';
+    version?: string;
+    baseUrl?: string;
+}
+/**
+ * Generate HTML vocabulary page
+ */
+export declare function generateHTML(source: VocabSource, options: HTMLOptions): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/generate/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/generate/html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAO/D,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CA8B9E"}

package/dist/generate/html.js

@@ -0,0 +1,37 @@
+import nunjucks from 'nunjucks';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Generate HTML vocabulary page
+ */
+export function generateHTML(source, options) {
+    // Configure Nunjucks to load templates from the templates directory
+    const templatesDir = join(__dirname, '..', 'templates');
+    const env = nunjucks.configure(templatesDir, {
+        autoescape: true,
+        trimBlocks: true,
+        lstripBlocks: true,
+    });
+    // Group terms by kind
+    const classes = source.terms.filter((t) => t.kind === 'Class').sort((a, b) => a.id.localeCompare(b.id));
+    const properties = source.terms.filter((t) => t.kind === 'Property').sort((a, b) => a.id.localeCompare(b.id));
+    // Prepare template data
+    const templateData = {
+        title: source.title,
+        description: source.description,
+        namespace: source.namespace,
+        docBase: source.docBase,
+        module: source.module,
+        status: source.status,
+        mode: options.mode,
+        version: options.version || source.version,
+        updated: source.updated,
+        classes,
+        properties,
+        baseUrl: options.baseUrl || '',
+    };
+    return env.render('vocab.html', templateData);
+}
+//# sourceMappingURL=html.js.map

package/dist/generate/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/generate/html.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAErC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAQtC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAmB,EAAE,OAAoB;IAClE,oEAAoE;IACpE,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE;QACzC,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,IAAI;QAChB,YAAY,EAAE,IAAI;KACrB,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxJ,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAiB,EAAE,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9J,wBAAwB;IACxB,MAAM,YAAY,GAAG;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO;QAC1C,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO;QACP,UAAU;QACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;KACjC,CAAC;IAEF,OAAO,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;AAClD,CAAC"}

package/dist/generate/redirects.d.ts

@@ -0,0 +1,17 @@
+export type RedirectType = 'none' | 'netlify' | 'cloudflare' | 'json';
+export interface RedirectConfig {
+    type: RedirectType;
+    module: 'core' | 'ui';
+    latestVersion?: string;
+    baseUrl?: string;
+}
+export interface Redirect {
+    from: string;
+    to: string;
+    status?: number;
+}
+/**
+ * Generate redirect rules based on configuration
+ */
+export declare function generateRedirects(config: RedirectConfig): string;
+//# sourceMappingURL=redirects.d.ts.map

package/dist/generate/redirects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.d.ts","sourceRoot":"","sources":["../../src/generate/redirects.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAmChE"}

package/dist/generate/redirects.js

@@ -0,0 +1,59 @@
+/**
+ * Generate redirect rules based on configuration
+ */
+export function generateRedirects(config) {
+    if (config.type === 'none') {
+        return '';
+    }
+    const redirects = [];
+    const pathPrefix = config.module === 'core' ? 'ns' : 'ui';
+    // Trailing slash normalization
+    redirects.push({
+        from: `/${pathPrefix}`,
+        to: `/${pathPrefix}/`,
+        status: 301,
+    });
+    // TR latest version redirect
+    if (config.latestVersion) {
+        redirects.push({
+            from: `/TR/${config.module}/`,
+            to: `/TR/${config.module}/${config.latestVersion}/`,
+            status: 302,
+        });
+    }
+    // Format based on type
+    switch (config.type) {
+        case 'netlify':
+            return formatNetlifyRedirects(redirects);
+        case 'cloudflare':
+            return formatCloudflareRedirects(redirects);
+        case 'json':
+            return formatJsonRedirects(redirects);
+        default:
+            return '';
+    }
+}
+/**
+ * Format redirects for Netlify _redirects file
+ */
+function formatNetlifyRedirects(redirects) {
+    return redirects.map(r => `${r.from}  ${r.to}  ${r.status || 301}`).join('\n') + '\n';
+}
+/**
+ * Format redirects for Cloudflare Pages
+ */
+function formatCloudflareRedirects(redirects) {
+    const rules = redirects.map(r => ({
+        source: r.from,
+        destination: r.to,
+        permanent: r.status === 301,
+    }));
+    return JSON.stringify({ redirects: rules }, null, 2);
+}
+/**
+ * Format redirects as generic JSON
+ */
+function formatJsonRedirects(redirects) {
+    return JSON.stringify(redirects, null, 2);
+}
+//# sourceMappingURL=redirects.js.map

package/dist/generate/redirects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.js","sourceRoot":"","sources":["../../src/generate/redirects.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACpD,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,EAAE,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAe,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAE1D,+BAA+B;IAC/B,SAAS,CAAC,IAAI,CAAC;QACX,IAAI,EAAE,IAAI,UAAU,EAAE;QACtB,EAAE,EAAE,IAAI,UAAU,GAAG;QACrB,MAAM,EAAE,GAAG;KACd,CAAC,CAAC;IAEH,6BAA6B;IAC7B,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACvB,SAAS,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,OAAO,MAAM,CAAC,MAAM,GAAG;YAC7B,EAAE,EAAE,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,aAAa,GAAG;YACnD,MAAM,EAAE,GAAG;SACd,CAAC,CAAC;IACP,CAAC;IAED,uBAAuB;IACvB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QAClB,KAAK,SAAS;YACV,OAAO,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC7C,KAAK,YAAY;YACb,OAAO,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAChD,KAAK,MAAM;YACP,OAAO,mBAAmB,CAAC,SAAS,CAAC,CAAC;QAC1C;YACI,OAAO,EAAE,CAAC;IAClB,CAAC;AACL,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,SAAqB;IACjD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC1F,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,SAAqB;IACpD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,CAAC,CAAC,IAAI;QACd,WAAW,EAAE,CAAC,CAAC,EAAE;QACjB,SAAS,EAAE,CAAC,CAAC,MAAM,KAAK,GAAG;KAC9B,CAAC,CAAC,CAAC;IACJ,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,SAAqB;IAC9C,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/generate/turtle.d.ts

@@ -0,0 +1,10 @@
+import type { VocabSource } from '../model.js';
+export interface TurtleOptions {
+    mode: 'ED' | 'TR';
+    version?: string;
+}
+/**
+ * Generate Turtle/RDF vocabulary from source
+ */
+export declare function generateTurtle(source: VocabSource, options: TurtleOptions): string;
+//# sourceMappingURL=turtle.d.ts.map

package/dist/generate/turtle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turtle.d.ts","sourceRoot":"","sources":["../../src/generate/turtle.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI/C,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAuGlF"}

package/dist/generate/turtle.js

@@ -0,0 +1,66 @@
+import { Writer, DataFactory } from 'n3';
+const { namedNode, literal } = DataFactory;
+/**
+ * Generate Turtle/RDF vocabulary from source
+ */
+export function generateTurtle(source, options) {
+    const writer = new Writer({
+        prefixes: {
+            rdf: 'http://www.w3.org/1999/02/22-rdf-syntax-ns#',
+            rdfs: 'http://www.w3.org/2000/01/rdf-schema#',
+            owl: 'http://www.w3.org/2002/07/owl#',
+            xsd: 'http://www.w3.org/2001/XMLSchema#',
+            '': source.namespace,
+        },
+    });
+    // Add ontology header
+    const ontologyIRI = source.docBase;
+    writer.addQuad(namedNode(ontologyIRI), namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'), namedNode('http://www.w3.org/2002/07/owl#Ontology'));
+    writer.addQuad(namedNode(ontologyIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#label'), literal(source.title));
+    writer.addQuad(namedNode(ontologyIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#comment'), literal(source.description));
+    // Add version metadata for TR
+    if (options.mode === 'TR' && options.version) {
+        writer.addQuad(namedNode(ontologyIRI), namedNode('http://www.w3.org/2002/07/owl#versionInfo'), literal(options.version));
+        const versionIRI = `${ontologyIRI}/TR/${source.module}/${options.version}/vocab.ttl`;
+        writer.addQuad(namedNode(ontologyIRI), namedNode('http://www.w3.org/2002/07/owl#versionIRI'), namedNode(versionIRI));
+    }
+    // Add imports for UI module (imports core)
+    if (source.module === 'ui') {
+        writer.addQuad(namedNode(ontologyIRI), namedNode('http://www.w3.org/2002/07/owl#imports'), namedNode('https://ujm.specs.openuji.org/ns'));
+    }
+    // Add terms
+    for (const term of source.terms) {
+        const termIRI = `${source.namespace}${term.id}`;
+        const termType = term.kind === 'Class'
+            ? 'http://www.w3.org/2000/01/rdf-schema#Class'
+            : 'http://www.w3.org/1999/02/22-rdf-syntax-ns#Property';
+        writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'), namedNode(termType));
+        writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#label'), literal(term.label));
+        writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#comment'), literal(term.comment));
+        // Add domain and range if present
+        if (term.domain) {
+            writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#domain'), namedNode(term.domain));
+        }
+        if (term.range) {
+            writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#range'), namedNode(term.range));
+        }
+        // Add deprecated marker
+        if (term.deprecated) {
+            writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/2002/07/owl#deprecated'), literal('true', namedNode('http://www.w3.org/2001/XMLSchema#boolean')));
+        }
+        // Add seeAlso links
+        if (term.seeAlso) {
+            for (const url of term.seeAlso) {
+                writer.addQuad(namedNode(termIRI), namedNode('http://www.w3.org/2000/01/rdf-schema#seeAlso'), namedNode(url));
+            }
+        }
+    }
+    let result = '';
+    writer.end((error, output) => {
+        if (error)
+            throw error;
+        result = output;
+    });
+    return result;
+}
+//# sourceMappingURL=turtle.js.map