@openfairygui/functions 0.2.0-alpha.11 → 0.2.0-alpha.13

package/src/codegen.ts

@@ -12,8 +12,9 @@ import {
 	UNITY_BINDER_TEMPLATE,
 	UNITY_COMPONENT_TEMPLATE,
 } from './codegen-templates.js';
-import { formatPluginError, type LoadedPlugin } from './plugins/loader.js';
-import type { CliCodeGenerationSettings, PublishFileSystem, RootProjectSettings } from './shared-types.js';
+import { formatPluginError, type LoadedPlugin } from './plugins/types.js';
+import type { PublishFileSystem } from './publish/contracts.js';
+import type { CliCodeGenerationSettings, RootProjectSettings } from './shared-types.js';
 
 export const AUTO_GENERATED_CODE_MARK = '/** This is an automatically generated class by FairyGUI. Please do not modify it. **/';
 const DEFAULT_CLASS_NAME_PREFIX = 'UI_';

package/src/index.ts

@@ -1,5 +1,11 @@
 export { inspect, type InspectReport, type InspectCategoryReport } from './inspect.js';
-export { validate, type ValidateOptions, type ValidationResult, type ValidationIssue, ValidationSeverity } from './validate.js';
+export {
+	validate,
+	type ValidateOptions,
+	type ValidationResult,
+	type ValidationIssue,
+	ValidationSeverity,
+} from './validate.js';
 export { prune, type PruneOptions } from './prune.js';
 export { rename, type RenameOptions } from './rename.js';
 export { atlas, type AtlasOptions } from './atlas.js';
@@ -17,15 +23,26 @@ export {
 	decodeText,
 } from './codegen.js';
 
-
 export type {
 	CodeWriter,
 	ICodeWriterConfig,
 	MaybePromise,
+	LoadedPlugin,
 	Plugin,
 	PluginManifest,
 	PluginModule,
 } from './plugins/types.js';
