forgeos 0.1.0-alpha.0 → 0.1.0-alpha.2

package/src/forge/compiler/package-graph/constants.ts

@@ -1,4 +1,4 @@
-export const PACKAGE_GRAPH_SCHEMA_VERSION = "1.0.0";
-export const PACKAGE_ANALYZER_VERSION = "0.1.1";
-export const GENERATOR_VERSION = "0.0.0";
-export const DEFAULT_PATTERN_EXPANSION_LIMIT = 50;
+export const PACKAGE_GRAPH_SCHEMA_VERSION = "1.0.0";
+export const PACKAGE_ANALYZER_VERSION = "0.2.0";
+export { GENERATOR_VERSION } from "../../version.ts";
+export const DEFAULT_PATTERN_EXPANSION_LIMIT = 50;

package/src/forge/compiler/package-graph/exports-discovery.ts

@@ -1,84 +1,91 @@
-import { join, posix } from "node:path";
-import { nodeFileSystem } from "../fs/index.ts";
-import { compareBytes } from "../primitives/compare.ts";
-import { DEFAULT_PATTERN_EXPANSION_LIMIT } from "./constants.ts";
-
-export interface DiscoveredSubpath {
-  subpath: string;
-  patternBacked: boolean;
-}
-
-export function discoverSubpathsFromExports(
-  exportsField: unknown,
-): DiscoveredSubpath[] {
-  if (exportsField == null) {
-    return [{ subpath: ".", patternBacked: false }];
-  }
-
-  if (typeof exportsField === "string") {
-    return [{ subpath: ".", patternBacked: false }];
-  }
-
-  if (typeof exportsField !== "object" || Array.isArray(exportsField)) {
-    return [{ subpath: ".", patternBacked: false }];
-  }
-
-  const entries: DiscoveredSubpath[] = [];
-  for (const key of Object.keys(exportsField as Record<string, unknown>)) {
-    const normalized = key === "." ? "." : key.startsWith("./") ? key : `./${key}`;
-    const patternBacked = normalized.endsWith("/*");
-    entries.push({ subpath: normalized, patternBacked });
-  }
-
-  entries.sort((a, b) => compareBytes(a.subpath, b.subpath));
-  return entries;
-}
-
-export function expandPatternSubpaths(
-  installPath: string,
-  patternSubpath: string,
-  limit: number = DEFAULT_PATTERN_EXPANSION_LIMIT,
-): string[] {
-  if (!patternSubpath.endsWith("/*")) {
-    return [patternSubpath];
-  }
-
-  const prefix = patternSubpath.slice(0, -2);
-  const relativePrefix = prefix.startsWith("./") ? prefix.slice(2) : prefix;
-  const baseDir = join(installPath, relativePrefix);
-
-  let files: string[];
-  try {
-    files = listFilesRecursive(baseDir);
-  } catch {
-    return [];
-  }
-
-  const expanded: string[] = [];
-  for (const file of files) {
-    const rel = posix.join(prefix, file);
-    expanded.push(rel.startsWith("./") ? rel : `./${rel}`);
-    if (expanded.length >= limit) {
-      break;
-    }
-  }
-
-  expanded.sort(compareBytes);
-  return expanded;
-}
-
-function listFilesRecursive(dir: string, relative = ""): string[] {
-  const files: string[] = [];
-
-  for (const entry of nodeFileSystem.readDir(dir)) {
-    const full = join(dir, entry.name);
-    const rel = relative ? posix.join(relative, entry.name) : entry.name;
-    if (entry.isDirectory) {
-      files.push(...listFilesRecursive(full, rel));
-    } else {
-      files.push(rel);
-    }
-  }
-
-  return files;
-}
+import { join, posix } from "node:path";
+import { nodeFileSystem } from "../fs/index.ts";
+import { compareBytes } from "../primitives/compare.ts";
+import { DEFAULT_PATTERN_EXPANSION_LIMIT } from "./constants.ts";
+
+export interface DiscoveredSubpath {
+  subpath: string;
+  patternBacked: boolean;
+}
+
+export function discoverSubpathsFromExports(
+  exportsField: unknown,
+): DiscoveredSubpath[] {
+  if (exportsField == null) {
+    return [{ subpath: ".", patternBacked: false }];
+  }
+
+  if (typeof exportsField === "string") {
+    return [{ subpath: ".", patternBacked: false }];
+  }
+
+  if (typeof exportsField !== "object" || Array.isArray(exportsField)) {
+    return [{ subpath: ".", patternBacked: false }];
+  }
+
+  const entries: DiscoveredSubpath[] = [];
+  for (const key of Object.keys(exportsField as Record<string, unknown>)) {
+    const normalized = key === "." ? "." : key.startsWith("./") ? key : `./${key}`;
+    const patternBacked = normalized.endsWith("/*");
+    entries.push({ subpath: normalized, patternBacked });
+  }
+
+  entries.sort((a, b) => compareBytes(a.subpath, b.subpath));
+  return entries;
+}
+
+export function expandPatternSubpaths(
+  installPath: string,
+  patternSubpath: string,
+  limit: number = DEFAULT_PATTERN_EXPANSION_LIMIT,
+): string[] {
+  if (!patternSubpath.endsWith("/*")) {
+    return [patternSubpath];
+  }
+
+  const prefix = patternSubpath.slice(0, -2);
+  const relativePrefix = prefix.startsWith("./") ? prefix.slice(2) : prefix;
+  const baseDir = join(installPath, relativePrefix);
+
+  let files: string[];
+  try {
+    files = listFilesRecursive(baseDir);
+  } catch {
+    return [];
+  }
+
+  const declarationFiles = files.filter(isDeclarationFile);
+  const candidates = declarationFiles.length > 0 ? declarationFiles : files;
+
+  const expanded: string[] = [];
+  for (const file of candidates) {
+    const rel = posix.join(prefix, file);
+    expanded.push(rel.startsWith("./") ? rel : `./${rel}`);
+    if (expanded.length >= limit) {
+      break;
+    }
+  }
+
+  expanded.sort(compareBytes);
+  return expanded;
+}
+
+function isDeclarationFile(path: string): boolean {
+  return path.endsWith(".d.ts") || path.endsWith(".d.cts") || path.endsWith(".d.mts");
+}
+
+function listFilesRecursive(dir: string, relative = ""): string[] {
+  const files: string[] = [];
+
+  for (const entry of nodeFileSystem.readDir(dir)) {
+    const full = join(dir, entry.name);
+    const rel = relative ? posix.join(relative, entry.name) : entry.name;
+    if (entry.isDirectory) {
+      files.push(...listFilesRecursive(full, rel));
+    } else {
+      files.push(rel);
+    }
+  }
+
+  return files;
+}

