@openpkg-ts/cli 0.2.3 → 0.3.1

package/dist/shared/chunk-1dqs11h6.js

@@ -0,0 +1,20 @@
+import { createRequire } from "node:module";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+export { __toESM, __require };

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+import { getExport, listExports } from "@openpkg-ts/sdk";
+import { OpenPkg } from "@openpkg-ts/spec";
+type FilterResult = {
+	spec: OpenPkg;
+	matched: number;
+	total: number;
+};
+type FilterSummaryResult = {
+	matched: number;
+	total: number;
+};
+export { listExports, getExport, FilterSummaryResult, FilterResult };

package/dist/{index.js → src/index.js}

@@ -1,3 +1,5 @@
+import"../shared/chunk-1dqs11h6.js";
+
 // src/index.ts
 import { getExport, listExports } from "@openpkg-ts/sdk";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openpkg-ts/cli",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "CLI for OpenPkg TypeScript API extraction and documentation generation",
   "homepage": "https://github.com/ryanwaits/openpkg-ts#readme",
   "repository": {
@@ -9,16 +9,22 @@
     "directory": "packages/cli"
   },
   "type": "module",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "bin": {
-    "openpkg": "./bin/openpkg.ts"
+    "openpkg": "./dist/bin/openpkg.js"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "bunup",
     "dev": "bunup --watch",
     "test": "bun test"
   },
   "dependencies": {
-    "@openpkg-ts/sdk": "^0.30.2",
+    "@openpkg-ts/adapters": "^0.3.0",
+    "@openpkg-ts/sdk": "^0.31.0",
     "commander": "^14.0.0"
   },
   "devDependencies": {

package/CHANGELOG.md

@@ -1,32 +0,0 @@
-# @openpkg-ts/cli
-
-## 0.2.3
-
-### Patch Changes
-
-- update @openpkg-ts/sdk dependency to ^0.30.2
-
-## 0.2.2
-
-### Patch Changes
-
-- pull version from package.json instead of hardcoding
-
-## 0.2.1
-
-### Patch Changes
-
-- fix workspace:\* deps to use published versions for npm compatibility
-- Updated dependencies
-  - @openpkg-ts/sdk@0.30.1
-
-## 0.2.0
-
-### Minor Changes
-
-- Major monorepo restructure: extract → sdk, doc-generator split into sdk/react/adapters, fumadocs-adapter deleted (use @openpkg-ts/adapters/fumadocs)
-
-### Patch Changes
-
-- Updated dependencies
-  - @openpkg-ts/sdk@0.30.0

package/bin/openpkg.ts

@@ -1,61 +0,0 @@
-#!/usr/bin/env bun
-import * as path from 'node:path';
-import { getExport, listExports } from '@openpkg-ts/sdk';
-import { Command } from 'commander';
-import { createDiffCommand } from '../src/commands/diff';
-import { createDocsCommand } from '../src/commands/docs';
-import { createSnapshotCommand } from '../src/commands/snapshot';
-import pkg from '../package.json';
-
-const program = new Command();
-
-program
-  .name('openpkg')
-  .description('OpenPkg CLI - TypeScript API extraction primitives')
-  .version(pkg.version);
-
-program
-  .command('list')
-  .description('List exports from a TypeScript entry point')
-  .argument('<entry>', 'Entry point file path')
-  .action(async (entry: string) => {
-    const entryFile = path.resolve(entry);
-    const result = await listExports({ entryFile });
-
-    if (result.errors.length > 0) {
-      console.error(JSON.stringify({ errors: result.errors }, null, 2));
-      process.exit(1);
-    }
-
-    console.log(JSON.stringify(result.exports, null, 2));
-  });
-
-program
-  .command('get')
-  .description('Get detailed spec for a single export')
-  .argument('<entry>', 'Entry point file path')
-  .argument('<name>', 'Export name')
-  .action(async (entry: string, name: string) => {
-    const entryFile = path.resolve(entry);
-    const result = await getExport({ entryFile, exportName: name });
-
-    if (!result.export) {
-      const errorMsg =
-        result.errors.length > 0 ? result.errors.join('; ') : `Export '${name}' not found`;
-      console.error(JSON.stringify({ error: errorMsg }, null, 2));
-      process.exit(1);
-    }
-
-    // Output export with related types if any
-    const output: Record<string, unknown> = { export: result.export };
-    if (result.types.length > 0) {
-      output.types = result.types;
-    }
-    console.log(JSON.stringify(output, null, 2));
-  });
-
-program.addCommand(createSnapshotCommand());
-program.addCommand(createDiffCommand());
-program.addCommand(createDocsCommand());
-
-program.parse();

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-import { getExport, listExports } from "@openpkg-ts/sdk";
-export { listExports, getExport };

package/src/commands/diff.ts

@@ -1,175 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import {
-  type CategorizedBreaking,
-  categorizeBreakingChanges,
-  diffSpec,
-  type OpenPkg,
-  recommendSemverBump,
-  type SemverBump,
-  type SpecExportKind,
-} from '@openpkg-ts/spec';
-import { Command } from 'commander';
-
-/**
- * A changed export with details about what changed
- */
-export interface ChangedExport {
-  id: string;
-  name: string;
-  kind: SpecExportKind;
-  description: string;
-}
-
-/**
- * Enriched diff result with categorized changes
- */
-export interface DiffResult {
-  breaking: CategorizedBreaking[];
-  added: string[];
-  removed: RemovedExport[];
-  changed: ChangedExport[];
-  docsOnly: string[];
-  summary: {
-    breakingCount: number;
-    addedCount: number;
-    removedCount: number;
-    changedCount: number;
-    docsOnlyCount: number;
-    semverBump: SemverBump;
-    semverReason: string;
-  };
-}
-
-export interface RemovedExport {
-  id: string;
-  name: string;
-  kind: SpecExportKind;
-}
-
-function loadSpec(filePath: string): OpenPkg {
-  const resolved = path.resolve(filePath);
-  const content = fs.readFileSync(resolved, 'utf-8');
-  return JSON.parse(content) as OpenPkg;
-}
-
-function toExportMap(spec: OpenPkg): Map<string, { name: string; kind: SpecExportKind }> {
-  const map = new Map<string, { name: string; kind: SpecExportKind }>();
-  for (const exp of spec.exports) {
-    map.set(exp.id, { name: exp.name, kind: exp.kind });
-  }
-  if (spec.types) {
-    for (const t of spec.types) {
-      map.set(t.id, { name: t.name, kind: t.kind as SpecExportKind });
-    }
-  }
-  return map;
-}
-
-/**
- * Enriches basic diffSpec output with categorization
- */
-export function enrichDiff(oldSpec: OpenPkg, newSpec: OpenPkg): DiffResult {
-  const rawDiff = diffSpec(oldSpec, newSpec);
-  const categorized = categorizeBreakingChanges(rawDiff.breaking, oldSpec, newSpec);
-  const semver = recommendSemverBump(rawDiff);
-
-  const oldExports = toExportMap(oldSpec);
-  const _newExports = toExportMap(newSpec);
-
-  // Separate removed from changed
-  const removed: RemovedExport[] = [];
-  const changed: ChangedExport[] = [];
-  const breaking: CategorizedBreaking[] = [];
-
-  for (const cat of categorized) {
-    if (cat.reason === 'removed') {
-      const info = oldExports.get(cat.id);
-      removed.push({
-        id: cat.id,
-        name: cat.name,
-        kind: info?.kind ?? cat.kind,
-      });
-    } else {
-      // It's a change, not a removal
-      changed.push({
-        id: cat.id,
-        name: cat.name,
-        kind: cat.kind,
-        description: describeChange(cat),
-      });
-      breaking.push(cat);
-    }
-  }
-
-  // Added exports
-  const added = rawDiff.nonBreaking;
-
-  return {
-    breaking,
-    added,
-    removed,
-    changed,
-    docsOnly: rawDiff.docsOnly,
-    summary: {
-      breakingCount: breaking.length,
-      addedCount: added.length,
-      removedCount: removed.length,
-      changedCount: changed.length,
-      docsOnlyCount: rawDiff.docsOnly.length,
-      semverBump: semver.bump,
-      semverReason: semver.reason,
-    },
-  };
-}
-
-/**
- * Generate human-readable description for a change
- */
-function describeChange(cat: CategorizedBreaking): string {
-  switch (cat.reason) {
-    case 'signature changed':
-      return `Function signature changed`;
-    case 'type definition changed':
-      return `Type definition changed`;
-    case 'constructor changed':
-      return `Class constructor signature changed`;
-    case 'methods removed':
-      return `Class methods removed`;
-    case 'methods changed':
-      return `Class methods changed`;
-    case 'changed':
-      return `${cat.kind} changed`;
-    default:
-      return cat.reason;
-  }
-}
-
-export function createDiffCommand(): Command {
-  return new Command('diff')
-    .description('Compare two OpenPkg specs and show differences')
-    .argument('<old>', 'Path to old spec file (JSON)')
-    .argument('<new>', 'Path to new spec file (JSON)')
-    .option('--json', 'Output as JSON (default)')
-    .option('--summary', 'Only show summary')
-    .action(
-      async (oldPath: string, newPath: string, options: { json?: boolean; summary?: boolean }) => {
-        try {
-          const oldSpec = loadSpec(oldPath);
-          const newSpec = loadSpec(newPath);
-
-          const result = enrichDiff(oldSpec, newSpec);
-
-          if (options.summary) {
-            console.log(JSON.stringify(result.summary, null, 2));
-          } else {
-            console.log(JSON.stringify(result, null, 2));
-          }
-        } catch (err) {
-          const error = err instanceof Error ? err : new Error(String(err));
-          console.error(JSON.stringify({ error: error.message }, null, 2));
-          process.exit(1);
-        }
-      },
-    );
-}

package/src/commands/docs.ts

@@ -1,125 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { createDocs, type DocsInstance, loadSpec } from '@openpkg-ts/sdk';
-import type { OpenPkg } from '@openpkg-ts/spec';
-import { Command } from 'commander';
-
-type OutputFormat = 'md' | 'json' | 'html';
-
-interface DocsCommandOptions {
-  output?: string;
-  format?: OutputFormat;
-  split?: boolean;
-}
-
-async function readStdin(): Promise<string> {
-  const chunks: Buffer[] = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(chunk);
-  }
-  return Buffer.concat(chunks).toString('utf-8');
-}
-
-function getExtension(format: OutputFormat): string {
-  switch (format) {
-    case 'json':
-      return '.json';
-    case 'html':
-      return '.html';
-    default:
-      return '.md';
-  }
-}
-
-function renderExport(docs: DocsInstance, exportId: string, format: OutputFormat): string {
-  const exp = docs.getExport(exportId);
-  if (!exp) throw new Error(`Export not found: ${exportId}`);
-
-  switch (format) {
-    case 'json':
-      return JSON.stringify(docs.toJSON({ exportId }), null, 2);
-    case 'html':
-      return docs.toHTML({ exportId });
-    default:
-      return docs.toMarkdown({ exportId, frontmatter: true, codeSignatures: true });
-  }
-}
-
-function renderFull(docs: DocsInstance, format: OutputFormat): string {
-  switch (format) {
-    case 'json':
-      return JSON.stringify(docs.toJSON(), null, 2);
-    case 'html':
-      return docs.toHTML();
-    default:
-      return docs.toMarkdown({ frontmatter: true, codeSignatures: true });
-  }
-}
-
-export function createDocsCommand(): Command {
-  return new Command('docs')
-    .description('Generate documentation from OpenPkg spec')
-    .argument('<spec>', 'Path to openpkg.json spec file (use - for stdin)')
-    .option('-o, --output <path>', 'Output file or directory (default: stdout)')
-    .option('-f, --format <format>', 'Output format: md, json, html (default: md)', 'md')
-    .option('--split', 'Output one file per export (requires --output as directory)')
-    .action(async (specPath: string, options: DocsCommandOptions) => {
-      const format = (options.format || 'md') as OutputFormat;
-
-      try {
-        let docs: DocsInstance;
-
-        // Handle stdin
-        if (specPath === '-') {
-          const input = await readStdin();
-          const spec: OpenPkg = JSON.parse(input);
-          docs = loadSpec(spec);
-        } else {
-          const specFile = path.resolve(specPath);
-          if (!fs.existsSync(specFile)) {
-            console.error(JSON.stringify({ error: `Spec file not found: ${specFile}` }));
-            process.exit(1);
-          }
-          docs = createDocs(specFile);
-        }
-
-        // Split mode: one file per export
-        if (options.split) {
-          if (!options.output) {
-            console.error(JSON.stringify({ error: '--split requires --output <directory>' }));
-            process.exit(1);
-          }
-
-          const outDir = path.resolve(options.output);
-          if (!fs.existsSync(outDir)) {
-            fs.mkdirSync(outDir, { recursive: true });
-          }
-
-          const exports = docs.getAllExports();
-          for (const exp of exports) {
-            const filename = `${exp.name}${getExtension(format)}`;
-            const filePath = path.join(outDir, filename);
-            const content = renderExport(docs, exp.id, format);
-            fs.writeFileSync(filePath, content);
-          }
-          console.error(`Wrote ${exports.length} files to ${outDir}`);
-          return;
-        }
-
-        // Single output mode
-        const output = renderFull(docs, format);
-
-        if (options.output && options.output !== '-') {
-          const outputPath = path.resolve(options.output);
-          fs.writeFileSync(outputPath, output);
-          console.error(`Wrote ${outputPath}`);
-        } else {
-          console.log(output);
-        }
-      } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        console.error(JSON.stringify({ error: error.message }));
-        process.exit(1);
-      }
-    });
-}

