@gxp-dev/tools 2.0.63 → 2.0.64

package/template/.claude/agents/gxp-developer.md

@@ -24,6 +24,7 @@ GxP plugins run inside a **container environment** provided by the `gxdev` devel
 ```
 
 **Key Principle**: Users ONLY edit files in `src/` directory. The runtime container handles:
+
 - Layout switching (Public, Private, System)
 - Dev tools modal (Ctrl+Shift+D)
 - Mock router for navigation
@@ -51,95 +52,95 @@ project/
 The store is the central hub for all platform data. Import it in any component:
 
 ```javascript
-import { useGxpStore } from "@/stores/gxpPortalConfigStore";
-
+import { useGxpStore } from "@/stores/gxpPortalConfigStore"
 
-const store = useGxpStore();
+const store = useGxpStore()
 ```
 
 ### Store Sections
 
-| Section | Purpose | Source |
-|---------|---------|--------|
-| `pluginVars` | Plugin settings/configuration | `app-manifest.json` → settings |
-| `stringsList` | Translatable UI strings | `app-manifest.json` → strings.default |
-| `assetList` | Asset URLs (images, etc.) | `app-manifest.json` → assets |
-| `triggerState` | Dynamic runtime state | `app-manifest.json` → triggerState |
-| `dependencyList` | External data dependencies | `app-manifest.json` → dependencies |
-| `permissionFlags` | Feature permissions | `app-manifest.json` → permissions |
+| Section           | Purpose                       | Source                                |
+| ----------------- | ----------------------------- | ------------------------------------- |
+| `pluginVars`      | Plugin settings/configuration | `app-manifest.json` → settings        |
+| `stringsList`     | Translatable UI strings       | `app-manifest.json` → strings.default |
+| `assetList`       | Asset URLs (images, etc.)     | `app-manifest.json` → assets          |
+| `triggerState`    | Dynamic runtime state         | `app-manifest.json` → triggerState    |
+| `dependencyList`  | External data dependencies    | `app-manifest.json` → dependencies    |
+| `permissionFlags` | Feature permissions           | `app-manifest.json` → permissions     |
 
 ### Getter Methods
 
 ```javascript
 // Get values with fallbacks
-store.getString('welcome_title', 'Default Title');
-store.getSetting('primary_color', '#FFD600');
-store.getAsset('hero_image', '/fallback.jpg');
-store.getState('current_step', 0);
-store.hasPermission('admin');
+store.getString("welcome_title", "Default Title")
+store.getSetting("primary_color", "#FFD600")
+store.getAsset("hero_image", "/fallback.jpg")
+store.getState("current_step", 0)
+store.hasPermission("admin")
 ```
 
 ## API Calls - ALWAYS USE THE STORE
 
 **CRITICAL**: Never use axios or fetch directly. Always use the store's API methods which handle:
+
 - Authentication (Bearer token injection)
 - Base URL configuration based on environment
 - Proxy handling for CORS in development
 - Error handling and logging
 
 ```javascript
-const store = useGxpStore();
+const store = useGxpStore()
 
 // GET request
-const data = await store.apiGet('/api/v1/attendees', { event_id: 123 });
+const data = await store.apiGet("/api/v1/attendees", { event_id: 123 })
 
 // POST request
-const result = await store.apiPost('/api/v1/check-ins', {
-  attendee_id: 456,
-  station_id: 'kiosk-1'
-});
+const result = await store.apiPost("/api/v1/check-ins", {
+	attendee_id: 456,
+	station_id: "kiosk-1",
+})
 
 // PUT request
-await store.apiPut('/api/v1/attendees/456', { status: 'checked_in' });
+await store.apiPut("/api/v1/attendees/456", { status: "checked_in" })
 
 // PATCH request
-await store.apiPatch('/api/v1/attendees/456', { badge_printed: true });
+await store.apiPatch("/api/v1/attendees/456", { badge_printed: true })
 
 // DELETE request
-await store.apiDelete('/api/v1/check-ins/789');
+await store.apiDelete("/api/v1/check-ins/789")
 ```
 
 ### API Environment Configuration
 
 The store reads `VITE_API_ENV` from `.env`:
 
-| Environment | API Base URL |
-|-------------|--------------|
-| `mock` | Local mock server (default) |
-| `local` | https://dashboard.eventfinity.test |
-| `develop` | https://api.zenith-develop.env.eventfinity.app |
-| `staging` | https://api.efz-staging.env.eventfinity.app |
-| `production` | https://api.gramercy.cloud |
+| Environment  | API Base URL                                   |
+| ------------ | ---------------------------------------------- |
+| `mock`       | Local mock server (default)                    |
+| `local`      | https://dashboard.eventfinity.test             |
+| `develop`    | https://api.zenith-develop.env.eventfinity.app |
+| `staging`    | https://api.efz-staging.env.eventfinity.app    |
+| `production` | https://api.gramercy.cloud                     |
 
 ## WebSocket Events
 
 WebSockets are pre-configured through the store. Listen for real-time events:
 
 ```javascript
