@addfox/core 0.1.1-beta.2

package/dist/esm/entry/html.d.ts

@@ -0,0 +1,35 @@
+import type { ScriptInjectPosition } from "../types.ts";
+export type { ScriptInjectPosition };
+export interface AddfoxEntryScriptResult {
+    /** Resolved src attribute value (relative path) */
+    src: string;
+    /** Where the script tag sits: head or body */
+    inject: ScriptInjectPosition;
+    /** HTML content with the data-addfox-entry script tag removed */
+    strippedHtml: string;
+}
+/** True if src is a relative path (no leading / or \, no protocol). */
+export declare function isScriptSrcRelative(src: string): boolean;
+/**
+ * Parses HTML at htmlPath for the entry script.
+ * Entry is either: (1) script with data-addfox-entry and protocol-less src, or
+ * (2) if none found, the first script in HTML (head or body) with protocol-less src.
+ * Returns src, inject position (head vs body), and HTML with that script tag removed.
+ * If no such tag is found or it has no valid src, returns undefined.
+ */
+export declare function parseAddfoxEntryFromHtml(htmlPath: string): AddfoxEntryScriptResult | undefined;
+/**
+ * If html has data-addfox-entry and its script src resolves to the same path as scriptPath,
+ * returns the inject position so the entry can use stripped template and html.inject.
+ */
+export declare function getScriptInjectIfMatches(htmlPath: string, scriptPath: string): ScriptInjectPosition | undefined;
+/**
+ * Resolve script path from HTML that has data-addfox-entry with src.
+ * - src must be relative; throws if absolute.
+ * - Resolved file must exist; throws if not found.
+ * Use this when the entry is driven by HTML so invalid config fails fast.
+ */
+export declare function resolveScriptFromHtmlStrict(htmlPath: string): {
+    scriptPath: string;
+    inject: ScriptInjectPosition;
+};

package/dist/esm/entry/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @addfox/core/entry
+ *
+ * Entry discovery and resolution
+ */
+export { discoverEntries, getHtmlEntryNames, getScriptOnlyEntryNames, getAllEntryNames, } from "./discoverer.ts";
+export type { EntryDiscovererOptions } from "./discoverer.ts";
+export { resolveEntries, resolveEntriesLegacy, extractEntriesFromManifest } from "./resolver.ts";
+export type { EntryResolverOptions, EntryResolutionResult } from "./resolver.ts";
+export type { ParsedEntryFromManifest, ExtractedEntry } from "./manifestParser.ts";
+export { parseAddfoxEntryFromHtml, getScriptInjectIfMatches, resolveScriptFromHtmlStrict, isScriptSrcRelative, } from "./html.ts";
+export type { AddfoxEntryScriptResult } from "./html.ts";

package/dist/esm/entry/manifestParser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Manifest entry parser - extracts entry paths from manifest.json
+ * Allows users to specify source file paths directly in manifest fields
+ */
+import type { ManifestRecord, EntryConfigValue } from "../types.ts";
+import type { BrowserTarget } from "../constants.ts";
+interface ExtractedEntry {
+    name: string;
+    value: EntryConfigValue;
+    /** Original manifest field path, used for later replacement */
+    manifestPath: string;
+}
+interface ParsedEntryFromManifest {
+    entries: Record<string, EntryConfigValue>;
+    /** Maps manifest field paths to entry names for replacement */
+    replacementMap: Map<string, string>;
+}
+/**
+ * Extract all entry config from manifest.
+ * Only extracts fields that specify source file paths (.ts/.tsx/.js/.jsx).
+ */
+export declare function extractEntriesFromManifest(manifest: ManifestRecord, browser: BrowserTarget): ParsedEntryFromManifest;
+/**
+ * Check whether the manifest contains any source file paths.
+ */
+export declare function hasManifestSourcePaths(manifest: ManifestRecord): boolean;
+export type { ParsedEntryFromManifest, ExtractedEntry };

package/dist/esm/entry/resolver.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Entry resolution - resolves entry configuration
+ * Priority: 1. config.entry > 2. manifest entries > 3. auto-discovery
+ */
+import type { AddfoxUserConfig, EntryInfo, ManifestRecord } from "../types.ts";
+import type { BrowserTarget } from "../constants.ts";
+import { type EntryDiscovererOptions } from "./discoverer.ts";
+import { extractEntriesFromManifest, type ParsedEntryFromManifest } from "./manifestParser.ts";
+export interface EntryResolverOptions {
+    entryDiscovererOptions?: EntryDiscovererOptions;
+    /** Target browser for manifest entry extraction */
+    browser?: BrowserTarget;
+}
+export interface EntryResolutionResult {
+    entries: EntryInfo[];
+    /** Map of manifest field paths to entry names for output path replacement */
+    manifestReplacementMap?: Map<string, string>;
+}
+/**
+ * Resolve entries with priority:
+ * 1. config.entry (highest priority)
+ * 2. manifest entries (if config.entry doesn't specify)
+ * 3. auto-discovery (lowest priority)
+ */
+export declare function resolveEntries(config: Pick<AddfoxUserConfig, "entry" | "appDir">, _root: string, baseDir: string, manifest?: ManifestRecord, options?: EntryResolverOptions): EntryResolutionResult;
+/**
+ * Legacy API - returns just the entries array for backward compatibility
+ */
+export declare function resolveEntriesLegacy(config: Pick<AddfoxUserConfig, "entry" | "appDir">, _root: string, baseDir: string, options?: EntryResolverOptions): EntryInfo[];
+export { extractEntriesFromManifest, type ParsedEntryFromManifest };

