@rslsp1/fa-app-tools 2.0.68 → 2.0.72

package/dist/index.d.mts

@@ -261,9 +261,124 @@ interface InspectPanelProps {
 }
 declare const InspectPanel: React__default.FC<InspectPanelProps>;
 
+interface TagBaseUser {
+    id: number;
+    username: string;
+    active_context_id?: number;
+}
+interface TagBaseContext {
+    id: number;
+    name: string;
+    label: string;
+    owner_id: number;
+}
+interface TagBaseTagEntry {
+    id: number;
+    context_id: number;
+    category: string;
+    label: string;
+    value: string;
+    ord: number;
+}
+interface TagBaseMeta {
+    version: number;
+    generatedAt: number | string;
+}
+interface TagBase {
+    users: TagBaseUser[];
+    contexts: TagBaseContext[];
+    tags: TagBaseTagEntry[];
+    meta: TagBaseMeta;
+}
+interface TagBaseEventVersion {
+    major: number;
+    minor: number;
+}
+declare const CURRENT_TAG_EVENT_VERSION: TagBaseEventVersion;
+interface TagCreatedPayload {
+    context_id: number;
+    category: string;
+    label: string;
+    value: string;
+    ord: number;
+}
+interface TagUpdatedDelta {
+    label?: string;
+    value?: string;
+    category?: string;
+    ord?: number;
+    enabled?: 0 | 1;
+}
+interface TagUpdatedPayload {
+    id: number;
+    delta: TagUpdatedDelta;
+}
+interface TagBaseEventBase {
+    v: TagBaseEventVersion;
+    ts: number;
+    clientId: string;
+    baseVersion: number;
+    userId: number;
+}
+interface TagCreatedEvent extends TagBaseEventBase {
+    type: 'tag_created';
+    payload: TagCreatedPayload;
+}
+interface TagUpdatedEvent extends TagBaseEventBase {
+    type: 'tag_updated';
+    payload: TagUpdatedPayload;
+}
+type TagBaseEvent = TagCreatedEvent | TagUpdatedEvent;
+declare function loadTagBase(namespace: string, token: string): Promise<TagBase | null>;
+declare function writeTagEvent(namespace: string, token: string, event: TagBaseEvent): Promise<void>;
+declare function createTagCreatedEvent(baseVersion: number, userId: number, payload: TagCreatedPayload): TagCreatedEvent;
+declare function createTagUpdatedEvent(baseVersion: number, userId: number, id: number, delta: TagUpdatedDelta): TagUpdatedEvent;
+interface TagBaseTagOption {
+    id: number | null;
+    label: string;
+    value: string;
+    category: string;
+    ord: number;
+    pending?: boolean;
+}
+interface TagBaseWorkspaceTags {
+    by_category: Record<string, TagBaseTagOption[]>;
+    all: TagBaseTagOption[];
+}
+declare function deriveTagBaseWorkspaceTags(tags: TagBaseTagEntry[], contextId: number, pending?: TagBaseTagOption[]): TagBaseWorkspaceTags;
+interface SelectionValidation {
+    valid: boolean;
+    reason: string | null;
+}
+declare function validateTagBaseSelection(base: TagBase, userId: number | null, contextId: number | null): SelectionValidation;
+
+interface TagBaseSectionProps {
+    tagBase: TagBase | null;
+    isLoading: boolean;
+    error: string | null;
+    needsPicker: boolean;
+    pickerMessage: string | null;
+    selectedUserId: number | null;
+    selectedContextId: number | null;
+    selectUser: (userId: number) => void;
+    selectContext: (contextId: number) => void;
+    resetSelection: () => void;
+    workspaceTags: TagBaseWorkspaceTags;
+    categories: string[];
+    createTag: (payload: {
+        category: string;
+        label: string;
+        value: string;
+    }) => Promise<void>;
+    updateTag: (id: number, delta: TagUpdatedDelta) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+declare function TagBaseSection(props: TagBaseSectionProps): React__default.JSX.Element;
+
 interface SetupPanelProps {
     onWorkspaceImport: (file: File) => void;
     buildInfo?: string;
+    tagBase?: TagBaseSectionProps;
 }
 declare const SetupPanel: React__default.FC<SetupPanelProps>;
 
@@ -645,6 +760,29 @@ declare function findTips(dag: Dag): number[];
 declare function findForks(dag: Dag): DagFork[];
 declare function topoSort(events: HFEvent[]): HFEvent[];
 
-declare const LIB_VERSION = "2.0.68";
+interface UseTagBaseResult {
+    tagBase: TagBase | null;
+    isLoading: boolean;
+    error: string | null;
+    selectedUserId: number | null;
+    selectedContextId: number | null;
+    needsPicker: boolean;
+    pickerMessage: string | null;
+    selectUser: (userId: number) => void;
+    selectContext: (contextId: number) => void;
+    resetSelection: () => void;
+    workspaceTags: TagBaseWorkspaceTags;
+    categories: string[];
+    refresh: () => Promise<void>;
+    createTag: (payload: {
+        category: string;
+        label: string;
+        value: string;
+    }) => Promise<void>;
+    updateTag: (id: number, delta: TagUpdatedDelta) => Promise<void>;
+}
+declare function useTagBase(token: string, namespace: string): UseTagBaseResult;
+
+declare const LIB_VERSION = "2.0.72";
 
-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, LabFrameExtractor, type LabFrameExtractorProps, 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, ServerTab, 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 };
+export { AvatarArchitectApp, type AvatarArchitectAppProps, CURRENT_TAG_EVENT_VERSION, 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, LabFrameExtractor, type LabFrameExtractorProps, 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, type SelectionValidation, ServerTab, SetupPanel, type SyncDiff, type TagBase, type TagBaseContext, type TagBaseEvent, type TagBaseMeta, TagBaseSection, type TagBaseSectionProps, type TagBaseTagEntry, type TagBaseTagOption, type TagBaseUser, type TagBaseWorkspaceTags, type TagCreatedEvent, type TagCreatedPayload, TagManagerPanel, type TagOption, type TagUpdatedDelta, type TagUpdatedEvent, type TagUpdatedPayload, type TagUpsertedPayload, type UseTagBaseResult, type WorkspaceTags, applyEvent, applyEvents, autoLabel, buildBlendInstruction, buildCompareInstruction, buildDag, buildFallbackPrompt, buildGenerationPrompt, buildImageGenerationOptions, buildLoopInstruction, buildPromptTabPayload, buildReferenceImageMediaIds, buildRemixInstruction, buildScanInstruction, cleanAiResponse, createFlowServices, createTagCreatedEvent, createTagUpdatedEvent, deriveTagBaseWorkspaceTags, exportProjectToZip, findForks, findTips, formatTreeToMarkdown, frameToGeneration, getFormattedTimestamp, getHFToken, getSessionClientId, groupGenerationsToLabItems, hfBatchArchive, hfBootstrapFromLegacy, hfDeleteProject, hfDownloadProject, hfListDir, hfListProjects, hfLoadImageAsBase64, hfUploadImage, hfUploadProjectForm, hfUploadSmallFile, importProjectFromZip, injectXMPMetadata, interpretSdkError, loadHFState, loadPendingEvents, loadTagBase, parsePromptFile, parsePromptResponse, setHFToken, topoSort, tsFromEventPath, useHFState, useKeyboardNavigation, useOnClickOutside, useTagBase, validateTagBaseSelection, writeHFEvent, writeTagEvent };

