@konitif/workbench 0.285.7 → 0.285.9

package/README.md

@@ -13,6 +13,7 @@ npm install @konitif/workbench
 
 - Workspace, layout, panel and shell contracts.
 - Tool and widget admission, registries and hosting adapters.
+- Generic widget-zone visibility and placement-drop projection.
 - Runtime lifecycle, checkpoint, recovery and observability contracts.
 - Project preflight and repository-quality contracts.
 - Explicit workspace persistence, synchronization and surface ports.

package/dist/application/experience/experienceLifecycle.d.ts

@@ -60,4 +60,5 @@ export declare function transitionWorkbenchExperienceLifecycle<TMetadata>(input:
     experience: WorkbenchExperience<TMetadata>;
     expected: Exclude<ExperienceLifecycleStatus, 'tombstoned'>;
     next: ExperienceLifecycleStatus;
+    metadata?: TMetadata;
 }): ExperienceLifecycleResult<WorkbenchExperience<TMetadata>>;

package/dist/application/experience/experienceLifecycle.js

@@ -83,7 +83,11 @@ export function transitionWorkbenchExperienceLifecycle(input) {
     if (!isAllowedTransition(input.experience.lifecycle, input.next)) {
         return refused('experience.lifecycle.status-conflict', '$.next', `Experience lifecycle cannot transition from ${input.experience.lifecycle} to ${input.next}.`, undefined, input.next);
     }
-    return accepted({ ...input.experience, lifecycle: input.next });
+    return accepted({
+        ...input.experience,
+        lifecycle: input.next,
+        metadata: input.metadata ?? input.experience.metadata,
+    });
 }
 function isAllowedTransition(current, next) {
     return next === 'tombstoned'

package/dist/application/experience/experienceRepository.d.ts

@@ -38,5 +38,6 @@ export interface WorkbenchExperienceRepository<TMetadata = unknown, TSpecializat
         experienceId: ExperienceIdentity;
         expected: Exclude<ExperienceLifecycleStatus, 'tombstoned'>;
         next: ExperienceLifecycleStatus;
+        metadata?: TMetadata;
     }): Promise<WorkbenchExperienceRepositoryResult<WorkbenchExperience<TMetadata>>>;
 }

package/dist/application/widgets/widgetZoneProjection.d.ts

@@ -0,0 +1,15 @@
+export type WorkbenchWidgetZoneProjectionReason = 'closed' | 'visible-content' | 'empty-edit-drop-target' | 'empty-runtime';
+export interface WorkbenchWidgetZoneProjection {
+    visible: boolean;
+    acceptsPlacementDrop: boolean;
+    reason: WorkbenchWidgetZoneProjectionReason;
+}
+/**
+ * Projects an authored widget-zone state into host-facing visibility and drop
+ * affordances without owning either the zone content or its renderer.
+ */
+export declare function projectWorkbenchWidgetZone(input: {
+    containerOpen: boolean;
+    visiblePlacementCount: number;
+    layoutEditingEnabled: boolean;
+}): WorkbenchWidgetZoneProjection;

package/dist/application/widgets/widgetZoneProjection.js

@@ -0,0 +1,20 @@
+/**
+ * Projects an authored widget-zone state into host-facing visibility and drop
+ * affordances without owning either the zone content or its renderer.
+ */
+export function projectWorkbenchWidgetZone(input) {
+    if (!input.containerOpen) {
+        return { visible: false, acceptsPlacementDrop: false, reason: 'closed' };
+    }
+    if (input.visiblePlacementCount > 0) {
+        return {
+            visible: true,
+            acceptsPlacementDrop: input.layoutEditingEnabled,
+            reason: 'visible-content'
+        };
+    }
+    if (input.layoutEditingEnabled) {
+        return { visible: true, acceptsPlacementDrop: true, reason: 'empty-edit-drop-target' };
+    }
+    return { visible: false, acceptsPlacementDrop: false, reason: 'empty-runtime' };
+}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from "./boot/index.js";
 export * from "./application/launch/workbenchLaunchPolicy.js";
 export * from "./application/launch/catalogShareReference.js";
 export * from "./application/widgets/createWorkbenchWidgetAdapter.js";
+export * from "./application/widgets/widgetZoneProjection.js";
 export * from "./application/tool/experienceToolSelection.js";
 export * from "./stage/index.js";
 export * from "./application/shell/state.js";

package/dist/index.js

@@ -2,6 +2,7 @@ export * from "./boot/index.js";
 export * from "./application/launch/workbenchLaunchPolicy.js";
 export * from "./application/launch/catalogShareReference.js";
 export * from "./application/widgets/createWorkbenchWidgetAdapter.js";
+export * from "./application/widgets/widgetZoneProjection.js";
 export * from "./application/tool/experienceToolSelection.js";
 export * from "./stage/index.js";
 export * from "./application/shell/state.js";