package/src/forge/compiler/package-graph/extract-dts.ts

@@ -1,32 +1,32 @@
-import type { ExportSignature } from "../types/package-graph.ts";
-import { compareExports } from "../primitives/sort.ts";
-import { readTextFile } from "./read-file.ts";
-import type { ResolutionMode } from "../types/runtime.ts";
-import {
-  DtsSignatureExtractor,
-  normalizeSignatureText,
-} from "./dts-extractor.ts";
-
-export { normalizeSignatureText };
-
-export function extractDtsSignatures(
-  dtsPath: string,
-  packageName: string,
-  entrypoint: string,
-  mode: ResolutionMode,
-): ExportSignature[] {
-  const extractor = new DtsSignatureExtractor(mode);
-  return extractor.extract(dtsPath, packageName, entrypoint);
-}
-
-export function canParseDtsFile(dtsPath: string, mode: ResolutionMode): boolean {
-  try {
-    readTextFile(dtsPath);
-    const exports = extractDtsSignatures(dtsPath, "probe", ".", mode);
-    return exports.length >= 0;
-  } catch {
-    return false;
-  }
-}
-
-export { compareExports, DtsSignatureExtractor };
+import type { ExportSignature } from "../types/package-graph.ts";
+import { compareExports } from "../primitives/sort.ts";
+import { readTextFile } from "./read-file.ts";
+import type { ResolutionMode } from "../types/runtime.ts";
+import {
+  DtsSignatureExtractor,
+  normalizeSignatureText,
+} from "./dts-extractor.ts";
+
+export { normalizeSignatureText };
+
+export function extractDtsSignatures(
+  dtsPath: string,
+  packageName: string,
+  entrypoint: string,
+  mode: ResolutionMode,
+): ExportSignature[] {
+  const extractor = new DtsSignatureExtractor(mode);
+  return extractor.extract(dtsPath, packageName, entrypoint);
+}
+
+export function canParseDtsFile(dtsPath: string, mode: ResolutionMode): boolean {
+  try {
+    readTextFile(dtsPath);
+    const exports = extractDtsSignatures(dtsPath, "probe", ".", mode);
+    return exports.length >= 0;
+  } catch {
+    return false;
+  }
+}
+
+export { compareExports, DtsSignatureExtractor };

package/src/forge/compiler/package-graph/index.ts

@@ -7,27 +7,27 @@ export {
   PackageGraphCompiler,
   recomputeFromInputs,
 } from "./compiler.ts";
