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

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Sascha Brunner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# arcgis-maps-sdk-js-ai-context
+
+> **DISCLAIMER:** This is work in progress and not yet tested extensively. Use at your own risk.
+
+Install AI assistant context files for [ArcGIS Maps SDK for JavaScript](https://developers.arcgis.com/javascript/) development. Supports Claude skills and GitHub Copilot instructions.
+
+## Features
+
+- **Claude Skills**: Comprehensive skill files for Claude AI assistant covering all major ArcGIS Maps SDK features
+- **GitHub Copilot Instructions**: Context files for GitHub Copilot to improve code suggestions
+- **SDK Version Selection**: Choose context files for specific ArcGIS Maps SDK versions
+- **Cross-platform**: Works on Windows, macOS, and Linux
+- **Zero dependencies**: Uses only built-in Node.js modules
+
+## Installation
+
+No installation required! Run directly with npx:
+
+```bash
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context <command>
+```
+
+## Commands
+
+### Install Claude Skills
+
+Installs Claude skill files to `.claude/skills/arcgis-maps-sdk-js/` in your project:
+
+```bash
+# Install for latest SDK version
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context claude
+
+# Install for specific SDK version
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context claude --sdk 4.34
+```
+
+### Install GitHub Copilot Instructions
+
+Installs Copilot instruction files to `.github/instructions/` in your project:
+
+```bash
+# Install for latest SDK version
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context copilot
+
+# Install for specific SDK version
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context copilot --sdk 4.34
+```
+
+### Install All
+
+Installs both Claude skills and Copilot instructions:
+
+```bash
+# Install for latest SDK version
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context all
+
+# Install for specific SDK version
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context all --sdk 4.34
+```
+
+### List Available Contexts
+
+Shows all available SDK versions and context files:
+
+```bash
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context list
+```
+
+### Help
+
+```bash
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context --help
+```
+
+## SDK Version Selection
+
+Use the `--sdk` flag to install context files for a specific ArcGIS Maps SDK version:
+
+```bash
+npx @saschabrunnerch/arcgis-maps-sdk-js-ai-context claude --sdk 4.34
+```
+
+Available versions can be viewed with the `list` command. If no version is specified, the latest available version is used.
+
+| SDK Version | Status |
+|-------------|--------|
+| 4.34 | Available |
+
+## Claude Skills Included
+
+The package includes 28 comprehensive Claude skills covering:
+
+| Skill | Description |
+|-------|-------------|
+| arcgis-core-maps | 2D and 3D map creation, views, navigation |
+| arcgis-layers | FeatureLayer, TileLayer, GeoJSONLayer, and more |
+| arcgis-visualization | Renderers, symbols, and visual variables |
+| arcgis-popup-templates | Popup configuration and content |
+| arcgis-widgets-ui | Built-in widgets and UI components |
+| arcgis-geometry-operations | Geometry engine and spatial operations |
+| arcgis-coordinates-projection | Coordinate systems and projections |
+| arcgis-authentication | OAuth, API keys, and identity management |
+| arcgis-portal-content | Portal items, groups, and content management |
+| arcgis-smart-mapping | Smart mapping and data-driven visualization |
+| arcgis-editing-advanced | Feature editing and sketching |
+| arcgis-analysis-services | Spatial analysis and geoprocessing |
+| arcgis-3d-advanced | 3D visualization and SceneView |
+| arcgis-scene-effects | 3D effects, lighting, and atmosphere |
+| arcgis-cim-symbols | CIM symbol specification |
+| arcgis-arcade | Arcade expressions |
+| arcgis-time-animation | Time-aware layers and animation |
+| arcgis-feature-effects | Feature effects and filters |
+| arcgis-custom-rendering | Custom WebGL rendering |
+| arcgis-interaction | View interaction and events |
+| arcgis-map-tools | Measurement, print, and utility tools |
+| arcgis-tables-forms | Attribute tables and feature forms |
+| arcgis-media-layers | Media and image layers |
+| arcgis-advanced-layers | Specialized layer types |
+| arcgis-imagery | Imagery and raster analysis |
+| arcgis-knowledge-graphs | Knowledge graph integration |
+| arcgis-utility-networks | Utility network analysis |
+| arcgis-core-utilities | Core utilities and helpers |
+
+## GitHub Copilot Instructions
+
+The package includes 16 comprehensive Copilot instruction files covering all topics:
+
+| File | Coverage |
+|------|----------|
+| arcgis-core-maps.instructions.md | Maps, views, navigation, imports |
+| arcgis-layers.instructions.md | All layer types, queries, management |
+| arcgis-visualization.instructions.md | Renderers, symbols, visual variables, labels |
+| arcgis-widgets-ui.instructions.md | Widgets, Calcite Design System |
+| arcgis-popup-templates.instructions.md | Popup content, charts, expressions |
+| arcgis-geometry.instructions.md | Geometry operators, spatial operations, projection |
+| arcgis-authentication.instructions.md | OAuth, API keys, identity |
+| arcgis-editing.instructions.md | Editor, Sketch, forms, versioning |
+| arcgis-3d.instructions.md | SceneView, 3D layers, weather, lighting, effects |
+| arcgis-arcade.instructions.md | Arcade expressions for all contexts |
+| arcgis-analysis.instructions.md | Analysis tools, measurement, print |
+| arcgis-smart-mapping.instructions.md | Auto-generated renderers, statistics |
+| arcgis-time-animation.instructions.md | TimeSlider, temporal data |
+| arcgis-cim-symbols.instructions.md | Advanced CIM symbology |
+| arcgis-portal-advanced.instructions.md | Portal, imagery, media layers, utility networks, knowledge graphs |
+| arcgis-core-utilities.instructions.md | reactiveUtils, Collection, hit testing, highlighting, events |
+
+Each file provides:
+- Import patterns and best practices
+- Comprehensive code examples
+- TypeScript guidance with `as const`
+- Common pitfalls to avoid
+
+## Usage with Claude
+
+After installing Claude skills, Claude will automatically have access to ArcGIS-specific knowledge when working in your project. The skills provide:
+
+- Correct import patterns for ESM and CDN usage
+- Best practices for TypeScript with autocasting
+- Code examples for common tasks
+- API reference guidance
+
+## Usage with GitHub Copilot
+
+After installing Copilot instructions, GitHub Copilot will provide better suggestions for:
+
+- ArcGIS API imports
+- Map and view initialization
+- Layer configuration
+- Widget setup
+- Common patterns
+
+## Requirements
+
+- Node.js 14.0.0 or higher
+
+## Source
+
+The context files in this package are based on the official ArcGIS Maps SDK for JavaScript documentation:
+
+- **Documentation:** https://developers.arcgis.com/javascript/latest/downloads/
+- **Folders used:** `api-reference` and `sample-code`
+
+## AI Assistance Declaration
+
+This project was primarily developed using AI coding assistants. The maintainer directed the development through prompts and reviewed all generated code.
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit issues and pull requests at:
+
+https://github.com/SaschaBrunnerCH/arcgis-maps-sdk-js-ai-context
+
+## Related
+
+- [ArcGIS Maps SDK for JavaScript](https://developers.arcgis.com/javascript/)
+- [Claude](https://claude.ai/)
+- [GitHub Copilot](https://github.com/features/copilot)

package/bin/cli.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+
+const path = require('path');
+const fs = require('fs');
+const { installClaude, installCopilot, installAll, listContexts, getAvailableVersions, colors, colorize, log } = require('../lib/installer');
+
+const pkg = require('../package.json');
+
+const COMMANDS = {
+  claude: 'Install Claude skills to .claude/skills/arcgis-maps-sdk-js/',
+  copilot: 'Install GitHub Copilot instructions to .github/instructions/',
+  all: 'Install both Claude skills and Copilot instructions (latest SDK version)',
+  list: 'Show available contexts and SDK versions',
+};
+
+function showBanner() {
+  log('');
+  log(colorize('bold', colorize('cyan', '  ArcGIS Maps SDK for JavaScript - AI Context Installer')));
+  log(colorize('dim', `  Version ${pkg.version}`));
+  log('');
+}
+
+function showHelp() {
+  showBanner();
+
+  log(colorize('bold', 'USAGE'));
+  log(`  npx ${pkg.name} <command> [options]`);
+  log('');
+
+  log(colorize('bold', 'COMMANDS'));
+  for (const [cmd, desc] of Object.entries(COMMANDS)) {
+    log(`  ${colorize('cyan', cmd.padEnd(12))} ${desc}`);
+  }
+  log('');
+
+  log(colorize('bold', 'OPTIONS'));
+  log(`  ${colorize('cyan', '--sdk <ver>'.padEnd(16))} ArcGIS SDK version (e.g., 4.34)`);
+  log(`  ${colorize('cyan', '--help, -h'.padEnd(16))} Show this help message`);
+  log(`  ${colorize('cyan', '--version, -v'.padEnd(16))} Show package version number`);
+  log('');
+
+  const versions = getAvailableVersions();
+  log(colorize('bold', 'AVAILABLE SDK VERSIONS'));
+  log(`  ${versions.join(', ')} ${colorize('dim', `(default: ${versions[versions.length - 1]})`)}`);
+  log('');
+
+  log(colorize('bold', 'EXAMPLES'));
+  log(colorize('dim', '  # Install Claude skills (latest SDK version)'));
+  log(`  npx ${pkg.name} claude`);
+  log('');
+  log(colorize('dim', '  # Install Claude skills for specific SDK version'));
+  log(`  npx ${pkg.name} claude --sdk 4.34`);
+  log('');
+  log(colorize('dim', '  # Install GitHub Copilot instructions'));
+  log(`  npx ${pkg.name} copilot --sdk 4.34`);
+  log('');
+  log(colorize('dim', '  # Install everything'));
+  log(`  npx ${pkg.name} all`);
+  log('');
+  log(colorize('dim', '  # List available contexts and versions'));
+  log(`  npx ${pkg.name} list`);
+  log('');
+
+  log(colorize('bold', 'MORE INFO'));
+  log(`  ${colorize('blue', pkg.homepage)}`);
+  log('');
+}
+
+function showVersion() {
+  log(`${pkg.name} v${pkg.version}`);
+}
+
+function parseArgs(args) {
+  const result = {
+    command: null,
+    sdkVersion: null,
+    help: false,
+    version: false,
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+
+    if (arg === '--help' || arg === '-h') {
+      result.help = true;
+    } else if (arg === '--version' || arg === '-v') {
+      result.version = true;
+    } else if (arg === '--sdk') {
+      result.sdkVersion = args[i + 1];
+      i++; // Skip next arg
+    } else if (arg.startsWith('--sdk=')) {
+      result.sdkVersion = arg.split('=')[1];
+    } else if (!arg.startsWith('-') && !result.command) {
+      result.command = arg;
+    }
+  }
+
+  return result;
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const parsed = parseArgs(args);
+
+  // Handle flags
+  if (parsed.help) {
+    showHelp();
+    process.exit(0);
+  }
+
+  if (parsed.version) {
+    showVersion();
+    process.exit(0);
+  }
+
+  // Get command
+  const command = parsed.command;
+
+  if (!command) {
+    showHelp();
+    process.exit(0);
+  }
+
+  // Validate SDK version if provided
+  const versions = getAvailableVersions();
+  let sdkVersion = parsed.sdkVersion;
+
+  if (sdkVersion && !versions.includes(sdkVersion)) {
+    log(`${colorize('red', 'Error:')} SDK version "${sdkVersion}" is not available.`);
+    log(`Available versions: ${versions.join(', ')}`);
+    process.exit(1);
+  }
+
+  // Default to latest version
+  if (!sdkVersion) {
+    sdkVersion = versions[versions.length - 1];
+  }
+
+  // Execute command
+  showBanner();
+
+  let success = false;
+
+  switch (command.toLowerCase()) {
+    case 'claude':
+      success = installClaude(process.cwd(), sdkVersion);
+      break;
+
+    case 'copilot':
+      success = installCopilot(process.cwd(), sdkVersion);
+      break;
+
+    case 'all':
+      success = installAll(process.cwd(), sdkVersion);
+      break;
+
+    case 'list':
+      listContexts();
+      success = true;
+      break;
+
+    default:
+      log(`${colorize('red', 'Error:')} Unknown command "${command}"`);
+      log('');
+      log(`Run ${colorize('cyan', `npx ${pkg.name} --help`)} for usage information.`);
+      process.exit(1);
+  }
+
+  log('');
+  process.exit(success ? 0 : 1);
+}
+
+main();