package/dist/infrastructure/persistence/BrowserExperienceRepository.d.ts

@@ -1,8 +1,11 @@
-import type { WorkbenchExperienceRepository } from "../../application/experience/experienceRepository.js";
+import type { WorkbenchExperienceRepository, WorkbenchExperienceRepositoryResult, WorkbenchExperienceRepositorySnapshot } from "../../application/experience/experienceRepository.js";
 export interface BrowserExperienceRepositoryStorage {
     getItem(key: string): string | null;
     setItem(key: string, value: string): void;
 }
+export interface BrowserWorkbenchExperienceRepository<TMetadata = unknown, TSpecialization = unknown> extends WorkbenchExperienceRepository<TMetadata, TSpecialization> {
+    initialize(snapshot: WorkbenchExperienceRepositorySnapshot<TMetadata, TSpecialization>): Promise<WorkbenchExperienceRepositoryResult<WorkbenchExperienceRepositorySnapshot<TMetadata, TSpecialization>>>;
+}
 /**
  * Browser persistence adapter for the generic Workbench Experience authority.
  * Products choose the storage key and keep migration and specialization policy
@@ -11,4 +14,4 @@ export interface BrowserExperienceRepositoryStorage {
 export declare function createBrowserWorkbenchExperienceRepository<TMetadata = unknown, TSpecialization = unknown>(input: {
     storageKey: string;
     storage?: BrowserExperienceRepositoryStorage | null;
-}): WorkbenchExperienceRepository<TMetadata, TSpecialization>;
+}): BrowserWorkbenchExperienceRepository<TMetadata, TSpecialization>;

package/dist/infrastructure/persistence/BrowserExperienceRepository.js

@@ -10,6 +10,18 @@ export function createBrowserWorkbenchExperienceRepository(input) {
     const storageKey = requireStorageKey(input.storageKey);
     return {
         hydrate: () => hydrate(storage, storageKey),
+        async initialize(snapshot) {
+            const current = await hydrate(storage, storageKey);
+            if (!current.ok)
+                return current;
+            if (current.value.experiences.length > 0 || current.value.revisions.length > 0) {
+                return refused('experience.repository.already-exists', 'Browser Experience repository is already initialized.');
+            }
+            if (!isRepositorySnapshot(snapshot)) {
+                return refused('experience.repository.invalid-artifact', 'Initial Experience snapshot does not match the Workbench contract.');
+            }
+            return persist(storage, storageKey, snapshot);
+        },
         async list() {
             const snapshot = await hydrate(storage, storageKey);
             return snapshot.ok ? accepted(snapshot.value.experiences) : snapshot;
@@ -78,6 +90,7 @@ export function createBrowserWorkbenchExperienceRepository(input) {
                 experience,
                 expected: value.expected,
                 next: value.next,
+                metadata: value.metadata,
             });
             if (!transitioned.ok)
                 return lifecycleRefused(transitioned.diagnostics[0]);
@@ -141,6 +154,11 @@ function isStoredRepository(value) {
         || !Array.isArray(value.experiences)
         || !Array.isArray(value.revisions))
         return false;
+    return isRepositorySnapshot(value);
+}
+function isRepositorySnapshot(value) {
+    if (!isRecord(value) || !Array.isArray(value.experiences) || !Array.isArray(value.revisions))
+        return false;
     const experiences = value.experiences;
     const revisions = value.revisions;
     if (!experiences.every(isWorkbenchExperience) || !revisions.every(isWorkbenchExperienceRevision))
@@ -149,7 +167,9 @@ function isStoredRepository(value) {
         && isIdentity(revision.experienceId, 'experience')
         && isIdentity(revision.id, 'experience-revision')
         && revision.experienceId.value === experience.id.value
-        && revision.id.value === experience.headRevisionId.value));
+        && revision.id.value === experience.headRevisionId.value)) && revisions.every(revision => experiences.some(experience => isRecord(revision)
+        && isIdentity(revision.experienceId, 'experience')
+        && revision.experienceId.value === experience.id.value));
 }
 function isWorkbenchExperience(value) {
     return isRecord(value)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@konitif/workbench",
   "license": "PolyForm-Noncommercial-1.0.0",
-  "version": "0.285.7",
+  "version": "0.285.9",
   "description": "Workspace composition, docking, registries and hosting contracts for KONITIF.",
   "repository": {
     "type": "git",

package/reference/catalog.json

@@ -107,7 +107,9 @@
       ],
       "symbolNames": [
         "createWorkbenchWidgetAdapter",
-        "WorkbenchWidgetHosting"
+        "WorkbenchWidgetHosting",
+        "projectWorkbenchWidgetZone",
+        "WorkbenchWidgetZoneProjection"
       ]
     },
     {