package/src/commands/snapshot.ts

@@ -1,122 +0,0 @@
-import * as fs from 'node:fs';
-import * as path from 'node:path';
-import { type Diagnostic, type ExtractOptions, extractSpec } from '@openpkg-ts/sdk';
-import { Command } from 'commander';
-
-interface SnapshotCommandOptions {
-  output?: string;
-  maxDepth?: string;
-  skipResolve?: boolean;
-  runtime?: boolean;
-  only?: string;
-  ignore?: string;
-  verify?: boolean;
-}
-
-function parseFilter(value: string | undefined): string[] | undefined {
-  if (!value) return undefined;
-  return value
-    .split(',')
-    .map((s) => s.trim())
-    .filter(Boolean);
-}
-
-function formatDiagnostics(diagnostics: Diagnostic[]): object[] {
-  return diagnostics.map((d) => ({
-    message: d.message,
-    severity: d.severity,
-    ...(d.code && { code: d.code }),
-    ...(d.suggestion && { suggestion: d.suggestion }),
-    ...(d.location && { location: d.location }),
-  }));
-}
-
-export function createSnapshotCommand(): Command {
-  return new Command('snapshot')
-    .description('Generate full OpenPkg spec from TypeScript entry point')
-    .argument('<entry>', 'Entry point file path')
-    .option(
-      '-o, --output <file>',
-      'Output file (default: openpkg.json, use - for stdout)',
-      'openpkg.json',
-    )
-    .option('--max-depth <n>', 'Max type depth (default: 4)', '4')
-    .option('--skip-resolve', 'Skip external type resolution')
-    .option('--runtime', 'Enable Standard Schema runtime extraction')
-    .option('--only <exports>', 'Filter exports (comma-separated, wildcards supported)')
-    .option('--ignore <exports>', 'Ignore exports (comma-separated, wildcards supported)')
-    .option('--verify', 'Exit 1 if any exports fail')
-    .action(async (entry: string, options: SnapshotCommandOptions) => {
-      const entryFile = path.resolve(entry);
-
-      const extractOptions: ExtractOptions = {
-        entryFile,
-        maxTypeDepth: parseInt(options.maxDepth ?? '4', 10),
-        resolveExternalTypes: !options.skipResolve,
-        schemaExtraction: options.runtime ? 'hybrid' : 'static',
-        only: parseFilter(options.only),
-        ignore: parseFilter(options.ignore),
-      };
-
-      try {
-        const result = await extractSpec(extractOptions);
-
-        // Build summary for stderr
-        const summary = {
-          exports: result.spec.exports.length,
-          types: result.spec.types?.length ?? 0,
-          diagnostics: result.diagnostics.length,
-          ...(result.verification && {
-            verification: {
-              discovered: result.verification.discovered,
-              extracted: result.verification.extracted,
-              skipped: result.verification.skipped,
-              failed: result.verification.failed,
-            },
-          }),
-          ...(result.runtimeSchemas && {
-            runtime: {
-              extracted: result.runtimeSchemas.extracted,
-              merged: result.runtimeSchemas.merged,
-              vendors: result.runtimeSchemas.vendors,
-            },
-          }),
-        };
-
-        // Write summary to stderr
-        console.error(JSON.stringify(summary, null, 2));
-
-        // Check for failures if --verify
-        if (options.verify && result.verification && result.verification.failed > 0) {
-          const errorOutput = {
-            error: 'Export verification failed',
-            failed: result.verification.details.failed,
-            diagnostics: formatDiagnostics(result.diagnostics),
-          };
-          console.error(JSON.stringify(errorOutput, null, 2));
-          process.exit(1);
-        }
-
-        // Output spec
-        const specJson = JSON.stringify(result.spec, null, 2);
-
-        if (options.output === '-') {
-          // Stdout mode
-          console.log(specJson);
-        } else {
-          // File mode
-          const outputPath = path.resolve(options.output ?? 'openpkg.json');
-          fs.writeFileSync(outputPath, specJson);
-          console.error(`Wrote ${outputPath}`);
-        }
-      } catch (err) {
-        const error = err instanceof Error ? err : new Error(String(err));
-        const errorOutput = {
-          error: error.message,
-          ...(error.stack && { stack: error.stack }),
-        };
-        console.error(JSON.stringify(errorOutput, null, 2));
-        process.exit(1);
-      }
-    });
-}

package/src/index.ts

@@ -1,2 +0,0 @@
-// CLI package - entry point for programmatic use if needed
-export { getExport, listExports } from '@openpkg-ts/sdk';