adnbn 0.9.0 → 0.11.0

package/dist/cli/bundler/utils/output.js

@@ -1,15 +1,173 @@
 import _ from "lodash";
 import path from "path";
-const appFilenameResolver = (app, filename, dirname) => (pathData, assetInfo) => {
+import postcss from "postcss";
+import valueParser from "postcss-value-parser";
+import { toPosix } from "./../../../cli/utils/path.js";
+const compilationBuildAssets = /* @__PURE__ */ new WeakMap();
+const appFilenameResolver = (app, filename, dirname) => {
   app = _.kebabCase(app);
-  let name = _.isFunction(filename) ? filename(pathData, assetInfo) : filename;
-  name = name.replaceAll("[app]", app);
-  if (dirname) {
-    return path.posix.join(dirname, name);
+  const resolve = (name) => {
+    name = name.replaceAll("[app]", app);
+    return dirname ? path.posix.join(dirname, name) : name;
+  };
+  if (!_.isFunction(filename)) {
+    return resolve(filename);
   }
-  return name;
+  return (pathData, assetInfo) => {
+    return resolve(filename(pathData, assetInfo));
+  };
+};
+const addRelatedSourceMaps = (sourceMaps, related) => {
+  const sourceMap = related == null ? void 0 : related.sourceMap;
+  if (Array.isArray(sourceMap)) {
+    sourceMap.forEach((file) => sourceMaps.add(toPosix(file)));
+  } else if (sourceMap) {
+    sourceMaps.add(toPosix(sourceMap));
+  }
+};
+const getRelatedSourceMaps = (compilation) => {
+  const sourceMaps = /* @__PURE__ */ new Set();
+  compilation.getAssets().forEach(({ info }) => addRelatedSourceMaps(sourceMaps, info.related));
+  return sourceMaps;
+};
+const isIgnoredAsset = (file, info, sourceMaps) => {
+  return Boolean(info.development || info.hotModuleReplacement || sourceMaps.has(file));
+};
+const classifyAsset = (file, info, fromModuleAssets) => {
+  if (info.assetType === "javascript") {
+    return "js";
+  }
+  if (info.assetType === "css" || info.assetType === "extract-css") {
+    return "css";
+  }
+  if (info.assetType || info.sourceFilename || fromModuleAssets) {
+    return "asset";
+  }
+  if (file.endsWith(".js") || file.endsWith(".mjs") || file.endsWith(".cjs")) {
+    return "js";
+  }
+  if (file.endsWith(".css")) {
+    return "css";
+  }
+  return "asset";
+};
+const getAssetKind = (compilation, file, sourceMaps, fromModuleAssets = false) => {
+  file = toPosix(file);
+  const asset = compilation.getAsset(file);
+  if (!asset || isIgnoredAsset(file, asset.info, sourceMaps)) {
+    return;
+  }
+  return classifyAsset(file, asset.info, fromModuleAssets);
+};
+const getModuleAssetNames = (module) => {
+  var _a;
+  return Object.keys(((_a = module.buildInfo) == null ? void 0 : _a.assets) ?? {});
+};
+const collectResources = (compilation, chunks, sourceMaps) => {
+  var _a, _b;
+  const candidates = /* @__PURE__ */ new Map();
+  const cssFiles = /* @__PURE__ */ new Set();
+  const sourceFiles = /* @__PURE__ */ new Set();
+  for (const chunk of chunks) {
+    for (const file of [...chunk.files, ...chunk.auxiliaryFiles]) {
+      const normalized = toPosix(file);
+      candidates.set(normalized, candidates.get(normalized) ?? false);
+      if (getAssetKind(compilation, normalized, sourceMaps) === "css") cssFiles.add(normalized);
+    }
+    for (const module of compilation.chunkGraph.getChunkModulesIterable(chunk)) {
+      for (const file of getModuleAssetNames(module)) {
+        candidates.set(toPosix(file), true);
+      }
+      if (module.type === "css/mini-extract") {
+        for (const dependency of ((_a = module.buildInfo) == null ? void 0 : _a.fileDependencies) ?? [])
+          sourceFiles.add(path.resolve(dependency));
+      }
+    }
+  }
+  const resources = compilation.getAssets().filter(
+    (asset) => getAssetKind(compilation, asset.name, sourceMaps) === "asset" && (!asset.info.sourceFilename || sourceFiles.has(
+      path.resolve(compilation.compiler.context, asset.info.sourceFilename.split(/[?#]/)[0])
+    ))
+  ).map((asset) => asset.name).sort((left, right) => right.length - left.length);
+  for (const file of cssFiles) {
+    const css = (_b = compilation.getAsset(file)) == null ? void 0 : _b.source.source().toString();
+    if (!css) continue;
+    postcss.parse(css, { from: file }).walkDecls((declaration) => {
+      valueParser(declaration.value).walk((node) => {
+        if (node.type !== "function" || node.value.toLowerCase() !== "url") return;
+        const argument = node.nodes[0];
+        if (!argument || argument.type !== "string" && argument.type !== "word") return false;
+        const url = argument.value.replace(
+          /\\([\da-f]{1,6}\s?|.)/gi,
+          (_match, escape) => /^[\da-f]{1,6}\s?$/i.test(escape) ? String.fromCodePoint(parseInt(escape.trim(), 16) || 65533) : escape
+        );
+        if (/^(?:data|blob):/i.test(url)) return false;
+        try {
+          const pathname = decodeURIComponent(new URL(url, `https://adnbn.invalid/${file}`).pathname);
+          const resource = resources.find((candidate) => pathname.endsWith(`/${candidate}`));
+          if (resource) candidates.set(resource, true);
+        } catch {
+        }
+        return false;
+      });
+    });
+  }
+  return Array.from(candidates).filter(([file, fromModuleAssets]) => {
+    return getAssetKind(compilation, file, sourceMaps, fromModuleAssets) === "asset";
+  }).map(([file]) => file).toSorted();
+};
+const collectCodeFiles = (compilation, files, sourceMaps) => {
+  const css = /* @__PURE__ */ new Set();
+  const js = /* @__PURE__ */ new Set();
+  for (const rawFile of files) {
+    const file = toPosix(rawFile);
+    const kind = getAssetKind(compilation, file, sourceMaps);
+    if (kind === "js") {
+      js.add(file);
+    } else if (kind === "css") {
+      css.add(file);
+    }
+  }
+  return { js: Array.from(js), css: Array.from(css) };
+};
+const collectAsyncCodeFiles = (compilation, chunks, sourceMaps, initialFiles) => {
+  const files = /* @__PURE__ */ new Set();
+  for (const chunk of chunks) {
+    for (const file of [...chunk.files, ...chunk.auxiliaryFiles]) {
+      const normalized = toPosix(file);
+      if (!initialFiles.has(normalized)) {
+        files.add(normalized);
+      }
+    }
+  }
+  return collectCodeFiles(compilation, files, sourceMaps);
+};
+const collectBuildAssets = (compilation) => {
+  const sourceMaps = getRelatedSourceMaps(compilation);
+  const assets = /* @__PURE__ */ Object.create(null);
+  const entrypoints = Array.from(compilation.entrypoints).toSorted(([left], [right]) => left.localeCompare(right));
+  for (const [name, entrypoint] of entrypoints) {
+    const initial = collectCodeFiles(compilation, entrypoint.getFiles(), sourceMaps);
+    const initialFiles = /* @__PURE__ */ new Set([...initial.js, ...initial.css]);
+    const entryChunk = entrypoint.getEntrypointChunk();
+    assets[name] = {
+      initial,
+      async: collectAsyncCodeFiles(compilation, entryChunk.getAllAsyncChunks(), sourceMaps, initialFiles),
+      assets: collectResources(compilation, entryChunk.getAllReferencedChunks(), sourceMaps)
+    };
+  }
+  return assets;
+};
+const setCompilationBuildAssets = (compilation, assets) => {
+  compilationBuildAssets.set(compilation, assets);
+};
+const getCompilationBuildAssets = (compilation) => {
+  return compilationBuildAssets.get(compilation);
 };
 export {
-  appFilenameResolver
+  appFilenameResolver,
+  collectBuildAssets,
+  getCompilationBuildAssets,
+  setCompilationBuildAssets
 };
 //# sourceMappingURL=output.js.map

package/dist/cli/bundler/utils/output.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/cli/bundler/utils/output.ts"],"sourcesContent":["import {Filename} from \"@rspack/core\";\nimport _ from \"lodash\";\nimport path from \"path\";\n\n// prettier-ignore\nexport const appFilenameResolver =\n    (app: string, filename: Filename, dirname?: string): Extract<Filename, Filename> =>\n        (pathData, assetInfo): string => {\n            app = _.kebabCase(app);\n\n            let name = _.isFunction(filename) ? filename(pathData, assetInfo) : filename;\n\n            name = name.replaceAll(\"[app]\", app);\n\n            if (dirname) {\n                return path.posix.join(dirname, name);\n            }\n\n            return name;\n        };\n"],"mappings":"AACA,OAAO,OAAO;AACd,OAAO,UAAU;AAGV,MAAM,sBACT,CAAC,KAAa,UAAoB,YAC9B,CAAC,UAAU,cAAsB;AAC7B,QAAM,EAAE,UAAU,GAAG;AAErB,MAAI,OAAO,EAAE,WAAW,QAAQ,IAAI,SAAS,UAAU,SAAS,IAAI;AAEpE,SAAO,KAAK,WAAW,SAAS,GAAG;AAEnC,MAAI,SAAS;AACT,WAAO,KAAK,MAAM,KAAK,SAAS,IAAI;AAAA,EACxC;AAEA,SAAO;AACX;","names":[]}
+{"version":3,"sources":["../../../../src/cli/bundler/utils/output.ts"],"sourcesContent":["import type {AssetInfo, Chunk, Compilation, Filename, Module} from \"@rspack/core\";\nimport _ from \"lodash\";\nimport path from \"path\";\nimport postcss from \"postcss\";\nimport valueParser from \"postcss-value-parser\";\n\nimport {toPosix} from \"@cli/utils/path\";\n\nimport type {EntrypointAssetsMap, EntrypointAssetsMapEntry, EntrypointAssetsFiles} from \"@typing/entrypoint\";\n\ntype AssetKind = \"asset\" | \"css\" | \"js\";\n\nconst compilationBuildAssets = new WeakMap<Compilation, EntrypointAssetsMap>();\n\n// prettier-ignore\nexport const appFilenameResolver =\n    (app: string, filename: Filename, dirname?: string): Filename => {\n        app = _.kebabCase(app);\n\n        const resolve = (name: string): string => {\n            name = name.replaceAll(\"[app]\", app);\n\n            return dirname ? path.posix.join(dirname, name) : name;\n        };\n\n        if (!_.isFunction(filename)) {\n            return resolve(filename);\n        }\n\n        return (pathData, assetInfo): string => {\n            return resolve(filename(pathData, assetInfo));\n        };\n    };\n\nconst addRelatedSourceMaps = (sourceMaps: Set<string>, related: AssetInfo[\"related\"]): void => {\n    const sourceMap = related?.sourceMap;\n\n    if (Array.isArray(sourceMap)) {\n        sourceMap.forEach(file => sourceMaps.add(toPosix(file)));\n    } else if (sourceMap) {\n        sourceMaps.add(toPosix(sourceMap));\n    }\n};\n\nconst getRelatedSourceMaps = (compilation: Compilation): ReadonlySet<string> => {\n    const sourceMaps = new Set<string>();\n\n    compilation.getAssets().forEach(({info}) => addRelatedSourceMaps(sourceMaps, info.related));\n\n    return sourceMaps;\n};\n\nconst isIgnoredAsset = (file: string, info: AssetInfo, sourceMaps: ReadonlySet<string>): boolean => {\n    return Boolean(info.development || info.hotModuleReplacement || sourceMaps.has(file));\n};\n\nconst classifyAsset = (file: string, info: AssetInfo, fromModuleAssets: boolean): AssetKind => {\n    if (info.assetType === \"javascript\") {\n        return \"js\";\n    }\n\n    if (info.assetType === \"css\" || info.assetType === \"extract-css\") {\n        return \"css\";\n    }\n\n    if (info.assetType || info.sourceFilename || fromModuleAssets) {\n        return \"asset\";\n    }\n\n    if (file.endsWith(\".js\") || file.endsWith(\".mjs\") || file.endsWith(\".cjs\")) {\n        return \"js\";\n    }\n\n    if (file.endsWith(\".css\")) {\n        return \"css\";\n    }\n\n    return \"asset\";\n};\n\nconst getAssetKind = (\n    compilation: Compilation,\n    file: string,\n    sourceMaps: ReadonlySet<string>,\n    fromModuleAssets = false\n): AssetKind | undefined => {\n    file = toPosix(file);\n\n    const asset = compilation.getAsset(file);\n\n    if (!asset || isIgnoredAsset(file, asset.info, sourceMaps)) {\n        return;\n    }\n\n    return classifyAsset(file, asset.info, fromModuleAssets);\n};\n\nconst getModuleAssetNames = (module: Module): readonly string[] => {\n    return Object.keys(module.buildInfo?.assets ?? {});\n};\n\nconst collectResources = (\n    compilation: Compilation,\n    chunks: Iterable<Chunk>,\n    sourceMaps: ReadonlySet<string>\n): readonly string[] => {\n    const candidates = new Map<string, boolean>();\n    const cssFiles = new Set<string>();\n    const sourceFiles = new Set<string>();\n\n    for (const chunk of chunks) {\n        for (const file of [...chunk.files, ...chunk.auxiliaryFiles]) {\n            const normalized = toPosix(file);\n\n            candidates.set(normalized, candidates.get(normalized) ?? false);\n            if (getAssetKind(compilation, normalized, sourceMaps) === \"css\") cssFiles.add(normalized);\n        }\n\n        for (const module of compilation.chunkGraph.getChunkModulesIterable(chunk)) {\n            for (const file of getModuleAssetNames(module)) {\n                candidates.set(toPosix(file), true);\n            }\n            if (module.type === \"css/mini-extract\") {\n                for (const dependency of module.buildInfo?.fileDependencies ?? [])\n                    sourceFiles.add(path.resolve(dependency));\n            }\n        }\n    }\n\n    // CssExtract executes url() asset modules during the build. They are not\n    // runtime chunk modules, so follow the emitted CSS references as well.\n    // This only reads assets; it never rewrites CSS or its filenames.\n    const resources = compilation\n        .getAssets()\n        .filter(\n            asset =>\n                getAssetKind(compilation, asset.name, sourceMaps) === \"asset\" &&\n                (!asset.info.sourceFilename ||\n                    sourceFiles.has(\n                        path.resolve(compilation.compiler.context, asset.info.sourceFilename.split(/[?#]/)[0])\n                    ))\n        )\n        .map(asset => asset.name)\n        .sort((left, right) => right.length - left.length);\n    for (const file of cssFiles) {\n        const css = compilation.getAsset(file)?.source.source().toString();\n        if (!css) continue;\n        postcss.parse(css, {from: file}).walkDecls(declaration => {\n            valueParser(declaration.value).walk(node => {\n                if (node.type !== \"function\" || node.value.toLowerCase() !== \"url\") return;\n                const argument = node.nodes[0];\n                if (!argument || (argument.type !== \"string\" && argument.type !== \"word\")) return false;\n                const url = argument.value.replace(/\\\\([\\da-f]{1,6}\\s?|.)/gi, (_match, escape: string) =>\n                    /^[\\da-f]{1,6}\\s?$/i.test(escape)\n                        ? String.fromCodePoint(parseInt(escape.trim(), 16) || 0xfffd)\n                        : escape\n                );\n                if (/^(?:data|blob):/i.test(url)) return false;\n                try {\n                    const pathname = decodeURIComponent(new URL(url, `https://adnbn.invalid/${file}`).pathname);\n                    const resource = resources.find(candidate => pathname.endsWith(`/${candidate}`));\n                    if (resource) candidates.set(resource, true);\n                } catch {\n                    // External or malformed URLs do not name an emitted build resource.\n                }\n                return false;\n            });\n        });\n    }\n\n    return Array.from(candidates)\n        .filter(([file, fromModuleAssets]) => {\n            return getAssetKind(compilation, file, sourceMaps, fromModuleAssets) === \"asset\";\n        })\n        .map(([file]) => file)\n        .toSorted();\n};\n\nconst collectCodeFiles = (\n    compilation: Compilation,\n    files: Iterable<string>,\n    sourceMaps: ReadonlySet<string>\n): EntrypointAssetsFiles => {\n    const css = new Set<string>();\n    const js = new Set<string>();\n\n    for (const rawFile of files) {\n        const file = toPosix(rawFile);\n        const kind = getAssetKind(compilation, file, sourceMaps);\n\n        if (kind === \"js\") {\n            js.add(file);\n        } else if (kind === \"css\") {\n            css.add(file);\n        }\n    }\n\n    return {js: Array.from(js), css: Array.from(css)};\n};\n\nconst collectAsyncCodeFiles = (\n    compilation: Compilation,\n    chunks: Iterable<Chunk>,\n    sourceMaps: ReadonlySet<string>,\n    initialFiles: ReadonlySet<string>\n): EntrypointAssetsFiles => {\n    const files = new Set<string>();\n\n    for (const chunk of chunks) {\n        for (const file of [...chunk.files, ...chunk.auxiliaryFiles]) {\n            const normalized = toPosix(file);\n\n            if (!initialFiles.has(normalized)) {\n                files.add(normalized);\n            }\n        }\n    }\n\n    return collectCodeFiles(compilation, files, sourceMaps);\n};\n\nexport const collectBuildAssets = (compilation: Compilation): EntrypointAssetsMap => {\n    const sourceMaps = getRelatedSourceMaps(compilation);\n    const assets = Object.create(null) as Record<string, EntrypointAssetsMapEntry>;\n\n    const entrypoints = Array.from(compilation.entrypoints).toSorted(([left], [right]) => left.localeCompare(right));\n\n    for (const [name, entrypoint] of entrypoints) {\n        const initial = collectCodeFiles(compilation, entrypoint.getFiles(), sourceMaps);\n        const initialFiles = new Set([...initial.js, ...initial.css]);\n        const entryChunk = entrypoint.getEntrypointChunk();\n\n        assets[name] = {\n            initial,\n            async: collectAsyncCodeFiles(compilation, entryChunk.getAllAsyncChunks(), sourceMaps, initialFiles),\n            assets: collectResources(compilation, entryChunk.getAllReferencedChunks(), sourceMaps),\n        };\n    }\n\n    return assets;\n};\n\nexport const setCompilationBuildAssets = (compilation: Compilation, assets: EntrypointAssetsMap): void => {\n    compilationBuildAssets.set(compilation, assets);\n};\n\nexport const getCompilationBuildAssets = (compilation: Compilation): EntrypointAssetsMap | undefined => {\n    return compilationBuildAssets.get(compilation);\n};\n"],"mappings":"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","names":[]}

package/dist/cli/bundler/utils/styles.d.ts

@@ -0,0 +1,5 @@
+import type { Chunk, Compilation, Module } from "@rspack/core";
+export declare const IsolatedStylesLayer = "adnbn:css:isolation";
+export declare const isIsolatedStylesModule: (module: Module) => boolean;
+export declare const isIsolatedStylesChunk: (compilation: Compilation, chunk: Chunk) => boolean;
+export declare const getIsolatedStylesFiles: (compilation: Compilation) => ReadonlySet<string>;

package/dist/cli/bundler/utils/styles.js

@@ -0,0 +1,30 @@
+const IsolatedStylesLayer = "adnbn:css:isolation";
+const isIsolatedStylesModule = (module) => module.type === "css/mini-extract" && module.layer === IsolatedStylesLayer;
+const isIsolatedStylesChunk = (compilation, chunk) => {
+  const modules = [...compilation.chunkGraph.getChunkModulesIterable(chunk)].filter(
+    (module) => module.type === "css/mini-extract"
+  );
+  const isolated = modules.some(isIsolatedStylesModule);
+  if (isolated && !modules.every(isIsolatedStylesModule)) {
+    throw new Error(
+      `CSS chunk "${chunk.name ?? chunk.id}" mixes document and ?isolation styles. Preserve the adnbnIsolatedStyles CSS cache group in your bundler configuration.`
+    );
+  }
+  return isolated;
+};
+const getIsolatedStylesFiles = (compilation) => {
+  const files = /* @__PURE__ */ new Set();
+  for (const chunk of compilation.chunks) {
+    if (isIsolatedStylesChunk(compilation, chunk)) {
+      for (const file of chunk.files) if (file.endsWith(".css")) files.add(file);
+    }
+  }
+  return files;
+};
+export {
+  IsolatedStylesLayer,
+  getIsolatedStylesFiles,
+  isIsolatedStylesChunk,
+  isIsolatedStylesModule
+};
+//# sourceMappingURL=styles.js.map

package/dist/cli/bundler/utils/styles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/cli/bundler/utils/styles.ts"],"sourcesContent":["import type {Chunk, Compilation, Module} from \"@rspack/core\";\n\n// This is a bundler layer, not a CSS @layer. A distinct css-loader identity is\n// also required: CssExtract deduplicates dependencies by their loader request.\nexport const IsolatedStylesLayer = \"adnbn:css:isolation\";\n\nexport const isIsolatedStylesModule = (module: Module): boolean =>\n    module.type === \"css/mini-extract\" && module.layer === IsolatedStylesLayer;\n\nexport const isIsolatedStylesChunk = (compilation: Compilation, chunk: Chunk): boolean => {\n    const modules = [...compilation.chunkGraph.getChunkModulesIterable(chunk)].filter(\n        module => module.type === \"css/mini-extract\"\n    );\n    const isolated = modules.some(isIsolatedStylesModule);\n    if (isolated && !modules.every(isIsolatedStylesModule)) {\n        throw new Error(\n            `CSS chunk \"${chunk.name ?? chunk.id}\" mixes document and ?isolation styles. Preserve the adnbnIsolatedStyles CSS cache group in your bundler configuration.`\n        );\n    }\n    return isolated;\n};\n\nexport const getIsolatedStylesFiles = (compilation: Compilation): ReadonlySet<string> => {\n    const files = new Set<string>();\n    for (const chunk of compilation.chunks) {\n        if (isIsolatedStylesChunk(compilation, chunk)) {\n            for (const file of chunk.files) if (file.endsWith(\".css\")) files.add(file);\n        }\n    }\n    return files;\n};\n"],"mappings":"AAIO,MAAM,sBAAsB;AAE5B,MAAM,yBAAyB,CAAC,WACnC,OAAO,SAAS,sBAAsB,OAAO,UAAU;AAEpD,MAAM,wBAAwB,CAAC,aAA0B,UAA0B;AACtF,QAAM,UAAU,CAAC,GAAG,YAAY,WAAW,wBAAwB,KAAK,CAAC,EAAE;AAAA,IACvE,YAAU,OAAO,SAAS;AAAA,EAC9B;AACA,QAAM,WAAW,QAAQ,KAAK,sBAAsB;AACpD,MAAI,YAAY,CAAC,QAAQ,MAAM,sBAAsB,GAAG;AACpD,UAAM,IAAI;AAAA,MACN,cAAc,MAAM,QAAQ,MAAM,EAAE;AAAA,IACxC;AAAA,EACJ;AACA,SAAO;AACX;AAEO,MAAM,yBAAyB,CAAC,gBAAkD;AACrF,QAAM,QAAQ,oBAAI,IAAY;AAC9B,aAAW,SAAS,YAAY,QAAQ;AACpC,QAAI,sBAAsB,aAAa,KAAK,GAAG;AAC3C,iBAAW,QAAQ,MAAM,MAAO,KAAI,KAAK,SAAS,MAAM,EAAG,OAAM,IAAI,IAAI;AAAA,IAC7E;AAAA,EACJ;AACA,SAAO;AACX;","names":[]}

package/dist/cli/entrypoint/file/ExpressionFile.d.ts

@@ -1,6 +1,6 @@
 import ts from "typescript";
 import SourceFile from "./SourceFile.js";
-import { MemberSignature } from "./parsers/types.js";
+import type { ExportValue, MemberSignature } from "./parsers/types.js";
 /**
  * Parses a TypeScript expression (object literal, function, or class)
  * and builds a full interface of its public members (methods and properties).
@@ -18,7 +18,10 @@ export default class ExpressionFile extends SourceFile {
     private readonly objectParser;
     private readonly classParser;
     private readonly jsDocParser;
+    private readonly exportParser;
     constructor(filePath: string);
+    /** Returns export metadata; consumers decide what that export means for their entrypoint. */
+    getDefaultExport(): ExportValue | undefined;
     getType(): string | undefined;
     setProperty(property: string): this;
     /**

package/dist/cli/entrypoint/file/ExpressionFile.js

@@ -2,6 +2,7 @@ import ts from "typescript";
 import SourceFile from "./SourceFile.js";
 import {
   ClassParser,
+  ExportParser,
   FunctionParser,
   JSDocParser,
   NodeFinder,
@@ -23,6 +24,7 @@ class ExpressionFile extends SourceFile {
   objectParser;
   classParser;
   jsDocParser;
+  exportParser;
   constructor(filePath) {
     super(filePath);
     this.typeResolver = new TypeResolver(this);
@@ -32,6 +34,15 @@ class ExpressionFile extends SourceFile {
     this.classParser = new ClassParser(this, this.typeResolver, this.signatureBuilder, this.nodeFinder);
     this.functionParser = new FunctionParser(this, this.nodeFinder, this.objectParser, this.classParser);
     this.jsDocParser = new JSDocParser();
+    this.exportParser = new ExportParser(
+      this,
+      this.nodeFinder,
+      () => this.getInputResolver().getTs().getConfig().options
+    );
+  }
+  /** Returns export metadata; consumers decide what that export means for their entrypoint. */
+  getDefaultExport() {
+    return this.exportParser.parseDefault();
   }
   getType() {
     if (this.property) {

package/dist/cli/entrypoint/file/ExpressionFile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/cli/entrypoint/file/ExpressionFile.ts"],"sourcesContent":["import ts from \"typescript\";\n\nimport SourceFile from \"./SourceFile\";\nimport {\n    ClassParser,\n    FunctionParser,\n    JSDocParser,\n    NodeFinder,\n    ObjectParser,\n    SignatureBuilder,\n    TypeResolver,\n} from \"./parsers\";\nimport {MemberSignature} from \"./parsers/types\";\n\nimport {PackageName} from \"@typing/app\";\n\n/**\n * Parses a TypeScript expression (object literal, function, or class)\n * and builds a full interface of its public members (methods and properties).\n */\nexport default class ExpressionFile extends SourceFile {\n    protected property?: string;\n    /**\n     * Names of wrapper functions whose first argument should be unwrapped for parsing.\n     */\n    protected definition = new Set<string>();\n\n    private readonly typeResolver: TypeResolver;\n    private readonly nodeFinder: NodeFinder;\n    private readonly signatureBuilder: SignatureBuilder;\n    private readonly functionParser: FunctionParser;\n    private readonly objectParser: ObjectParser;\n    private readonly classParser: ClassParser;\n    private readonly jsDocParser: JSDocParser;\n\n    constructor(filePath: string) {\n        super(filePath);\n\n        this.typeResolver = new TypeResolver(this);\n        this.nodeFinder = new NodeFinder(this);\n        this.signatureBuilder = new SignatureBuilder(this.typeResolver);\n        this.objectParser = new ObjectParser(this, this.signatureBuilder);\n        this.classParser = new ClassParser(this, this.typeResolver, this.signatureBuilder, this.nodeFinder);\n        this.functionParser = new FunctionParser(this, this.nodeFinder, this.objectParser, this.classParser);\n        this.jsDocParser = new JSDocParser();\n    }\n\n    public getType(): string | undefined {\n        // If a specific variable or property is requested, extract its type\n        if (this.property) {\n            // 1) Named variable scenario: e.g. export const init = () => ...\n            const varDecl = this.nodeFinder.findVariableDeclaration(this.property);\n\n            if (varDecl && varDecl.initializer) {\n                return this.getTypeFromInitializer(varDecl.initializer);\n            }\n\n            // 2) Property on default export object: unwrap and look up key\n            let exportExpr: ts.Expression | undefined;\n            const sf = this.getSourceFile();\n\n            const findExport = (node: ts.Node) => {\n                if (ts.isExportAssignment(node)) {\n                    exportExpr = node.expression;\n                }\n                ts.forEachChild(node, findExport);\n            };\n\n            findExport(sf);\n\n            if (!exportExpr) return undefined;\n\n            // Special case for service definitions with JSDoc annotations\n            if (this.definition.size > 0 && ts.isCallExpression(exportExpr) && ts.isIdentifier(exportExpr.expression)) {\n                const fnName = exportExpr.expression.text;\n\n                if (this.definition.has(fnName)) {\n                    // Check if the wrapper function is imported from the designated package name\n                    let importPath: string | undefined;\n                    try {\n                        importPath = this.getImports().get(fnName);\n                    } catch {\n                        // unable to resolve import source -> ignore wrapper\n                        return undefined;\n                    }\n\n                    if (importPath !== PackageName) {\n                        // Function is not imported from the designated package name -> ignore wrapper\n                        console.warn(`Function ${fnName} is not imported from '${PackageName}' in file ${this.file}`);\n                        return undefined;\n                    }\n\n                    if (exportExpr.arguments.length > 0) {\n                        const firstArg = exportExpr.arguments[0];\n\n                        if (ts.isObjectLiteralExpression(firstArg)) {\n                            for (const prop of firstArg.properties) {\n                                const key = this.objectParser.getName(prop.name ?? prop);\n\n                                if (key !== this.property) continue;\n\n                                if (ts.isPropertyAssignment(prop)) {\n                                    const initType = this.getTypeFromInitializer(prop.initializer);\n                                    if (initType) return initType;\n                                } else if (ts.isMethodDeclaration(prop)) {\n                                    // Get the return type of the method\n                                    const returnType = this.getTypeFromMethodReturn(prop);\n                                    if (returnType) return returnType;\n                                } else if (ts.isShorthandPropertyAssignment(prop)) {\n                                    return this.resolveTypeFromShorthand(prop.name.text);\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n\n            const expr = this.unwrapExpression(exportExpr);\n\n            if (ts.isObjectLiteralExpression(expr)) {\n                for (const prop of expr.properties) {\n                    const key = this.objectParser.getName(prop.name ?? prop);\n\n                    if (key !== this.property) continue;\n\n                    if (ts.isPropertyAssignment(prop)) {\n                        return this.getTypeFromInitializer(prop.initializer);\n                    } else if (ts.isMethodDeclaration(prop) || ts.isGetAccessorDeclaration(prop)) {\n                        const sig = this.signatureBuilder.getMethodSignature(prop as ts.MethodDeclaration);\n\n                        return this.signatureBuilder.buildFunctionType(sig);\n                    } else if (ts.isShorthandPropertyAssignment(prop)) {\n                        return this.resolveTypeFromShorthand(prop.name.text);\n                    }\n                }\n                return undefined;\n            }\n\n            // Fallback: treat default export expression as initializer\n            return this.getTypeFromInitializer(expr);\n        }\n\n        // Default: parse full default export into interface-like string\n        let members: Record<string, MemberSignature> | undefined;\n        const sf = this.getSourceFile();\n\n        const collect = (node: ts.Node) => {\n            if (ts.isExportAssignment(node)) {\n                const expr0 = node.expression;\n                const expr = this.unwrapExpression(expr0);\n                const parsed = this.parse(expr);\n                if (parsed) members = parsed;\n            }\n            ts.forEachChild(node, collect);\n        };\n\n        collect(sf);\n        if (!members) return undefined;\n        return this.signatureBuilder.formatMembers(members);\n    }\n\n    public setProperty(property: string): this {\n        this.property = property;\n\n        return this;\n    }\n\n    /**\n     * Entry point: accepts an expression and returns a map of member signatures,\n     * or undefined if the expression cannot be parsed.\n     */\n    protected parse(expr: ts.Expression): Record<string, MemberSignature> | undefined {\n        if (ts.isFunctionExpression(expr) || ts.isArrowFunction(expr)) {\n            return this.functionParser.parse(expr);\n        } else if (ts.isObjectLiteralExpression(expr)) {\n            return this.objectParser.parse(expr);\n        } else if (ts.isClassExpression(expr)) {\n            return this.classParser.parse(expr);\n        }\n\n        return undefined;\n    }\n\n    /**\n     * Specify wrapper functions whose first argument should be unwrapped for parsing.\n     */\n    public setDefinition(definition: string | string[]): this {\n        const defs = typeof definition === \"string\" ? [definition] : definition;\n\n        defs.forEach(def => this.definition.add(def));\n\n        return this;\n    }\n\n    /**\n     * Recursively unwraps type assertions, satisfies, parentheses, and allowed wrapper calls.\n     */\n    private unwrapExpression(expr: ts.Expression): ts.Expression {\n        // First use the AbstractExpressionParser's unwrapExpression for basic unwrapping\n        expr = this.functionParser.unwrapExpression(expr);\n\n        // Explicitly handle type assertions\n        if (ts.isAsExpression(expr)) {\n            return this.unwrapExpression(expr.expression);\n        }\n\n        // Then handle the additional unwrapping for known definition wrappers\n        if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {\n            const fnName = expr.expression.text;\n\n            if (this.definition.has(fnName)) {\n                let importPath: string | undefined;\n\n                try {\n                    importPath = this.getImports().get(fnName);\n                } catch {\n                    // unable to resolve import source -> ignore wrapper\n                    return expr;\n                }\n\n                if (importPath !== PackageName) {\n                    console.warn(`Function ${fnName} is not imported from '${PackageName}' in file ${this.file}`);\n                } else if (expr.arguments.length > 0) {\n                    const first = expr.arguments[0];\n                    return this.unwrapExpression(first as ts.Expression);\n                }\n            }\n        }\n\n        return expr;\n    }\n\n    /**\n     * Given an initializer or expression, extracts its type: function signature or interface.\n     */\n    private getTypeFromInitializer(\n        node: ts.Expression | ts.MethodDeclaration | ts.GetAccessorDeclaration\n    ): string | undefined {\n        // Unwrap type assertions\n        if (ts.isAsExpression(node)) {\n            return this.getTypeFromInitializer(node.expression);\n        }\n\n        // Function or arrow function: try to parse returned object or instance\n        if (ts.isFunctionExpression(node) || ts.isArrowFunction(node)) {\n            // attempt to parse returned expression into members\n            const members = this.functionParser.parse(node as ts.FunctionExpression | ts.ArrowFunction);\n\n            if (members) {\n                return this.signatureBuilder.formatMembers(members);\n            }\n\n            // fallback to function signature\n            const sig = this.signatureBuilder.getMethodSignature(node as ts.FunctionExpression | ts.ArrowFunction);\n\n            return this.signatureBuilder.buildFunctionType(sig);\n        }\n\n        // Class or method-like: signature of accessor/method\n        if (ts.isMethodDeclaration(node) || ts.isGetAccessorDeclaration(node)) {\n            const sig = this.signatureBuilder.getMethodSignature(node as ts.MethodDeclaration);\n            return this.signatureBuilder.buildFunctionType(sig);\n        }\n\n        // Object literal, class expression/declaration, or new expression: return interface of members\n        let members: Record<string, MemberSignature> | undefined;\n\n        if (ts.isObjectLiteralExpression(node) || ts.isClassExpression(node) || ts.isClassDeclaration(node)) {\n            members = this.parse(node as ts.Expression);\n        } else if (ts.isNewExpression(node)) {\n            const ctor = node.expression;\n\n            if (ts.isIdentifier(ctor)) {\n                members = this.classParser.parseFileClass(ctor.text);\n            } else if (ts.isClassExpression(ctor)) {\n                members = this.classParser.parse(ctor);\n            }\n        }\n\n        if (members) {\n            return this.signatureBuilder.formatMembers(members);\n        }\n\n        if (ts.isLiteralExpression(node) || ts.isArrayLiteralExpression(node) || ts.isObjectLiteralExpression(node)) {\n            return this.objectParser.inferTypeFromExpression(node as ts.Expression);\n        }\n\n        return undefined;\n    }\n\n    private resolveTypeFromShorthand(name: string): string | undefined {\n        const varDecl = this.nodeFinder.findVariableDeclaration(name);\n        if (varDecl && varDecl.initializer) {\n            const t = this.getTypeFromInitializer(varDecl.initializer);\n            if (t) return t;\n        }\n        const variable = this.getVariables().get(name);\n        if (variable) {\n            const val = variable.value;\n            switch (typeof val) {\n                case \"string\":\n                    return \"string\";\n                case \"number\":\n                    return \"number\";\n                case \"boolean\":\n                    return \"boolean\";\n                case \"object\":\n                    if (val === null) return \"null\";\n                    if (Array.isArray(val)) return \"array\";\n                    return \"object\";\n                default:\n                    return \"any\";\n            }\n        }\n        return \"any\";\n    }\n\n    /**\n     * Extracts the type of the return value of a method, taking into account JSDoc annotations.\n     *\n     * @param method The method declaration to extract the return type from\n     * @returns The extracted return type as a string, or undefined if it cannot be extracted\n     */\n    private getTypeFromMethodReturn(method: ts.MethodDeclaration): string | undefined {\n        // Try to find a return statement in the method body\n        if (method.body) {\n            // First, check if there's a JSDoc return type annotation\n            const jsDocReturnType = this.jsDocParser.getJSDocReturnType(method);\n            if (jsDocReturnType) {\n                // If the return type is a new expression, try to parse it\n                if (jsDocReturnType.includes(\"new \")) {\n                    const className = jsDocReturnType.replace(\"new \", \"\").trim();\n                    const members = this.classParser.parseFileClass(className);\n                    if (members) {\n                        return this.signatureBuilder.formatMembers(members);\n                    }\n                }\n\n                // If the return type is a class name, try to parse it\n                const members = this.classParser.parseFileClass(jsDocReturnType);\n                if (members) {\n                    return this.signatureBuilder.formatMembers(members);\n                }\n\n                return jsDocReturnType;\n            }\n\n            // If there's no JSDoc return type, try to find a return statement\n            let returnExpr: ts.Expression | undefined;\n\n            const findReturn = (node: ts.Node): void => {\n                if (ts.isReturnStatement(node) && node.expression) {\n                    returnExpr = node.expression;\n                    return;\n                }\n                ts.forEachChild(node, findReturn);\n            };\n\n            findReturn(method.body);\n\n            if (returnExpr) {\n                return this.getTypeFromInitializer(returnExpr);\n            }\n        }\n\n        // If we couldn't find a return statement, use the method's return type\n        if (method.type) {\n            return this.typeResolver.resolveTypeNode(method.type);\n        }\n\n        return undefined;\n    }\n}\n"],"mappings":"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","names":["sf","members"]}
+{"version":3,"sources":["../../../../src/cli/entrypoint/file/ExpressionFile.ts"],"sourcesContent":["import ts from \"typescript\";\n\nimport SourceFile from \"./SourceFile\";\nimport {\n    ClassParser,\n    ExportParser,\n    FunctionParser,\n    JSDocParser,\n    NodeFinder,\n    ObjectParser,\n    SignatureBuilder,\n    TypeResolver,\n} from \"./parsers\";\nimport type {ExportValue, MemberSignature} from \"./parsers/types\";\n\nimport {PackageName} from \"@typing/app\";\n\n/**\n * Parses a TypeScript expression (object literal, function, or class)\n * and builds a full interface of its public members (methods and properties).\n */\nexport default class ExpressionFile extends SourceFile {\n    protected property?: string;\n    /**\n     * Names of wrapper functions whose first argument should be unwrapped for parsing.\n     */\n    protected definition = new Set<string>();\n\n    private readonly typeResolver: TypeResolver;\n    private readonly nodeFinder: NodeFinder;\n    private readonly signatureBuilder: SignatureBuilder;\n    private readonly functionParser: FunctionParser;\n    private readonly objectParser: ObjectParser;\n    private readonly classParser: ClassParser;\n    private readonly jsDocParser: JSDocParser;\n    private readonly exportParser: ExportParser;\n\n    constructor(filePath: string) {\n        super(filePath);\n\n        this.typeResolver = new TypeResolver(this);\n        this.nodeFinder = new NodeFinder(this);\n        this.signatureBuilder = new SignatureBuilder(this.typeResolver);\n        this.objectParser = new ObjectParser(this, this.signatureBuilder);\n        this.classParser = new ClassParser(this, this.typeResolver, this.signatureBuilder, this.nodeFinder);\n        this.functionParser = new FunctionParser(this, this.nodeFinder, this.objectParser, this.classParser);\n        this.jsDocParser = new JSDocParser();\n        this.exportParser = new ExportParser(\n            this,\n            this.nodeFinder,\n            () => this.getInputResolver().getTs().getConfig().options\n        );\n    }\n\n    /** Returns export metadata; consumers decide what that export means for their entrypoint. */\n    public getDefaultExport(): ExportValue | undefined {\n        return this.exportParser.parseDefault();\n    }\n\n    public getType(): string | undefined {\n        // If a specific variable or property is requested, extract its type\n        if (this.property) {\n            // 1) Named variable scenario: e.g. export const init = () => ...\n            const varDecl = this.nodeFinder.findVariableDeclaration(this.property);\n\n            if (varDecl && varDecl.initializer) {\n                return this.getTypeFromInitializer(varDecl.initializer);\n            }\n\n            // 2) Property on default export object: unwrap and look up key\n            let exportExpr: ts.Expression | undefined;\n            const sf = this.getSourceFile();\n\n            const findExport = (node: ts.Node) => {\n                if (ts.isExportAssignment(node)) {\n                    exportExpr = node.expression;\n                }\n                ts.forEachChild(node, findExport);\n            };\n\n            findExport(sf);\n\n            if (!exportExpr) return undefined;\n\n            // Special case for service definitions with JSDoc annotations\n            if (this.definition.size > 0 && ts.isCallExpression(exportExpr) && ts.isIdentifier(exportExpr.expression)) {\n                const fnName = exportExpr.expression.text;\n\n                if (this.definition.has(fnName)) {\n                    // Check if the wrapper function is imported from the designated package name\n                    let importPath: string | undefined;\n                    try {\n                        importPath = this.getImports().get(fnName);\n                    } catch {\n                        // unable to resolve import source -> ignore wrapper\n                        return undefined;\n                    }\n\n                    if (importPath !== PackageName) {\n                        // Function is not imported from the designated package name -> ignore wrapper\n                        console.warn(`Function ${fnName} is not imported from '${PackageName}' in file ${this.file}`);\n                        return undefined;\n                    }\n\n                    if (exportExpr.arguments.length > 0) {\n                        const firstArg = exportExpr.arguments[0];\n\n                        if (ts.isObjectLiteralExpression(firstArg)) {\n                            for (const prop of firstArg.properties) {\n                                const key = this.objectParser.getName(prop.name ?? prop);\n\n                                if (key !== this.property) continue;\n\n                                if (ts.isPropertyAssignment(prop)) {\n                                    const initType = this.getTypeFromInitializer(prop.initializer);\n                                    if (initType) return initType;\n                                } else if (ts.isMethodDeclaration(prop)) {\n                                    // Get the return type of the method\n                                    const returnType = this.getTypeFromMethodReturn(prop);\n                                    if (returnType) return returnType;\n                                } else if (ts.isShorthandPropertyAssignment(prop)) {\n                                    return this.resolveTypeFromShorthand(prop.name.text);\n                                }\n                            }\n                        }\n                    }\n                }\n            }\n\n            const expr = this.unwrapExpression(exportExpr);\n\n            if (ts.isObjectLiteralExpression(expr)) {\n                for (const prop of expr.properties) {\n                    const key = this.objectParser.getName(prop.name ?? prop);\n\n                    if (key !== this.property) continue;\n\n                    if (ts.isPropertyAssignment(prop)) {\n                        return this.getTypeFromInitializer(prop.initializer);\n                    } else if (ts.isMethodDeclaration(prop) || ts.isGetAccessorDeclaration(prop)) {\n                        const sig = this.signatureBuilder.getMethodSignature(prop as ts.MethodDeclaration);\n\n                        return this.signatureBuilder.buildFunctionType(sig);\n                    } else if (ts.isShorthandPropertyAssignment(prop)) {\n                        return this.resolveTypeFromShorthand(prop.name.text);\n                    }\n                }\n                return undefined;\n            }\n\n            // Fallback: treat default export expression as initializer\n            return this.getTypeFromInitializer(expr);\n        }\n\n        // Default: parse full default export into interface-like string\n        let members: Record<string, MemberSignature> | undefined;\n        const sf = this.getSourceFile();\n\n        const collect = (node: ts.Node) => {\n            if (ts.isExportAssignment(node)) {\n                const expr0 = node.expression;\n                const expr = this.unwrapExpression(expr0);\n                const parsed = this.parse(expr);\n                if (parsed) members = parsed;\n            }\n            ts.forEachChild(node, collect);\n        };\n\n        collect(sf);\n        if (!members) return undefined;\n        return this.signatureBuilder.formatMembers(members);\n    }\n\n    public setProperty(property: string): this {\n        this.property = property;\n\n        return this;\n    }\n\n    /**\n     * Entry point: accepts an expression and returns a map of member signatures,\n     * or undefined if the expression cannot be parsed.\n     */\n    protected parse(expr: ts.Expression): Record<string, MemberSignature> | undefined {\n        if (ts.isFunctionExpression(expr) || ts.isArrowFunction(expr)) {\n            return this.functionParser.parse(expr);\n        } else if (ts.isObjectLiteralExpression(expr)) {\n            return this.objectParser.parse(expr);\n        } else if (ts.isClassExpression(expr)) {\n            return this.classParser.parse(expr);\n        }\n\n        return undefined;\n    }\n\n    /**\n     * Specify wrapper functions whose first argument should be unwrapped for parsing.\n     */\n    public setDefinition(definition: string | string[]): this {\n        const defs = typeof definition === \"string\" ? [definition] : definition;\n\n        defs.forEach(def => this.definition.add(def));\n\n        return this;\n    }\n\n    /**\n     * Recursively unwraps type assertions, satisfies, parentheses, and allowed wrapper calls.\n     */\n    private unwrapExpression(expr: ts.Expression): ts.Expression {\n        // First use the AbstractExpressionParser's unwrapExpression for basic unwrapping\n        expr = this.functionParser.unwrapExpression(expr);\n\n        // Explicitly handle type assertions\n        if (ts.isAsExpression(expr)) {\n            return this.unwrapExpression(expr.expression);\n        }\n\n        // Then handle the additional unwrapping for known definition wrappers\n        if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {\n            const fnName = expr.expression.text;\n\n            if (this.definition.has(fnName)) {\n                let importPath: string | undefined;\n\n                try {\n                    importPath = this.getImports().get(fnName);\n                } catch {\n                    // unable to resolve import source -> ignore wrapper\n                    return expr;\n                }\n\n                if (importPath !== PackageName) {\n                    console.warn(`Function ${fnName} is not imported from '${PackageName}' in file ${this.file}`);\n                } else if (expr.arguments.length > 0) {\n                    const first = expr.arguments[0];\n                    return this.unwrapExpression(first as ts.Expression);\n                }\n            }\n        }\n\n        return expr;\n    }\n\n    /**\n     * Given an initializer or expression, extracts its type: function signature or interface.\n     */\n    private getTypeFromInitializer(\n        node: ts.Expression | ts.MethodDeclaration | ts.GetAccessorDeclaration\n    ): string | undefined {\n        // Unwrap type assertions\n        if (ts.isAsExpression(node)) {\n            return this.getTypeFromInitializer(node.expression);\n        }\n\n        // Function or arrow function: try to parse returned object or instance\n        if (ts.isFunctionExpression(node) || ts.isArrowFunction(node)) {\n            // attempt to parse returned expression into members\n            const members = this.functionParser.parse(node as ts.FunctionExpression | ts.ArrowFunction);\n\n            if (members) {\n                return this.signatureBuilder.formatMembers(members);\n            }\n\n            // fallback to function signature\n            const sig = this.signatureBuilder.getMethodSignature(node as ts.FunctionExpression | ts.ArrowFunction);\n\n            return this.signatureBuilder.buildFunctionType(sig);\n        }\n\n        // Class or method-like: signature of accessor/method\n        if (ts.isMethodDeclaration(node) || ts.isGetAccessorDeclaration(node)) {\n            const sig = this.signatureBuilder.getMethodSignature(node as ts.MethodDeclaration);\n            return this.signatureBuilder.buildFunctionType(sig);\n        }\n\n        // Object literal, class expression/declaration, or new expression: return interface of members\n        let members: Record<string, MemberSignature> | undefined;\n\n        if (ts.isObjectLiteralExpression(node) || ts.isClassExpression(node) || ts.isClassDeclaration(node)) {\n            members = this.parse(node as ts.Expression);\n        } else if (ts.isNewExpression(node)) {\n            const ctor = node.expression;\n\n            if (ts.isIdentifier(ctor)) {\n                members = this.classParser.parseFileClass(ctor.text);\n            } else if (ts.isClassExpression(ctor)) {\n                members = this.classParser.parse(ctor);\n            }\n        }\n\n        if (members) {\n            return this.signatureBuilder.formatMembers(members);\n        }\n\n        if (ts.isLiteralExpression(node) || ts.isArrayLiteralExpression(node) || ts.isObjectLiteralExpression(node)) {\n            return this.objectParser.inferTypeFromExpression(node as ts.Expression);\n        }\n\n        return undefined;\n    }\n\n    private resolveTypeFromShorthand(name: string): string | undefined {\n        const varDecl = this.nodeFinder.findVariableDeclaration(name);\n        if (varDecl && varDecl.initializer) {\n            const t = this.getTypeFromInitializer(varDecl.initializer);\n            if (t) return t;\n        }\n        const variable = this.getVariables().get(name);\n        if (variable) {\n            const val = variable.value;\n            switch (typeof val) {\n                case \"string\":\n                    return \"string\";\n                case \"number\":\n                    return \"number\";\n                case \"boolean\":\n                    return \"boolean\";\n                case \"object\":\n                    if (val === null) return \"null\";\n                    if (Array.isArray(val)) return \"array\";\n                    return \"object\";\n                default:\n                    return \"any\";\n            }\n        }\n        return \"any\";\n    }\n\n    /**\n     * Extracts the type of the return value of a method, taking into account JSDoc annotations.\n     *\n     * @param method The method declaration to extract the return type from\n     * @returns The extracted return type as a string, or undefined if it cannot be extracted\n     */\n    private getTypeFromMethodReturn(method: ts.MethodDeclaration): string | undefined {\n        // Try to find a return statement in the method body\n        if (method.body) {\n            // First, check if there's a JSDoc return type annotation\n            const jsDocReturnType = this.jsDocParser.getJSDocReturnType(method);\n            if (jsDocReturnType) {\n                // If the return type is a new expression, try to parse it\n                if (jsDocReturnType.includes(\"new \")) {\n                    const className = jsDocReturnType.replace(\"new \", \"\").trim();\n                    const members = this.classParser.parseFileClass(className);\n                    if (members) {\n                        return this.signatureBuilder.formatMembers(members);\n                    }\n                }\n\n                // If the return type is a class name, try to parse it\n                const members = this.classParser.parseFileClass(jsDocReturnType);\n                if (members) {\n                    return this.signatureBuilder.formatMembers(members);\n                }\n\n                return jsDocReturnType;\n            }\n\n            // If there's no JSDoc return type, try to find a return statement\n            let returnExpr: ts.Expression | undefined;\n\n            const findReturn = (node: ts.Node): void => {\n                if (ts.isReturnStatement(node) && node.expression) {\n                    returnExpr = node.expression;\n                    return;\n                }\n                ts.forEachChild(node, findReturn);\n            };\n\n            findReturn(method.body);\n\n            if (returnExpr) {\n                return this.getTypeFromInitializer(returnExpr);\n            }\n        }\n\n        // If we couldn't find a return statement, use the method's return type\n        if (method.type) {\n            return this.typeResolver.resolveTypeNode(method.type);\n        }\n\n        return undefined;\n    }\n}\n"],"mappings":"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","names":["sf","members"]}

package/dist/cli/entrypoint/file/OptionFile.d.ts

@@ -7,8 +7,10 @@ export default class<T extends Record<string, any>> extends SourceFile {
     setDefinition(definition: string | string[]): this;
     setProperties(properties: string[]): this;
     getOptions(): T;
+    /** Presence does not require evaluating the property's value (for example a render method). */
+    getDeclaredProperties(): Set<string>;
     getDefinition(): string | undefined;
-    protected getOptionsFromVariables(): T;
-    protected getOptionsFromDefinition(): T;
+    private requireValue;
+    private getOptionBindings;
     protected getExpressionForOptions(expr: ts.Expression): ts.Expression | undefined;
 }

package/dist/cli/entrypoint/file/OptionFile.js

@@ -18,41 +18,48 @@ class OptionFile_default extends SourceFile {
     return this;
   }
   getOptions() {
-    return { ...this.getOptionsFromVariables(), ...this.getOptionsFromDefinition() };
+    const options = [];
+    for (const [name, binding] of this.getOptionBindings()) {
+      if (!this.properties.has(name)) continue;
+      const value = this.requireValue(binding.source.parseNode(binding.node, name));
+      options.push([name, value]);
+    }
+    return Object.fromEntries(options);
+  }
+  /** Presence does not require evaluating the property's value (for example a render method). */
+  getDeclaredProperties() {
+    return new Set(this.getOptionBindings().keys());
   }
   getDefinition() {
-    if (this.definition === void 0) {
-      this.getOptionsFromDefinition();
-    }
-    if (this.definition === null) {
-      return;
-    }
-    return this.definition;
+    if (this.definition === void 0) this.getOptionBindings();
+    return this.definition ?? void 0;
   }
-  getOptionsFromVariables() {
-    const options = Array.from(this.getVariables().values()).filter(({ name, exported }) => exported && this.properties.has(name)).reduce((config, { name, value }) => ({ ...config, [name]: value }), {});
-    return options;
+  requireValue(result) {
+    if (result.resolved) return result.value;
+    const origin = result.file === this.file ? "" : ` (declared in "${result.file}")`;
+    throw new Error(
+      `Invalid options in "${this.file}": ${result.path || "options"} must be statically known: ${result.reason}${origin}`
+    );
   }
-  getOptionsFromDefinition() {
-    let options = {};
-    const parse = (node) => {
-      if (ts.isExportAssignment(node)) {
-        const expr = this.getExpressionForOptions(node.expression);
-        if (expr) {
-          options = this.parseNode(expr);
-        }
-      }
-      ts.forEachChild(node, parse);
-    };
-    parse(this.getSourceFile());
-    return _.pickBy(options, (_2, key) => this.properties.has(key));
+  getOptionBindings() {
+    const bindings = this.getBindings(true);
+    bindings.delete("default");
+    for (const statement of this.getSourceFile().statements) {
+      if (!ts.isExportAssignment(statement)) continue;
+      const expression = this.getExpressionForOptions(statement.expression);
+      if (!expression) continue;
+      const properties = this.requireValue(this.getProperties(expression));
+      for (const [name, binding] of properties) bindings.set(name, binding);
+    }
+    return bindings;
   }
   getExpressionForOptions(expr) {
     this.definition = null;
+    while (ts.isAsExpression(expr) || ts.isSatisfiesExpression(expr) || ts.isParenthesizedExpression(expr) || ts.isTypeAssertionExpression(expr)) {
+      expr = expr.expression;
+    }
     if (ts.isObjectLiteralExpression(expr)) {
       return expr;
-    } else if ((ts.isAsExpression(expr) || ts.isSatisfiesExpression(expr)) && ts.isObjectLiteralExpression(expr.expression)) {
-      return expr.expression;
     } else if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {
       const functionName = expr.expression.text;
       if (this.getImports().get(functionName) !== PackageName) {
@@ -60,11 +67,8 @@ class OptionFile_default extends SourceFile {
         return;
       }
       if (this.definitions.has(functionName) && expr.arguments.length > 0) {
-        const arg = expr.arguments[0];
-        if (ts.isObjectLiteralExpression(arg)) {
-          this.definition = functionName;
-          return arg;
-        }
+        this.definition = functionName;
+        return expr.arguments[0];
       }
     }
   }

package/dist/cli/entrypoint/file/OptionFile.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/cli/entrypoint/file/OptionFile.ts"],"sourcesContent":["import ts from \"typescript\";\nimport _ from \"lodash\";\n\nimport SourceFile from \"./SourceFile\";\n\nimport {PackageName} from \"@typing/app\";\n\nexport default class<T extends Record<string, any>> extends SourceFile {\n    protected definitions = new Set<string>();\n\n    protected definition: string | null | undefined = undefined;\n\n    protected properties = new Set<string>();\n\n    public setDefinition(definition: string | string[]): this {\n        if (_.isString(definition)) {\n            definition = [definition];\n        }\n\n        definition.forEach(definition => this.definitions.add(definition));\n\n        return this;\n    }\n\n    public setProperties(properties: string[]): this {\n        properties.forEach(property => this.properties.add(property));\n\n        return this;\n    }\n\n    public getOptions(): T {\n        return {...this.getOptionsFromVariables(), ...this.getOptionsFromDefinition()};\n    }\n\n    public getDefinition(): string | undefined {\n        if (this.definition === undefined) {\n            this.getOptionsFromDefinition();\n        }\n\n        if (this.definition === null) {\n            return;\n        }\n\n        return this.definition;\n    }\n\n    protected getOptionsFromVariables(): T {\n        const options = Array.from(this.getVariables().values())\n            .filter(({name, exported}) => exported && this.properties.has(name))\n            .reduce((config, {name, value}) => ({...config, [name]: value}), {});\n\n        return options as T;\n    }\n\n    protected getOptionsFromDefinition(): T {\n        let options = {} as T;\n\n        const parse = (node: ts.Node) => {\n            if (ts.isExportAssignment(node)) {\n                const expr = this.getExpressionForOptions(node.expression);\n\n                if (expr) {\n                    options = this.parseNode(expr);\n                }\n            }\n\n            ts.forEachChild(node, parse);\n        };\n\n        parse(this.getSourceFile());\n\n        return _.pickBy(options, (_, key) => this.properties.has(key)) as T;\n    }\n\n    protected getExpressionForOptions(expr: ts.Expression): ts.Expression | undefined {\n        this.definition = null;\n\n        if (ts.isObjectLiteralExpression(expr)) {\n            return expr;\n        } else if (\n            (ts.isAsExpression(expr) || ts.isSatisfiesExpression(expr)) &&\n            ts.isObjectLiteralExpression(expr.expression)\n        ) {\n            return expr.expression;\n        } else if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {\n            const functionName = expr.expression.text;\n\n            if (this.getImports().get(functionName) !== PackageName) {\n                console.warn(`Function ${functionName} is not imported from '${PackageName}' on file ${this.file}`);\n\n                return;\n            }\n\n            if (this.definitions.has(functionName) && expr.arguments.length > 0) {\n                const arg = expr.arguments[0];\n\n                if (ts.isObjectLiteralExpression(arg)) {\n                    this.definition = functionName;\n\n                    return arg;\n                }\n            }\n        }\n    }\n}\n"],"mappings":"AAAA,OAAO,QAAQ;AACf,OAAO,OAAO;AAEd,OAAO,gBAAgB;AAEvB,SAAQ,mBAAkB;AAE1B,MAAO,2BAAqD,WAAW;AAAA,EACzD,cAAc,oBAAI,IAAY;AAAA,EAE9B,aAAwC;AAAA,EAExC,aAAa,oBAAI,IAAY;AAAA,EAEhC,cAAc,YAAqC;AACtD,QAAI,EAAE,SAAS,UAAU,GAAG;AACxB,mBAAa,CAAC,UAAU;AAAA,IAC5B;AAEA,eAAW,QAAQ,CAAAA,gBAAc,KAAK,YAAY,IAAIA,WAAU,CAAC;AAEjE,WAAO;AAAA,EACX;AAAA,EAEO,cAAc,YAA4B;AAC7C,eAAW,QAAQ,cAAY,KAAK,WAAW,IAAI,QAAQ,CAAC;AAE5D,WAAO;AAAA,EACX;AAAA,EAEO,aAAgB;AACnB,WAAO,EAAC,GAAG,KAAK,wBAAwB,GAAG,GAAG,KAAK,yBAAyB,EAAC;AAAA,EACjF;AAAA,EAEO,gBAAoC;AACvC,QAAI,KAAK,eAAe,QAAW;AAC/B,WAAK,yBAAyB;AAAA,IAClC;AAEA,QAAI,KAAK,eAAe,MAAM;AAC1B;AAAA,IACJ;AAEA,WAAO,KAAK;AAAA,EAChB;AAAA,EAEU,0BAA6B;AACnC,UAAM,UAAU,MAAM,KAAK,KAAK,aAAa,EAAE,OAAO,CAAC,EAClD,OAAO,CAAC,EAAC,MAAM,SAAQ,MAAM,YAAY,KAAK,WAAW,IAAI,IAAI,CAAC,EAClE,OAAO,CAAC,QAAQ,EAAC,MAAM,MAAK,OAAO,EAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,MAAK,IAAI,CAAC,CAAC;AAEvE,WAAO;AAAA,EACX;AAAA,EAEU,2BAA8B;AACpC,QAAI,UAAU,CAAC;AAEf,UAAM,QAAQ,CAAC,SAAkB;AAC7B,UAAI,GAAG,mBAAmB,IAAI,GAAG;AAC7B,cAAM,OAAO,KAAK,wBAAwB,KAAK,UAAU;AAEzD,YAAI,MAAM;AACN,oBAAU,KAAK,UAAU,IAAI;AAAA,QACjC;AAAA,MACJ;AAEA,SAAG,aAAa,MAAM,KAAK;AAAA,IAC/B;AAEA,UAAM,KAAK,cAAc,CAAC;AAE1B,WAAO,EAAE,OAAO,SAAS,CAACC,IAAG,QAAQ,KAAK,WAAW,IAAI,GAAG,CAAC;AAAA,EACjE;AAAA,EAEU,wBAAwB,MAAgD;AAC9E,SAAK,aAAa;AAElB,QAAI,GAAG,0BAA0B,IAAI,GAAG;AACpC,aAAO;AAAA,IACX,YACK,GAAG,eAAe,IAAI,KAAK,GAAG,sBAAsB,IAAI,MACzD,GAAG,0BAA0B,KAAK,UAAU,GAC9C;AACE,aAAO,KAAK;AAAA,IAChB,WAAW,GAAG,iBAAiB,IAAI,KAAK,GAAG,aAAa,KAAK,UAAU,GAAG;AACtE,YAAM,eAAe,KAAK,WAAW;AAErC,UAAI,KAAK,WAAW,EAAE,IAAI,YAAY,MAAM,aAAa;AACrD,gBAAQ,KAAK,YAAY,YAAY,0BAA0B,WAAW,aAAa,KAAK,IAAI,EAAE;AAElG;AAAA,MACJ;AAEA,UAAI,KAAK,YAAY,IAAI,YAAY,KAAK,KAAK,UAAU,SAAS,GAAG;AACjE,cAAM,MAAM,KAAK,UAAU,CAAC;AAE5B,YAAI,GAAG,0BAA0B,GAAG,GAAG;AACnC,eAAK,aAAa;AAElB,iBAAO;AAAA,QACX;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AACJ;","names":["definition","_"]}
+{"version":3,"sources":["../../../../src/cli/entrypoint/file/OptionFile.ts"],"sourcesContent":["import ts from \"typescript\";\nimport _ from \"lodash\";\n\nimport SourceFile from \"./SourceFile\";\nimport type {SourceBinding, SourceReadResult} from \"./types\";\n\nimport {PackageName} from \"@typing/app\";\n\nexport default class<T extends Record<string, any>> extends SourceFile {\n    protected definitions = new Set<string>();\n\n    protected definition: string | null | undefined = undefined;\n\n    protected properties = new Set<string>();\n\n    public setDefinition(definition: string | string[]): this {\n        if (_.isString(definition)) {\n            definition = [definition];\n        }\n\n        definition.forEach(definition => this.definitions.add(definition));\n\n        return this;\n    }\n\n    public setProperties(properties: string[]): this {\n        properties.forEach(property => this.properties.add(property));\n\n        return this;\n    }\n\n    public getOptions(): T {\n        const options: [string, unknown][] = [];\n        for (const [name, binding] of this.getOptionBindings()) {\n            if (!this.properties.has(name)) continue;\n            const value = this.requireValue(binding.source.parseNode(binding.node, name));\n            options.push([name, value]);\n        }\n        return Object.fromEntries(options) as T;\n    }\n\n    /** Presence does not require evaluating the property's value (for example a render method). */\n    public getDeclaredProperties(): Set<string> {\n        return new Set(this.getOptionBindings().keys());\n    }\n\n    public getDefinition(): string | undefined {\n        if (this.definition === undefined) this.getOptionBindings();\n        return this.definition ?? undefined;\n    }\n\n    private requireValue<V>(result: SourceReadResult<V>): V {\n        if (result.resolved) return result.value;\n        const origin = result.file === this.file ? \"\" : ` (declared in \"${result.file}\")`;\n        throw new Error(\n            `Invalid options in \"${this.file}\": ${result.path || \"options\"} must be statically known: ${result.reason}${origin}`\n        );\n    }\n\n    private getOptionBindings(): Map<string, SourceBinding> {\n        const bindings = this.getBindings(true);\n        bindings.delete(\"default\");\n        for (const statement of this.getSourceFile().statements) {\n            if (!ts.isExportAssignment(statement)) continue;\n            const expression = this.getExpressionForOptions(statement.expression);\n            if (!expression) continue;\n            const properties = this.requireValue(this.getProperties(expression));\n            for (const [name, binding] of properties) bindings.set(name, binding);\n        }\n        return bindings;\n    }\n\n    protected getExpressionForOptions(expr: ts.Expression): ts.Expression | undefined {\n        this.definition = null;\n\n        while (\n            ts.isAsExpression(expr) ||\n            ts.isSatisfiesExpression(expr) ||\n            ts.isParenthesizedExpression(expr) ||\n            ts.isTypeAssertionExpression(expr)\n        ) {\n            expr = expr.expression;\n        }\n\n        if (ts.isObjectLiteralExpression(expr)) {\n            return expr;\n        } else if (ts.isCallExpression(expr) && ts.isIdentifier(expr.expression)) {\n            const functionName = expr.expression.text;\n\n            if (this.getImports().get(functionName) !== PackageName) {\n                console.warn(`Function ${functionName} is not imported from '${PackageName}' on file ${this.file}`);\n\n                return;\n            }\n\n            if (this.definitions.has(functionName) && expr.arguments.length > 0) {\n                this.definition = functionName;\n                return expr.arguments[0];\n            }\n        }\n    }\n}\n"],"mappings":"AAAA,OAAO,QAAQ;AACf,OAAO,OAAO;AAEd,OAAO,gBAAgB;AAGvB,SAAQ,mBAAkB;AAE1B,MAAO,2BAAqD,WAAW;AAAA,EACzD,cAAc,oBAAI,IAAY;AAAA,EAE9B,aAAwC;AAAA,EAExC,aAAa,oBAAI,IAAY;AAAA,EAEhC,cAAc,YAAqC;AACtD,QAAI,EAAE,SAAS,UAAU,GAAG;AACxB,mBAAa,CAAC,UAAU;AAAA,IAC5B;AAEA,eAAW,QAAQ,CAAAA,gBAAc,KAAK,YAAY,IAAIA,WAAU,CAAC;AAEjE,WAAO;AAAA,EACX;AAAA,EAEO,cAAc,YAA4B;AAC7C,eAAW,QAAQ,cAAY,KAAK,WAAW,IAAI,QAAQ,CAAC;AAE5D,WAAO;AAAA,EACX;AAAA,EAEO,aAAgB;AACnB,UAAM,UAA+B,CAAC;AACtC,eAAW,CAAC,MAAM,OAAO,KAAK,KAAK,kBAAkB,GAAG;AACpD,UAAI,CAAC,KAAK,WAAW,IAAI,IAAI,EAAG;AAChC,YAAM,QAAQ,KAAK,aAAa,QAAQ,OAAO,UAAU,QAAQ,MAAM,IAAI,CAAC;AAC5E,cAAQ,KAAK,CAAC,MAAM,KAAK,CAAC;AAAA,IAC9B;AACA,WAAO,OAAO,YAAY,OAAO;AAAA,EACrC;AAAA;AAAA,EAGO,wBAAqC;AACxC,WAAO,IAAI,IAAI,KAAK,kBAAkB,EAAE,KAAK,CAAC;AAAA,EAClD;AAAA,EAEO,gBAAoC;AACvC,QAAI,KAAK,eAAe,OAAW,MAAK,kBAAkB;AAC1D,WAAO,KAAK,cAAc;AAAA,EAC9B;AAAA,EAEQ,aAAgB,QAAgC;AACpD,QAAI,OAAO,SAAU,QAAO,OAAO;AACnC,UAAM,SAAS,OAAO,SAAS,KAAK,OAAO,KAAK,kBAAkB,OAAO,IAAI;AAC7E,UAAM,IAAI;AAAA,MACN,uBAAuB,KAAK,IAAI,MAAM,OAAO,QAAQ,SAAS,8BAA8B,OAAO,MAAM,GAAG,MAAM;AAAA,IACtH;AAAA,EACJ;AAAA,EAEQ,oBAAgD;AACpD,UAAM,WAAW,KAAK,YAAY,IAAI;AACtC,aAAS,OAAO,SAAS;AACzB,eAAW,aAAa,KAAK,cAAc,EAAE,YAAY;AACrD,UAAI,CAAC,GAAG,mBAAmB,SAAS,EAAG;AACvC,YAAM,aAAa,KAAK,wBAAwB,UAAU,UAAU;AACpE,UAAI,CAAC,WAAY;AACjB,YAAM,aAAa,KAAK,aAAa,KAAK,cAAc,UAAU,CAAC;AACnE,iBAAW,CAAC,MAAM,OAAO,KAAK,WAAY,UAAS,IAAI,MAAM,OAAO;AAAA,IACxE;AACA,WAAO;AAAA,EACX;AAAA,EAEU,wBAAwB,MAAgD;AAC9E,SAAK,aAAa;AAElB,WACI,GAAG,eAAe,IAAI,KACtB,GAAG,sBAAsB,IAAI,KAC7B,GAAG,0BAA0B,IAAI,KACjC,GAAG,0BAA0B,IAAI,GACnC;AACE,aAAO,KAAK;AAAA,IAChB;AAEA,QAAI,GAAG,0BAA0B,IAAI,GAAG;AACpC,aAAO;AAAA,IACX,WAAW,GAAG,iBAAiB,IAAI,KAAK,GAAG,aAAa,KAAK,UAAU,GAAG;AACtE,YAAM,eAAe,KAAK,WAAW;AAErC,UAAI,KAAK,WAAW,EAAE,IAAI,YAAY,MAAM,aAAa;AACrD,gBAAQ,KAAK,YAAY,YAAY,0BAA0B,WAAW,aAAa,KAAK,IAAI,EAAE;AAElG;AAAA,MACJ;AAEA,UAAI,KAAK,YAAY,IAAI,YAAY,KAAK,KAAK,UAAU,SAAS,GAAG;AACjE,aAAK,aAAa;AAClB,eAAO,KAAK,UAAU,CAAC;AAAA,MAC3B;AAAA,IACJ;AAAA,EACJ;AACJ;","names":["definition"]}

package/dist/cli/entrypoint/file/SourceFile.d.ts

@@ -1,22 +1,33 @@
 import ts from "typescript";
 import { ImportResolver } from "./resolvers/index.js";
-import { EnumMap, ImportMap, VariableMap } from "./types.js";
-export default class EntryFile {
+import type { ImportMap, VariableMap, SourceReadResult, SourceBinding } from "./types.js";
+export default class SourceFile {
     protected readonly file: string;
     private sourceFile?;
     private variables?;
     private imports?;
-    private enums?;
+    private sources;
     protected importResolver?: ImportResolver;
-    static make<T extends EntryFile>(this: new (file: string) => T, file: string): T;
+    static make<T extends SourceFile>(this: new (file: string) => T, file: string): T;
     constructor(file: string);
     getSourceFile(): ts.SourceFile;
     getImports(): ImportMap;
-    getEnums(): EnumMap;
+    /** Collect declarations without evaluating runtime functions or unrelated initializers. */
+    protected getBindings(exportedOnly?: boolean): Map<string, SourceBinding>;
     getVariables(): VariableMap;
     protected resolveValue(from: string, target: string, name: string): any;
-    protected findPropertyAccessValue(property: ts.Node): any;
-    parseNode(node?: ts.Node): any;
+    private getImportBinding;
+    private getImportedSource;
+    private failure;
+    /** Follow static bindings, retaining their source module and detecting reference cycles. */
+    private resolveNode;
+    parseNode(node?: ts.Node, property?: string): SourceReadResult;
+    /** Read an object's shape first so callers can select build fields before evaluating values. */
+    protected getProperties(node: ts.Node, property?: string): SourceReadResult<Map<string, SourceBinding>>;
+    private readProperties;
+    private objectProperties;
+    private readValue;
+    private readResolvedValue;
     protected getInputResolver(): ImportResolver;
     setImportResolver(resolver: ImportResolver): ImportResolver;
 }