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

package/dist/codegen-CEnmtjBP.d.ts

@@ -0,0 +1,241 @@
+import { l as PublishFileSystem, r as AtlasRasterBackend, t as AtlasOptions } from "./atlas-CDn6TirX.js";
+import { Component, Document, Package, ProjectSettings, PublishSettings, Transform } from "@openfairygui/core";
+
+//#region src/publish.d.ts
+interface PublishOptions {
+  /**
+   * Output directory override for published files (.fui + atlas PNGs).
+   * When omitted, publish uses package-level or project-level publish paths.
+   */
+  output?: string;
+  /**
+   * Compress the binary data with zlib raw deflate. Default: false.
+   */
+  compressed?: boolean;
+  /**
+   * File extension for the binary output. Default: 'fui'.
+   * Unity projects typically use 'bytes'.
+   */
+  fileExtension?: string;
+  /**
+   * Raster backend for atlas image compositing.
+   * If not provided, atlas packing only computes layout (no PNGs generated).
+   */
+  encoder?: AtlasRasterBackend;
+  /**
+   * Base path for reading source images (project assets root).
+   * Required when encoder is provided.
+   */
+  basePath?: string;
+  /**
+   * Atlas packing options.
+   */
+  atlas?: Omit<AtlasOptions, 'encoder' | 'basePath' | 'outputPath'>;
+  /**
+   * Filter which packages to publish by name. If not set, all packages are published.
+   */
+  packages?: string[];
+  /**
+   * FileSystem abstraction for writing output files.
+   * Required for actual file output. Without it, only the Document model
+   * is updated (atlas layout computed, sprite nodes created).
+   */
+  fs?: PublishFileSystem;
+  /**
+   * Active branch name used when branchProcessing is "主干合并活跃分支".
+   * Empty or omitted means publishing the main branch.
+   */
+  branch?: string;
+  /**
+   * 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;
+}
+interface ResolvedPublishAtlasOptions extends Pick<AtlasOptions, 'maxSize' | 'fast' | 'allowRotation' | 'padding' | 'powerOfTwo' | 'square' | 'multiPage' | 'trimImage' | 'extractAlpha'> {}
+interface ResolvePublishOptionsOverrides {
+  compressed?: boolean;
+  fileExtension?: string;
+  packages?: string[];
+  atlas?: Partial<ResolvedPublishAtlasOptions>;
+}
+interface ResolvedPublishOptions {
+  compressed: boolean;
+  fileExtension: string;
+  packages?: string[];
+  atlas: ResolvedPublishAtlasOptions;
+}
+/**
+ * Resolve publish defaults from the document's project settings.
+ *
+ * This keeps the editor-aligned publish rules reusable across environments,
+ * while callers still provide environment-specific concerns such as fs/encoder/basePath.
+ */
+declare function resolvePublishOptions(doc: Document, overrides?: ResolvePublishOptionsOverrides): ResolvedPublishOptions;
+/**
+ * Publishes a FairyGUI project.
+ *
+ * Orchestrates:
+ * 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();
+ * const doc = await io.readProject('./project.fairy');
+ *
+ * await doc.transform(publish({
+ *   output: './release/',
+ *   compressed: true,
+ *   encoder: sharp,
+ *   basePath: './assets/',
+ *   fileExtension: 'bytes',
+ *   fs: io.createFileSystem(),
+ * }));
+ * ```
+ */
+declare function publish(options: PublishOptions): Transform;
+//#endregion
+//#region src/shared-types.d.ts
+type ExtrasMap = Record<string, unknown>;
+interface CliCodeGenerationSettings extends NonNullable<PublishSettings['codeGeneration']> {
+  allowGenCode?: boolean;
+  classNamePrefix?: string;
+  codePath?: string;
+  codeType?: string;
+  getMemberByName?: boolean;
+  ignoreNoname?: boolean;
+  memberNamePrefix?: string;
+  packageName?: string;
+}
+interface CliAtlasSettings extends NonNullable<PublishSettings['atlasSetting']> {
+  maxSize?: number;
+  paging?: boolean;
+  sizeOption?: string;
+  forceSquare?: boolean;
+  fast?: boolean;
+  allowRotation?: boolean;
+  padding?: number;
+  trimImage?: boolean;
+  extractAlpha?: boolean;
+}
+interface CliPublishSettings extends PublishSettings {
+  atlasSetting?: CliAtlasSettings;
+  codeGeneration?: CliCodeGenerationSettings;
+}
+type RootProjectSettings = ProjectSettings & {
+  publish?: CliPublishSettings;
+};
+interface PublishDependency {
+  id: string;
+  name: string;
+}
+interface HasOptionalFont {
+  getFont?(): string | string[] | null | undefined;
+}
+interface HasOptionalSrc {
+  getSrc?(): string | undefined;
+}
+interface HasOptionalUrl {
+  getUrl?(): string | undefined;
+}
+//#endregion
+//#region src/plugins/types.d.ts
+type MaybePromise<T> = T | Promise<T>;
+interface PluginManifest {
+  name: string;
+  displayName?: string;
+  description?: string;
+  version?: string;
+  author?: {
+    name?: string;
+  };
+  icon?: string;
+  main: string;
+}
+interface ICodeWriterConfig {
+  blockStart?: string;
+  blockEnd?: string;
+  blockFromNewLine?: boolean;
+  usingTabs?: boolean;
+  endOfLine?: string;
+  fileMark?: string;
+}
+interface CodeWriter {
+  writeMark(): void;
+  writeln(fmt?: string, ...args: any[]): CodeWriter;
+  startBlock(): CodeWriter;
+  endBlock(): CodeWriter;
+  incIndent(): CodeWriter;
+  decIndent(): CodeWriter;
+  reset(): void;
+  toString(): string;
+  save(filePath: string): void;
+}
+interface Plugin {
+  genCode?: (doc: Document, settings: Required<CliCodeGenerationSettings>, options: PublishCodeGenerationOptions) => MaybePromise<void>;
+  onPublishStart?: (doc: Document, options: PublishOptions) => MaybePromise<void>;
+  onPublishEnd?: (doc: Document, options: PublishOptions) => MaybePromise<void>;
+}
+interface LoadedPlugin {
+  name: string;
+  plugin: Plugin;
+}
+type PluginModule = Plugin & {
+  default?: Plugin;
+};
+//#endregion
+//#region src/codegen.d.ts
+declare const AUTO_GENERATED_CODE_MARK = "/** This is an automatically generated class by FairyGUI. Please do not modify it. **/";
+interface PublishCodeGenerationOptions {
+  basePath?: string;
+  fs: PublishFileSystem;
+  packages: Package[];
+  plugins?: LoadedPlugin[];
+}
+interface ResolvedPackageCodegenPlan {
+  outputDir: string;
+  packageFolderName: string;
+  packageNamespace: string;
+  binderClassName: string;
+  settings: CliCodeGenerationSettings;
+}
+interface CodegenMember {
+  index: number;
+  kind: 'child' | 'controller' | 'transition';
+  name: string;
+  originalName: string;
+  type: string;
+  ignored: boolean;
+  referencedComponent?: CodegenReferencedComponent;
+}
+interface CodegenReferencedComponent {
+  component: Component;
+  package: Package;
+}
+interface CodegenClass {
+  classId: string;
+  className: string;
+  encodedClassName: string;
+  componentType: string;
+  componentName: string;
+  packageName: string;
+  url: string;
+  members: CodegenMember[];
+}
+declare function publishCodeGeneration(doc: Document, options: PublishCodeGenerationOptions): Promise<void>;
+declare function resolvePackageCodegenPlan(pkg: Package, settings: CliCodeGenerationSettings, options: PublishCodeGenerationOptions): ResolvedPackageCodegenPlan | null;
+declare function buildCodegenClasses(doc: Document, pkg: Package, plan: ResolvedPackageCodegenPlan): CodegenClass[];
+declare function encodeText(value: string): Uint8Array;
+declare function decodeText(value: Uint8Array): string;
+//#endregion
+export { ResolvedPublishAtlasOptions as A, HasOptionalFont as C, RootProjectSettings as D, PublishDependency as E, publish as M, resolvePublishOptions as N, PublishOptions as O, ExtrasMap as S, HasOptionalUrl as T, PluginManifest as _, PublishCodeGenerationOptions as a, CliCodeGenerationSettings as b, decodeText as c, resolvePackageCodegenPlan as d, CodeWriter as f, Plugin as g, MaybePromise as h, CodegenReferencedComponent as i, ResolvedPublishOptions as j, ResolvePublishOptionsOverrides as k, encodeText as l, LoadedPlugin as m, CodegenClass as n, ResolvedPackageCodegenPlan as o, ICodeWriterConfig as p, CodegenMember as r, buildCodegenClasses as s, AUTO_GENERATED_CODE_MARK as t, publishCodeGeneration as u, PluginModule as v, HasOptionalSrc as w, CliPublishSettings as x, CliAtlasSettings as y };