@rslsp1/fa-app-tools 1.3.18 → 2.0.12

package/dist/index.d.ts

@@ -310,12 +310,14 @@ interface AvatarArchitectAppProps {
     onSelectMedia: () => Promise<MediaItem[]>;
     buildInfo?: string;
     initialHfToken?: string;
+    hfNamespace?: string;
+    allowDevNamespace?: boolean;
     onFetchServerProjects?: () => Promise<ProjectMeta[]>;
     onServerSave?: (zipBase64: string, name: string) => Promise<ProjectMeta>;
     onServerLoad?: (id: string) => Promise<File>;
     onServerDelete?: (id: string) => Promise<void>;
 }
-declare function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onSelectMedia, buildInfo, initialHfToken, onFetchServerProjects, onServerSave, onServerLoad, onServerDelete }: AvatarArchitectAppProps): react_jsx_runtime.JSX.Element;
+declare function AvatarArchitectApp({ onGenerateImage, onGeneratePrompt, onDownload, onSelectMedia, buildInfo, initialHfToken, hfNamespace, allowDevNamespace, onFetchServerProjects, onServerSave, onServerLoad, onServerDelete }: AvatarArchitectAppProps): react_jsx_runtime.JSX.Element;
 
 interface FaAppProps {
     onGenerateImage: (params: Record<string, any>) => Promise<{
@@ -347,13 +349,15 @@ interface FaAppProps {
         mediaId: string;
     }>;
     libToken?: string;
+    allowDevNamespace?: boolean;
+    serverBaseUrl?: string;
     onFetchServerProjects?: () => Promise<ProjectMeta[]>;
     onServerSave?: (zipBase64: string, name: string) => Promise<ProjectMeta>;
     onServerLoad?: (id: string) => Promise<File>;
     onServerDelete?: (id: string) => Promise<void>;
     buildInfo?: string;
 }
-declare function FaApp({ onGenerateImage, onGeneratePrompt, onGenerateVideo: _onGenerateVideo, onDownload, onSelectMedia, onFlowSave: _onFlowSave, onFlowUpload: _onFlowUpload, onFlowMediaUpload: _onFlowMediaUpload, libToken, onFetchServerProjects, onServerSave, onServerLoad, onServerDelete, buildInfo, }: FaAppProps): react_jsx_runtime.JSX.Element;
+declare function FaApp({ onGenerateImage, onGeneratePrompt, onGenerateVideo: _onGenerateVideo, onDownload, onSelectMedia, onFlowSave: _onFlowSave, onFlowUpload: _onFlowUpload, onFlowMediaUpload: _onFlowMediaUpload, libToken, allowDevNamespace, serverBaseUrl, onFetchServerProjects, onServerSave, onServerLoad, onServerDelete, buildInfo, }: FaAppProps): react_jsx_runtime.JSX.Element;
 
 interface CollapsibleCardProps {
     title: string;
@@ -394,6 +398,7 @@ interface PromptTabProps {
 declare const PromptTab: React.FC<PromptTabProps>;
 
 interface ProjectSyncTabProps {
+    topSlot?: React.ReactNode;
     onProjectExport?: () => Promise<void>;
     onProjectImport?: (file: File) => Promise<void>;
     onWorkspaceImport?: (file: File) => void;
@@ -498,6 +503,46 @@ declare function buildLoopInstruction(rounds: Array<{
 declare function autoLabel(index: number): string;
 declare function buildReferenceImageMediaIds(images: SelectedLabImage[]): string[];
 
+interface HFEventVersion {
+    major: number;
+    minor: number;
+}
+interface HFEvent<P = unknown> {
+    v: HFEventVersion;
+    type: string;
+    ts: number;
+    prevTs: number[];
+    clientId: string;
+    payload: P;
+}
+interface HFStateMeta {
+    consolidatedAt: number;
+    version: number;
+}
+interface HFStateSnapshot {
+    metadata: HFMetadataEntry[];
+    tags: WorkspaceTags;
+    meta: HFStateMeta;
+}
+interface HFFileInfo$1 {
+    type: 'file' | 'directory';
+    path: string;
+    size: number;
+}
+interface ImageAddedPayload extends HFMetadataEntry {
+}
+interface TagUpsertedPayload {
+    category: string;
+    label: string;
+    value: string;
+    is_user_created?: boolean;
+    is_deleted?: boolean;
+}
+interface MetadataUpdatedPayload {
+    id: string;
+    delta: Partial<HFMetadataEntry>;
+}
+
 declare function getHFToken(): string | null;
 declare function setHFToken(token: string): void;
 interface HFProjectMeta {
@@ -507,17 +552,66 @@ interface HFProjectMeta {
     size: number;
     isLfs: boolean;
 }
+interface HFFileInfo {
+    type: 'file' | 'directory';
+    path: string;
+    size: number;
+}
+declare function hfListDir(namespace: string, subdir: string, token: string): Promise<HFFileInfo[]>;
+declare function hfUploadSmallFile(repoPath: string, content: string, token: string, summary?: string): Promise<void>;
+declare function hfBatchArchive(moves: Array<{
+    from: string;
+    to: string;
+    content: string;
+}>, token: string, summary: string): Promise<void>;
+declare function tsFromEventPath(repoPath: string): number;
+declare function loadHFState(namespace: string, token: string): Promise<HFStateSnapshot | null>;
+declare function loadPendingEvents(namespace: string, token: string, sinceTs: number): Promise<HFEvent[]>;
+declare function getSessionClientId(): string;
+declare function writeHFEvent<P>(namespace: string, token: string, type: string, payload: P, prevTs: number[]): Promise<HFEvent<P>>;
+declare function hfBootstrapFromLegacy(namespace: string, token: string, onProgress?: (msg: string) => void): Promise<void>;
 declare function hfListProjects(token: string): Promise<HFProjectMeta[]>;
 declare function hfDownloadProject(path: string, token: string): Promise<File>;
-declare function hfUploadProjectForm(zipBase64: string, name: string, token: string): Promise<HFProjectMeta>;
+declare function hfUploadProjectForm(_zipBase64: string, _name: string, _token: string): Promise<HFProjectMeta>;
 declare function hfDeleteProject(path: string, token: string): Promise<void>;
-declare function hfSaveTags(workspaceTags: any, token: string): Promise<void>;
-declare function hfLoadTags(token: string): Promise<any | null>;
-declare function hfSaveMetadata(entries: any[], token: string): Promise<void>;
-declare function hfLoadMetadata(token: string): Promise<any[]>;
 declare function hfUploadImage(base64: string, id: string, token: string, mimeType?: string): Promise<void>;
 declare function hfLoadImageAsBase64(id: string, token: string): Promise<string | null>;
 
-declare const LIB_VERSION = "1.3.18";
+interface HFStateResult {
+    state: HFStateSnapshot | null;
+    isLoading: boolean;
+    error: string | null;
+    pendingBufferCount: number;
+    eventCount: number;
+    forks: Array<{
+        parentTs: number;
+        childTs: number[];
+    }>;
+    allEvents: HFEvent[];
+    writeEvent: (type: string, payload: any) => Promise<void>;
+    refresh: () => Promise<void>;
+    lastEventTs: number;
+    hasStateZip: boolean;
+}
+declare function useHFState(token: string, namespace: string): HFStateResult;
+
+declare function applyEvent(state: HFStateSnapshot, event: HFEvent): HFStateSnapshot;
+declare function applyEvents(state: HFStateSnapshot, events: HFEvent[]): HFStateSnapshot;
+
+interface DagNode {
+    event: HFEvent;
+    children: number[];
+}
+interface DagFork {
+    parentTs: number;
+    childTs: number[];
+}
+type Dag = Map<number, DagNode>;
+declare function buildDag(events: HFEvent[]): Dag;
+declare function findTips(dag: Dag): number[];
+declare function findForks(dag: Dag): DagFork[];
+declare function topoSort(events: HFEvent[]): HFEvent[];
+
+declare const LIB_VERSION = "2.0.12";
 
-export { AvatarArchitectApp, type AvatarArchitectAppProps, CollapsibleCard, CompactDropdown, type ExtractedCharacter, FaApp, type FaAppProps, FaToolsBadge, type FlowSdk, GLOBAL_STYLES, type Generation, type HFMetadataEntry, HistoryPanel, InspectPanel, LIB_VERSION, LabBlend, LabCompare, type LabFrame, LabImagePicker, type LabItem, LabLoop, LabRemix, type LabServices, LabsTab, ListView, type MediaItem, MediaLibrary, PillButton, type ProjectMeta, type ProjectSettings, ProjectSyncTab, PromptTab, SectionLabel, type SelectedLabImage, type SelectedTag, SetupPanel, type SyncDiff, TagManagerPanel, type TagOption, type WorkspaceTags, autoLabel, buildBlendInstruction, buildCompareInstruction, buildFallbackPrompt, buildGenerationPrompt, buildImageGenerationOptions, buildLoopInstruction, buildPromptTabPayload, buildReferenceImageMediaIds, buildRemixInstruction, buildScanInstruction, cleanAiResponse, createFlowServices, exportProjectToZip, formatTreeToMarkdown, frameToGeneration, getFormattedTimestamp, getHFToken, groupGenerationsToLabItems, hfDeleteProject, hfDownloadProject, hfListProjects, hfLoadImageAsBase64, hfLoadMetadata, hfLoadTags, hfSaveMetadata, hfSaveTags, hfUploadImage, hfUploadProjectForm, importProjectFromZip, injectXMPMetadata, interpretSdkError, parsePromptFile, parsePromptResponse, setHFToken, useKeyboardNavigation, useOnClickOutside };
+export { AvatarArchitectApp, type AvatarArchitectAppProps, CollapsibleCard, CompactDropdown, type DagFork, type ExtractedCharacter, FaApp, type FaAppProps, FaToolsBadge, type FlowSdk, GLOBAL_STYLES, type Generation, type HFEvent, type HFEventVersion, type HFFileInfo$1 as HFFileInfo, type HFMetadataEntry, type HFStateMeta, type HFStateResult, type HFStateSnapshot, HistoryPanel, type ImageAddedPayload, InspectPanel, LIB_VERSION, LabBlend, LabCompare, type LabFrame, LabImagePicker, type LabItem, LabLoop, LabRemix, type LabServices, LabsTab, ListView, type MediaItem, MediaLibrary, type MetadataUpdatedPayload, PillButton, type ProjectMeta, type ProjectSettings, ProjectSyncTab, PromptTab, SectionLabel, type SelectedLabImage, type SelectedTag, SetupPanel, type SyncDiff, TagManagerPanel, type TagOption, type TagUpsertedPayload, type WorkspaceTags, applyEvent, applyEvents, autoLabel, buildBlendInstruction, buildCompareInstruction, buildDag, buildFallbackPrompt, buildGenerationPrompt, buildImageGenerationOptions, buildLoopInstruction, buildPromptTabPayload, buildReferenceImageMediaIds, buildRemixInstruction, buildScanInstruction, cleanAiResponse, createFlowServices, exportProjectToZip, findForks, findTips, formatTreeToMarkdown, frameToGeneration, getFormattedTimestamp, getHFToken, getSessionClientId, groupGenerationsToLabItems, hfBatchArchive, hfBootstrapFromLegacy, hfDeleteProject, hfDownloadProject, hfListDir, hfListProjects, hfLoadImageAsBase64, hfUploadImage, hfUploadProjectForm, hfUploadSmallFile, importProjectFromZip, injectXMPMetadata, interpretSdkError, loadHFState, loadPendingEvents, parsePromptFile, parsePromptResponse, setHFToken, topoSort, tsFromEventPath, useHFState, useKeyboardNavigation, useOnClickOutside, writeHFEvent };