@unisphere/nx 4.7.0 → 4.10.1

package/dist/generators/add-playground/add-playground.d.ts

@@ -0,0 +1,5 @@
+import { Tree } from '@nx/devkit';
+import { AddPlaygroundGeneratorSchema } from './schema';
+export declare function addPlaygroundGenerator(tree: Tree, options: AddPlaygroundGeneratorSchema): Promise<() => void>;
+export default addPlaygroundGenerator;
+//# sourceMappingURL=add-playground.d.ts.map

package/dist/generators/add-playground/add-playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-playground.d.ts","sourceRoot":"","sources":["../../../src/generators/add-playground/add-playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AA6CxD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,uBAmDtC;AAED,eAAe,sBAAsB,CAAC"}

package/dist/generators/add-playground/add-playground.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPlaygroundGenerator = addPlaygroundGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const path = tslib_1.__importStar(require("path"));
+const utils_1 = require("../utils");
+const VALID_ENGINES = ['vanilla-ts', 'vanilla-js', 'react'];
+function validateOptions(options) {
+    if (!options.name || options.name.trim() === '') {
+        throw new Error(`Missing required option: 'name'\n` +
+            `  Description: The name of the playground to create\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-playground --name=my-demo --engine=react`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.name)) {
+        throw new Error(`Invalid value '${options.name}' for option 'name'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.name}`);
+    }
+    if (!options.engine || !VALID_ENGINES.includes(options.engine)) {
+        throw new Error(`Invalid value '${options.engine}' for option 'engine'\n` +
+            `  Allowed values: ${VALID_ENGINES.join(', ')}\n` +
+            `  Example: nx g @unisphere/nx:add-playground --name=demo --engine=react`);
+    }
+    if (options.group) {
+        const groupPattern = /^[a-zA-Z0-9][a-zA-Z0-9\-_/]*$/;
+        if (!groupPattern.test(options.group)) {
+            throw new Error(`Invalid value '${options.group}' for option 'group'\n` +
+                `  Group path must contain only letters, numbers, hyphens, underscores, and forward slashes\n` +
+                `  Example: --group=getting-started or --group=advanced/hooks`);
+        }
+    }
+}
+async function addPlaygroundGenerator(tree, options) {
+    validateOptions(options);
+    // Ensure we're in a valid Unisphere workspace
+    (0, utils_1.validateUnisphereConfig)(tree);
+    const playgroundName = (0, devkit_1.names)(options.name).fileName;
+    const engine = options.engine;
+    // Build target path
+    const groupPath = options.group ? options.group.replace(/^\/|\/$/g, '') : '';
+    const targetDir = groupPath
+        ? `unisphere/playgrounds/${groupPath}/${playgroundName}`
+        : `unisphere/playgrounds/${playgroundName}`;
+    // Check if already exists
+    if (tree.exists(`${targetDir}/playground.json`)) {
+        throw new Error(`Playground already exists at "${targetDir}".\n` +
+            'Please choose a different name or remove the existing playground first.');
+    }
+    // Template variables
+    const templateVars = {
+        ...(0, utils_1.createNameTransforms)(playgroundName, 'playgroundName'),
+        tmpl: '',
+    };
+    // Generate files from engine-specific templates
+    (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'templates', engine), targetDir, templateVars);
+    await (0, devkit_1.formatFiles)(tree);
+    return () => {
+        devkit_1.logger.info('');
+        devkit_1.logger.info('✅ Code playground created successfully!');
+        devkit_1.logger.info('');
+        devkit_1.logger.info(`📁 Location: ${targetDir}`);
+        devkit_1.logger.info(`🔧 Engine: ${engine}`);
+        if (groupPath) {
+            devkit_1.logger.info(`📂 Group: ${groupPath}`);
+        }
+        devkit_1.logger.info('');
+    };
+}
+exports.default = addPlaygroundGenerator;

package/dist/generators/add-playground/schema.d.ts

@@ -0,0 +1,5 @@
+export interface AddPlaygroundGeneratorSchema {
+  name: string;
+  group?: string;
+  engine: 'vanilla-ts' | 'vanilla-js' | 'react';
+}