package/dist/esm/frameworkDetect.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Detect front-end framework from project package.json (dependencies / devDependencies).
+ * Used for debug error output; falls back to Vanilla when none detected.
+ */
+export type FrontendFramework = "Vanilla" | "React" | "Vue" | "Preact" | "Svelte" | "Solid";
+/**
+ * Detect front-end framework from project root package.json.
+ * Checks dependencies/devDependencies for solid-js, svelte, vue, preact, react (first match wins).
+ * Returns "Vanilla" when root is empty, package.json missing, or no framework detected.
+ */
+export declare function detectFrontendFramework(root: string): FrontendFramework;

package/dist/esm/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @addfox/core - Core build logic for Addfox
+ *
+ * Responsibilities:
+ * - Build orchestration (Pipeline)
+ * - Config loading and resolution
+ * - Entry discovery and resolution
+ * - Manifest building and loading
+ * - Type definitions and constants
+ */
+export { defineConfig } from "./config/defineConfig.js";
+export { resolveAddfoxConfig, loadConfigFile, getResolvedConfigFilePath, getResolvedRstestConfigFilePath, clearConfigCache, } from "./config/loader.js";
+export type { ConfigResolutionResult, ConfigLoaderOptions, } from "./config/loader.js";
+export { Pipeline } from "./pipeline/Pipeline.js";
+export type { PipelineContext, PipelineStage, PipelineHook } from "./pipeline/types.js";
+export { discoverEntries, getHtmlEntryNames, getScriptOnlyEntryNames, getAllEntryNames, } from "./entry/discoverer.js";
+export type { EntryDiscovererOptions } from "./entry/discoverer.js";
+export { resolveEntries, extractEntriesFromManifest } from "./entry/resolver.js";
+export type { EntryResolverOptions, EntryResolutionResult } from "./entry/resolver.js";
+export type { ParsedEntryFromManifest, ExtractedEntry } from "./entry/manifestParser.js";
+export { parseAddfoxEntryFromHtml, getScriptInjectIfMatches, resolveScriptFromHtmlStrict, isScriptSrcRelative, } from "./entry/html.js";
+export type { AddfoxEntryScriptResult } from "./entry/html.js";
+export { buildForBrowser, resolveManifestChromium, resolveManifestFirefox, resolveManifestForTarget, getManifestRecordForTarget, } from "./manifest/builder.js";
+export type { ContentScriptOutput } from "./manifest/builder.js";
+export { resolveManifestInput, ManifestLoader, } from "./manifest/loader.js";
+export type { ManifestValidationTarget } from "./manifest/loader.js";
+export { DEFAULT_OUT_DIR, DEFAULT_APP_DIR, DEFAULT_ENV_PREFIXES, ADDFOX_OUTPUT_ROOT, HMR_WS_PORT, DEFAULT_BROWSER, SUPPORTED_BROWSERS, SUPPORTED_LAUNCH_TARGETS, CLI_COMMANDS, RSTEST_CONFIG_FILES, MANIFEST_ENTRY_PATHS, MANIFEST_ENTRY_KEYS, MANIFEST_DIR, MANIFEST_FILE_NAMES, CONFIG_FILES, SCRIPT_EXTS, HTML_ENTRY_NAMES, SCRIPT_ONLY_ENTRY_NAMES, RELOAD_MANAGER_ENTRY_NAMES, RESERVED_ENTRY_NAMES, BROWSER_OUTPUT_PREFIX, getBrowserOutputDir, } from "./constants.js";
+export { toReloadManagerEntries } from "./reloadManager.js";
+export { getAddfoxVersion } from "./version.js";
+export { detectFrontendFramework, type FrontendFramework, } from "./frameworkDetect.js";
+export type { AddfoxUserConfig, AddfoxResolvedConfig, ManifestConfig, ManifestRecord, ChromiumFirefoxManifest, ManifestPathConfig, BrowserPathConfig, RsbuildConfigHelpers, EntryInfo, ReloadManagerEntry, ScriptInjectPosition, RsdoctorReportOptions, } from "./types.js";
+export type { BrowserTarget, CliCommand, LaunchTarget, EntryKey, ChromiumLaunchTarget, } from "./constants.js";