@saschabrunnerch/arcgis-maps-sdk-js-ai-context 0.0.1 → 0.1.0

package/contexts/4.34/copilot/arcgis-arcade.instructions.md

@@ -1,234 +0,0 @@
----
-applyTo: "**/*.{js,ts,jsx,tsx,html}"
----
-
-# ArcGIS Maps SDK - Arcade Expressions
-
-## Arcade Basics
-
-Arcade is used for:
-- Dynamic popup content
-- Data-driven rendering
-- Custom labels
-- Field calculations
-- Form validation
-
-### Basic Syntax
-```arcade
-var population = $feature.population;
-var area = $feature.area_sqkm;
-var density = population / area;
-return Round(density, 2);
-```
-
-## Arcade in PopupTemplates
-
-```javascript
-layer.popupTemplate = {
-  title: "{name}",
-  expressionInfos: [
-    {
-      name: "density",
-      title: "Population Density",
-      expression: "Round($feature.population / $feature.area, 2)"
-    }
-  ],
-  content: "Density: {expression/density} people/km²"
-};
-```
-
-## Arcade in Renderers
-
-```javascript
-layer.renderer = {
-  type: "unique-value",
-  valueExpression: `
-    if ($feature.value > 100) {
-      return "High";
-    } else {
-      return "Low";
-    }
-  `,
-  uniqueValueInfos: [
-    { value: "High", symbol: { type: "simple-fill", color: "red" } },
-    { value: "Low", symbol: { type: "simple-fill", color: "blue" } }
-  ]
-};
-```
-
-### Visual Variable Expression
-```javascript
-visualVariables: [{
-  type: "size",
-  valueExpression: "Sqrt($feature.population) * 0.1",
-  stops: [
-    { value: 10, size: 4 },
-    { value: 100, size: 40 }
-  ]
-}]
-```
-
-## Arcade in Labels
-
-```javascript
-layer.labelingInfo = [{
-  symbol: { type: "text", color: "black", font: { size: 10 } },
-  labelExpressionInfo: {
-    expression: `
-      var pop = $feature.population;
-      if (pop > 1000000) {
-        return $feature.name + " (" + Round(pop/1000000, 1) + "M)";
-      }
-      return $feature.name;
-    `
-  }
-}];
-```
-
-## Math Functions
-
-```arcade
-Round(3.14159, 2)        // 3.14
-Floor(3.9)               // 3
-Ceil(3.1)                // 4
-Abs(-5)                  // 5
-Sqrt(16)                 // 4
-Pow(2, 3)                // 8
-Min(1, 2, 3)             // 1
-Max(1, 2, 3)             // 3
-Sum([1, 2, 3])           // 6
-Mean([1, 2, 3])          // 2
-```
-
-## Text Functions
-
-```arcade
-Upper("hello")           // "HELLO"
-Lower("HELLO")           // "hello"
-Trim("  hello  ")        // "hello"
-Left("hello", 2)         // "he"
-Right("hello", 2)        // "lo"
-Find("l", "hello")       // 2
-Replace("hello", "l", "L") // "heLLo"
-Split("a,b,c", ",")      // ["a", "b", "c"]
-Concatenate(["a", "b"])  // "ab"
-```
-
-## Date Functions
-
-```arcade
-Now()                                    // Current date/time
-Today()                                  // Current date
-Year($feature.date_field)               // Extract year
-Month($feature.date_field)              // Extract month
-Day($feature.date_field)                // Extract day
-DateDiff(Now(), $feature.date, "days")  // Days between
-Text($feature.date, "MMMM D, YYYY")     // Format date
-```
-
-## Geometry Functions
-
-```arcade
-Area($feature, "square-kilometers")
-Length($feature, "kilometers")
-Centroid($feature)
-Buffer($feature, 100, "meters")
-Intersects($feature, $otherFeature)
-Contains($feature, $point)
-```
-
-## Conditional Functions
-
-```arcade
-// IIf (inline if)
-IIf($feature.value > 100, "High", "Low")
-
-// When (multiple conditions)
-When(
-  $feature.type == "A", "Type A",
-  $feature.type == "B", "Type B",
-  "Other"
-)
-
-// Decode (value matching)
-Decode($feature.code,
-  1, "One",
-  2, "Two",
-  "Unknown"
-)
-```
-
-## Array Functions
-
-```arcade
-var arr = [1, 2, 3, 4, 5];
-Count(arr)               // 5
-First(arr)               // 1
-Last(arr)                // 5
-IndexOf(arr, 3)          // 2
-Includes(arr, 3)         // true
-Push(arr, 6)             // adds 6
-Reverse(arr)             // reverses
-Sort(arr)                // sorts
-Slice(arr, 1, 3)         // [2, 3]
-```
-
-## Feature Access
-
-```arcade
-// Current feature
-$feature.fieldName
-
-// All features in layer
-var allFeatures = FeatureSet($layer);
-var filtered = Filter(allFeatures, "type = 'A'");
-var total = Sum(filtered, "value");
-
-// Related records
-var related = FeatureSetByRelationshipName($feature, "relationshipName");
-
-// Global variables
-$map, $view, $datastore
-```
-
-## Execute Programmatically
-
-```javascript
-import Arcade from "@arcgis/core/arcade/Arcade.js";
-
-const profile = {
-  variables: [{ name: "$feature", type: "feature" }]
-};
-
-const executor = await Arcade.createArcadeExecutor(
-  "Round($feature.value * 100, 2)",
-  profile
-);
-
-const result = executor.execute({ $feature: graphic });
-```
-
-## Arcade in HTML
-
-```html
-<script type="text/plain" id="my-expression">
-  var total = $feature.value_a + $feature.value_b;
-  return Round(total, 1);
-</script>
-
-<script type="module">
-  const expression = document.getElementById("my-expression").text;
-  layer.popupTemplate = {
-    expressionInfos: [{ name: "calc", expression }],
-    content: "Value: {expression/calc}"
-  };
-</script>
-```
-
-## Common Pitfalls
-
-1. **Null values** - Check with `IsEmpty($feature.field)`
-2. **Type coercion** - Use `Number()` or `Text()` for conversion
-3. **Case sensitivity** - Functions case-insensitive, field names exact
-4. **Performance** - Complex expressions slow down rendering
-5. **Debugging** - Use `Console()` function