-export type {
-  BuildOptions,
-  AnalyzeResult,
-  BuildResult,
-} from "./compiler.ts";
-export {
-  resolveEntrypointTypes,
-  moduleSpecifierForSubpath,
-  createResolutionCompilerOptions,
-  typesPackageName,
-} from "./resolve.ts";
-export {
-  discoverSubpathsFromExports,
-  expandPatternSubpaths,
-} from "./exports-discovery.ts";
-export { extractDtsSignatures, normalizeSignatureText } from "./extract-dts.ts";
-export { extractJsDoc, extractExamples } from "./jsdoc.ts";
-export {
-  hashPackageJson,
-  hashDtsFiles,
-  computeContentChecksum,
-} from "./checksum.ts";
-export { setReadFileTracker } from "./read-file.ts";
-export type { ReadFileTracker } from "./read-file.ts";
+export type {
+  BuildOptions,
+  AnalyzeResult,
+  BuildResult,
+} from "./compiler.ts";
+export {
+  resolveEntrypointTypes,
+  moduleSpecifierForSubpath,
+  createResolutionCompilerOptions,
+  typesPackageName,
+} from "./resolve.ts";
+export {
+  discoverSubpathsFromExports,
+  expandPatternSubpaths,
+} from "./exports-discovery.ts";
+export { extractDtsSignatures, normalizeSignatureText } from "./extract-dts.ts";
+export { extractJsDoc, extractExamples } from "./jsdoc.ts";
+export {
+  hashPackageJson,
+  hashDtsFiles,
+  computeContentChecksum,
+} from "./checksum.ts";
+export { setReadFileTracker } from "./read-file.ts";
+export type { ReadFileTracker } from "./read-file.ts";

package/src/forge/compiler/package-graph/jsdoc.ts

@@ -1,6 +1,6 @@
-import ts from "typescript";
-import type { JsDoc } from "../types/package-graph.ts";
-
+import ts from "typescript";
+import type { JsDoc } from "../types/package-graph.ts";
+
 function tagText(tag: ts.JSDocTag): string {
   if (typeof tag.comment === "string") {
     return tag.comment.trim();
@@ -13,50 +13,50 @@ function tagText(tag: ts.JSDocTag): string {
   }
   return "";
 }
-
-export function extractJsDoc(
-  symbol: ts.Symbol,
-  checker: ts.TypeChecker,
-): JsDoc | null {
-  const parts = symbol.getDocumentationComment(checker);
-  const summary = ts.displayPartsToString(parts).trim();
-
-  const tags: { tag: string; text: string }[] = [];
-  for (const decl of symbol.declarations ?? []) {
-    for (const tag of ts.getJSDocTags(decl)) {
-      tags.push({
-        tag: tag.tagName.text,
-        text: tagText(tag),
-      });
-    }
-  }
-
-  if (summary.length === 0 && tags.length === 0) {
-    return null;
-  }
-
-  tags.sort((a, b) => {
-    const tagCmp = a.tag.localeCompare(b.tag);
-    if (tagCmp !== 0) return tagCmp;
-    return a.text.localeCompare(b.text);
-  });
-
-  return { summary, tags };
-}
-
-export function extractExamples(jsdoc: JsDoc | null): string[] {
-  if (jsdoc == null) {
-    return [];
-  }
-
-  const examples = jsdoc.tags
-    .filter((tag) => tag.tag.toLowerCase() === "example")
-    .map((tag) => normalizeExample(tag.text))
-    .filter((text) => text.length > 0);
-
-  return [...new Set(examples)].sort((a, b) => a.localeCompare(b));
-}
-
-function normalizeExample(text: string): string {
-  return text.replace(/\r\n/g, "\n").trim();
-}
+
+export function extractJsDoc(
+  symbol: ts.Symbol,
+  checker: ts.TypeChecker,
+): JsDoc | null {
+  const parts = symbol.getDocumentationComment(checker);
+  const summary = ts.displayPartsToString(parts).trim();
+
+  const tags: { tag: string; text: string }[] = [];
+  for (const decl of symbol.declarations ?? []) {
+    for (const tag of ts.getJSDocTags(decl)) {
+      tags.push({
+        tag: tag.tagName.text,
+        text: tagText(tag),
+      });
+    }
+  }
+
+  if (summary.length === 0 && tags.length === 0) {
+    return null;
+  }
+
+  tags.sort((a, b) => {
+    const tagCmp = a.tag.localeCompare(b.tag);
+    if (tagCmp !== 0) return tagCmp;
+    return a.text.localeCompare(b.text);
+  });
+
+  return { summary, tags };
+}
+
+export function extractExamples(jsdoc: JsDoc | null): string[] {
+  if (jsdoc == null) {
+    return [];
+  }
+
+  const examples = jsdoc.tags
+    .filter((tag) => tag.tag.toLowerCase() === "example")
+    .map((tag) => normalizeExample(tag.text))
+    .filter((text) => text.length > 0);
+
+  return [...new Set(examples)].sort((a, b) => a.localeCompare(b));
+}
+
+function normalizeExample(text: string): string {
+  return text.replace(/\r\n/g, "\n").trim();
+}