-const store = useGxpStore();
+const store = useGxpStore()
 
 // Listen on primary socket
-store.listenSocket('primary', 'EventName', (data) => {
-  console.log('Event received:', data);
-});
+store.listenSocket("primary", "EventName", (data) => {
+	console.log("Event received:", data)
+})
 
 // Emit to primary socket
-store.emitSocket('primary', 'client-event', { message: 'Hello' });
+store.emitSocket("primary", "client-event", { message: "Hello" })
 
 // For dependency-based sockets (configured in app-manifest.json)
-store.useSocketListener('dependency_identifier', 'updated', (data) => {
-  console.log('Dependency updated:', data);
-});
+store.useSocketListener("dependency_identifier", "updated", (data) => {
+	console.log("Dependency updated:", data)
+})
 ```
 
 ### Dependency Socket Configuration
@@ -148,16 +149,16 @@ In `app-manifest.json`:
 
 ```json
 {
-  "dependencies": [
-    {
-      "identifier": "ai_session",
-      "model": "AiInterface",
-      "events": {
-        "created": "AiSessionMessageCreated",
-        "updated": "AiSessionMessageUpdated"
-      }
-    }
-  ]
+	"dependencies": [
+		{
+			"identifier": "ai_session",
+			"model": "AiInterface",
+			"events": {
+				"created": "AiSessionMessageCreated",
+				"updated": "AiSessionMessageUpdated"
+			}
+		}
+	]
 }
 ```
 
@@ -165,8 +166,8 @@ Then listen:
 
 ```javascript
 store.sockets.ai_session?.created?.listen((data) => {
-  console.log('AI message created:', data);
-});
+	console.log("AI message created:", data)
+})
 ```
 
 ## Vue Directives for Dynamic Content
@@ -191,10 +192,10 @@ store.sockets.ai_session?.created?.listen((data) => {
 
 ```html
 <!-- Replace src from assetList (default) -->
-<img gxp-src="hero_image" src="/placeholder.jpg" alt="Hero">
+<img gxp-src="hero_image" src="/placeholder.jpg" alt="Hero" />
 
 <!-- Replace src from triggerState -->
-<img gxp-src="dynamic_image" gxp-state src="/placeholder.jpg">
+<img gxp-src="dynamic_image" gxp-state src="/placeholder.jpg" />
 ```
 
 ## Component Template
@@ -203,48 +204,48 @@ When creating new components, use this pattern:
 
 ```vue
 <template>
-  <div class="my-component">
-    <h1 gxp-string="component_title">Default Title</h1>
-    <img gxp-src="component_image" src="/placeholder.jpg" alt="">
+	<div class="my-component">
+		<h1 gxp-string="component_title">Default Title</h1>
+		<img gxp-src="component_image" src="/placeholder.jpg" alt="" />
 
-    <button @click="handleAction" variant="primary">
-      <span gxp-string="action_button">Click Me</span>
-    </button>
+		<button @click="handleAction" variant="primary">
+			<span gxp-string="action_button">Click Me</span>
+		</button>
 
-    <div v-if="loading" class="spinner"></div>
-  </div>
+		<div v-if="loading" class="spinner"></div>
+	</div>
 </template>
 
 <script setup>
-import { ref, onMounted } from 'vue';
-import { useGxpStore } from "@/stores/gxpPortalConfigStore";
+import { ref, onMounted } from "vue"
+import { useGxpStore } from "@/stores/gxpPortalConfigStore"
 