package/dist/generators/add-playground/schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "AddPlayground",
+  "title": "Add a code playground",
+  "description": "Scaffold a new code playground example",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Playground name (letters, numbers, hyphens, spaces)",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
+    },
+    "group": {
+      "type": "string",
+      "description": "Optional group path (e.g., 'getting-started' or 'advanced/hooks')"
+    },
+    "engine": {
+      "type": "string",
+      "description": "Template engine to use",
+      "oneOf": [
+        { "const": "vanilla-ts", "title": "Vanilla TypeScript" },
+        { "const": "vanilla-js", "title": "Vanilla JavaScript" },
+        { "const": "react", "title": "React (TSX)" }
+      ],
+      "default": "vanilla-ts"
+    }
+  },
+  "required": ["name", "engine"]
+}

package/dist/generators/add-playground/templates/react/playground.json.template

@@ -0,0 +1,9 @@
+{
+  "name": "<%= playgroundName__humanReadable %>",
+  "description": "",
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "entry": "index.tsx"
+}

package/dist/generators/add-playground/templates/react/src/App.tsx.template

@@ -0,0 +1,5 @@
+import React from 'react';
+
+export function App() {
+  return <h1>Hello from <%= playgroundName__humanReadable %></h1>;
+}

package/dist/generators/add-playground/templates/react/src/index.html.template

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title><%= playgroundName__humanReadable %></title>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="./index.tsx"></script>
+</body>
+</html>

package/dist/generators/add-playground/templates/react/src/index.tsx.template

@@ -0,0 +1,5 @@
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import { App } from './App';
+
+createRoot(document.getElementById('root')!).render(<App />);

package/dist/generators/add-playground/templates/vanilla-js/playground.json.template

@@ -0,0 +1,6 @@
+{
+  "name": "<%= playgroundName__humanReadable %>",
+  "description": "",
+  "dependencies": {},
+  "entry": "index.js"
+}

package/dist/generators/add-playground/templates/vanilla-js/src/index.html.template

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title><%= playgroundName__humanReadable %></title>
+</head>
+<body>
+  <div id="app"></div>
+  <script type="module" src="./index.js"></script>
+</body>
+</html>

package/dist/generators/add-playground/templates/vanilla-js/src/index.js.template

@@ -0,0 +1,2 @@
+const app = document.getElementById('app');
+app.innerHTML = '<h1>Hello from <%= playgroundName__humanReadable %></h1>';

package/dist/generators/add-playground/templates/vanilla-ts/playground.json.template

@@ -0,0 +1,6 @@
+{
+  "name": "<%= playgroundName__humanReadable %>",
+  "description": "",
+  "dependencies": {},
+  "entry": "index.ts"
+}

package/dist/generators/add-playground/templates/vanilla-ts/src/index.html.template

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title><%= playgroundName__humanReadable %></title>
+</head>
+<body>
+  <div id="app"></div>
+  <script type="module" src="./index.ts"></script>
+</body>
+</html>

package/dist/generators/add-playground/templates/vanilla-ts/src/index.ts.template

@@ -0,0 +1,2 @@
+const app = document.getElementById('app')!;
+app.innerHTML = '<h1>Hello from <%= playgroundName__humanReadable %></h1>';

package/dist/migrations/4-10-1/add-get-workspace-to-get-service.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Add getWorkspace() call before getService in runtime files
+ *
+ * Transforms this._options.getService to this._options.getWorkspace().getService
+ * in runtime project files.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=add-get-workspace-to-get-service.d.ts.map

package/dist/migrations/4-10-1/add-get-workspace-to-get-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-get-workspace-to-get-service.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-10-1/add-get-workspace-to-get-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAA6C,MAAM,YAAY,CAAC;AAE7E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA0D9D"}