package/dist/index.d.ts

@@ -261,9 +261,124 @@ interface InspectPanelProps {
 }
 declare const InspectPanel: React__default.FC<InspectPanelProps>;
 
+interface TagBaseUser {
+    id: number;
+    username: string;
+    active_context_id?: number;
+}
+interface TagBaseContext {
+    id: number;
+    name: string;
+    label: string;
+    owner_id: number;
+}
+interface TagBaseTagEntry {
+    id: number;
+    context_id: number;
+    category: string;
+    label: string;
+    value: string;
+    ord: number;
+}
+interface TagBaseMeta {
+    version: number;
+    generatedAt: number | string;
+}
+interface TagBase {
+    users: TagBaseUser[];
+    contexts: TagBaseContext[];
+    tags: TagBaseTagEntry[];
+    meta: TagBaseMeta;
+}
+interface TagBaseEventVersion {
+    major: number;
+    minor: number;
+}
+declare const CURRENT_TAG_EVENT_VERSION: TagBaseEventVersion;
+interface TagCreatedPayload {
+    context_id: number;
+    category: string;
+    label: string;
+    value: string;
+    ord: number;
+}
+interface TagUpdatedDelta {
+    label?: string;
+    value?: string;
+    category?: string;
+    ord?: number;
+    enabled?: 0 | 1;
+}
+interface TagUpdatedPayload {
+    id: number;
+    delta: TagUpdatedDelta;
+}
+interface TagBaseEventBase {
+    v: TagBaseEventVersion;
+    ts: number;
+    clientId: string;
+    baseVersion: number;
+    userId: number;
+}
+interface TagCreatedEvent extends TagBaseEventBase {
+    type: 'tag_created';
+    payload: TagCreatedPayload;
+}
+interface TagUpdatedEvent extends TagBaseEventBase {
+    type: 'tag_updated';
+    payload: TagUpdatedPayload;
+}
+type TagBaseEvent = TagCreatedEvent | TagUpdatedEvent;
+declare function loadTagBase(namespace: string, token: string): Promise<TagBase | null>;
+declare function writeTagEvent(namespace: string, token: string, event: TagBaseEvent): Promise<void>;
+declare function createTagCreatedEvent(baseVersion: number, userId: number, payload: TagCreatedPayload): TagCreatedEvent;
+declare function createTagUpdatedEvent(baseVersion: number, userId: number, id: number, delta: TagUpdatedDelta): TagUpdatedEvent;
+interface TagBaseTagOption {
+    id: number | null;
+    label: string;
+    value: string;
+    category: string;
+    ord: number;
+    pending?: boolean;
+}
+interface TagBaseWorkspaceTags {
+    by_category: Record<string, TagBaseTagOption[]>;
+    all: TagBaseTagOption[];
+}
+declare function deriveTagBaseWorkspaceTags(tags: TagBaseTagEntry[], contextId: number, pending?: TagBaseTagOption[]): TagBaseWorkspaceTags;
+interface SelectionValidation {
+    valid: boolean;
+    reason: string | null;
+}
+declare function validateTagBaseSelection(base: TagBase, userId: number | null, contextId: number | null): SelectionValidation;
+
+interface TagBaseSectionProps {
+    tagBase: TagBase | null;
+    isLoading: boolean;
+    error: string | null;
+    needsPicker: boolean;
+    pickerMessage: string | null;
+    selectedUserId: number | null;
+    selectedContextId: number | null;
+    selectUser: (userId: number) => void;
+    selectContext: (contextId: number) => void;
+    resetSelection: () => void;
+    workspaceTags: TagBaseWorkspaceTags;
+    categories: string[];
+    createTag: (payload: {
+        category: string;
+        label: string;
+        value: string;
+    }) => Promise<void>;
+    updateTag: (id: number, delta: TagUpdatedDelta) => Promise<void>;
+    refresh: () => Promise<void>;
+}
+declare function TagBaseSection(props: TagBaseSectionProps): React__default.JSX.Element;
+
 interface SetupPanelProps {
     onWorkspaceImport: (file: File) => void;
     buildInfo?: string;
+    tagBase?: TagBaseSectionProps;
 }
 declare const SetupPanel: React__default.FC<SetupPanelProps>;
 