-const store = useGxpStore();
-const loading = ref(false);
-const data = ref(null);
+const store = useGxpStore()
+const loading = ref(false)
+const data = ref(null)
 
 async function handleAction() {
-  loading.value = true;
-  try {
-    data.value = await store.apiGet('/api/v1/endpoint');
-  } catch (error) {
-    console.error('API Error:', error);
-  } finally {
-    loading.value = false;
-  }
+	loading.value = true
+	try {
+		data.value = await store.apiGet("/api/v1/endpoint")
+	} catch (error) {
+		console.error("API Error:", error)
+	} finally {
+		loading.value = false
+	}
 }
 
 onMounted(() => {
-  // Listen for real-time updates
-  store.listenSocket('primary', 'DataUpdated', (eventData) => {
-    data.value = eventData;
-  });
-});
+	// Listen for real-time updates
+	store.listenSocket("primary", "DataUpdated", (eventData) => {
+		data.value = eventData
+	})
+})
 </script>
 
 <style scoped>
 .my-component {
-  padding: 20px;
+	padding: 20px;
 }
 </style>
 ```
@@ -255,24 +256,24 @@ This is the main configuration file. Changes hot-reload during development:
 
 ```json
 {
-  "name": "my-plugin",
-  "description": "My GxP Plugin",
-  "settings": {
-    "primary_color": "#FFD600",
-    "idle_timeout": 30
-  },
-  "strings": {
-    "default": {
-      "welcome_title": "Welcome",
-      "action_button": "Get Started"
-    }
-  },
-  "assets": {
-    "hero_image": "/dev-assets/images/hero.jpg",
-    "logo": "/dev-assets/images/logo.png"
-  },
-  "dependencies": [],
-  "permissions": []
+	"name": "my-plugin",
+	"description": "My GxP Plugin",
+	"settings": {
+		"primary_color": "#FFD600",
+		"idle_timeout": 30
+	},
+	"strings": {
+		"default": {
+			"welcome_title": "Welcome",
+			"action_button": "Get Started"
+		}
+	},
+	"assets": {
+		"hero_image": "/dev-assets/images/hero.jpg",
+		"logo": "/dev-assets/images/logo.png"
+	},
+	"dependencies": [],
+	"permissions": []
 }
 ```
 

package/template/.claude/settings.json

@@ -1,9 +1,9 @@
 {
-  "mcpServers": {
-    "gxp-api": {
-      "command": "gxp-api-server",
-      "args": [],
-      "env": {}
-    }
-  }
+	"mcpServers": {
+		"gxp-api": {
+			"command": "gxp-api-server",
+			"args": [],
+			"env": {}
+		}
+	}
 }

package/template/AGENTS.md

@@ -20,8 +20,8 @@ src/
 The `gxpPortalConfigStore` is the central hub. Import it in any component:
 
 ```javascript
-import { useGxpStore } from '@gx-runtime/stores/gxpPortalConfigStore';
-const store = useGxpStore();
+import { useGxpStore } from "@gx-runtime/stores/gxpPortalConfigStore"
+const store = useGxpStore()
 ```
 
 ## API Calls - ALWAYS Use Store Methods
@@ -30,11 +30,11 @@ NEVER use axios or fetch directly. The store handles authentication, base URLs,
 
 ```javascript
 // Correct - use store methods
-const data = await store.apiGet('/api/v1/endpoint', { param: 'value' });
-await store.apiPost('/api/v1/endpoint', { data: 'value' });
-await store.apiPut('/api/v1/endpoint/123', { data: 'value' });
-await store.apiPatch('/api/v1/endpoint/123', { data: 'value' });
-await store.apiDelete('/api/v1/endpoint/123');
+const data = await store.apiGet("/api/v1/endpoint", { param: "value" })
+await store.apiPost("/api/v1/endpoint", { data: "value" })
+await store.apiPut("/api/v1/endpoint/123", { data: "value" })
+await store.apiPatch("/api/v1/endpoint/123", { data: "value" })
+await store.apiDelete("/api/v1/endpoint/123")
 
 // WRONG - never do this
 // const response = await axios.get(...);  // NO!
@@ -45,17 +45,17 @@ await store.apiDelete('/api/v1/endpoint/123');
 
 ```javascript
 // Get values with fallbacks
-store.getString('key', 'default');      // From stringsList
-store.getSetting('key', 'default');     // From pluginVars
-store.getAsset('key', '/fallback.jpg'); // From assetList
-store.getState('key', null);            // From triggerState
-store.hasPermission('admin');           // Check permissions
+store.getString("key", "default") // From stringsList
+store.getSetting("key", "default") // From pluginVars
+store.getAsset("key", "/fallback.jpg") // From assetList
+store.getState("key", null) // From triggerState
+store.hasPermission("admin") // Check permissions
 
 // Update values
-store.updateString('key', 'value');
-store.updateSetting('key', 'value');
-store.updateAsset('key', 'url');
-store.updateState('key', 'value');
+store.updateString("key", "value")
+store.updateSetting("key", "value")
+store.updateAsset("key", "url")
+store.updateState("key", "value")
 ```
 
 ## WebSocket Events
