@trackunit/iris-app 1.12.9 → 1.12.10

package/src/generators/preset/files/.agents/skills/widget-extensions/SKILL.md

@@ -0,0 +1,245 @@
+---
+name: widget-extensions
+description: Use when creating dashboard widgets, KPI displays, configurable widgets with edit dialogs, or data visualizations for dashboards.
+---
+
+# Widget Extensions
+
+## Overview
+
+Widget extensions are React components that integrate into Trackunit Manager dashboards. Use `useWidgetConfig` for data, filters, and edit mode. Supports KPI, CHART, LIST, MAP, and OTHER types.
+
+## When to Use
+
+- Creating dashboard KPIs or metrics
+- Building data visualization widgets
+- Adding configurable widgets with edit dialogs
+- Displaying filtered/time-ranged data in dashboards
+
+**Not for:** Full-page extensions (use `FLEET_EXTENSION` or `ASSET_HOME_EXTENSION`).
+
+## Creating Widget Extensions
+
+```bash
+npx nx g @trackunit/iris-app:extend --name=[my-widget-name] --app=[app-name] --directory=[feature] --type=WIDGET_EXTENSION
+```
+
+This creates:
+- `extension-manifest.ts` - Widget configuration and metadata
+- `src/app.tsx` - Main widget component (handles both display and edit mode)
+
+## Widget Manifest
+
+```typescript
+import { WidgetExtensionManifest } from '@trackunit/iris-app-api';
+
+const widgetExtensionManifest: WidgetExtensionManifest = {
+  id: "my-widget-id",
+  type: "WIDGET_EXTENSION",
+  sourceRoot: "libs/[feature]/[widget-name]/src",
+  
+  widgetType: "CHART", // CHART | KPI | LIST | MAP | OTHER
+  
+  size: {
+    default: { width: 2, height: 2 }, // 1-6 grid units
+    allowFullWidth: false,
+  },
+  
+  header: {
+    name: "My Widget",
+    image: { name: "ChartBar" }, // IconByName or IconByPath
+    hasEditDialog: true,
+  },
+  
+  footer: {
+    linkDescription: "View details",
+    link: "/my-app/details",
+    poweredByImage: { path: "/assets/logo.svg" },
+  },
+  
+  preview: {
+    description: "Displays chart data for analysis",
+  },
+  
+  supportedLocations: ["MY_HOME", "PLAYGROUND"],
+  
+  supportedFilters: {
+    TIME_RANGE: { include: ["ALL"] },
+    ASSETS: { include: ["assetType", "brands", "models"] },
+    CUSTOMERS: { include: ["customerType", "criticality"] },
+    SITES: { include: ["siteType", "location"] },
+  },
+};
+```
+
+## Widget Types
+
+| Type | Use Case |
+|------|----------|
+| `KPI` | Single metric displays (typically 1x1) |
+| `CHART` | Data visualization (charts, graphs) |
+| `LIST` | Tabular or list-based data |
+| `MAP` | Geographic or spatial data |
+| `OTHER` | Custom or specialized widgets |
+
+## Supported Locations
+
+- `MY_HOME` - User's personal dashboard
+- `SITE_HOME` - Site-specific dashboards
+- `PLAYGROUND` - Widget testing playground
+
+## Widget Development
+
+### Basic Widget Component
+
+```typescript
+import { useWidgetConfig } from '@trackunit/react-core-hooks';
+
+export const App = () => {
+  const {
+    data, setData, dataVersion, loadingData,
+    title, setTitle,
+    filters, timeRange,
+    isEditMode, openEditMode, closeEditMode,
+    pollInterval, setLoadingState
+  } = useWidgetConfig();
+
+  if (isEditMode) {
+    return <EditDialog />;
+  }
+
+  return (
+    <WidgetBody>
+      <h2>{title}</h2>
+      {/* Widget content */}
+    </WidgetBody>
+  );
+};
+```
+
+### useWidgetConfig Hook
+
+**Data Management:**
+- `data: Record<string, unknown> | null` - Widget configuration data
+- `setData(data, version)` - Update widget data
+- `dataVersion: number | null` - Current data version for migrations
+- `loadingData: boolean` - Whether widget data is loading
+
+**Title Management:**
+- `title: string` - Widget title
+- `setTitle(title)` - Update widget title
+
+**Context:**
+- `filters` - Applied filters (assets, customers, sites)
+- `timeRange` - Selected time range (startMsInEpoch, endMsInEpoch)
+- `isEditMode: boolean` - Whether widget is in edit mode
+
+**Edit Mode:**
+- `openEditMode()` - Enter edit mode
+- `closeEditMode()` - Exit edit mode
+
+### Widget with Edit Dialog
+
+```typescript
+import { useWidgetConfig } from '@trackunit/react-core-hooks';
+import { WidgetEditBody } from '@trackunit/react-widgets';
+
+export const App = () => {
+  const { isEditMode, data, closeEditMode } = useWidgetConfig();
+  
+  if (isEditMode) {
+    return (
+      <WidgetEditBody
+        onSave={async () => {
+          await closeEditMode({ newData: { data: { demo: "yourDataHere"}, dataVersion: 1 }});
+        }}
+        onCancel={closeEditMode}
+        initialData={data}
+      />
+    );
+  }
+  
+  return <MainWidgetContent />;
+};
+```
+
+## Filter Support
+
+### Using Filters
+
+```typescript
+const { filters, timeRange } = useWidgetConfig();
+
+const selectedAssets = filters.assetsFilterBarValues?.assetType;
+const selectedCustomers = filters.customersFilterBarValues?.customerType;
+const selectedSites = filters.sitesFilterBarValues?.siteType;
+
+const startTime = timeRange?.startMsInEpoch;
+const endTime = timeRange?.endMsInEpoch;
+```
+
+## KPI Widget Example
+
+```typescript
+import { useWidgetConfig } from '@trackunit/react-core-hooks';
+import { useQuery } from '@trackunit/react-graphql-hooks';
+
+export const App = () => {
+  const { filters, timeRange, pollInterval, setLoadingState } = useWidgetConfig();
+  
+  const { data: kpiData, loading } = useQuery(MY_KPI_QUERY, {
+    variables: {
+      filters: {
+        assetIds: filters.assetsFilterBarValues?.assetIds,
+        timeRange: {
+          start: timeRange?.startMsInEpoch,
+          end: timeRange?.endMsInEpoch,
+        },
+      },
+    },
+    pollInterval
+  });
+
+  useEffect(() => {
+    void setLoadingState({ hasData: !!kpiData, isLoading: loading });
+  }, [kpiData, loading, setLoadingState]);
+  
+  return (
+    <div className="kpi-widget">
+      <div className="kpi-value">{kpiData?.totalCount}</div>
+      <div className="kpi-label">Total Assets</div>
+    </div>
+  );
+};
+```
+
+## Best Practices
+
+### Widget Design
+1. **Responsive Layout** - Design for different grid sizes
+2. **Loading States** - Show loading indicators for async operations
+3. **Error Handling** - Gracefully handle data loading errors
+4. **Empty States** - Provide meaningful empty state messages
+
+### Data Management
+1. **Use Real Data** - Always fetch from Trackunit GraphQL API
+2. **Respect Filters** - Apply user-selected filters to data queries
+3. **Efficient Updates** - Only update widget data when necessary
+4. **Version Control** - Use `dataVersion` for configuration migrations
+
+### Configuration
+1. **Meaningful Defaults** - Provide sensible default configurations
+2. **Validation** - Validate user input in edit dialogs
+3. **Persistence** - Use `setData()` to save configuration changes
+4. **User Experience** - Keep configuration UI simple and intuitive
+
+## Common Mistakes
+
+| Mistake | Fix |
+|---------|-----|
+| Using generic widget libraries | Use Trackunit IrisX App SDK patterns |
+| Not handling `isEditMode` | Check `isEditMode` and render edit dialog |
+| Missing `setLoadingState` call | Call `setLoadingState` to show loading indicators |
+| Ignoring `filters` from context | Apply filters to data queries |
+| Not using `dataVersion` | Increment version when changing data schema |
+| Missing empty/error states | Handle no data and error conditions gracefully |