package/dist/migrations/4-10-1/add-get-workspace-to-get-service.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Migration: Add getWorkspace() call before getService in runtime files
+ *
+ * Transforms this._options.getService to this._options.getWorkspace().getService
+ * in runtime project files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Adding getWorkspace() before getService calls in runtime projects...');
+    const runtimesDir = 'unisphere/runtimes';
+    if (!tree.exists(runtimesDir)) {
+        devkit_1.logger.info('ℹ️ No runtimes directory found');
+        return;
+    }
+    let updatedCount = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, runtimesDir, (filePath) => {
+        if (!filePath.endsWith('.ts') && !filePath.endsWith('.tsx'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content)
+            return;
+        if (!content.includes('_options') || !content.includes('getService'))
+            return;
+        // Match this._options followed by optional whitespace/newline/dot then .getService
+        // Handles: this._options.getService / this._options.\n      .getService / this._options\n      .getService
+        const pattern = /this\._options\.?\s*\.getService/g;
+        if (!pattern.test(content))
+            return;
+        // Already migrated check: if getWorkspace().getService exists, skip
+        if (content.includes('.getWorkspace().getService') || content.includes('.getWorkspace()\n')) {
+            // More precise check: see if all occurrences are already migrated
+            const unmigrated = content.replace(/this\._options\.getWorkspace\(\)\s*\.getService/g, '');
+            if (!/this\._options\.?\s*\.getService/.test(unmigrated)) {
+                return;
+            }
+        }
+        const updatedContent = content.replace(/this\._options\.?\s*\.\s*getService/g, 'this._options.getWorkspace().getService');
+        if (updatedContent !== content) {
+            tree.write(filePath, updatedContent);
+            updatedCount++;
+            devkit_1.logger.info(`  ✅ Updated ${filePath}`);
+        }
+    });
+    if (updatedCount === 0) {
+        devkit_1.logger.info('ℹ️ No runtime files needed getWorkspace() insertion before getService');
+    }
+    else {
+        await (0, devkit_1.formatFiles)(tree);
+        devkit_1.logger.info(`✅ Updated ${updatedCount} runtime file(s)`);
+    }
+}

package/dist/migrations/4-10-1/update-unisphere-visual-target.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Migration: Update UnisphereVisualTarget usage
+ *
+ * 1. Renames `target` property to `type` in visual target object literals
+ *    (where value is 'body' or 'element')
+ * 2. Converts string visual targets to { type: 'element', elementId: '<string>' }
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=update-unisphere-visual-target.d.ts.map

package/dist/migrations/4-10-1/update-unisphere-visual-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-unisphere-visual-target.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-10-1/update-unisphere-visual-target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAA6C,MAAM,YAAY,CAAC;AAS7E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF9D"}