@@ -64,15 +64,15 @@ Listen for real-time events through the store:
 
 ```javascript
 // Listen on primary socket
-store.listenSocket('primary', 'EventName', (data) => {
-  console.log('Received:', data);
-});
+store.listenSocket("primary", "EventName", (data) => {
+	console.log("Received:", data)
+})
 
 // Emit events
-store.emitSocket('primary', 'client-event', { data: 'value' });
+store.emitSocket("primary", "client-event", { data: "value" })
 
 // For dependency-based sockets
-store.useSocketListener('dependency_id', 'updated', callback);
+store.useSocketListener("dependency_id", "updated", callback)
 ```
 
 ## Vue Directives for Dynamic Content
@@ -87,7 +87,7 @@ Use these directives instead of hardcoding text and images:
 <span gxp-string="company_name" gxp-settings>Company</span>
 
 <!-- Images from assets -->
-<img gxp-src="hero_image" src="/placeholder.jpg" alt="Hero">
+<img gxp-src="hero_image" src="/placeholder.jpg" alt="Hero" />
 ```
 
 ## Component Kit
@@ -95,7 +95,13 @@ Use these directives instead of hardcoding text and images:
 Import UI components from `@gramercytech/gx-componentkit`:
 
 ```javascript
-import { GxButton, GxCard, GxInput, GxModal, GxSpinner } from '@gramercytech/gx-componentkit';
+import {
+	GxButton,
+	GxCard,
+	GxInput,
+	GxModal,
+	GxSpinner,
+} from "@gramercytech/gx-componentkit"
 ```
 
 Available: GxButton, GxCard, GxInput, GxModal, GxSpinner, GxAlert, GxBadge, GxAvatar, GxProgress, GxTabs, GxAccordion
@@ -113,6 +119,7 @@ Edit `app-manifest.json` for strings, assets, and settings. Changes hot-reload d
 ## API Environments
 
 Set `VITE_API_ENV` in `.env`:
+
 - `mock` - Local mock server (default)
 - `develop` - https://api.zenith-develop.env.eventfinity.app
 - `staging` - https://api.efz-staging.env.eventfinity.app

package/template/GEMINI.md

@@ -16,43 +16,43 @@ The plugin runs inside a container provided by the `gxdev` server. Only edit fil
 NEVER use axios or fetch directly. Always use the store's API methods:
 
 ```javascript
-import { useGxpStore } from '@gx-runtime/stores/gxpPortalConfigStore';
-const store = useGxpStore();
+import { useGxpStore } from "@gx-runtime/stores/gxpPortalConfigStore"
+const store = useGxpStore()
 
 // API methods (handles auth, CORS, base URL automatically)
-await store.apiGet('/api/v1/endpoint', { params });
-await store.apiPost('/api/v1/endpoint', data);
-await store.apiPut('/api/v1/endpoint/id', data);
-await store.apiPatch('/api/v1/endpoint/id', data);
-await store.apiDelete('/api/v1/endpoint/id');
+await store.apiGet("/api/v1/endpoint", { params })
+await store.apiPost("/api/v1/endpoint", data)
+await store.apiPut("/api/v1/endpoint/id", data)
+await store.apiPatch("/api/v1/endpoint/id", data)
+await store.apiDelete("/api/v1/endpoint/id")
 ```
 
 ## Store Data Access
 
 ```javascript
 // Getters
-store.getString('key', 'default');      // UI strings
-store.getSetting('key', 'default');     // Settings
-store.getAsset('key', '/fallback.jpg'); // Asset URLs
-store.getState('key', null);            // Runtime state
+store.getString("key", "default") // UI strings
+store.getSetting("key", "default") // Settings
+store.getAsset("key", "/fallback.jpg") // Asset URLs
+store.getState("key", null) // Runtime state
 
 // Setters
-store.updateString('key', 'value');
-store.updateSetting('key', 'value');
-store.updateAsset('key', 'url');
-store.updateState('key', 'value');
+store.updateString("key", "value")
+store.updateSetting("key", "value")
+store.updateAsset("key", "url")
+store.updateState("key", "value")
 ```
 
 ## WebSocket Events
 
 ```javascript
 // Listen for events
-store.listenSocket('primary', 'EventName', (data) => {
-  console.log('Event received:', data);
-});
+store.listenSocket("primary", "EventName", (data) => {
+	console.log("Event received:", data)
+})
 
 // Emit events
-store.emitSocket('primary', 'event-name', data);
+store.emitSocket("primary", "event-name", data)
 ```
 
 ## Vue Directives
@@ -62,7 +62,7 @@ store.emitSocket('primary', 'event-name', data);
 <h1 gxp-string="welcome_title">Default</h1>
 
 <!-- Dynamic images from assets -->
-<img gxp-src="hero_image" src="/placeholder.jpg">
+<img gxp-src="hero_image" src="/placeholder.jpg" />
 ```
 
 ## Component Kit