package/src/generators/preset/files/.cursor/mcp.json

@@ -1,5 +1,9 @@
 {
   "mcpServers": {
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    },
     "nx-mcp": {
       "command": "npx",
       "args": ["-y", "nx-mcp@latest"]

package/src/generators/preset/generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app/src/generators/preset/generator.ts"],"names":[],"mappings":";;AAmBA,0CA6DC;;AAhFD,uCAQoB;AACpB,+BAA0D;AAC1D,qCAA+C;AAC/C,wDAAwB;AAGxB;;;;GAIG;AACI,KAAK,UAAU,eAAe,CAAC,IAAU,EAAE,OAA8B;IAC9E,kBAAkB;IAClB,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK,CACR,gBAAgB,EAChB,4LAA4L,CAC7L,CAAC;IACF,IAAI,CAAC,KAAK,CACR,gBAAgB,EAChB,oIAAoI,CACrI,CAAC;IAEF,MAAM,cAAc,GAAG,yBAAyB,CAAC;IAEjD,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAA,sBAAa,EAAC,IAAI,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;IAE5D,IAAA,mBAAU,EAAC,IAAI,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE;QACvC,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC;YAC3B,KAAK,CAAC,eAAe,GAAG,EAAE,CAAC;QAC7B,CAAC;QACD,KAAK,CAAC,eAAe,CAAC,IAAI,CACxB,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,8BAA8B,CAC/B,CAAC;QACF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,IAAA,kBAAe,EAAC,IAAI,EAAE;QAC7C,GAAG,OAAO;QACV,YAAY,EAAE,oBAAoB;QAClC,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,IAAA,qCAA4B,EAC1B,IAAI,EACJ;QACE,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,QAAQ;KACtB,EACD,EAAE,CACH,CAAC;IAEF,4CAA4C;IAC5C,IAAA,mBAAU,EAAC,IAAI,EAAE,cAAc,EAAE,CAAC,OAA6C,EAAE,EAAE;QACjF,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,GAAG,yCAAyC,CAAC;QAChF,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,0GAA0G;IAC1G,MAAM,SAAS,GAAG,MAAM,IAAA,0BAAkB,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAErD,OAAO,IAAA,yBAAgB,EAAC,UAAU,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,kBAAe,eAAe,CAAC;AAE/B,SAAS,qBAAqB,CAAC,IAAU;IACvC,MAAM,MAAM,GAAG,IAAA,mBAAU,EAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACtC,MAAM,CAAC,eAAe,GAAG;QACvB,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,MAAM;KAChB,CAAC;IACF,IAAA,qBAAY,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7B,CAAC","sourcesContent":["import {\n  Tree,\n  addDependenciesToPackageJson,\n  generateFiles,\n  readNxJson,\n  runTasksInSerial,\n  updateJson,\n  updateNxJson,\n} from \"@nx/devkit\";\nimport { initGenerator as jsInitGenerator } from \"@nx/js\";\nimport { reactInitGenerator } from \"@nx/react\";\nimport path from \"path\";\nimport { PresetGeneratorSchema } from \"./schema\";\n\n/**\n *  Preset generator for Iris apps workspace.\n *  Use with create-nx-workspace to create a new workspace for developing Iris apps.\n * ```npx create-nx-workspace --preset=iris-app```\n */\nexport async function presetGenerator(tree: Tree, options: PresetGeneratorSchema) {\n  // setup workspace\n  updateWorkspaceLayout(tree);\n  tree.write(\n    \"apps/readme.md\",\n    `# Apps\\n\\nThis folder contains all apps in the workspace.\\n\\nApps are the main entry point for the Iris App SDK.\\nCreate an app by running \\`nx g @trackunit/iris-app:create <app-name>\\`.`\n  );\n  tree.write(\n    \"libs/readme.md\",\n    `# Libs\\n\\nThis folder contains all libs in the workspace.\\nCreate a lib by running \\`nx g @trackunit/iris-app:extend <lib-name>\\`.`\n  );\n\n  const extensionsPath = \".vscode/extensions.json\";\n\n  if (!tree.exists(extensionsPath)) {\n    tree.write(extensionsPath, \"{}\");\n  }\n\n  generateFiles(tree, path.join(__dirname, \"files\"), \".\", {});\n\n  updateJson(tree, extensionsPath, value => {\n    if (!value.recommendations) {\n      value.recommendations = [];\n    }\n    value.recommendations.push(\n      \"graphql.vscode-graphql\",\n      \"graphql.vscode-graphql-syntax\",\n      \"bradlc.vscode-tailwindcss\",\n      \"firsttris.vscode-jest-runner\"\n    );\n    return value;\n  });\n\n  const jsInitTask = await jsInitGenerator(tree, {\n    ...options,\n    tsConfigName: \"tsconfig.base.json\",\n    skipFormat: true,\n  });\n\n  addDependenciesToPackageJson(\n    tree,\n    {\n      react: \"19.0.0\",\n      \"react-dom\": \"19.0.0\",\n    },\n    {}\n  );\n\n  // Add update script for @trackunit packages\n  updateJson(tree, \"package.json\", (pkgJson: { scripts?: Record<string, string> }) => {\n    if (!pkgJson.scripts) {\n      pkgJson.scripts = {};\n    }\n    pkgJson.scripts[\"update:trackunit\"] = 'npx npm-check-updates \"/@trackunit/\" -u';\n    return pkgJson;\n  });\n\n  // This react generator adds react 19 and react-dom 19 to the package.json if we don't add react 18 above.\n  const initReact = await reactInitGenerator(tree, {});\n\n  return runTasksInSerial(jsInitTask, initReact);\n}\n\nexport default presetGenerator;\n\nfunction updateWorkspaceLayout(tree: Tree) {\n  const nxJson = readNxJson(tree) ?? {};\n  nxJson.workspaceLayout = {\n    libsDir: \"libs\",\n    appsDir: \"apps\",\n  };\n  updateNxJson(tree, nxJson);\n}\n"]}