package/dist/migrations/4-10-1/update-unisphere-visual-target.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Migration: Update UnisphereVisualTarget usage
+ *
+ * 1. Renames `target` property to `type` in visual target object literals
+ *    (where value is 'body' or 'element')
+ * 2. Converts string visual targets to { type: 'element', elementId: '<string>' }
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const ts_morph_1 = require("ts-morph");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Updating UnisphereVisualTarget usage...');
+    const project = new ts_morph_1.Project({
+        manipulationSettings: { quoteKind: ts_morph_1.QuoteKind.Single },
+    });
+    let updatedCount = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, '.', (filePath) => {
+        if (!filePath.endsWith('.ts') && !filePath.endsWith('.tsx'))
+            return;
+        if (!filePath.includes('unisphere/'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content)
+            return;
+        if (!content.includes('target'))
+            return;
+        const sourceFile = project.createSourceFile(filePath, content, {
+            overwrite: true,
+        });
+        let hasChanges = false;
+        // Pass 1: Rename target → type in object literals where value is 'body' or 'element'
+        // Only in visual target contexts (mountVisual args, visuals config, nested in target property)
+        const allPropertyAssignments = sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.PropertyAssignment);
+        for (const prop of allPropertyAssignments) {
+            if (prop.getName() !== 'target')
+                continue;
+            const initializer = prop.getInitializerIfKind(ts_morph_1.SyntaxKind.StringLiteral);
+            if (!initializer)
+                continue;
+            const value = initializer.getLiteralValue();
+            if (value !== 'body' && value !== 'element')
+                continue;
+            if (!isVisualTargetObjectContext(prop))
+                continue;
+            prop.getNameNode().replaceWithText('type');
+            hasChanges = true;
+        }
+        // Pass 2: Convert string targets to objects in mountVisual calls and visuals config
+        // Re-query after Pass 1 modifications
+        const propertyAssignments = sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.PropertyAssignment);
+        for (const prop of propertyAssignments) {
+            if (prop.getName() !== 'target')
+                continue;
+            const initializer = prop.getInitializerIfKind(ts_morph_1.SyntaxKind.StringLiteral);
+            if (!initializer)
+                continue;
+            const value = initializer.getLiteralValue();
+            // Skip 'body' and 'element' - those were handled in Pass 1
+            if (value === 'body' || value === 'element')
+                continue;
+            // Check if this is in a visual target context
+            if (!isVisualTargetContext(prop))
+                continue;
+            // Transform string to { type: 'element', elementId: '<string>' }
+            initializer.replaceWithText(`{ type: 'element', elementId: '${value}' }`);
+            hasChanges = true;
+        }
+        if (hasChanges) {
+            tree.write(filePath, sourceFile.getFullText());
+            updatedCount++;
+            devkit_1.logger.info(`  ✅ Updated ${filePath}`);
+        }
+    });
+    if (updatedCount === 0) {
+        devkit_1.logger.info('ℹ️ No UnisphereVisualTarget usages needed transformation');
+    }
+    else {
+        await (0, devkit_1.formatFiles)(tree);
+        devkit_1.logger.info(`✅ Updated UnisphereVisualTarget usage in ${updatedCount} file(s)`);
+    }
+}
+/**
+ * Checks if a `target` property with value 'body'/'element' is inside a UnisphereVisualTarget object.
+ * The object itself (containing target: 'body') is the visual target value, so we check
+ * whether it's nested inside a `target` property of a parent, a mountVisual call, or visuals array.
+ */
+function isVisualTargetObjectContext(prop) {
+    const objLiteral = prop.getParent();
+    if (!ts_morph_1.Node.isObjectLiteralExpression(objLiteral))
+        return false;
+    const objParent = objLiteral.getParent();
+    // Context 1: Object is value of a `target` property in a parent object
+    // e.g., mountVisual({ target: { target: 'body' } }) — inner object is the visual target
+    if (ts_morph_1.Node.isPropertyAssignment(objParent) && objParent.getName() === 'target')
+        return true;
+    // Context 2: Object is inside a mountVisual() call directly
+    // e.g., mountVisual({ target: 'body' }) — less common but possible
+    if (ts_morph_1.Node.isCallExpression(objParent)) {
+        const expr = objParent.getExpression();
+        if (expr.getText().endsWith('mountVisual'))
+            return true;
+    }
+    // Context 3: Object is inside a visuals array item's target property
+    // e.g., visuals: [{ target: { target: 'body' } }]
+    if (ts_morph_1.Node.isPropertyAssignment(objParent) && objParent.getName() === 'target') {
+        const outerObj = objParent.getParent();
+        if (ts_morph_1.Node.isObjectLiteralExpression(outerObj)) {
+            const arrayParent = outerObj.getParent();
+            if (ts_morph_1.Node.isArrayLiteralExpression(arrayParent)) {
+                const arrayPropParent = arrayParent.getParent();
+                if (ts_morph_1.Node.isPropertyAssignment(arrayPropParent) &&
+                    arrayPropParent.getName() === 'visuals')
+                    return true;
+            }
+        }
+    }
+    // Context 4: Object has sibling properties that indicate it's a visual target
+    // (has elementId for 'element' type, or classNames/style for 'body' type)
+    if (objLiteral.getProperty('elementId'))
+        return true;
+    if (objLiteral.getProperty('classNames'))
+        return true;
+    if (objLiteral.getProperty('style'))
+        return true;
+    return false;
+}
+/**
+ * Checks if a `target` property with a string value is in a visual target context
+ * (the string IS the visual target value, needing conversion to object).
+ */
+function isVisualTargetContext(prop) {
+    const parent = prop.getParent();
+    if (!ts_morph_1.Node.isObjectLiteralExpression(parent))
+        return false;
+    // Context 1: Inside mountVisual() call argument
+    // e.g., super.mountVisual({ type: 'popup', target: 'someId', settings: {} })
+    const grandparent = parent.getParent();
+    if (ts_morph_1.Node.isCallExpression(grandparent)) {
+        const expr = grandparent.getExpression();
+        if (expr.getText().endsWith('mountVisual'))
+            return true;
+    }
+    // Context 2: Inside a visuals array item
+    // e.g., visuals: [{ target: 'someId', ... }]
+    if (ts_morph_1.Node.isArrayLiteralExpression(grandparent)) {
+        const arrayParent = grandparent.getParent();
+        if (ts_morph_1.Node.isPropertyAssignment(arrayParent)) {
+            if (arrayParent.getName() === 'visuals')
+                return true;
+        }
+    }
+    // Context 3: Parent object has siblings suggesting visual config
+    // (has 'type' property with value like 'popup', 'inline', etc.)
+    const typeProp = parent.getProperty('type');
+    if (typeProp && ts_morph_1.Node.isPropertyAssignment(typeProp)) {
+        const typeInit = typeProp.getInitializerIfKind(ts_morph_1.SyntaxKind.StringLiteral);
+        if (typeInit) {
+            const typeValue = typeInit.getLiteralValue();
+            if (typeValue === 'popup' ||
+                typeValue === 'inline' ||
+                typeValue === 'drawer')
+                return true;
+        }
+    }
+    return false;
+}

