@widgetic/creator 0.3.60 → 0.3.61

package/dist/components/WidgetShapeLivePreviews.svelte.d.ts

@@ -8,23 +8,45 @@ interface VersionOption {
     dateLabel?: string;
     /** True when this option is the live published version. */
     isLive?: boolean;
+    /** True when this version has never been published. */
+    isDraft?: boolean;
 }
+type ShapeRect = {
+    widgetId: string;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    localWidth?: number;
+    localHeight?: number;
+    matrix?: number[];
+    /** Pointer is over the shape (Fabric mouse:over); keeps chrome visible. */
+    hovered?: boolean;
+    src: string;
+};
 interface Props {
     class?: string;
     style?: string;
     enabled?: boolean;
-    /** Screen-space boxes for widget shapes currently on the canvas. */
-    getRects?: (() => Array<{
-        widgetId: string;
-        left: number;
-        top: number;
-        width: number;
-        height: number;
-    }>) | null;
+    /** Shared host: inactive units < active body (60) < controls (70) < active chrome (80). */
+    portalTarget?: string;
+    /** Bounds park chrome; the local dimensions/matrix transform the live body. */
+    getRects?: (() => Array<Omit<ShapeRect, 'src'>>) | null;
     /** Resolve a live preview URL for a widget (CDN published or Worker preview). */
     resolveUrl?: ((widgetId: string) => string | null) | null;
+    /** Keep chrome visible while a historical build is pending or failed. */
+    resolvePreviewState?: ((widgetId: string) => {
+        loading: boolean;
+        error: string | null;
+    } | null) | null;
+    /** Retry the selected historical version; never refresh shared HEAD. */
+    onRetryPreview?: ((widgetId: string) => void) | null;
     /** Currently selected WidgetShape id (highlights chrome). */
     selectedWidgetId?: string | null;
+    primaryWidgetId?: string | null;
+    onSetPrimary?: ((widgetId: string) => void) | null;
+    /** Shared publish gate; explicit versions must not inherit another row's error. */
+    resolvePublishDisabled?: ((widgetId: string, version?: number | null) => boolean) | null;
     /** Translate shape by screen-pixel delta. */
     onTranslate?: ((widgetId: string, dxScreen: number, dyScreen: number) => void) | null;
     /** Fired once when a chrome drag ends (mark canvas dirty / history). */
@@ -41,21 +63,31 @@ interface Props {
     resolveVersionOptions?: ((widgetId: string) => Array<VersionOption> | null) | null;
     /** Currently selected version option id. */
     resolveVersionSelectedId?: ((widgetId: string) => string | null) | null;
-    onVersionChange?: ((widgetId: string, versionId: string) => void) | null;
+    onVersionChange?: ((widgetId: string, versionId: string, buildPreview?: boolean) => void) | null;
     /** Promote a published version to Live (same as chat Set live). */
     onSetLive?: ((widgetId: string, version: number) => void) | null;
     /** Version currently being set live (disables that row's button). */
     settingLiveVersion?: number | null;
-    /** Optional notify after local iframe reload (does not capture screenshots). */
-    onRefresh?: ((widgetId: string) => void) | null;
+    /** Capture callback after an explicit reload has loaded and settled. */
+    onRefresh?: ((widgetId: string, iframe: HTMLIFrameElement, isCurrent: () => boolean) => void | Promise<void>) | null;
     /** Bump when widget names / publish state change so chrome re-renders. */
     titleRevision?: number;
     /** Whether this widget has unpublished codegen ahead of Live (show Publish). */
     resolveCanPublish?: ((widgetId: string) => boolean) | null;
+    /**
+     * Whether a specific Draft row can be published. Drafts carry their own
+     * commit, so they can be promoted without regenerating first — the main
+     * `resolveCanPublish` gate is about HEAD vs Live and would say "no".
+     */
+    resolveCanPublishDraft?: ((widgetId: string, version: number) => boolean) | null;
     /** Publish HEAD as a new live version (shape bar Publish button). */
     onPublish?: ((widgetId: string) => void) | null;
+    /** Publish a specific Draft version (built from that version's own commit). */
+    onPublishDraft?: ((widgetId: string, version: number) => void) | null;
     /** True while publish is in flight for this widget. */
     resolveIsPublishing?: ((widgetId: string) => boolean) | null;
+    /** Publish-disabled reason for a specific Draft row (null = enabled). */
+    resolvePublishDisabledReason?: ((widgetId: string, version: number) => string | null) | null;
 }
 declare const WidgetShapeLivePreviews: import("svelte").Component<Props, {
     sync: () => void;

package/dist/utils/versionPreviewError.d.ts

@@ -0,0 +1,9 @@
+/** Keep SDK diagnostics separate from the friendly, version-scoped preview message. */
+export function parseVersionPreviewError(error: any): Promise<{
+    kind: string;
+    code: any;
+    status: number;
+    message: string;
+    technicalMessage: any;
+    commitSha: any;
+}>;

package/dist/utils/versionPreviewError.js

@@ -0,0 +1,19 @@
+/** Keep SDK diagnostics separate from the friendly, version-scoped preview message. */
+export async function parseVersionPreviewError(error) {
+	let payload = null;
+	const response = error?.response;
+	try {
+		payload = response ? await response.clone().json() : null;
+	} catch { /* Network failures and non-JSON responses still have a useful status. */ }
+	const code = payload?.error?.code ?? payload?.code ?? error?.code ?? null;
+	const status = Number(response?.status ?? error?.status) || null;
+	const kind = status === 422 || code === 'VERSION_BUILD_FAILED' ? 'compile' : 'load';
+	return {
+		kind, code, status,
+		message: kind === 'compile'
+			? 'This version has a code error.'
+			: 'Could not load this version. Please try again.',
+		technicalMessage: payload?.error?.message ?? payload?.message ?? error?.message ?? String(error),
+		commitSha: payload?.error?.data?.commitSha ?? payload?.data?.commitSha ?? null,
+	};
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@widgetic/creator",
-	"version": "0.3.60",
+	"version": "0.3.61",
 	"type": "module",
 	"peerDependencies": {
 		"@sveltejs/kit": "^2.20.0",