package/src/generators/preset/root-files/AGENTS.md

@@ -0,0 +1,43 @@
+# IrisX App SDK Workspace
+
+This is an IrisX App workspace. Follow these rules for all development.
+
+## Building Real Applications
+
+You are building real applications that work with actual Trackunit data.
+
+- Never mock data unless explicitly requested by the user
+- Always use Trackunit's GraphQL API to fetch real data
+- If data is not available via GraphQL, ask the user how they want to obtain the data
+- Only use mock data if the user explicitly requests it for testing purposes
+
+When building any feature:
+1. Identify what data you need
+2. Check if it's available via Trackunit's GraphQL API
+3. If available, use the GraphQL API
+4. If not available, ask the user
+
+## IrisX App Commands
+
+**ALWAYS use these specific commands** (never generic React/Node.js commands):
+
+- **Create new app:** `npx nx generate @trackunit/iris-app:create [name-of-your-app]`
+- **Create new extension:** `npx nx g @trackunit/iris-app:extend --name=[my-extension-name] --app=[app-name] --directory=[feature] --type=[extension-type]`
+- **Run app:** `npx nx run [name-of-your-app]:serve`
+
+Available extension types:
+- `ASSET_HOME_EXTENSION` - Tabs in Asset Home screen
+- `SITE_HOME_EXTENSION` - Tabs in Site Home screen
+- `FLEET_EXTENSION` - Menu items in Main Menu
+- `REPORT_EXTENSION` - Reports in Reports screen
+- `WIDGET_EXTENSION` - Dashboard widgets
+- `IRIS_APP_SETTINGS_EXTENSION` - Configuration in App library
+- `ADMIN_EXTENSION` - Admin UI tabs (admin-only)
+- `CUSTOMER_HOME_EXTENSION` - UI within Customer Home
+- `ASSET_EVENTS_ACTIONS_EXTENSION` - UI in Asset Home Events
+- `LIFECYCLE_EXTENSION` - Handles app install/uninstall events
+- `SERVERLESS_FUNCTION_EXTENSION` - Serverless backend functions
+
+## Quality Assurance
+
+Before completing any task: Always check for and fix all ESLint and TypeScript errors in modified files.