package/dist/migrations/4-10-1/wrap-tiny-data-store-initial-value.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Wrap TinyDataStore/TinyStorage constructor arguments in initialValue
+ *
+ * Transforms constructor calls to wrap the argument in an { initialValue: ... } object.
+ * Skips instances that already have an initialValue property.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=wrap-tiny-data-store-initial-value.d.ts.map

package/dist/migrations/4-10-1/wrap-tiny-data-store-initial-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrap-tiny-data-store-initial-value.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-10-1/wrap-tiny-data-store-initial-value.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAA6C,MAAM,YAAY,CAAC;AAK7E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAmE9D"}

package/dist/migrations/4-10-1/wrap-tiny-data-store-initial-value.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Migration: Wrap TinyDataStore/TinyStorage constructor arguments in initialValue
+ *
+ * Transforms constructor calls to wrap the argument in an { initialValue: ... } object.
+ * Skips instances that already have an initialValue property.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const ts_morph_1 = require("ts-morph");
+const TARGET_CLASSES = ['TinyDataStore', 'TinyStorage'];
+async function update(tree) {
+    devkit_1.logger.info('🔄 Wrapping TinyDataStore/TinyStorage constructor arguments in initialValue...');
+    const project = new ts_morph_1.Project({
+        manipulationSettings: { quoteKind: ts_morph_1.QuoteKind.Single },
+    });
+    let updatedCount = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, '.', (filePath) => {
+        if (!filePath.endsWith('.ts') && !filePath.endsWith('.tsx'))
+            return;
+        if (!filePath.includes('unisphere/'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content)
+            return;
+        if (!TARGET_CLASSES.some((cls) => content.includes(cls)))
+            return;
+        const sourceFile = project.createSourceFile(filePath, content, {
+            overwrite: true,
+        });
+        let hasChanges = false;
+        const newExpressions = sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.NewExpression);
+        for (const expr of newExpressions) {
+            const exprText = expr.getExpression().getText();
+            if (!TARGET_CLASSES.includes(exprText))
+                continue;
+            const args = expr.getArguments();
+            if (args.length !== 1)
+                continue;
+            const arg = args[0];
+            // Skip if argument already has an initialValue property
+            if (arg.getKind() === ts_morph_1.SyntaxKind.ObjectLiteralExpression) {
+                const objLiteral = arg.asKind(ts_morph_1.SyntaxKind.ObjectLiteralExpression);
+                if (objLiteral?.getProperty('initialValue'))
+                    continue;
+            }
+            const argText = arg.getText();
+            arg.replaceWithText(`{\n      initialValue: ${argText},\n    }`);
+            hasChanges = true;
+        }
+        if (hasChanges) {
+            tree.write(filePath, sourceFile.getFullText());
+            updatedCount++;
+            devkit_1.logger.info(`  ✅ Updated ${filePath}`);
+        }
+    });
+    if (updatedCount === 0) {
+        devkit_1.logger.info('ℹ️ No TinyDataStore/TinyStorage instances needed transformation');
+    }
+    else {
+        await (0, devkit_1.formatFiles)(tree);
+        devkit_1.logger.info(`✅ Wrapped constructor arguments in initialValue for ${updatedCount} file(s)`);
+    }
+}

