@trackunit/iris-app 2.6.26-alpha-12adfed37e0.0 → 2.7.0

package/CHANGELOG.md

@@ -1,3 +1,22 @@
+## 2.7.0 (2026-09-17)
+
+### 🚀 Features
+
+- **iris-app:** SAGA-830 ship map setup guidance in generated workspaces ([c39be40f8e6](https://github.com/Trackunit/manager/commit/c39be40f8e6))
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-build-utilities to 2.4.56
+- Updated iris-app-api to 2.6.4
+- Updated react-vite-test-setup to 0.0.139
+- Updated css-classname-utils to 0.0.47
+- Updated react-graphql-tools to 1.17.36
+- Updated shared-utils to 1.16.49
+
+### ❤️ Thank You
+
+- cameliaistrate
+
 ## 2.6.25 (2026-09-17)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app",
-  "version": "2.6.26-alpha-12adfed37e0.0",
+  "version": "2.7.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "src/index.js",
   "generators": "./generators.json",
@@ -10,7 +10,7 @@
     "node": ">=24.x"
   },
   "dependencies": {
-    "@trackunit/css-classname-utils": "0.0.47-alpha-12adfed37e0.0",
+    "@trackunit/css-classname-utils": "0.0.47",
     "@typescript-eslint/types": "8.58.1",
     "@typescript-eslint/typescript-estree": "8.58.1",
     "pacote": "^21.0.4",
@@ -26,10 +26,10 @@
     "@nx/react": "23.1.0",
     "@npmcli/arborist": "^9.1.9",
     "win-ca": "^3.5.1",
-    "@trackunit/iris-app-build-utilities": "2.4.56-alpha-12adfed37e0.0",
-    "@trackunit/react-graphql-tools": "1.17.36-alpha-12adfed37e0.0",
-    "@trackunit/shared-utils": "1.16.49-alpha-12adfed37e0.0",
-    "@trackunit/iris-app-api": "2.6.4-alpha-12adfed37e0.0",
+    "@trackunit/iris-app-build-utilities": "2.4.56",
+    "@trackunit/react-graphql-tools": "1.17.36",
+    "@trackunit/shared-utils": "1.16.49",
+    "@trackunit/iris-app-api": "2.6.4",
     "tslib": "^2.6.2",
     "@clack/prompts": "^1.0.0",
     "@npm/types": "^1.0.2",

package/src/generators/preset/files/.agents/skills/set-up-react-map/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: set-up-react-map
+description: >-
+  Builds a base map in a generated IrisX app with @trackunit/react-map and
+  Trackunit's public Google Maps or Mapbox adapter. Use when adding a greenfield
+  map or choosing and configuring a map provider. Not for legacy map migrations.
+---
+
+# Set up react-map
+
+Use `@trackunit/react-map` with one Trackunit adapter. Do not use `google.maps`, Mapbox JavaScript APIs, or adapter implementation dependencies directly in app code. Importing the required Mapbox stylesheet is the only `mapbox-gl` import allowed.
+
+## Ensure a UI extension exists
+
+An IrisX app needs a UI extension to render the map. If none exists, ask the user which extension point should contain it, then generate one:
+
+```bash
+npx nx g @trackunit/iris-app:extend --name=<extension-name> --app=<app-name> --directory=<directory> --type=<extension-type>
+```
+
+Do not choose an extension point without user confirmation.
+
+## Choose the provider
+
+Before implementing, ask which adapter to use unless the request already names one:
+
+- `@trackunit/react-map-adapter-google`: Google Maps is the provider currently used and supported by Trackunit. Use this by default when no preference is specified or the user asks for Trackunit's supported adapter.
+- `@trackunit/react-map-adapter-mapbox`: use only when the user selects Mapbox. Trackunit does not have a Mapbox access token—that should be supplied by the user.
+
+## Install
+
+Use the generated workspace's npm workflow. Install only the selected adapter.
+
+Google:
+
+```bash
+npm install @trackunit/react-map @trackunit/react-map-adapter-google
+npm install --save-dev @types/google.maps
+```
+
+Mapbox:
+
+```bash
+npm install @trackunit/react-map @trackunit/react-map-adapter-mapbox
+```
+
+Then read the installed package READMEs for the current public API:
+
+- [`@trackunit/react-map` README](../../../node_modules/@trackunit/react-map/README.md)
+- [`@trackunit/react-map-adapter-google` README](../../../node_modules/@trackunit/react-map-adapter-google/README.md)
+- [`@trackunit/react-map-adapter-mapbox` README](../../../node_modules/@trackunit/react-map-adapter-mapbox/README.md)
+
+## Configure CSP
+
+An empty `cspHeader` does not allow either provider by default. Spread the selected adapter's CSP contract in `iris-app-manifest.ts`.
+
+Google:
+
+```ts
+import { googleMapCspDirectives } from "@trackunit/react-map-adapter-google";
+
+const irisAppManifest = {
+  // Existing manifest fields
+  cspHeader: {
+    ...googleMapCspDirectives(),
+  },
+};
+```
+
+Mapbox:
+
+```ts
+import { mapboxMapCspDirectives } from "@trackunit/react-map-adapter-mapbox";
+
+const irisAppManifest = {
+  // Existing manifest fields
+  cspHeader: {
+    ...mapboxMapCspDirectives(),
+  },
+};
+```
+
+If the manifest already declares the same directives, merge their arrays without removing adapter values. Custom Mapbox styles and tile sources may require additional origins. Stop and re-serve the app after changing its manifest.
+
+## Render the base map
+
+Ensure every map ancestor has a resolved height. Scaffold the selected adapter with an empty credential, then ask the user to provide it after the scaffold is ready. Do not introduce a credential-management dependency unless the user requests one; if they do, use a version compatible with the generated workspace.
+
+Google:
+
+```tsx
+import { DefaultControls, useMap } from "@trackunit/react-map";
+import { googleMapsAdapter } from "@trackunit/react-map-adapter-google";
+
+const [Map, api] = useMap(googleMapsAdapter({ apiKey: "" }));
+
+return (
+  <Map aria-label="Map" className="h-full w-full">
+    <DefaultControls api={api} />
+  </Map>
+);
+```
+
+Mapbox:
+
+```tsx
+import "mapbox-gl/dist/mapbox-gl.css";
+import { DefaultControls, useMap } from "@trackunit/react-map";
+import { mapboxAdapter } from "@trackunit/react-map-adapter-mapbox";
+
+const [Map, api] = useMap(mapboxAdapter({ accessToken: "" }));
+
+return (
+  <Map aria-label="Map" className="h-full w-full">
+    <DefaultControls api={api} />
+  </Map>
+);
+```
+
+Import the Mapbox CSS once in the app entry when using Mapbox.
+
+## Verify
+
+1. Run `npx nx run <extension>:lint`, `test`, and `tsc-validate`.
+2. Run `npx nx run <app>:build`.
+3. Serve the app and enable **Use Local Apps** in Manager.
+4. Verify tiles and provider attribution render on first load.
+5. Check the browser console for CSP violations and credential errors.