@snaptrude/plugin-core 0.0.0-dev-20260708130115 → 0.0.0-dev-20260827135706

package/dist/api/entity/story.d.ts

@@ -1,5 +1,6 @@
 import * as z from "zod";
 import { PluginApiReturn } from "../../types";
+import { ComponentHandle } from "../../handles";
 /**
  * Story (floor/storey) management.
  *
@@ -38,6 +39,8 @@ export declare abstract class PluginStoryApi {
      * const info = await snaptrude.entity.story.get(1, ["height", "name", "spacesCount"])
      * console.log(info.name, info.height, info.spacesCount)
      * ```
+     *
+     * @deprecated Use `core.storeys.get`
      */
     abstract get(storyValue: number, properties: PluginStoryGetProperty[]): PluginApiReturn<PluginStoryGetResult>;
     /**
@@ -61,6 +64,8 @@ export declare abstract class PluginStoryApi {
      *   console.log(`Story ${s.value}: ${s.name} (id: ${s.id})`)
      * }
      * ```
+     *
+     * @deprecated Use `core.storeys.list`
      */
     abstract getAll(): PluginApiReturn<PluginStoryGetAllResult>;
     /**
@@ -87,33 +92,167 @@ export declare abstract class PluginStoryApi {
      * // Create a new third floor with custom height
      * const { storyId } = await snaptrude.entity.story.create(3, 4.5)
      * ```
+     *
+     * @deprecated Use `core.storeys.create`
      */
     abstract create(storyValue: number, height?: number): PluginApiReturn<PluginStoryCreateResult>;
     /**
-     * Update a story's height.
+     * Update a story's floor-to-floor `height` and/or `name`.
+     *
+     * **Height** is the same operation as editing the height in the Stories panel:
+     * the walls, columns, and masses on the story are **stretched** to the new
+     * height, every story **above shifts up/down** by the delta so the stack stays
+     * contiguous, and coupled elements (staircases, parametric curtain walls,
+     * furniture offsets) are re-fitted. The whole height cascade is committed as
+     * **one undo step**. Height-locked elements are left untouched.
+     *
+     * **Name** is the same as renaming the story in the Stories panel: it is
+     * persisted immediately (saved to the project) but, mirroring the panel, is
+     * **not** part of the height undo step.
      *
-     * Changes the floor-to-floor height of the specified story. This
-     * operation is undoable.
+     * At least one of `height` or `options.name` must be supplied. Omitting the
+     * `height` argument (e.g. for a rename-only update) leaves the height
+     * untouched.
      *
      * @param storyValue - Integer storey number
      *   identifying the story to update
-     * @param height - New height value in Babylon
-     *   units
-     * @returns A {@linkcode PluginStoryUpdateResult} with the updated `storyValue` and `height`
-     * @throws If the story does not exist or the update fails
+     * @param height - New floor-to-floor height in
+     *   Babylon units. Omit to leave the height unchanged.
+     * @param options - `name` (new display name for the story)
+     * @returns A {@linkcode PluginStoryUpdateResult} with the story's
+     *   `storyValue`, `height`, and `name` after the update
+     * @throws `PRECONDITION_FAILED` if no story has the given value;
+     *   `VALIDATION` if neither `height` nor `options.name` is supplied;
+     *   `STORY_HEIGHT_REJECTED` if the engine rejects the height (e.g. out of
+     *   range — the change silently reverts host-side and is surfaced as this
+     *   error); `STORY_UPDATE_FAILED` if the story cannot be re-read after the
+     *   update
      *
      * @examplePrompt Change the ground floor height to 3.5 metres
      * @examplePrompt Make the second storey taller
+     * @examplePrompt Rename the ground floor to "Lobby"
      * @examplePrompt Set the floor-to-floor height of level 1
-     * @examplePrompt Increase the height of the third floor
+     * @examplePrompt Rename storey 2 and make it taller in one go
      *
      * # Example
      * ```ts
-     * // Set ground floor height to 5 Babylon units
+     * // Set ground floor height to 5 Babylon units — walls stretch and the
+     * // floors above move up to match, all in a single undo step.
      * const result = await snaptrude.entity.story.update(1, 5)
+     * // Rename only, leaving the height untouched.
+     * await snaptrude.entity.story.update(1, undefined, { name: "Lobby" })
+     * ```
+     *
+     * @deprecated Use `core.storeys.update`
+     */
+    abstract update(storyValue: number, height?: number, options?: {
+        name?: string;
+    }): PluginApiReturn<PluginStoryUpdateResult>;
+    /**
+     * Make a story the active story — the same as clicking it in the storey/layer
+     * panel. Subsequent draws and creates target this story, and in 2D the
+     * viewport switches to it. This is a view/navigation change: it is **not**
+     * undoable and commits nothing to the model.
+     *
+     * @param storyValue - Integer storey number to activate
+     * @returns A {@linkcode PluginStorySetActiveResult} echoing the now-active `storyValue`
+     * @throws `PRECONDITION_FAILED` if no story has the given value
+     *
+     * @examplePrompt Switch to the second floor
+     * @examplePrompt Make the ground storey active
+     * @examplePrompt Go to the basement level
+     * @examplePrompt Set level 3 as the current storey
+     *
+     * # Example
+     * ```ts
+     * // Activate story 2, then draw a wall — it lands on story 2.
+     * await snaptrude.entity.story.setActive(2)
+     * ```
+     *
+     * @deprecated Use `core.storeys.setActive`
+     */
+    abstract setActive(storyValue: number): PluginApiReturn<PluginStorySetActiveResult>;
+    /**
+     * Delete a story and everything on it — the same as removing it from the
+     * storey panel. Every element placed on the story (walls, floors, masses, …)
+     * is deleted with it, the remaining stories are re-stacked, and the active
+     * story falls back to an adjacent one. Committed as a single undo step.
+     *
+     * @param storyValue - Integer storey number to delete
+     * @returns A {@linkcode PluginStoryDeleteResult} with the deleted `storyValue`
+     *   and the `newActiveStory` the editor fell back to
+     * @throws `PRECONDITION_FAILED` if no story has the given value; or if plugin
+     *   writes are disabled
+     *
+     * @examplePrompt Delete the top floor
+     * @examplePrompt Remove the basement level
+     * @examplePrompt Get rid of storey 3
+     * @examplePrompt Delete the second floor and everything on it
+     *
+     * # Example
+     * ```ts
+     * const { newActiveStory } = await snaptrude.entity.story.delete(3)
+     * console.log(`Deleted story 3; now on story ${newActiveStory}`)
+     * ```
+     *
+     * @deprecated Use `core.storeys.delete`
+     */
+    abstract delete(storyValue: number): PluginApiReturn<PluginStoryDeleteResult>;
+    /**
+     * Duplicate a story into the adjacent level, up or down.
+     *
+     * By default the **whole story** is duplicated: every eligible element on the
+     * active story (walls, floors, roofs, masses, columns, beams, staircases,
+     * ceilings, parametric curtain walls, and furniture) is copied into the story
+     * one level `"up"` or `"down"`. Pass `options.components` to duplicate only a
+     * subset instead. The target story is **created automatically** if it does not
+     * yet exist, inheriting the source story's height.
+     *
+     * Copies are **instanced** by default (`unique: false`) — they share geometry
+     * with the source, so later edits propagate. Set `unique: true` for independent
+     * geometry. Doors and windows are never duplicated on their own; they ride along
+     * with their host wall. Locked, throw-away, and unsupported elements are skipped
+     * and counted in `skipped`. The whole operation is a single undo step.
+     *
+     * @param direction - `"up"` to duplicate into the story above, `"down"` for below
+     * @param options - `components` (restrict to a subset of the story's elements;
+     *   omit for the whole story) and `unique` (default `false` = instanced copies;
+     *   `true` = independent geometry)
+     * @returns A {@linkcode PluginStoryDuplicateResult} with the `sourceStory`, the
+     *   `targetStories` the copies landed on, the `created` component handles, the
+     *   `createdStoryValues` for any stories generated to receive them, and the
+     *   `skipped` count of ineligible elements
+     * @throws `NO_ACTIVE_STRUCTURE` if there is no active structure to duplicate
+     *   into; `NO_ELIGIBLE_ELEMENTS` if nothing on the source story (or in
+     *   `options.components`) is duplicable; `HANDLE_INVALID` for a stale or
+     *   foreign supplied handle; or if plugin writes are disabled
+     *
+     * @examplePrompt Duplicate this floor to the storey above
+     * @examplePrompt Copy the ground floor down into a new basement
+     * @examplePrompt Repeat this level upwards with its own independent geometry
+     * @examplePrompt Duplicate just the selected walls onto the next floor up
+     *
+     * @performance For storeys that share a layout, duplicate the storey instead of recreating
+     *   its contents floor by floor — this copies every eligible element in one call, and the
+     *   default instanced copies keep the floors linked. To stack many identical floors, either
+     *   call this per level or capture the storey's component ids and
+     *   `design.create.copy(ids, oneFloorRise, { count })` to lay them all down in a single call.
+     *
+     * # Example
+     * ```ts
+     * // Duplicate the whole active story one level up (instanced copies).
+     * const { targetStories, created, skipped } =
+     *   await snaptrude.entity.story.duplicate("up")
+     * console.log(`Copied ${created.length} elements onto story ${targetStories}`)
+     * if (skipped) console.log(`${skipped} elements were skipped`)
      * ```
+     *
+     * @deprecated Use `core.storeys.copy`
      */