package/contexts/4.34/copilot/arcgis-authentication.instructions.md

@@ -1,187 +0,0 @@
----
-applyTo: "**/*.{js,ts,jsx,tsx,html}"
----
-
-# ArcGIS Maps SDK - Authentication
-
-## OAuth 2.0 Authentication
-
-### Basic OAuth Setup
-```javascript
-import OAuthInfo from "@arcgis/core/identity/OAuthInfo.js";
-import esriId from "@arcgis/core/identity/IdentityManager.js";
-
-const oauthInfo = new OAuthInfo({
-  appId: "YOUR_APP_ID",
-  popup: false  // false = redirect, true = popup
-});
-
-esriId.registerOAuthInfos([oauthInfo]);
-```
-
-### Check Sign-In Status
-```javascript
-async function checkSignIn() {
-  try {
-    await esriId.checkSignInStatus(oauthInfo.portalUrl + "/sharing");
-    const portal = new Portal({ authMode: "immediate" });
-    await portal.load();
-    console.log("Signed in as:", portal.user.username);
-    return portal;
-  } catch {
-    console.log("Not signed in");
-    return null;
-  }
-}
-```
-
-### Sign In
-```javascript
-async function signIn() {
-  const credential = await esriId.getCredential(
-    oauthInfo.portalUrl + "/sharing"
-  );
-  return credential;
-}
-```
-
-### Sign Out
-```javascript
-function signOut() {
-  esriId.destroyCredentials();
-  window.location.reload();
-}
-```
-
-### OAuth Component
-```html
-<arcgis-oauth app-id="YOUR_APP_ID"></arcgis-oauth>
-
-<script type="module">
-  const oauth = document.querySelector("arcgis-oauth");
-  oauth.addEventListener("arcgisSignIn", (e) => console.log(e.detail.credential));
-  oauth.addEventListener("arcgisSignOut", () => console.log("Signed out"));
-</script>
-```
-
-## API Keys
-
-```javascript
-import esriConfig from "@arcgis/core/config.js";
-
-esriConfig.apiKey = "YOUR_API_KEY";
-
-const map = new Map({
-  basemap: "arcgis/streets"  // Requires API key
-});
-```
-
-### API Key in HTML
-```html
-<script>
-  window.esriConfig = { apiKey: "YOUR_API_KEY" };
-</script>
-<script src="https://js.arcgis.com/4.34/"></script>
-```
-
-## Enterprise Portal
-
-```javascript
-const oauthInfo = new OAuthInfo({
-  appId: "YOUR_APP_ID",
-  portalUrl: "https://your-portal.com/portal",
-  popup: true
-});
-
-// Or set globally
-import esriConfig from "@arcgis/core/config.js";
-esriConfig.portalUrl = "https://your-portal.com/portal";
-```
-
-## Portal User Information
-
-```javascript
-import Portal from "@arcgis/core/portal/Portal.js";
-
-const portal = new Portal({ authMode: "immediate" });
-await portal.load();
-
-console.log("Username:", portal.user.username);
-console.log("Full name:", portal.user.fullName);
-console.log("Email:", portal.user.email);
-console.log("Role:", portal.user.role);
-console.log("Org:", portal.name);
-```
-
-## Query User Items
-
-```javascript
-import PortalQueryParams from "@arcgis/core/portal/PortalQueryParams.js";
-
-const queryParams = new PortalQueryParams({
-  query: `owner:${portal.user.username}`,
-  sortField: "modified",
-  sortOrder: "desc",
-  num: 20
-});
-
-const result = await portal.queryItems(queryParams);
-result.results.forEach(item => console.log(item.title, item.type));
-```
-
-## Token Management
-
-```javascript
-// Get token
-const credential = await esriId.getCredential("https://services.arcgis.com/...");
-console.log("Token:", credential.token);
-console.log("Expires:", new Date(credential.expires));
-
-// Register token
-esriId.registerToken({
-  server: "https://services.arcgis.com/",
-  token: "YOUR_TOKEN"
-});
-```
-
-## Trusted Servers
-
-```javascript
-import esriConfig from "@arcgis/core/config.js";
-
-esriConfig.request.trustedServers.push("https://services.arcgis.com");
-esriConfig.request.trustedServers.push("https://your-server.com");
-```
-
-## CORS and Proxy
-
-```javascript
-esriConfig.request.proxyUrl = "/proxy/";
-
-esriConfig.request.proxyRules.push({
-  urlPrefix: "https://services.arcgis.com",
-  proxyUrl: "/proxy/"
-});
-```
-
-## Error Handling
-
-```javascript
-esriId.on("credential-create", (event) => {
-  console.log("New credential:", event.credential);
-});
-
-layer.on("layerview-create-error", (event) => {
-  if (event.error.name === "identity-manager:not-authorized") {
-    signIn();
-  }
-});
-```
-
-## Common Pitfalls
-
-1. **App ID registration** - Must be registered with correct redirect URIs
-2. **Popup blockers** - Use redirect flow as fallback
-3. **Token expiration** - Handle refresh or re-authentication
-4. **CORS errors** - Configure trusted servers or use proxy
-5. **Portal URL mismatch** - Trailing slashes matter