package/dist/migrations/4-11-0/migrate-analytics-types.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Migrate Kava analytics types to Application Events bucket types
+ *
+ * Renames enums/types and adds the required `bucket: AnalyticsBucket.ApplicationEvents`
+ * field to all report() calls.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=migrate-analytics-types.d.ts.map

package/dist/migrations/4-11-0/migrate-analytics-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-analytics-types.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-11-0/migrate-analytics-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAA6C,MAAM,YAAY,CAAC;AAa7E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA2G9D"}

package/dist/migrations/4-11-0/migrate-analytics-types.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Migration: Migrate Kava analytics types to Application Events bucket types
+ *
+ * Renames enums/types and adds the required `bucket: AnalyticsBucket.ApplicationEvents`
+ * field to all report() calls.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const ts_morph_1 = require("ts-morph");
+const RENAMES = {
+    KavaEventTypes: 'ApplicationEventTypes',
+    KavaButtonsTypes: 'ApplicationButtonTypes',
+    KavaPageTypes: 'ApplicationPageTypes',
+    KavaBaseTypePayload: 'ApplicationEventsBasePayload',
+    KavaButtonTypePayload: 'ApplicationButtonPayload',
+    KavaPageTypePayload: 'ApplicationPagePayload',
+    KavaRequestPayloadByType: 'AnalyticsPayloadByBucket',
+};
+async function update(tree) {
+    devkit_1.logger.info('🔄 Migrating Kava analytics types to Application Events bucket types...');
+    const runtimesDir = 'unisphere/runtimes';
+    if (!tree.exists(runtimesDir)) {
+        devkit_1.logger.info('ℹ️ No runtimes directory found');
+        return;
+    }
+    const project = new ts_morph_1.Project({
+        manipulationSettings: { quoteKind: ts_morph_1.QuoteKind.Single },
+    });
+    let updatedCount = 0;
+    (0, devkit_1.visitNotIgnoredFiles)(tree, runtimesDir, (filePath) => {
+        if (!filePath.endsWith('.ts') && !filePath.endsWith('.tsx'))
+            return;
+        const content = tree.read(filePath, 'utf-8');
+        if (!content)
+            return;
+        const hasOldTypes = Object.keys(RENAMES).some((old) => content.includes(old));
+        if (!hasOldTypes)
+            return;
+        const sourceFile = project.createSourceFile(filePath, content, {
+            overwrite: true,
+        });
+        let hasChanges = false;
+        // Step 1: Add `bucket: AnalyticsBucket.ApplicationEvents` to any object literal
+        // containing an `eventType: KavaEventTypes.*` property (covers direct .report() calls
+        // and indirect patterns like wrapper functions).
+        const objectLiterals = sourceFile.getDescendantsOfKind(ts_morph_1.SyntaxKind.ObjectLiteralExpression);
+        for (const objLiteral of objectLiterals) {
+            if (objLiteral.getProperty('bucket'))
+                continue;
+            const eventTypeProp = objLiteral.getProperty('eventType');
+            if (!eventTypeProp)
+                continue;
+            const eventTypeText = eventTypeProp.getText();
+            if (!eventTypeText.includes('KavaEventTypes.') &&
+                !eventTypeText.includes('ApplicationEventTypes.'))
+                continue;
+            objLiteral.insertPropertyAssignment(0, {
+                name: 'bucket',
+                initializer: 'AnalyticsBucket.ApplicationEvents',
+            });
+            hasChanges = true;
+        }
+        // Step 2: Rename all old type/enum references
+        let updatedText = sourceFile.getFullText();
+        for (const [oldName, newName] of Object.entries(RENAMES)) {
+            const regex = new RegExp(`\\b${oldName}\\b`, 'g');
+            if (regex.test(updatedText)) {
+                updatedText = updatedText.replace(regex, newName);
+                hasChanges = true;
+            }
+        }
+        // Step 3: Add AnalyticsBucket to imports from @unisphere/runtime
+        if (hasChanges) {
+            if (updatedText.includes('AnalyticsBucket') &&
+                !updatedText.match(/import\s*\{[^}]*AnalyticsBucket[^}]*\}\s*from\s*['"]@unisphere\/runtime['"]/)) {
+                updatedText = updatedText.replace(/(import\s*\{)([^}]*)(}\s*from\s*['"]@unisphere\/runtime['"])/, (_match, start, imports, end) => {
+                    const importList = imports
+                        .split(',')
+                        .map((s) => s.trim())
+                        .filter(Boolean);
+                    if (!importList.includes('AnalyticsBucket')) {
+                        importList.push('AnalyticsBucket');
+                        importList.sort();
+                    }
+                    return `${start}\n  ${importList.join(',\n  ')},\n${end}`;
+                });
+            }
+            tree.write(filePath, updatedText);
+            updatedCount++;
+            devkit_1.logger.info(`  ✅ Updated ${filePath}`);
+        }
+    });
+    if (updatedCount === 0) {
+        devkit_1.logger.info('ℹ️ No files needed analytics type migration');
+    }
+    else {
+        await (0, devkit_1.formatFiles)(tree);
+        devkit_1.logger.info(`✅ Migrated analytics types in ${updatedCount} file(s)`);
+    }
+}