package/src/generators/preset/root-files/CLAUDE.md

@@ -0,0 +1,17 @@
+@AGENTS.md
+
+# IrisX App Workspace
+
+This is an IrisX App project generated by the Trackunit SDK. Follow AGENTS.md for all development rules.
+
+## Skills
+
+SDK-specific skills are located in `.agents/skills/`. When a skill is referenced in AGENTS.md, read it from `.agents/skills/[skill-name]/SKILL.md`.
+
+If skills from `.agents/skills/` are not appearing in your available skills list, suggest the user symlink them for automatic discovery:
+
+```bash
+ln -s .agents/skills .claude/skills
+```
+
+Note: If the user already has a `.claude/skills` folder, they should symlink individual skills or the contents instead.

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/iris-app-sdk/iris-app/src/index.ts"],"names":[],"mappings":";;;;AAAA,2DAAiE;AAAxD,6GAAA,gBAAgB,OAAA;AAEzB,2DAA0E;AAAjE,sHAAA,yBAAyB,OAAA;AAElC,+DAAqC;AACrC,8DAAoC","sourcesContent":["export { IrisAppGenerator } from \"./generators/create/generator\";\nexport type { IrisAppGeneratorSchema } from \"./generators/create/schema\";\nexport { IrisAppExtensionGenerator } from \"./generators/extend/generator\";\nexport type { IrisAppExtensionGeneratorSchema } from \"./generators/extend/schema\";\nexport * from \"./utils/ast/astUtils\";\nexport * from \"./utils/fileUpdater\";\n"]}