package/contexts/4.34/copilot/arcgis-cim-symbols.instructions.md

@@ -1,177 +0,0 @@
----
-applyTo: "**/*.{js,ts,jsx,tsx,html}"
----
-
-# ArcGIS Maps SDK - CIM Symbols
-
-Advanced cartographic symbols using CIM (Cartographic Information Model).
-
-## Basic CIM Symbol
-
-```javascript
-const graphic = new Graphic({
-  geometry: point,
-  symbol: {
-    type: "cim",
-    data: {
-      type: "CIMSymbolReference",
-      symbol: {
-        type: "CIMPointSymbol",
-        symbolLayers: [{
-          type: "CIMVectorMarker",
-          enable: true,
-          size: 20,
-          frame: { xmin: 0, ymin: 0, xmax: 10, ymax: 10 },
-          markerGraphics: [{
-            type: "CIMMarkerGraphic",
-            geometry: { rings: [[[0,0], [10,0], [10,10], [0,10], [0,0]]] },
-            symbol: {
-              type: "CIMPolygonSymbol",
-              symbolLayers: [{
-                type: "CIMSolidFill",
-                enable: true,
-                color: [255, 0, 0, 255]
-              }]
-            }
-          }]
-        }]
-      }
-    }
-  }
-});
-```
-
-## CIM Line Symbol (Arrow)
-
-```javascript
-const arrowLineCIM = {
-  type: "CIMSymbolReference",
-  symbol: {
-    type: "CIMLineSymbol",
-    symbolLayers: [
-      {
-        type: "CIMVectorMarker",
-        enable: true,
-        size: 12,
-        markerPlacement: {
-          type: "CIMMarkerPlacementAtExtremities",
-          extremityPlacement: "JustEnd",
-          angleToLine: true
-        },
-        frame: { xmin: 0, ymin: 0, xmax: 10, ymax: 10 },
-        markerGraphics: [{
-          type: "CIMMarkerGraphic",
-          geometry: { rings: [[[0, 0], [10, 5], [0, 10], [3, 5], [0, 0]]] },
-          symbol: {
-            type: "CIMPolygonSymbol",
-            symbolLayers: [{ type: "CIMSolidFill", enable: true, color: [0, 0, 0, 255] }]
-          }
-        }]
-      },
-      { type: "CIMSolidStroke", enable: true, width: 2, color: [0, 0, 0, 255] }
-    ]
-  }
-};
-```
-
-## CIM Polygon Symbol (Hatched)
-
-```javascript
-const hatchedFillCIM = {
-  type: "CIMSymbolReference",
-  symbol: {
-    type: "CIMPolygonSymbol",
-    symbolLayers: [
-      {
-        type: "CIMHatchFill",
-        enable: true,
-        lineSymbol: {
-          type: "CIMLineSymbol",
-          symbolLayers: [{ type: "CIMSolidStroke", enable: true, width: 1, color: [0, 0, 0, 255] }]
-        },
-        rotation: 45,
-        separation: 5
-      },
-      { type: "CIMSolidFill", enable: true, color: [255, 255, 200, 255] },
-      { type: "CIMSolidStroke", enable: true, width: 2, color: [0, 0, 0, 255] }
-    ]
-  }
-};
-```
-
-## Data-Driven CIM
-
-```javascript
-const dataDrivenCIM = {
-  type: "CIMSymbolReference",
-  primitiveOverrides: [{
-    type: "CIMPrimitiveOverride",
-    primitiveName: "fillLayer",
-    propertyName: "Color",
-    valueExpressionInfo: {
-      type: "CIMExpressionInfo",
-      expression: `
-        var val = $feature.value;
-        if (val < 50) return [255, 0, 0, 255];
-        return [0, 255, 0, 255];
-      `,
-      returnType: "Default"
-    }
-  }],
-  symbol: {
-    type: "CIMPointSymbol",
-    symbolLayers: [{
-      type: "CIMVectorMarker",
-      markerGraphics: [{
-        type: "CIMMarkerGraphic",
-        symbol: {
-          type: "CIMPolygonSymbol",
-          symbolLayers: [{
-            type: "CIMSolidFill",
-            primitiveName: "fillLayer",
-            color: [128, 128, 128, 255]
-          }]
-        }
-      }]
-    }]
-  }
-};
-```
-
-## Marker Placement
-
-```javascript
-// Along line
-markerPlacement: {
-  type: "CIMMarkerPlacementAlongLineSameSize",
-  placementTemplate: [20],
-  angleToLine: true
-}
-
-// At vertices
-markerPlacement: {
-  type: "CIMMarkerPlacementAtRatioPositions",
-  positionArray: [0, 0.5, 1],
-  angleToLine: true
-}
-```
-
-## CIM Properties
-
-```javascript
-// Colors: [R, G, B, A] where each is 0-255
-color: [255, 0, 0, 255]
-
-// Stroke
-{ type: "CIMSolidStroke", width: 2, color: [0, 0, 0, 255], capStyle: "Round", joinStyle: "Round" }
-
-// Anchor
-{ anchorPoint: { x: 0, y: -0.5 }, anchorPointUnits: "Relative" }
-```
-
-## Common Pitfalls
-
-1. **Frame coordinates** - Frame defines coordinate space for graphics
-2. **Layer order** - Renders bottom to top
-3. **Primitive names** - Must be unique for overrides
-4. **Closed rings** - First point must equal last point