package/dist/migrations/4-8-0/restore-security-audit-step.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=restore-security-audit-step.d.ts.map

package/dist/migrations/4-8-0/restore-security-audit-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-security-audit-step.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-8-0/restore-security-audit-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,YAAY,CAAC;AAO1C,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9D"}

package/dist/migrations/4-8-0/restore-security-audit-step.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const AUDIT_STEP = `      - name: Security Audit
+        run: npx unisphere tools audit
+        env:
+          KALTURA_JFROG_TOKEN: \${{ steps.setup-jfrog.outputs.oidc-token }}`;
+async function update(tree) {
+    const cicdPath = '.github/workflows/cicd.yml';
+    if (!tree.exists(cicdPath)) {
+        devkit_1.logger.warn('⚠️ No cicd.yml found, skipping');
+        return;
+    }
+    let content = tree.read(cicdPath, 'utf-8');
+    if (!content) {
+        devkit_1.logger.warn('⚠️ Could not read cicd.yml, skipping');
+        return;
+    }
+    const commentedPattern = /^[ \t]*#\s*- name: Security Audit\s*\n(?:[ \t]*#.*\n)*/m;
+    if (commentedPattern.test(content)) {
+        content = content.replace(commentedPattern, AUDIT_STEP + '\n');
+        tree.write(cicdPath, content);
+        devkit_1.logger.info('✅ Uncommented Security Audit step in cicd.yml');
+        return;
+    }
+    if (content.includes('Security Audit')) {
+        devkit_1.logger.info('ℹ️ Security Audit step already exists in cicd.yml');
+        return;
+    }
+    const installDepsMatch = content.match(/( *- name: Install Dependencies[ \t]*\n(?:.*\n)*?)([ \t]*- name: )/);
+    if (!installDepsMatch) {
+        devkit_1.logger.warn('⚠️ Could not find Install Dependencies step in cicd.yml');
+        throw new Error('Could not find Install Dependencies step in cicd.yml');
+    }
+    const insertIndex = installDepsMatch.index + installDepsMatch[1].length;
+    content =
+        content.slice(0, insertIndex) +
+            '\n' +
+            AUDIT_STEP +
+            '\n\n' +
+            content.slice(insertIndex);
+    tree.write(cicdPath, content);
+    devkit_1.logger.info('✅ Added Security Audit step to cicd.yml');
+}