+export type {
+	AtlasRasterBackend,
+	AtlasRasterCompositeInput,
+	AtlasRasterInput,
+	AtlasRasterMetadata,
+	AtlasRasterPipeline,
+	AtlasRasterResolvedBuffer,
+	PublishFileSystem,
+	PublishOutputFileSystem,
+	PublishSourceFileSystem,
+} from './publish/contracts.js';
 export {
 	restore,
 	type RestoreFileSystem,
@@ -60,7 +77,6 @@ export type {
 	HasOptionalSrc,
 	HasOptionalUrl,
 	PublishDependency,
-	PublishFileSystem,
 	RootProjectSettings,
 	CliCodeGenerationSettings,
 } from './shared-types.js';

package/src/node.ts

@@ -0,0 +1,4 @@
+export {
+	publishNode,
+	type PublishNodeOptions,
+} from './adapters/node/publish.js';

package/src/plugins/types.ts

@@ -44,4 +44,13 @@ export interface Plugin {
 	onPublishEnd?: (doc: Document, options: PublishOptions) => MaybePromise<void>;
 }
 
+export interface LoadedPlugin {
+	name: string;
+	plugin: Plugin;
+}
+
 export type PluginModule = Plugin & { default?: Plugin };
+
+export function formatPluginError(error: unknown): string {
+	return error instanceof Error ? error.message : String(error);
+}

package/src/publish/contracts.ts

@@ -0,0 +1,80 @@
+import type { FileSystem } from '@openfairygui/core';
+
+/**
+ * Source files required by a publish adapter.
+ *
+ * The host owns this filesystem: Node adapters use native paths while web
+ * adapters can use File System Access, OPFS, IndexedDB, ZIP, or memory.
+ */
+export type PublishSourceFileSystem = Pick<FileSystem, 'readFileRaw' | 'join'>;
+
+/**
+ * Output files required by a publish adapter.
+ */
+export type PublishOutputFileSystem = Pick<FileSystem, 'writeFileRaw' | 'mkdir' | 'join'>;
+
+/**
+ * Full filesystem contract consumed by the capability-injected publish core.
+ *
+ * Read, enumeration, and delete operations are optional because individual
+ * publish lanes only request them when needed.
+ */
+export type PublishFileSystem = PublishOutputFileSystem & {
+	deleteFile?: (path: string) => Promise<void>;
+	exists?: FileSystem['exists'];
+	readdir?: FileSystem['readdir'];
+	readFileRaw?: FileSystem['readFileRaw'];
+};
+
+export interface AtlasRasterMetadata {
+	width?: number;
+	height?: number;
+	channels?: number;
+	hasAlpha?: boolean;
+	trimOffsetLeft?: number;
+	trimOffsetTop?: number;
+}
+
+export interface AtlasRasterResolvedBuffer {
+	data: Uint8Array;
+	info: Required<Pick<AtlasRasterMetadata, 'width' | 'height' | 'channels'>> & AtlasRasterMetadata;
+}
+
+export interface AtlasRasterCompositeInput {
+	input: Uint8Array;
+	left: number;
+	top: number;
+}
+
+export type AtlasRasterInput =
+	| string
+	| Uint8Array
+	| {
+			create: {
+				width: number;
+				height: number;
+				channels: 4;
+				background: { r: number; g: number; b: number; alpha: number };
+			};
+	  };
+
+/**
+ * Host-provided raster pipeline used by atlas packing.
+ *
+ * Sharp and the browser Canvas adapter both satisfy this contract.
+ */
+export interface AtlasRasterPipeline {
+	ensureAlpha(): AtlasRasterPipeline;
+	resize(options: { width: number; height: number; fit?: 'fill' }): AtlasRasterPipeline;
+	raw(): AtlasRasterPipeline;
+	extract(options: { left: number; top: number; width: number; height: number }): AtlasRasterPipeline;
+	png(): AtlasRasterPipeline;
+	rotate(angle: number): AtlasRasterPipeline;
+	composite(inputs: AtlasRasterCompositeInput[]): AtlasRasterPipeline;
+	metadata(): Promise<AtlasRasterMetadata>;
+	toBuffer(options: { resolveWithObject: true }): Promise<AtlasRasterResolvedBuffer>;
+	toBuffer(options?: { resolveWithObject?: false }): Promise<Uint8Array>;
+	toFile(path: string): Promise<unknown>;
+}
+
+export type AtlasRasterBackend = (input: AtlasRasterInput) => AtlasRasterPipeline;

package/src/publish.ts

@@ -18,12 +18,12 @@ import {
 import { createTransform } from './utils.js';
 import { atlas, type AtlasOptions } from './atlas.js';
 import { publishCodeGeneration, resolveProjectBasePath } from './codegen.js';
-import { formatPluginError, loadPlugins, type LoadedPlugin } from './plugins/loader.js';
+import { formatPluginError, type LoadedPlugin } from './plugins/types.js';
+import type { AtlasRasterBackend, PublishFileSystem } from './publish/contracts.js';
 import type {
 	CliPublishSettings,
 	HasOptionalFont,
 	PackagePublishArtifactsExtras,
-	PublishFileSystem,
 	RootProjectSettings,
 } from './shared-types.js';
 
@@ -46,10 +46,10 @@ export interface PublishOptions {
 	fileExtension?: string;
 
 	/**
-	 * Sharp module instance for atlas image compositing.
+	 * Raster backend for atlas image compositing.
 	 * If not provided, atlas packing only computes layout (no PNGs generated).
 	 */
-	encoder?: unknown;
+	encoder?: AtlasRasterBackend;
 
 	/**
 	 * Base path for reading source images (project assets root).
@@ -79,9 +79,33 @@ export interface PublishOptions {
 	 * Empty or omitted means publishing the main branch.
 	 */
 	branch?: string;
-}
 
-export interface ResolvedPublishAtlasOptions extends Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'> {}
+	/**
+	 * Publish hooks supplied by the host adapter.
+	 *
+	 * Node adapters load project plugins. Browser adapters pass an empty list.
+	 */
+	plugins?: LoadedPlugin[];
+
+	/**
+	 * Run generic code generation after runtime artifacts. Default: true.
+	 */
+	codeGeneration?: boolean;
+}
+
+export interface ResolvedPublishAtlasOptions
+	extends Pick<
+		AtlasOptions,
+		| 'maxSize'
+		| 'fast'
+		| 'allowRotation'
+		| 'padding'
+		| 'powerOfTwo'
+		| 'square'
+		| 'multiPage'
+		| 'trimImage'
+		| 'extractAlpha'
+	> {}
 
 export interface ResolvePublishOptionsOverrides {
 	compressed?: boolean;
@@ -139,16 +163,6 @@ async function runPublishPluginHook(
 	}
 }
 
-function resolvePublishPluginsDir(doc: Document, options: PublishOptions): string {
-	const fs = options.fs;
-	const projectDir = doc.getProjectDir?.() ?? '';
-	if (projectDir) return fs?.join ? fs.join(projectDir, 'plugins') : `${projectDir.replace(/[/\\]+$/, '')}/plugins`;
-
-	const projectBasePath = resolveProjectBasePath(options.basePath);
-	if (!projectBasePath) return '';
-	return fs?.join ? fs.join(projectBasePath, 'plugins') : `${projectBasePath.replace(/[/\\]+$/, '')}/plugins`;
-}
-
 interface ImageResourceExtras extends Record<string, unknown> {
 	_fileName?: string;
 }
@@ -229,27 +243,6 @@ interface ComponentWithPublishRefs {
 	listTransitions?(): TransitionWithPublishRefs[];
 }
 
-interface PublishEncoderMetadata {
-	width?: number;
-	height?: number;
-	channels?: number;
-}
-
-interface PublishEncoderResolvedBuffer {
-	data: Uint8Array;
-	info: Required<Pick<PublishEncoderMetadata, 'width' | 'height' | 'channels'>> & PublishEncoderMetadata;
-}
-
-interface PublishEncoderPipeline {
-	ensureAlpha(): PublishEncoderPipeline;
-	resize(options: { width: number; height: number; fit: 'fill' }): PublishEncoderPipeline;
-	raw(): PublishEncoderPipeline;
-	toBuffer(options: { resolveWithObject: true }): Promise<PublishEncoderResolvedBuffer>;
-	metadata(): Promise<PublishEncoderMetadata>;
-}
-
-type PublishEncoder = (input: string | Uint8Array) => PublishEncoderPipeline;
-
 const UNITY_PROJECT_TYPE = ProjectType.Unity;
 const COCOS_CREATOR_PROJECT_TYPE = ProjectType.CocosCreator;
 
@@ -302,8 +295,7 @@ export function resolvePublishOptions(
 	const atlasSetting = publishSettings.atlasSetting ?? {};
 	const projectType = root.getProjectType();
 
-	const fileExtension = overrides.fileExtension
-		?? resolveDefaultPublishFileExtension(projectType, publishSettings);
+	const fileExtension = overrides.fileExtension ?? resolveDefaultPublishFileExtension(projectType, publishSettings);
 
 	let compressed = overrides.compressed ?? publishSettings.compressDesc ?? false;
 	if (projectType === UNITY_PROJECT_TYPE) {
@@ -347,7 +339,6 @@ function joinPathSegments(left: string, right: string): string {
 	return `${normalizedLeft}${separator}${normalizedRight}`;
 }
 
-
 function dirname(filePath: string): string {
 	const trimmed = filePath.replace(/[/\\]+$/, '');
 	const match = trimmed.match(/^(.*)[/\\][^/\\]+$/);
@@ -386,7 +377,9 @@ function isMovieClipResource(resource: ReturnType<Package['listResources']>[numb
 	return resource.propertyType === 'MovieClipResource';
 }
 
-function isHighResolutionResource(resource: ReturnType<Package['listResources']>[number]): resource is ImageResource | MovieClipResource {
+function isHighResolutionResource(
+	resource: ReturnType<Package['listResources']>[number],
+): resource is ImageResource | MovieClipResource {
 	return isImageResource(resource) || isMovieClipResource(resource);
 }
 
@@ -406,7 +399,9 @@ function isSpineResource(resource: ReturnType<Package['listResources']>[number])
 	return resource.propertyType === 'SpineResource';
 }
 
-function isDragonBonesResource(resource: ReturnType<Package['listResources']>[number]): resource is DragonBonesResource {
+function isDragonBonesResource(
+	resource: ReturnType<Package['listResources']>[number],
+): resource is DragonBonesResource {
 	return resource.propertyType === 'DragonBonesResource';
 }
 
@@ -453,10 +448,7 @@ function addLocalFontRef(target: Set<string>, pkgId: string, value: string | str
 	addLocalUiResourceRef(target, pkgId, value ?? undefined);
 }
 
-function resolvePackageAssetsBasePath(
-	basePath: string,
-	resource: BranchAwarePublishedResource | undefined,
-): string {
+function resolvePackageAssetsBasePath(basePath: string, resource: BranchAwarePublishedResource | undefined): string {
 	const branchName = resource?.getBranch?.() ?? '';
 	if (!branchName) return basePath;
 	const normalized = basePath.replace(/[/\\]+$/, '');
@@ -510,7 +502,11 @@ function resolvePublishedMiscFileName(resource: MiscResource, projectType: numbe
 }
 
 function resolvePublishedSkeletonFileName(resource: SpineResource | DragonBonesResource, projectType: number): string {
-	if (projectType === UNITY_PROJECT_TYPE && isSpineResource(resource) && resource.getFile().toLowerCase().endsWith('.skel')) {
+	if (
+		projectType === UNITY_PROJECT_TYPE &&
+		isSpineResource(resource) &&
+		resource.getFile().toLowerCase().endsWith('.skel')
+	) {
 		return `${resource.getFile()}.bytes`;
 	}
 	return resource.getFile();
@@ -528,7 +524,11 @@ function setPublishedFileExtra(
 }
 
 function setPublishedIdExtra(
-	resource: { getId(): string; getExtras(): Record<string, unknown> | undefined; setExtras(value: Record<string, unknown>): unknown },
+	resource: {
+		getId(): string;
+		getExtras(): Record<string, unknown> | undefined;
+		setExtras(value: Record<string, unknown>): unknown;
+	},
 	effectiveId: string | null,
 ): void {
 	const extras = (resource.getExtras() as PublishFileExtras | undefined) ?? {};
@@ -553,11 +553,7 @@ function getBranchName(resource: BranchAwarePublishedResource | undefined): stri
 	return resource?.getBranch?.() ?? '';
 }
 
-function buildBranchResourceKey(resource: {
-	propertyType: string;
-	getPath(): string;
-	getName(): string;
-}): string {
+function buildBranchResourceKey(resource: { propertyType: string; getPath(): string; getName(): string }): string {
 	return `${resource.propertyType}|${resource.getPath() ?? ''}|${resource.getName() ?? ''}`;
 }
 
@@ -567,12 +563,15 @@ const HIGH_RESOLUTION_LEVELS = [
 	{ scale: 4, bit: 4, slot: 2 },
 ] as const;
 
-function buildHighResolutionResourceKey(resource: {
-	propertyType: string;
-	getPath(): string;
-	getName(): string;
-	getBranch?(): string;
-}, name = resource.getName()): string {
+function buildHighResolutionResourceKey(
+	resource: {
+		propertyType: string;
+		getPath(): string;
+		getName(): string;
+		getBranch?(): string;
+	},
+	name = resource.getName(),
+): string {
 	return `${resource.propertyType}|${resource.getBranch?.() ?? ''}|${resource.getPath() ?? ''}|${name}`;
 }
 
@@ -622,7 +621,10 @@ function collectHighResolutionItemIds(
 			}
 
 			const highResolutionResource = highResolutionResourceByKey.get(
-				buildHighResolutionResourceKey(resource, appendHighResolutionScaleToName(resource.getName(), level.scale)),
+				buildHighResolutionResourceKey(
+					resource,
+					appendHighResolutionScaleToName(resource.getName(), level.scale),
+				),
 			);
 			if (!highResolutionResource) {
 				ids[level.slot] = null;
@@ -767,7 +769,12 @@ function collectPackagePublishContext(
 			continue;
 		}
 		if (isImageResource(resource)) {
-			if (resource.getExported() || referencedIds.has(resourceId) || spriteItemIds.has(resourceId) || pixelHitTestImageIds.has(resourceId)) {
+			if (
+				resource.getExported() ||
+				referencedIds.has(resourceId) ||
+				spriteItemIds.has(resourceId) ||
+				pixelHitTestImageIds.has(resourceId)
+			) {
 				publishedResourceIds.add(resourceId);
 			}
 			continue;
@@ -888,7 +895,7 @@ async function applyPixelHitTests(
 	pkg: Package,
 	imageIds: Set<string>,
 	basePath: string | undefined,
-	encoder: PublishEncoder | undefined,
+	encoder: AtlasRasterBackend | undefined,
 ): Promise<void> {
 	const images = pkg.listImageResources();
 	for (const image of images) {
@@ -950,7 +957,7 @@ async function applyPixelHitTests(
 async function annotatePackagePublishArtifacts(
 	pkg: Package,
 	basePath: string | undefined,
-	encoder: PublishEncoder | undefined,
+	encoder: AtlasRasterBackend | undefined,
 	options: {
 		projectType: number;
 		includeBranches: boolean;
@@ -1002,10 +1009,7 @@ function getAnnotatedExportedResourceIds(pkg: Package): Set<string> {
 	return new Set(extras.exportedResourceIds ?? []);
 }
 
-function getPublishedSkeletonDependencyImageIds(
-	pkg: Package,
-	publishedResourceIds: Set<string>,
-): Set<string> {
+function getPublishedSkeletonDependencyImageIds(pkg: Package, publishedResourceIds: Set<string>): Set<string> {
 	const imageIds = new Set<string>();
 	const resourcesById = new Map(pkg.listResources().map((resource) => [resource.getId(), resource] as const));
 	for (const resource of pkg.listResources()) {
@@ -1035,7 +1039,9 @@ async function exportPackageSounds(
 			return isSoundResource(resource) && publishedResourceIds.has(resource.getId());
 		});
 		if (hasPublishedSound) {
-			logger.warn(`publish: Sound resources in package "${pkg.getName()}" were not exported because basePath/readFileRaw is unavailable.`);
+			logger.warn(
+				`publish: Sound resources in package "${pkg.getName()}" were not exported because basePath/readFileRaw is unavailable.`,
+			);
 		}
 		return;
 	}
@@ -1071,19 +1077,23 @@ async function exportPackageExternalResources(
 	if (!basePath || !readFileRaw) {
 		const hasPublishedExternal = pkg.listResources().some((resource) => {
 			return (
-				(isMiscResource(resource) || isSkeletonResource(resource))
-				&& exportedResourceIds.has(resource.getId())
-			) || skeletonDependencyImageIds.has(resource.getId());
+				((isMiscResource(resource) || isSkeletonResource(resource)) &&
+					exportedResourceIds.has(resource.getId())) ||
+				skeletonDependencyImageIds.has(resource.getId())
+			);
 		});
 		if (hasPublishedExternal) {
-			logger.warn(`publish: External resources in package "${pkg.getName()}" were not exported because basePath/readFileRaw is unavailable.`);
+			logger.warn(
+				`publish: External resources in package "${pkg.getName()}" were not exported because basePath/readFileRaw is unavailable.`,
+			);
 		}
 		return;
 	}
 
 	for (const resource of pkg.listResources()) {
 		const resourceId = resource.getId();
-		const isSkeletonExternal = exportedResourceIds.has(resourceId) && (isMiscResource(resource) || isSkeletonResource(resource));
+		const isSkeletonExternal =
+			exportedResourceIds.has(resourceId) && (isMiscResource(resource) || isSkeletonResource(resource));
 		const isSkeletonImageDependency = skeletonDependencyImageIds.has(resourceId) && isImageResource(resource);
 		if (!isSkeletonExternal && !isSkeletonImageDependency) continue;
 
@@ -1094,7 +1104,8 @@ async function exportPackageExternalResources(
 			targetName = resolveImageFileName(resource);
 		} else if (isMiscResource(resource) || isSkeletonResource(resource)) {
 			sourcePath = resolveGenericResourcePath(resource, pkg, basePath);
-			targetName = ((resource.getExtras() as PublishFileExtras | undefined) ?? {})._publishedFile ?? resource.getFile();
+			targetName =
+				((resource.getExtras() as PublishFileExtras | undefined) ?? {})._publishedFile ?? resource.getFile();
 		} else {
 			continue;
 		}
@@ -1104,7 +1115,9 @@ async function exportPackageExternalResources(
 			const data = await readFileRaw(sourcePath);
 			await fs.writeFileRaw(targetPath, data);
 		} catch {
-			logger.warn(`publish: Could not export external resource "${resource.getId()}" from package "${pkg.getName()}".`);
+			logger.warn(
+				`publish: Could not export external resource "${resource.getId()}" from package "${pkg.getName()}".`,
+			);
 		}
 	}
 }
@@ -1113,10 +1126,13 @@ async function exportPackageExternalResources(
  * Publishes a FairyGUI project.
  *
  * Orchestrates:
- * 1. Atlas packing (MaxRects layout + optional sharp compositing)
+ * 1. Atlas packing (MaxRects layout + optional raster compositing)
  * 2. Per-package .fui binary serialization
  * 3. File writing to the output directory
  *
+ * This is the capability-injected core. Standard hosts should use
+ * `publishNode()` or `publishBrowser()` through their dedicated entries.
+ *
  * ```ts
  * import sharp from 'sharp';
  * const io = new NodeIO();
@@ -1140,7 +1156,9 @@ export function publish(options: PublishOptions): Transform {
 			if (isAbsolutePathLike(trimmed) || !projectBasePath) {
 				return trimTrailingSlashes(trimmed);
 			}
-			return trimTrailingSlashes(options.fs ? options.fs.join(projectBasePath, trimmed) : joinPathSegments(projectBasePath, trimmed));
+			return trimTrailingSlashes(
+				options.fs ? options.fs.join(projectBasePath, trimmed) : joinPathSegments(projectBasePath, trimmed),
+			);
 		};
 
 		const resolveProjectPublishConfig = (): ResolvedProjectPublishConfig => {
@@ -1167,7 +1185,11 @@ export function publish(options: PublishOptions): Transform {
 			};
 		};
 
-		const resolvePackagePublishPlan = (pkg: Package, config: ResolvedProjectPublishConfig, projectBasePath?: string): ResolvedPackagePublishPlan => {
+		const resolvePackagePublishPlan = (
+			pkg: Package,
+			config: ResolvedProjectPublishConfig,
+			projectBasePath?: string,
+		): ResolvedPackagePublishPlan => {
 			let outputDir: string | undefined;
 
 			if (options.output) {
@@ -1215,7 +1237,7 @@ export function publish(options: PublishOptions): Transform {
 			},
 		});
 
-		const publishPackage = async ( plan: ResolvedPackagePublishPlan, writerFs: FileSystem, packageIndex: number) => {
+		const publishPackage = async (plan: ResolvedPackagePublishPlan, writerFs: FileSystem, packageIndex: number) => {
 			const atlasRuntimeOptions = resolvePublishAtlasRuntimeOptions(plan.fileExtension);
 			await atlas({
 				...plan.atlas,
@@ -1232,7 +1254,9 @@ export function publish(options: PublishOptions): Transform {
 
 			if (!options.fs) return;
 			if (!plan.outputDir) {
-				throw new Error('publish: no output directory resolved. Provide --output, or configure global publish.path / package publishPath.');
+				throw new Error(
+					'publish: no output directory resolved. Provide --output, or configure global publish.path / package publishPath.',
+				);
 			}
 
 			await options.fs.mkdir(plan.outputDir);
@@ -1268,8 +1292,7 @@ export function publish(options: PublishOptions): Transform {
 		const root = doc.getRoot();
 		const logger = doc.getLogger();
 		const projectBasePath = resolveProjectBasePath(options.basePath) || doc.getProjectDir?.() || '';
-		const pluginsDir = resolvePublishPluginsDir(doc, options);
-		const plugins = pluginsDir ? await loadPlugins(doc, pluginsDir) : [];
+		const plugins = options.plugins ?? [];
 		await runPublishPluginHook(plugins, 'onPublishStart', doc, options);
 
 		const resolved = resolveProjectPublishConfig();
@@ -1298,23 +1321,20 @@ export function publish(options: PublishOptions): Transform {
 			// Compute dependency list and selected publish artifacts before atlas packing,
 			// so merged-branch publishes can pack the overridden resources with main IDs.
 			_computeDependencies(doc, pkg, pkgMap);
-			await annotatePackagePublishArtifacts(
-				pkg,
-				options.basePath,
-				options.encoder as PublishEncoder | undefined,
-				{
-					projectType: resolved.projectType,
-					includeBranches: resolved.includeBranches,
-					activeBranch: resolved.activeBranch,
-					includeHighResolution: resolved.includeHighResolution,
-				},
-			);
+			await annotatePackagePublishArtifacts(pkg, options.basePath, options.encoder, {
+				projectType: resolved.projectType,
+				includeBranches: resolved.includeBranches,
+				activeBranch: resolved.activeBranch,
+				includeHighResolution: resolved.includeHighResolution,
+			});
 		}
 
 		const plans = allPackages.map((pkg) => resolvePackagePublishPlan(pkg, resolved, projectBasePath));
 
 		if (!options.fs) {
-			logger.info(`publish: No fs provided — layout computed for ${allPackages.length} package(s), skipping file output.`);
+			logger.info(
+				`publish: No fs provided — layout computed for ${allPackages.length} package(s), skipping file output.`,
+			);
 			const noopWriterFs = toBinaryWriterFileSystem(createNoopPublishFs());
 			for (const plan of plans) {
 				await publishPackage(plan, noopWriterFs, allDocPackages.indexOf(plan.pkg));
@@ -1338,14 +1358,18 @@ export function publish(options: PublishOptions): Transform {
 			await publishPackage(plan, writerFs, pkgIndex);
 		}
 
-		await publishCodeGeneration(doc, {
-			basePath: options.basePath,
-			fs: options.fs,
-			packages: allPackages,
-			plugins,
-		});
+		if (options.codeGeneration !== false) {
+			await publishCodeGeneration(doc, {
+				basePath: options.basePath,
+				fs: options.fs,
+				packages: allPackages,
+				plugins,
+			});
+		}
 
-		const publishedTargets = [...new Set(plans.map((plan) => plan.outputDir).filter((value): value is string => Boolean(value)))];
+		const publishedTargets = [
+			...new Set(plans.map((plan) => plan.outputDir).filter((value): value is string => Boolean(value))),
+		];
 		logger.info(
 			publishedTargets.length > 0
 				? `publish: Published ${allPackages.length} package(s) to ${publishedTargets.join(', ')}`
@@ -1363,7 +1387,12 @@ export function publish(options: PublishOptions): Transform {
 function _computeDependencies(doc: Document, pkg: Package, pkgMap: Map<string, Package>): void {
 	const referencedPkgIds = new Set<string>();
 	const pkgId = pkg.getId();
-	const packageOrder = new Map(doc.getRoot().listPackages().map((entry, index) => [entry.getId(), index] as const));
+	const packageOrder = new Map(
+		doc
+			.getRoot()
+			.listPackages()
+			.map((entry, index) => [entry.getId(), index] as const),
+	);
 	const addDependencyPackageId = (dependencyPkgId: string | null | undefined): void => {
 		const normalized = dependencyPkgId?.trim() ?? '';
 		if (!normalized || normalized === pkgId) return;

package/src/shared-types.ts

@@ -1,4 +1,6 @@
-import type { FileSystem, ProjectSettings, PublishSettings } from '@openfairygui/core';
+import type { ProjectSettings, PublishSettings } from '@openfairygui/core';
+
+export type { PublishFileSystem } from './publish/contracts.js';
 
 export type ExtrasMap = Record<string, unknown>;
 
@@ -57,10 +59,3 @@ export interface HasOptionalSrc {
 export interface HasOptionalUrl {
 	getUrl?(): string | undefined;
 }
-
-export type PublishFileSystem = Pick<FileSystem, 'join' | 'mkdir' | 'writeFileRaw'> & {
-	deleteFile?: (path: string) => Promise<void>;
-	exists?: FileSystem['exists'];
-	readdir?: FileSystem['readdir'];
-	readFileRaw?: FileSystem['readFileRaw'];
-};

package/src/web.ts

@@ -0,0 +1,11 @@
+export {
+	publishBrowser,
+	type BrowserPublishedFile,
+	type BrowserPublishAtlasOptions,
+	type BrowserPublishDiagnostic,
+	type BrowserPublishOptions,
+	type BrowserPublishProjectType,
+	type BrowserPublishResult,
+	type BrowserPublishOutputFileSystem,
+	type BrowserPublishSourceFileSystem,
+} from './adapters/web/publish.js';