@atomm-developer/generator-workbench 0.1.0 → 0.1.1

package/README.md

@@ -6,8 +6,9 @@ V1 provides:
 
 - Web Component shell
 - login / avatar / logout entry
+- credits badge and export credit hint
 - local template import / export entry
-- floating export actions
+- billing-backed export actions
 - runtime panel / canvas mounting
 
 ## Install
@@ -21,7 +22,7 @@ pnpm add @atomm-developer/generator-workbench
 
 ```html
 <script src="https://static-res.atomm.com/scripts/js/generator-sdk/index.umd.js"></script>
-<script src="https://static-res.atomm.com/scripts/js/generator-workbench/index.umd.js"></script>
+<script src="https://static-res.atomm.com/scripts/js/generator-sdk/generator-workbench/index.umd.js"></script>
 ```
 
 ## Usage
@@ -46,6 +47,12 @@ workbench.config = {
 await workbench.mount()
 ```
 
+## Billing Behavior
+
+- When `sdk.credits` and `sdk.billing` are available, the top bar shows the current credits balance after login.
+- The export trigger shows the current `creditsPerUse` hint from `sdk.billing.getUsage()`.
+- `exportSvg()` and `openInStudio()` now follow the standard generator flow: ensure login first, then call `sdk.billing.consume()`, then perform the export action.
+
 ## Local Preview
 
 ```bash

package/dist/index.d.ts

@@ -1,10 +1,15 @@
 import { AuthStatus } from '@atomm-developer/generator-sdk';
+import { BillingChangeCallback } from '@atomm-developer/generator-sdk';
+import { BillingCheckResult } from '@atomm-developer/generator-sdk';
+import { BillingConsumeOptions } from '@atomm-developer/generator-sdk';
+import { BillingConsumeResult } from '@atomm-developer/generator-sdk';
 import { ExportDownloadResult } from '@atomm-developer/generator-sdk';
 import { ExportOpenInStudioResult } from '@atomm-developer/generator-sdk';
 import { GeneratorTemplateDefinition } from '@atomm-developer/generator-sdk';
 import { PanelFilter } from '@atomm-developer/generator-sdk';
 import { PanelSchema } from '@atomm-developer/generator-sdk';
 import { TemplateBuildOptions } from '@atomm-developer/generator-sdk';
+import { UsageInfo } from '@atomm-developer/generator-sdk';
 import { UserInfo } from '@atomm-developer/generator-sdk';
 
 export declare function defineGeneratorWorkbench(tagName?: string): typeof GeneratorWorkbenchElement;
@@ -39,6 +44,21 @@ export declare interface GeneratorSDKLike {
         logout(): Promise<void>;
         onChange(callback: (status: AuthStatus) => void): () => void;
     };
+    credits?: {
+        getBalance(): Promise<{
+            quota: number;
+        }>;
+        getCachedBalance?(): number;
+        onChange?(callback: (balance: number) => void): () => void;
+    };
+    billing?: {
+        getUsage(): Promise<UsageInfo>;
+        getCachedUsage?(): UsageInfo | null;
+        check?(): BillingCheckResult;
+        consume(options?: BillingConsumeOptions): Promise<BillingConsumeResult>;
+        refreshCredits?(): Promise<void>;
+        onChange?(callback: BillingChangeCallback): () => void;
+    };
     template: {
         build(args: TemplateBuildOptions): GeneratorTemplateDefinition;
         parse(text: string): GeneratorTemplateDefinition;
@@ -78,6 +98,8 @@ export declare interface GeneratorWorkbenchConfig {
     autoMount?: boolean;
     panelTarget?: 'left' | 'right';
     avatarMenuTrigger?: 'hover' | 'click';
+    /** Override the default atomm-ui CDN CSS URL injected into Shadow DOM */
+    atommUiCssUrl?: string;
     runtimePanelFilter?: PanelFilter;
     getTemplateMeta?: () => Record<string, unknown>;
     getTemplateFieldPaths?: (panelSchema: PanelSchema) => string[];
@@ -90,14 +112,16 @@ export declare class GeneratorWorkbenchElement extends HTMLElement {
     private _sdk;
     private _runtime;
     private _config;
-    private _refs;
     private _mounted;
     private _state;
     private _cleanupAuth?;
+    private _cleanupCredits?;
+    private _cleanupBilling?;
     private _authController?;
     private _templateController?;
     private _exportController?;
     private _runtimeController?;
+    private _shellContext?;
     constructor();
     get sdk(): GeneratorSDKLike | null;
     set sdk(value: GeneratorSDKLike | null);
@@ -116,13 +140,14 @@ export declare class GeneratorWorkbenchElement extends HTMLElement {
     openInStudio(): Promise<void>;
     private render;
     private bindControllers;
-    private bindShellEvents;
+    private bindShellCallbacks;
     private bindAuthState;
+    private bindBillingSubscriptions;
     private syncAuthUI;
-    private toggleFabMenu;
-    private toggleAvatarMenu;
-    private setAvatarMenuOpen;
-    private syncMenuUI;
+    private syncBillingUI;
+    private applyBillingUsage;
+    private resetBillingState;
+    private syncBillingState;
     private handleLogin;
     private handleLogout;
     private handleError;