@@ -645,6 +760,29 @@ declare function findTips(dag: Dag): number[];
 declare function findForks(dag: Dag): DagFork[];
 declare function topoSort(events: HFEvent[]): HFEvent[];
 
-declare const LIB_VERSION = "2.0.68";
+interface UseTagBaseResult {
+    tagBase: TagBase | null;
+    isLoading: boolean;
+    error: string | null;
+    selectedUserId: number | null;
+    selectedContextId: number | null;
+    needsPicker: boolean;
+    pickerMessage: string | null;
+    selectUser: (userId: number) => void;
+    selectContext: (contextId: number) => void;
+    resetSelection: () => void;
+    workspaceTags: TagBaseWorkspaceTags;
+    categories: string[];
+    refresh: () => Promise<void>;
+    createTag: (payload: {
+        category: string;
+        label: string;
+        value: string;
+    }) => Promise<void>;
+    updateTag: (id: number, delta: TagUpdatedDelta) => Promise<void>;
+}
+declare function useTagBase(token: string, namespace: string): UseTagBaseResult;
+
+declare const LIB_VERSION = "2.0.72";
 
-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, LabFrameExtractor, type LabFrameExtractorProps, 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, ServerTab, 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 };
+export { AvatarArchitectApp, type AvatarArchitectAppProps, CURRENT_TAG_EVENT_VERSION, 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, LabFrameExtractor, type LabFrameExtractorProps, 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, type SelectionValidation, ServerTab, SetupPanel, type SyncDiff, type TagBase, type TagBaseContext, type TagBaseEvent, type TagBaseMeta, TagBaseSection, type TagBaseSectionProps, type TagBaseTagEntry, type TagBaseTagOption, type TagBaseUser, type TagBaseWorkspaceTags, type TagCreatedEvent, type TagCreatedPayload, TagManagerPanel, type TagOption, type TagUpdatedDelta, type TagUpdatedEvent, type TagUpdatedPayload, type TagUpsertedPayload, type UseTagBaseResult, type WorkspaceTags, applyEvent, applyEvents, autoLabel, buildBlendInstruction, buildCompareInstruction, buildDag, buildFallbackPrompt, buildGenerationPrompt, buildImageGenerationOptions, buildLoopInstruction, buildPromptTabPayload, buildReferenceImageMediaIds, buildRemixInstruction, buildScanInstruction, cleanAiResponse, createFlowServices, createTagCreatedEvent, createTagUpdatedEvent, deriveTagBaseWorkspaceTags, exportProjectToZip, findForks, findTips, formatTreeToMarkdown, frameToGeneration, getFormattedTimestamp, getHFToken, getSessionClientId, groupGenerationsToLabItems, hfBatchArchive, hfBootstrapFromLegacy, hfDeleteProject, hfDownloadProject, hfListDir, hfListProjects, hfLoadImageAsBase64, hfUploadImage, hfUploadProjectForm, hfUploadSmallFile, importProjectFromZip, injectXMPMetadata, interpretSdkError, loadHFState, loadPendingEvents, loadTagBase, parsePromptFile, parsePromptResponse, setHFToken, topoSort, tsFromEventPath, useHFState, useKeyboardNavigation, useOnClickOutside, useTagBase, validateTagBaseSelection, writeHFEvent, writeTagEvent };