-    abstract update(storyValue: number, height: number): PluginApiReturn<PluginStoryUpdateResult>;
+    abstract duplicate(direction: "up" | "down", options?: {
+        components?: ComponentHandle[];
+        unique?: boolean;
+    }): PluginApiReturn<PluginStoryDuplicateResult>;
 }
 /**
  * Available properties that can be queried on a story.
@@ -221,29 +360,117 @@ export declare const PluginStoryCreateResult: z.ZodObject<{
 }, z.core.$strip>;
 export type PluginStoryCreateResult = z.infer<typeof PluginStoryCreateResult>;
 /**
- * Arguments for {@linkcode PluginStoryApi.update}.
+ * Arguments for {@linkcode PluginStoryApi.update}. At least one of `height` or
+ * `name` must be supplied.
  *
  * | Property | Type | Description |
  * |---|---|---|
  * | `storyValue` | `number` (int) | Storey number of the story to update |
- * | `height` | `number` | New height in Babylon units |
+ * | `height` | `number?` | New height in Babylon units (omit to leave unchanged) |
+ * | `name` | `string?` | New display name for the story (omit to leave unchanged) |
  */
 export declare const PluginStoryUpdateArgs: z.ZodObject<{
     storyValue: z.ZodNumber;
-    height: z.ZodNumber;
+    height: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type PluginStoryUpdateArgs = z.infer<typeof PluginStoryUpdateArgs>;
 /**
- * Result of {@linkcode PluginStoryApi.update}.
+ * Result of {@linkcode PluginStoryApi.update} — the story's state after the update.
  *
  * | Property | Type | Description |
  * |---|---|---|
  * | `storyValue` | `number` | The storey number of the updated story |
- * | `height` | `number` | The new height after the update |
+ * | `height` | `number` | The height after the update |
+ * | `name` | `string` | The name after the update |
  */
 export declare const PluginStoryUpdateResult: z.ZodObject<{
     storyValue: z.ZodNumber;
     height: z.ZodNumber;
+    name: z.ZodString;
 }, z.core.$strip>;
 export type PluginStoryUpdateResult = z.infer<typeof PluginStoryUpdateResult>;
+/**
+ * Arguments for {@linkcode PluginStoryApi.setActive}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `storyValue` | `number` (int) | Storey number to activate |
+ */
+export declare const PluginStorySetActiveArgs: z.ZodObject<{
+    storyValue: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginStorySetActiveArgs = z.infer<typeof PluginStorySetActiveArgs>;
+/**
+ * Result of {@linkcode PluginStoryApi.setActive}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `storyValue` | `number` | The storey number that is now active |
+ */
+export declare const PluginStorySetActiveResult: z.ZodObject<{
+    storyValue: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginStorySetActiveResult = z.infer<typeof PluginStorySetActiveResult>;
+/**
+ * Arguments for {@linkcode PluginStoryApi.delete}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `storyValue` | `number` (int) | Storey number to delete |
+ */
+export declare const PluginStoryDeleteArgs: z.ZodObject<{
+    storyValue: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginStoryDeleteArgs = z.infer<typeof PluginStoryDeleteArgs>;
+/**
+ * Result of {@linkcode PluginStoryApi.delete}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `storyValue` | `number` | The storey number that was deleted |
+ * | `newActiveStory` | `number` | The storey the editor fell back to as active |
+ */
+export declare const PluginStoryDeleteResult: z.ZodObject<{
+    storyValue: z.ZodNumber;
+    newActiveStory: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginStoryDeleteResult = z.infer<typeof PluginStoryDeleteResult>;
+/**
+ * Arguments for {@linkcode PluginStoryApi.duplicate} (options flattened).
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `direction` | `'up' \| 'down'` | Which adjacent story to duplicate into |
+ * | `components` | {@linkcode ComponentHandle}`[]?` | Restrict to a subset; omit for the whole story |
+ * | `unique` | `boolean?` | `false` (default) = instanced copies; `true` = independent geometry |
+ */
+export declare const PluginStoryDuplicateArgs: z.ZodObject<{
+    direction: z.ZodEnum<{
+        up: "up";
+        down: "down";
+    }>;
+    components: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>>;
+    unique: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type PluginStoryDuplicateArgs = z.infer<typeof PluginStoryDuplicateArgs>;
+/**
+ * Result of {@linkcode PluginStoryApi.duplicate}.
+ *
+ * | Property | Type | Description |
+ * |---|---|---|
+ * | `sourceStory` | `number` | Storey value the copies were duplicated from |
+ * | `targetStories` | `number[]` | Storey values the copies landed on |
+ * | `created` | {@linkcode ComponentHandle}`[]` | Handles of the newly created components |
+ * | `createdStoryValues` | `number[]` | Storey values that were generated to receive the copies |
+ * | `skipped` | `number` | Count of ineligible elements that were skipped |
+ */
+export declare const PluginStoryDuplicateResult: z.ZodObject<{
+    sourceStory: z.ZodNumber;
+    targetStories: z.ZodArray<z.ZodNumber>;
+    created: z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<ComponentHandle, string>>>;
+    createdStoryValues: z.ZodArray<z.ZodNumber>;
+    skipped: z.ZodNumber;
+}, z.core.$strip>;
+export type PluginStoryDuplicateResult = z.infer<typeof PluginStoryDuplicateResult>;
 //# sourceMappingURL=story.d.ts.map

package/dist/api/entity/story.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../../src/api/entity/story.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAA;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;;;;;;;GAWG;AACH,8BAAsB,cAAc;;IAGlC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,GAAG,CACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,sBAAsB,EAAE,GACnC,eAAe,CAAC,oBAAoB,CAAC;IAExC;;;;;;;;;;;;;;;;;;;;;OAqBG;aACa,MAAM,IAAI,eAAe,CAAC,uBAAuB,CAAC;IAElE;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,eAAe,CAAC,uBAAuB,CAAC;IAE3C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;aACa,MAAM,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,eAAe,CAAC,uBAAuB,CAAC;CAC5C;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;EASjC,CAAA;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;iBAG7B,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;iBAWrB,CAAA;AAEZ,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;;;;iBAQlC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AAEF,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA"}
+{"version":3,"file":"story.d.ts","sourceRoot":"","sources":["../../../src/api/entity/story.ts"],"names":[],"mappings":"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"}

package/dist/api/index.d.ts

@@ -3,6 +3,8 @@ import { PluginDesignApi } from "./design";
 import { PluginEntityApi } from "./entity";
 import { PluginProgramApi } from "./program";
 import { PluginPresentationApi } from "./presentation";
+import { PluginAnalysisApi } from "./analysis";
+import { PluginWorkspaceApi } from "./workspace";
 /**
  * Root API surface for Snaptrude plugins.
  *
@@ -13,6 +15,8 @@ import { PluginPresentationApi } from "./presentation";
  * - {@linkcode PluginApi.entity} — CRUD operations on Snaptrude entities (spaces, stories)
  * - {@linkcode PluginApi.program} — Program-mode planning reads (departments, metrics)
  * - {@linkcode PluginApi.presentation} — Presentation preparation (views, AI Inspiration)
+ * - {@linkcode PluginApi.analysis} — Sustainability analysis (sunpath, shadows, sunlight/illuminance heatmaps)
+ * - {@linkcode PluginApi.workspace} — Dashboard surface: projects and teams
  */
 export declare abstract class PluginApi {
     /** Core math, geometry, history, and units primitives. See {@linkcode PluginCoreApi}. */
@@ -25,6 +29,10 @@ export declare abstract class PluginApi {
     abstract program: PluginProgramApi;
     /** Presentation preparation reads — saved views. See {@linkcode PluginPresentationApi}. */
     abstract presentation: PluginPresentationApi;
+    /** Sustainability analysis — sun & daylight studies. See {@linkcode PluginAnalysisApi}. */
+    abstract analysis: PluginAnalysisApi;
+    /** Dashboard surface — projects and teams. See {@linkcode PluginWorkspaceApi}. */
+    abstract workspace: PluginWorkspaceApi;
     constructor();
 }
 export * from "./core";
@@ -32,4 +40,6 @@ export * from "./design";
 export * from "./entity";
 export * from "./program";
 export * from "./presentation";
+export * from "./analysis";
+export * from "./workspace";
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAEtD;;;;;;;;;;GAUG;AACH,8BAAsB,SAAS;IAC7B,yFAAyF;IACzF,SAAgB,IAAI,EAAE,aAAa,CAAA;IACnC,0EAA0E;IAC1E,SAAgB,MAAM,EAAE,eAAe,CAAA;IACvC,8EAA8E;IAC9E,SAAgB,MAAM,EAAE,eAAe,CAAA;IACvC,oGAAoG;IACpG,SAAgB,OAAO,EAAE,gBAAgB,CAAA;IACzC,2FAA2F;IAC3F,SAAgB,YAAY,EAAE,qBAAqB,CAAA;;CAGpD;AAED,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;;;;;;GAYG;AACH,8BAAsB,SAAS;IAC7B,yFAAyF;IACzF,SAAgB,IAAI,EAAE,aAAa,CAAA;IACnC,0EAA0E;IAC1E,SAAgB,MAAM,EAAE,eAAe,CAAA;IACvC,8EAA8E;IAC9E,SAAgB,MAAM,EAAE,eAAe,CAAA;IACvC,oGAAoG;IACpG,SAAgB,OAAO,EAAE,gBAAgB,CAAA;IACzC,2FAA2F;IAC3F,SAAgB,YAAY,EAAE,qBAAqB,CAAA;IACnD,2FAA2F;IAC3F,SAAgB,QAAQ,EAAE,iBAAiB,CAAA;IAC3C,kFAAkF;IAClF,SAAgB,SAAS,EAAE,kBAAkB,CAAA;;CAG9C;AAED,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/api/presentation/aiInspiration.d.ts

@@ -6,8 +6,8 @@ type JsonValue = z.infer<typeof JsonPrimitive> | JsonValue[] | {
 };
 declare const JsonValue: z.ZodType<JsonValue>;
 export declare const PluginAIInspirationRunMode: z.ZodEnum<{
-    blocking: "blocking";
     job: "job";
+    blocking: "blocking";
 }>;
 export type PluginAIInspirationRunMode = z.infer<typeof PluginAIInspirationRunMode>;
 export declare const PluginAIInspirationOutputKind: z.ZodEnum<{
@@ -58,16 +58,16 @@ export declare const PluginAIInspirationVideoDuration: z.ZodEnum<{
 }>;
 export type PluginAIInspirationVideoDuration = z.infer<typeof PluginAIInspirationVideoDuration>;
 export declare const PluginAIInspirationJobStatus: z.ZodEnum<{
-    queued: "queued";
+    failed: "failed";
     running: "running";
+    queued: "queued";
     completed: "completed";
-    failed: "failed";
     cancelled: "cancelled";
 }>;
 export type PluginAIInspirationJobStatus = z.infer<typeof PluginAIInspirationJobStatus>;
 export declare const PluginAIInspirationWorkflowRunState: z.ZodEnum<{
-    running: "running";
     failed: "failed";
+    running: "running";
     current: "current";
     stale: "stale";
     superseded: "superseded";
@@ -486,8 +486,8 @@ export declare const PluginAIInspirationGenerateArgs: z.ZodObject<{
         }>>;
     }, z.core.$strip>>;
     runMode: z.ZodOptional<z.ZodEnum<{
-        blocking: "blocking";
         job: "job";
+        blocking: "blocking";
     }>>;
 }, z.core.$strip>;
 export type PluginAIInspirationGenerateArgs = z.infer<typeof PluginAIInspirationGenerateArgs>;
@@ -537,8 +537,8 @@ export declare const PluginAIInspirationRefineArgs: z.ZodObject<{
     sourceShapeId: z.ZodString;
     upscaleFactor: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1.5>, z.ZodLiteral<2>, z.ZodLiteral<4>]>>;
     runMode: z.ZodOptional<z.ZodEnum<{
-        blocking: "blocking";
         job: "job";
+        blocking: "blocking";
     }>>;
 }, z.core.$strip>;
 export type PluginAIInspirationRefineArgs = z.infer<typeof PluginAIInspirationRefineArgs>;
@@ -551,10 +551,10 @@ export type PluginAIInspirationJobProgress = z.infer<typeof PluginAIInspirationJ
 export declare const PluginAIInspirationJob: z.ZodObject<{
     jobId: z.ZodString;
     status: z.ZodEnum<{
-        queued: "queued";
+        failed: "failed";
         running: "running";
+        queued: "queued";
         completed: "completed";
-        failed: "failed";
         cancelled: "cancelled";
     }>;
     createdAt: z.ZodNumber;
@@ -618,10 +618,10 @@ export declare const PluginAIInspirationGetJobResult: z.ZodObject<{
     job: z.ZodObject<{
         jobId: z.ZodString;
         status: z.ZodEnum<{
-            queued: "queued";
+            failed: "failed";
             running: "running";
+            queued: "queued";
             completed: "completed";
-            failed: "failed";
             cancelled: "cancelled";
         }>;
         createdAt: z.ZodNumber;
@@ -682,10 +682,10 @@ export declare const PluginAIInspirationCancelJobResult: z.ZodObject<{
     job: z.ZodObject<{
         jobId: z.ZodString;
         status: z.ZodEnum<{
-            queued: "queued";
+            failed: "failed";
             running: "running";
+            queued: "queued";
             completed: "completed";
-            failed: "failed";
             cancelled: "cancelled";
         }>;
         createdAt: z.ZodNumber;
@@ -746,10 +746,10 @@ export declare const PluginAIInspirationListJobsResult: z.ZodObject<{
     jobs: z.ZodArray<z.ZodObject<{
         jobId: z.ZodString;
         status: z.ZodEnum<{
-            queued: "queued";
+            failed: "failed";
             running: "running";
+            queued: "queued";
             completed: "completed";
-            failed: "failed";
             cancelled: "cancelled";
         }>;
         createdAt: z.ZodNumber;
@@ -873,8 +873,8 @@ export declare const PluginAIInspirationWorkflowNode: z.ZodObject<{
     }>;
     state: z.ZodString;
     runState: z.ZodOptional<z.ZodEnum<{
-        running: "running";
         failed: "failed";
+        running: "running";
         current: "current";
         stale: "stale";
         superseded: "superseded";
@@ -928,8 +928,8 @@ export declare const PluginAIInspirationWorkflowEdge: z.ZodObject<{
     }, z.core.$strip>;
     state: z.ZodString;
     runState: z.ZodOptional<z.ZodEnum<{
-        running: "running";
         failed: "failed";
+        running: "running";
         current: "current";
         stale: "stale";
         superseded: "superseded";
@@ -956,8 +956,8 @@ export declare const PluginAIInspirationWorkflow: z.ZodObject<{
         }>;
         state: z.ZodString;
         runState: z.ZodOptional<z.ZodEnum<{
-            running: "running";
             failed: "failed";
+            running: "running";
             current: "current";
             stale: "stale";
             superseded: "superseded";
@@ -1010,8 +1010,8 @@ export declare const PluginAIInspirationWorkflow: z.ZodObject<{
         }, z.core.$strip>;
         state: z.ZodString;
         runState: z.ZodOptional<z.ZodEnum<{
-            running: "running";
             failed: "failed";
+            running: "running";
             current: "current";
             stale: "stale";
             superseded: "superseded";
@@ -1046,8 +1046,8 @@ export declare const PluginAIInspirationGetWorkflowForShapeResult: z.ZodObject<{
             }>;
             state: z.ZodString;
             runState: z.ZodOptional<z.ZodEnum<{
-                running: "running";
                 failed: "failed";
+                running: "running";
                 current: "current";
                 stale: "stale";
                 superseded: "superseded";
@@ -1100,8 +1100,8 @@ export declare const PluginAIInspirationGetWorkflowForShapeResult: z.ZodObject<{
             }, z.core.$strip>;
             state: z.ZodString;
             runState: z.ZodOptional<z.ZodEnum<{
-                running: "running";
                 failed: "failed";
+                running: "running";
                 current: "current";
                 stale: "stale";
                 superseded: "superseded";
@@ -1125,8 +1125,8 @@ export declare const PluginAIInspirationGetWorkflowForShapeResult: z.ZodObject<{
         }>;
         state: z.ZodString;
         runState: z.ZodOptional<z.ZodEnum<{
-            running: "running";
             failed: "failed";
+            running: "running";
             current: "current";
             stale: "stale";
             superseded: "superseded";
@@ -1153,8 +1153,8 @@ export declare const PluginAIInspirationRerunPlanResult: z.ZodDiscriminatedUnion
         }>;
         state: z.ZodString;
         runState: z.ZodOptional<z.ZodEnum<{
-            running: "running";
             failed: "failed";
+            running: "running";
             current: "current";
             stale: "stale";
             superseded: "superseded";
@@ -1208,8 +1208,8 @@ export declare const PluginAIInspirationRerunPlanResult: z.ZodDiscriminatedUnion
         }, z.core.$strip>;
         state: z.ZodString;
         runState: z.ZodOptional<z.ZodEnum<{
-            running: "running";
             failed: "failed";
+            running: "running";
             current: "current";
             stale: "stale";
             superseded: "superseded";
@@ -1334,8 +1334,8 @@ export declare const PluginAIInspirationRerunSelectedBranchArgs: z.ZodObject<{
     shapeId: z.ZodString;
     endFrameShapeId: z.ZodOptional<z.ZodString>;
     runMode: z.ZodOptional<z.ZodEnum<{
-        blocking: "blocking";
         job: "job";
+        blocking: "blocking";
     }>>;
 }, z.core.$strip>;
 export type PluginAIInspirationRerunSelectedBranchArgs = z.infer<typeof PluginAIInspirationRerunSelectedBranchArgs>;
@@ -2026,8 +2026,8 @@ export declare const PluginAIInspirationRunRecipeArgs: z.ZodObject<{
     }, unknown>>>;
     slotShapeIds: z.ZodRecord<z.ZodString, z.ZodString>;
     runMode: z.ZodOptional<z.ZodEnum<{
-        blocking: "blocking";
         job: "job";
+        blocking: "blocking";
     }>>;
 }, z.core.$strip>;
 export type PluginAIInspirationRunRecipeArgs = z.infer<typeof PluginAIInspirationRunRecipeArgs>;