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

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

@@ -1,294 +0,0 @@
----
-applyTo: "**/*.{js,ts,jsx,tsx,html}"
----
-
-# ArcGIS Maps SDK - Analysis & Utilities
-
-## Coordinate Conversion
-
-```javascript
-import CoordinateFormatter from "@arcgis/core/geometry/coordinateFormatter.js";
-
-await CoordinateFormatter.load();
-
-// To DMS
-const dms = CoordinateFormatter.toLatitudeLongitude(point, "dms", 2);
-
-// To MGRS
-const mgrs = CoordinateFormatter.toMgrs(point, "automatic", 5, false);
-
-// To UTM
-const utm = CoordinateFormatter.toUtm(point, "latitude-band-indicators", true);
-
-// From string
-const point = CoordinateFormatter.fromLatitudeLongitude("34.05N, 118.24W");
-```
-
-## esriRequest (HTTP)
-
-```javascript
-import esriRequest from "@arcgis/core/request.js";
-
-const response = await esriRequest(url, {
-  query: { f: "json" },
-  responseType: "json"
-});
-console.log(response.data);
-
-// POST request
-const response = await esriRequest(url, {
-  method: "post",
-  body: formData,
-  responseType: "json"
-});
-```
-
-## Print Task
-
-```javascript
-import PrintTask from "@arcgis/core/tasks/PrintTask.js";
-import PrintTemplate from "@arcgis/core/tasks/support/PrintTemplate.js";
-import PrintParameters from "@arcgis/core/tasks/support/PrintParameters.js";
-
-const printTask = new PrintTask({
-  url: "https://utility.arcgisonline.com/.../PrintingTools/GPServer/Export%20Web%20Map%20Task"
-});
-
-const template = new PrintTemplate({
-  format: "pdf",
-  layout: "letter-ansi-a-landscape",
-  exportOptions: { dpi: 150 }
-});
-
-const params = new PrintParameters({
-  view: view,
-  template: template
-});
-
-const result = await printTask.execute(params);
-console.log("PDF URL:", result.url);
-```
-
-## Route Task
-
-```javascript
-import RouteTask from "@arcgis/core/tasks/RouteTask.js";
-import RouteParameters from "@arcgis/core/tasks/support/RouteParameters.js";
-import Stop from "@arcgis/core/tasks/support/Stop.js";
-
-const routeTask = new RouteTask({
-  url: "https://route.arcgis.com/arcgis/rest/services/World/Route/NAServer/Route_World"
-});
-
-const params = new RouteParameters({
-  stops: new FeatureSet({
-    features: [
-      new Graphic({ geometry: startPoint }),
-      new Graphic({ geometry: endPoint })
-    ]
-  }),
-  returnDirections: true
-});
-
-const result = await routeTask.solve(params);
-const route = result.routeResults[0].route;
-```
-
-## Geocoding
-
-```javascript
-import Locator from "@arcgis/core/tasks/Locator.js";
-
-const locator = new Locator({
-  url: "https://geocode.arcgis.com/arcgis/rest/services/World/GeocodeServer"
-});
-
-// Address to location
-const results = await locator.addressToLocations({
-  address: { SingleLine: "380 New York St, Redlands, CA" }
-});
-
-// Location to address
-const result = await locator.locationToAddress({ location: point });
-```
-
-## Feature Clustering
-
-```javascript
-layer.featureReduction = {
-  type: "cluster",
-  clusterRadius: 80,
-  clusterMinSize: 16,
-  clusterMaxSize: 60,
-  popupTemplate: {
-    title: "Cluster of {cluster_count}",
-    content: [{ type: "fields", fieldInfos: [{ fieldName: "cluster_count" }] }]
-  },
-  fields: [{
-    name: "cluster_avg_value",
-    alias: "Average",
-    onStatisticField: "value",
-    statisticType: "avg"
-  }]
-};
-```
-
-## Measurement
-
-```html
-<arcgis-distance-measurement-2d slot="top-right"></arcgis-distance-measurement-2d>
-<arcgis-area-measurement-2d slot="top-right"></arcgis-area-measurement-2d>
-```
-
-```javascript
-import Measurement from "@arcgis/core/widgets/Measurement.js";
-
-const measurement = new Measurement({
-  view: view,
-  activeTool: "distance"  // distance, area
-});
-
-view.ui.add(measurement, "top-right");
-```
-
-## Swipe
-
-```html
-<arcgis-map basemap="streets-vector">
-  <arcgis-swipe slot="top-right" position="50"></arcgis-swipe>
-</arcgis-map>
-```
-
-```javascript
-import Swipe from "@arcgis/core/widgets/Swipe.js";
-
-const swipe = new Swipe({
-  view: view,
-  leadingLayers: [layer1],
-  trailingLayers: [layer2],
-  position: 50
-});
-```
-
-## Bookmarks
-
-```html
-<arcgis-bookmarks slot="top-right"></arcgis-bookmarks>
-```
-
-```javascript
-import Bookmarks from "@arcgis/core/widgets/Bookmarks.js";
-
-const bookmarks = new Bookmarks({
-  view: view,
-  bookmarks: [
-    {
-      name: "Los Angeles",
-      viewpoint: { targetGeometry: extent1 }
-    },
-    {
-      name: "New York",
-      viewpoint: { targetGeometry: extent2 }
-    }
-  ]
-});
-```
-
-## Portal Operations
-
-### Save WebMap
-
-```javascript
-import WebMap from "@arcgis/core/WebMap.js";
-
-const webmap = new WebMap({ basemap: "topo-vector" });
-webmap.add(layer);
-
-await webmap.save({
-  folder: portal.user.username + "/My Maps",
-  title: "My WebMap",
-  description: "Description",
-  tags: ["tag1", "tag2"]
-});
-```
-
-### Load and Update WebMap
-
-```javascript
-const webmap = new WebMap({
-  portalItem: { id: "EXISTING_WEBMAP_ID" }
-});
-
-await webmap.load();
-webmap.add(newLayer);
-await webmap.save();
-```
-
-## Time-Aware Layers
-
-```javascript
-// TimeSlider
-import TimeSlider from "@arcgis/core/widgets/TimeSlider.js";
-
-const timeSlider = new TimeSlider({
-  view: view,
-  fullTimeExtent: layer.timeInfo.fullTimeExtent,
-  mode: "time-window",
-  stops: { interval: { value: 1, unit: "hours" } }
-});
-```
-
-```html
-<arcgis-time-slider slot="bottom" mode="time-window" loop></arcgis-time-slider>
-```
-
-## Statistics
-
-```javascript
-const query = layer.createQuery();
-query.outStatistics = [
-  { statisticType: "sum", onStatisticField: "population", outStatisticFieldName: "total" },
-  { statisticType: "avg", onStatisticField: "population", outStatisticFieldName: "average" },
-  { statisticType: "min", onStatisticField: "population", outStatisticFieldName: "minimum" },
-  { statisticType: "max", onStatisticField: "population", outStatisticFieldName: "maximum" },
-  { statisticType: "count", onStatisticField: "population", outStatisticFieldName: "count" }
-];
-
-query.groupByFieldsForStatistics = ["category"];
-
-const result = await layer.queryFeatures(query);
-```
-
-## Hit Test
-
-```javascript
-view.on("click", async (event) => {
-  const response = await view.hitTest(event);
-
-  if (response.results.length > 0) {
-    const graphic = response.results[0].graphic;
-    console.log("Clicked:", graphic.attributes);
-  }
-});
-```
-
-## Screenshot
-
-```javascript
-const screenshot = await view.takeScreenshot({
-  format: "png",
-  quality: 100,
-  width: 1920,
-  height: 1080
-});
-
-const image = document.createElement("img");
-image.src = screenshot.dataUrl;
-```
-
-## Common Pitfalls
-
-1. **API key required** - Many services need API key or OAuth
-2. **Async operations** - Always await async methods
-3. **CORS** - Configure proxy for cross-origin services
-4. **Rate limits** - Be aware of service rate limits

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