package/src/utils/ast/astUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astUtils.js","sourceRoot":"","sources":["../../../../../../../libs/iris-app-sdk/iris-app/src/utils/ast/astUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { objectEntries } from \"@trackunit/shared-utils\";\nimport { tsquery } from \"@phenomnomnominal/tsquery\";\nimport * as ts from \"typescript\";\n\n/**\n * This function removes a property with a given name from an object literal\n * provided as a text string.\n *\n * @param {string} fileContent The source code as text\n * @param {string} propertyNames The properties to remove from the object\n */\nexport function removePropertyWithName(fileContent: string, ...propertyNames: Array<string>) {\n  const sourceFile = tsquery.ast(fileContent);\n  const updatedSourceFile = tsquery.map(sourceFile, \"ObjectLiteralExpression\", node => {\n    if (ts.isObjectLiteralExpression(node)) {\n      // Filter out the given property\n      const updatedProperties = node.properties.filter(property => {\n        return !(\n          ts.isPropertyAssignment(property) &&\n          ts.isIdentifier(property.name) &&\n          propertyNames.includes(property.name.text)\n        );\n      });\n      return ts.factory.createObjectLiteralExpression(updatedProperties, true);\n    }\n    return node;\n  });\n  return ts.createPrinter().printFile(updatedSourceFile);\n}\n\n/**\n * This function adds a new property with a given name and value to an object literal\n * provided as a text string.\n *\n * @param {string} fileContent - the source code as text\n * @param {string} propertyName - the name of the property to add\n * @param {string | string[]} propertyValue - the value of the property to add\n */\nexport function addPropertyWithName(\n  fileContent: string,\n  propertyName: string,\n  propertyValue: string | Array<string> | Record<string, string>\n) {\n  const sourceFile = tsquery.ast(fileContent);\n  const updatedSourceFile = tsquery.map(sourceFile, \"ObjectLiteralExpression\", node => {\n    if (ts.isObjectLiteralExpression(node)) {\n      // Add a new property to the object literal\n      let updatedProperties;\n      if (typeof propertyValue === \"string\") {\n        updatedProperties = [\n          ...node.properties,\n          ts.factory.createPropertyAssignment(\n            ts.factory.createIdentifier(propertyName),\n            ts.factory.createStringLiteral(propertyValue)\n          ),\n        ];\n      } else if (Array.isArray(propertyValue)) {\n        const arrayLiteral = ts.factory.createArrayLiteralExpression(\n          propertyValue.map(value => ts.factory.createStringLiteral(value))\n        );\n        updatedProperties = [\n          ...node.properties,\n          ts.factory.createPropertyAssignment(ts.factory.createIdentifier(propertyName), arrayLiteral),\n        ];\n      } else if (typeof propertyValue === \"object\") {\n        updatedProperties = [\n          ...node.properties,\n          ts.factory.createPropertyAssignment(\n            ts.factory.createIdentifier(propertyName),\n            ts.factory.createObjectLiteralExpression(createObjectLiteralElementLike(propertyValue))\n          ),\n        ];\n      }\n      return ts.factory.createObjectLiteralExpression(updatedProperties, true);\n    }\n    return node;\n  });\n  return ts.createPrinter().printFile(updatedSourceFile);\n}\n\n/**\n * This function adds a spread assignment to an object literal.\n *\n * @param {string} fileContent - the source code as text\n * @param {string} variableName - the name of the variable to spread\n */\nexport function addSpreadAssignment(fileContent: string, variableName: string) {\n  const sourceFile = tsquery.ast(fileContent);\n  \n  // First check if the spread already exists\n  const existingSpreads = tsquery(sourceFile, \"SpreadAssignment\");\n  const hasExistingSpread = existingSpreads.some(spread => {\n    if (ts.isSpreadAssignment(spread)) {\n      return spread.expression.getText() === variableName;\n    }\n    return false;\n  });\n  \n  if (hasExistingSpread) {\n    return fileContent; // Already has the spread, no changes needed\n  }\n  \n  const updatedSourceFile = tsquery.map(sourceFile, \"ObjectLiteralExpression\", node => {\n    if (ts.isObjectLiteralExpression(node)) {\n      // Add the spread assignment to the object literal\n      const spreadAssignment = ts.factory.createSpreadAssignment(\n        ts.factory.createIdentifier(variableName)\n      );\n      const updatedProperties = [...node.properties, spreadAssignment];\n      return ts.factory.createObjectLiteralExpression(updatedProperties, true);\n    }\n    return node;\n  });\n  return ts.createPrinter().printFile(updatedSourceFile);\n}\n\n/**\n * This function adds a require statement to a file after existing require statements.\n *\n * @param {string} fileContent - the source code as text\n * @param {string} variableName - the name of the variable to assign to\n * @param {string} modulePath - the module path to require\n */\nexport function addRequireStatement(fileContent: string, variableName: string, modulePath: string) {\n  const sourceFile = tsquery.ast(fileContent);\n  \n  // Check if the require statement already exists\n  const existingRequires = tsquery(sourceFile, \"CallExpression\");\n  const hasExistingRequire = existingRequires.some(call => {\n    if (ts.isCallExpression(call) && \n        ts.isIdentifier(call.expression) && \n        call.expression.text === \"require\" &&\n        call.arguments.length > 0) {\n      const firstArg = call.arguments[0];\n      if (firstArg && ts.isStringLiteral(firstArg)) {\n        return firstArg.text === modulePath;\n      }\n    }\n    return false;\n  });\n  \n  if (hasExistingRequire) {\n    return fileContent; // Already has the require, no changes needed\n  }\n  \n  // Find all variable statements with require calls\n  const requireStatements = tsquery(sourceFile, \"VariableStatement\")\n    .filter(stmt => stmt.getText().includes(\"require(\"));\n  \n  const requireStatement = `const ${variableName} = require(\"${modulePath}\").default;`;\n  \n  if (requireStatements.length > 0) {\n    // Add after the last require statement\n    const lastRequire = requireStatements[requireStatements.length - 1];\n    if (lastRequire) {\n      const lastRequireEnd = lastRequire.getEnd();\n      \n      return fileContent.slice(0, lastRequireEnd) + '\\n' + requireStatement + fileContent.slice(lastRequireEnd);\n    }\n  }\n  \n  // Add at the beginning if no require statements found\n  return requireStatement + '\\n' + fileContent;\n}\n\nfunction createObjectLiteralElementLike(obj: Record<string, string>): Array<ts.ObjectLiteralElementLike> {\n  const properties: Array<ts.ObjectLiteralElementLike> = [];\n  for (const [key, value] of objectEntries(obj)) {\n    properties.push(\n      ts.factory.createPropertyAssignment(ts.factory.createStringLiteral(key), ts.factory.createStringLiteral(value))\n    );\n  }\n  return properties;\n}\n"]}

