@things-factory/figure-ui 10.1.241 → 10.1.244

package/dist-client/modeller/product-session.d.ts

@@ -8,6 +8,16 @@ export interface FigureProductRecord {
     id: string;
     source: string;
 }
+/**
+ * The row's catalogue fields -- the type (before release), the category, the tags. Kept on the row, not in the asset,
+ * and saved with it by 「저장」: written at once on change, they stayed after 「저장하지 않고 떠나기」 and the save
+ * button never lit for them (2026-11-01 audit item 5).
+ */
+export interface FigureCatalogPatch {
+    type?: string;
+    category?: string;
+    tags?: string[];
+}
 /** Persistence is injected; neither the model engine nor the renderer owns the product ID. */
 export interface FigureProductStore {
     load(id: string): Promise<FigureProductRecord>;
@@ -30,10 +40,26 @@ export interface FigureProductStore {
         /** Keys of the AI proposals whose steps the source holds: the server records them with the save. */
         proposalKeys?: string[];
     }): Promise<FigureProductRecord>;
+    /** Writes the row's catalogue fields of a saved figure. */
+    updateCatalog(id: string, patch: FigureCatalogPatch): Promise<unknown>;
 }
 /** Product lifecycle boundary. A late response can never change another editor's asset or ID. */
 export declare function createFigureProductSession(store: FigureProductStore): {
     read: () => {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -44,13 +70,26 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         fields: never[];
         geometry: never[];
         bindings: never[];
-        dirty: false;
         revision: null;
         canUndo?: undefined;
         canRedo?: undefined;
         palette?: undefined;
         asset?: undefined;
     } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -59,10 +98,9 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         context: string;
         name: string;
         revision: number;
-        dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         asset: import("@hatiolab/figure-model").FigureAsset;
@@ -77,11 +115,229 @@ export declare function createFigureProductSession(store: FigureProductStore): {
      * -- the server writes over it only while it still holds this. Nothing for a figure not saved yet.
      */
     confirmedSource: () => string | undefined;
+    /**
+     * A catalogue field changed, held for the next save; one changed back to what the row holds (`saved`) is no
+     * change. Only a saved figure has a row to write: a new figure's type goes with its first save. Taken while a save
+     * is on its way too: the field shows it, so it is held for the save after (2026-11-01 re-check). A field that save
+     * is writing is held whatever it is changed to -- back to the old value too, which the save is about to replace;
+     * the save done lets go only of a value it wrote (2026-11-01 second re-check).
+     */
+    editCatalog(patch: FigureCatalogPatch, saved: FigureCatalogPatch): {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
+        id: string | undefined;
+        creationId: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+        asset?: undefined;
+    } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
+        id: string | undefined;
+        creationId: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
+            value: number;
+        }>;
+        asset: import("@hatiolab/figure-model").FigureAsset;
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    /**
+     * After a conflict, the edits written over the server's latest: the next save expects that latest, so it goes
+     * through only while the server still holds it -- a third change meanwhile is a conflict again.
+     */
+    overwriteConflict(): {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
+        id: string | undefined;
+        creationId: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+        asset?: undefined;
+    } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
+        id: string | undefined;
+        creationId: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
+            value: number;
+        }>;
+        asset: import("@hatiolab/figure-model").FigureAsset;
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
+    /**
+     * After a conflict, the edits kept as a figure of their own: from here they are a new figure, under a new creation
+     * id, saved by the first save's question; the figure they came from is left as the server holds it.
+     */
+    detachAsCopy(): {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
+        id: string | undefined;
+        creationId: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: null;
+        name: null;
+        fields: never[];
+        geometry: never[];
+        bindings: never[];
+        revision: null;
+        canUndo?: undefined;
+        canRedo?: undefined;
+        palette?: undefined;
+        asset?: undefined;
+    } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
+        id: string | undefined;
+        creationId: string | undefined;
+        loading: boolean;
+        saving: boolean;
+        error: string | undefined;
+        context: string;
+        name: string;
+        revision: number;
+        canUndo: boolean;
+        canRedo: boolean;
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
+            value: number;
+        }>;
+        asset: import("@hatiolab/figure-model").FigureAsset;
+        geometry: import("@hatiolab/figure-model").FigureAssetGeometry[];
+        bindings: import("@hatiolab/figure-model").FigureEvaluatedBinding[];
+        palette: Record<string, string>;
+    };
     /** A new figure, named in the screen's language by the page: the session has no words of its own. */
     startNew({ discard, name }: {
         discard?: boolean;
         name: string;
     }): {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -92,13 +348,26 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         fields: never[];
         geometry: never[];
         bindings: never[];
-        dirty: false;
         revision: null;
         canUndo?: undefined;
         canRedo?: undefined;
         palette?: undefined;
         asset?: undefined;
     } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -107,10 +376,9 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         context: string;
         name: string;
         revision: number;
-        dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         asset: import("@hatiolab/figure-model").FigureAsset;
@@ -121,6 +389,20 @@ export declare function createFigureProductSession(store: FigureProductStore): {
     open(nextId: string, { discard }?: {
         discard?: boolean | undefined;
     }): Promise<{
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -131,13 +413,26 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         fields: never[];
         geometry: never[];
         bindings: never[];
-        dirty: false;
         revision: null;
         canUndo?: undefined;
         canRedo?: undefined;
         palette?: undefined;
         asset?: undefined;
     } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -146,10 +441,9 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         context: string;
         name: string;
         revision: number;
-        dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         asset: import("@hatiolab/figure-model").FigureAsset;
@@ -160,6 +454,20 @@ export declare function createFigureProductSession(store: FigureProductStore): {
     close({ discard }?: {
         discard?: boolean | undefined;
     }): {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -170,13 +478,26 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         fields: never[];
         geometry: never[];
         bindings: never[];
-        dirty: false;
         revision: null;
         canUndo?: undefined;
         canRedo?: undefined;
         palette?: undefined;
         asset?: undefined;
     } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -185,10 +506,9 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         context: string;
         name: string;
         revision: number;
-        dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         asset: import("@hatiolab/figure-model").FigureAsset;
@@ -215,7 +535,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -246,7 +566,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -286,7 +606,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -313,7 +633,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -382,7 +702,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -417,7 +737,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -444,7 +764,7 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         readonly asset: import("@hatiolab/figure-model").FigureAsset;
@@ -465,6 +785,20 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         type?: string;
         namespace?: string;
     }): Promise<{
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -475,13 +809,26 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         fields: never[];
         geometry: never[];
         bindings: never[];
-        dirty: false;
         revision: null;
         canUndo?: undefined;
         canRedo?: undefined;
         palette?: undefined;
         asset?: undefined;
     } | {
+        dirty: boolean;
+        catalog: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        catalogWritten: {
+            type?: string;
+            category?: string;
+            tags?: string[];
+        };
+        conflict: {
+            latest: string | undefined;
+        } | undefined;
         id: string | undefined;
         creationId: string | undefined;
         loading: boolean;
@@ -490,10 +837,9 @@ export declare function createFigureProductSession(store: FigureProductStore): {
         context: string;
         name: string;
         revision: number;
-        dirty: boolean;
         canUndo: boolean;
         canRedo: boolean;
-        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"] /** The card's picture. Absent when the browser could not draw one; the source is saved either way. */[number] & {
+        fields: Array<import("@hatiolab/figure-model").FigureAsset["document"]["model"]["inputs"][number] & {
             value: number;
         }>;
         asset: import("@hatiolab/figure-model").FigureAsset;