package/generators.json

@@ -55,6 +55,11 @@
       "factory": "./dist/generators/internal-dev-runner/generator",
       "schema": "./dist/generators/internal-dev-runner/schema.json",
       "description": "Internal-dev-runner - Run a migration for testing purposes (dev only)"
+    },
+    "add-playground": {
+      "factory": "./dist/generators/add-playground/add-playground",
+      "schema": "./dist/generators/add-playground/schema.json",
+      "description": "Add a code playground example"
     }
   }
 }

package/migrations.json

@@ -450,6 +450,46 @@
       "cli": {
         "postUpdateMessage": "✅ GitHub documentation workflow added"
       }
+    },
+    "4-8-0-restore-security-audit-step": {
+      "version": "4.8.0",
+      "description": "Restores Security Audit step in cicd.yml if commented out or missing",
+      "factory": "./dist/migrations/4-8-0/restore-security-audit-step.js",
+      "cli": {
+        "postUpdateMessage": "✅ Security Audit step restored in cicd.yml"
+      }
+    },
+    "4-10-1-wrap-tiny-data-store-initial-value": {
+      "version": "4.10.1",
+      "description": "Wraps TinyDataStore/TinyStorage constructor arguments in initialValue property",
+      "factory": "./dist/migrations/4-10-1/wrap-tiny-data-store-initial-value.js",
+      "cli": {
+        "postUpdateMessage": "✅ TinyDataStore/TinyStorage constructor arguments wrapped in initialValue"
+      }
+    },
+    "4-10-1-add-get-workspace-to-get-service": {
+      "version": "4.10.1",
+      "description": "Adds getWorkspace() call before getService in runtime files",
+      "factory": "./dist/migrations/4-10-1/add-get-workspace-to-get-service.js",
+      "cli": {
+        "postUpdateMessage": "✅ Runtime files updated: this._options.getService → this._options.getWorkspace().getService"
+      }
+    },
+    "4-10-1-update-unisphere-visual-target": {
+      "version": "4.10.1",
+      "description": "Updates UnisphereVisualTarget usage: renames target→type, converts string targets to objects",
+      "factory": "./dist/migrations/4-10-1/update-unisphere-visual-target.js",
+      "cli": {
+        "postUpdateMessage": "✅ UnisphereVisualTarget usage updated (target→type, string→object)"
+      }
+    },
+    "4-11-0-migrate-analytics-types": {
+      "version": "4.11.0",
+      "description": "Migrates Kava analytics types to Application Events bucket types (KavaEventTypes→ApplicationEventTypes, KavaButtonsTypes→ApplicationButtonTypes, adds bucket field)",
+      "factory": "./dist/migrations/4-11-0/migrate-analytics-types.js",
+      "cli": {
+        "postUpdateMessage": "✅ Analytics types migrated to Application Events bucket pattern"
+      }
     }
   },
   "packageJsonUpdates": {
@@ -772,6 +812,40 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "4.8.0": {
+      "version": "4.8.0",
+      "cli": "nx",
+      "postUpdateMessage": "🎉 Migration to @unisphere/nx 4.8.0 completed successfully!",
+      "packages": {
+        "@unisphere/cli": {
+          "version": "5.2.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
+    },
+    "4.10.1": {
+      "version": "4.10.1",
+      "cli": "nx",
+      "postUpdateMessage": "🎉 Migration to @unisphere/nx 4.10.1 completed successfully!",
+      "packages": {
+        "@unisphere/core": {
+          "version": "^1.97.1",
+          "alwaysAddToPackageJson": false
+        },
+        "@unisphere/runtime": {
+          "version": "^1.97.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@unisphere/runtime-js": {
+          "version": "^1.93.0",
+          "alwaysAddToPackageJson": false
+        },
+        "@unisphere/runtime-react": {
+          "version": "^1.87.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisphere/nx",
-  "version": "4.7.0",
+  "version": "4.10.1",
   "private": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",