package/src/utils/fileUpdater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileUpdater.js","sourceRoot":"","sources":["../../../../../../libs/iris-app-sdk/iris-app/src/utils/fileUpdater.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACI,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAE,IAAY,EAAE,OAAwC,EAAE,EAAE;IACrG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAEpC,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC;AAdW,QAAA,gBAAgB,oBAc3B","sourcesContent":["import { Tree } from \"@nx/devkit\";\n\n/**\n *\n * @param tree File system tree\n * @param path Path to source file in the Tree\n * @param updater Function that maps the current file content to a new to be written to the Tree\n */\nexport const updateFileInTree = (tree: Tree, path: string, updater: (fileContent: string) => string) => {\n  if (!tree.exists(path)) {\n    throw new Error(\"File not found: \" + path);\n  }\n\n  const fileContent = tree.read(path, \"utf-8\");\n  if (!fileContent) {\n    throw new Error(\"File is empty: \" + path);\n  }\n  const result = updater(fileContent);\n\n  if (result !== fileContent) {\n    tree.write(path, result);\n  }\n};\n"]}

package/src/generators/preset/files/.cursor/commands/create-app.md

@@ -1,226 +0,0 @@
-# Create IrisX App
-
-You are helping a user create a new IrisX App with appropriate extensions. Follow this browser-driven iterative development workflow.
-
-## Core Principles
-
-### Real Data First
-**CRITICAL: Always use Trackunit's GraphQL API for data** - never mock data unless explicitly requested.
-- Use **Trackunit MCP** `introspect-schema` to discover available data
-- Use **Trackunit MCP** `validate-query` to test queries before implementing
-- See @irisx-app-sdk-graphql for implementation patterns
-
-### UI Components
-**Use Trackunit Component Library** for consistent UI:
-- Use **Trackunit MCP** `get-story-code` to find components and patterns
-- See @tables-and-sorting, @react-core-hooks for details
-
-### Browser Testing
-**Follow browser-first development workflow**:
-- See @browser-irisx-development for complete browser testing procedures
-- Always verify in browser after each code change
-- Check lints first, then reload browser and verify
-
-## Development Workflow
-
-### Phase 1: Planning
-
-**1. Analyze Requirements**
-If not already described, ask: "What functionality do you want to build?"
-
-**2. Create Implementation Plan**
-Before any coding, create a detailed plan that **MUST follow this structure**:
-
-**Phase 1: Project Setup**
-- Create app with `@trackunit/iris-app:create [app-name]`
-- Create extensions with `@trackunit/iris-app:extend` (list each extension)
-- Start dev server in background
-
-**Phase 2: Browser Verification (CRITICAL GATE)**
-- Open browser to https://new.manager.trackunit.com/goto/iris-app-dev
-- Wait for user login (2-4 minutes)
-- Enable "Use Local Apps" toggle (dataTestId="localDevModeSwitch") if not already enabled
-- Navigate to extension location based on type (see @browser-irisx-development):
-  - FLEET_EXTENSION: Main menu → App name
-  - ASSET_HOME_EXTENSION: Assets → Select asset → Extension tab
-  - SITE_HOME_EXTENSION: Sites → Select site → Extension tab
-  - WIDGET_EXTENSION: Dashboard → Add Widget → Find widget
-- Take snapshot to verify extension loads
-- Check console for errors
-- **STOP - Must confirm extension working in browser before Phase 3**
-
-**Phase 3: Feature Implementation (One at a Time)**
-For EACH feature, list as separate item:
-- Feature 1: [Name]
-  - Prerequisites: [GraphQL setup/scopes/packages needed for THIS feature only]
-  - Implementation: [What to build]
-  - Validation: Check lints (zero tolerance), then browser test
-  - Browser test: [What to verify]
-  
-- Feature 2: [Name]
-  - Prerequisites: [Any new tools needed for THIS feature]
-  - Implementation: [What to build]
-  - Validation: Check lints (zero tolerance), then browser test
-  - Browser test: [What to verify]
-
-(Continue for all features)
-
-**Phase 4: Final Verification**
-- Run lints on all files (zero errors)
-- End-to-end browser testing
-- Documentation completion
-
-**Plan Details:**
-- App name: [kebab-case, descriptive]
-- Extension types: [List types from @irisx-app-sdk]
-- Data sources: [GraphQL queries, CustomFields needed]
-- UI components: [Components from Trackunit library]
-- Manifest config: [Scopes, CSP headers if needed]
-
-**3. Present Plan to User**
-Show the complete plan with:
-- **Browser flow explicitly documented** in Phase 2 with the URL https://new.manager.trackunit.com/goto/iris-app-dev
-- Navigation steps for the specific extension type(s)
-- Browser-first workflow clearly outlined
-Confirm with user before proceeding.
-
-### Phase 2: Project Setup
-
-**4. Create App and Extensions ONLY**
-```bash
-npx nx generate @trackunit/iris-app:create [app-name]
-npx nx g @trackunit/iris-app:extend --name=[extension-name] --directory=[feature-name] --type=[EXTENSION_TYPE]
-```
-
-**5. Start Development Server Immediately**
-Run in background terminal right after creation:
-```bash
-npx nx run [app-name]:serve
-```
-
-**6. Open Browser and Verify Basics Work**
-**CRITICAL: Do this BEFORE any GraphQL setup or UI implementation**
-
-Follow the complete browser setup workflow in @browser-irisx-development:
-- Navigate to https://new.manager.trackunit.com/goto/iris-app-dev
-- Wait for user login (be patient, 2-4 minutes)
-- Enable "Use Local Apps" toggle (dataTestId="localDevModeSwitch") if not already enabled
-- Navigate to extension location based on type:
-  - FLEET_EXTENSION: Main menu → Look for app name
-  - ASSET_HOME_EXTENSION: Assets → Open any asset → Look for extension tab
-  - SITE_HOME_EXTENSION: Sites → Open any site → Look for extension tab
-  - WIDGET_EXTENSION: Dashboard → Add Widget → Find widget
-- Take snapshot to verify extension loads
-- Check console for errors using browser_console_messages
-
-**STOP HERE: Do not proceed to Phase 3 until extension is confirmed working in browser**
-
-### Phase 3: Iterative Feature Development
-
-**7. Create Documentation**
-Create `/docs/[app-name].md` following @structured-development with the plan and architecture.
-
-**8. For Each Feature in Plan (ONE AT A TIME)**
-
-For each feature, follow this exact workflow:
-
-**a) Setup prerequisites for this feature ONLY**:
-   - If feature needs GraphQL: Install GraphQL tools NOW
-     ```bash
-     npm install @trackunit/react-graphql-tools
-     npx nx generate @trackunit/react-graphql-tools:add-graphql --project=[project-name]
-     ```
-   - If feature needs specific scopes: Update manifest NOW
-   - If feature needs CustomFields: Configure manifest NOW
-   - Use Trackunit MCP to discover data/components needed for THIS feature
-
-**b) Implement the feature**:
-   - Write code changes for ONE feature only
-   - Keep changes small and focused (single metric, single UI component, etc.)
-   - If building multiple similar items (e.g., 3 KPI cards), do them one at a time
-
-**c) Check for lint and TypeScript errors**:
-   - Run `read_lints` on the files you just modified
-   - Fix ALL errors immediately
-   - Zero tolerance: Do not proceed with any linter or TypeScript errors
-   - Recheck after fixes to confirm all errors are resolved
-
-**d) Reload browser to test**:
-   - Follow reload strategy in @browser-irisx-development
-   - Check browser console and network tab for errors
-   - Verify the feature renders correctly
-   - Take screenshot if visual changes
-
-**f) Debug if needed**:
-   - Read console errors from browser
-   - Check network requests for GraphQL/API issues
-   - Adjust code and repeat from step c) (check lints, then reload browser) until feature works
-   - DO NOT move forward until this feature is working
-
-**g) Update documentation**:
-   - Mark feature as completed in `/docs/[app-name].md`
-   - Document any important findings or gotchas
-
-**h) Move to next feature**:
-   - Only proceed when current feature is verified working in browser with zero errors
-   - Repeat entire process for next feature in plan
-
-**9. Continuous Validation Rules**
-Throughout all of Phase 3:
-- After EVERY code change: Check lints first, then reload browser (@browser-irisx-development)
-- Fix ALL lint and TypeScript errors immediately (zero tolerance)
-- Check browser console for errors after each reload
-- Never implement multiple features without full validation between them
-
-### Phase 4: Completion
-
-**10. Final Verification**
-- Run `read_lints` on all modified files to ensure zero errors
-- Test all features end-to-end in browser (@browser-irisx-development)
-- Verify data loads correctly (real GraphQL data)
-- Take screenshots of working features
-
-**11. Summary**
-Inform the user:
-- All features implemented and verified in browser with zero errors
-- No linter or TypeScript errors remaining
-- Documentation at `docs/[app-name].md`
-- App running at local dev server
-- **Important**: User must deploy via Trackunit marketplace (never auto-submit)
-
-## Critical Development Rules
-
-### Strict Browser-First Workflow
-**Follow this exact order:**
-
-1. Create app + extensions
-2. Start dev server immediately
-3. Open browser and verify extension loads (@browser-irisx-development)
-4. **STOP - Do not proceed without browser verification**
-5. Implement ONE feature with prerequisites
-6. Check lints and fix ALL errors (zero tolerance)
-7. Reload browser and verify that ONE feature (@browser-irisx-development)
-8. Repeat steps 5-7 for each remaining feature
-
-### Feature Implementation Rules
-- **One feature at a time** - even if building similar components
-- **Prerequisites on-demand** - set up GraphQL/scopes only when needed for current feature
-- **Zero tolerance for errors** - fix all lint and TypeScript errors immediately after code changes
-- **Test completely** - verify working in browser before moving on
-- **Small incremental changes** - easier to debug when issues arise
-- **Continuous validation** - lint check, then browser test after every change
-
-### Validation Checklist
-After EVERY code change:
-1. Run `read_lints` on modified files
-2. Fix ALL linter and TypeScript errors (zero tolerance)
-3. Reload browser (see @browser-irisx-development for reload strategy)
-4. Check browser console and network tab for errors
-5. Verify UI renders correctly
-6. Take screenshot if visual changes
-7. Fix any issues before proceeding
-
-### Data & UI Development
-- **GraphQL**: Use Trackunit MCP `introspect-schema` and `validate-query`, then implement per @irisx-app-sdk-graphql
-- **Components**: Use Trackunit MCP `get-story-code` to find patterns, implement, verify in browser
-- **Real Data**: Always use Trackunit GraphQL API, never mock data unless explicitly requested