@mapbox/mcp-docs-server 0.1.0-dev

package/dist/commonjs/resources/mapbox-style-layers-resource/MapboxStyleLayersResource.js

@@ -0,0 +1,323 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapboxStyleLayersResource = void 0;
+const BaseResource_js_1 = require("../BaseResource.js");
+/**
+ * Resource providing Mapbox GL JS style specification guidance
+ * to help LLMs understand layer types, properties, and how to use them
+ */
+class MapboxStyleLayersResource extends BaseResource_js_1.BaseResource {
+    name = 'Mapbox Style Specification Guide';
+    uri = 'resource://mapbox-style-layers';
+    description = 'Mapbox GL JS style specification reference for layer types, paint/layout properties, and Streets v8 source layers';
+    mimeType = 'text/markdown';
+    async readCallback(uri, _extra) {
+        // Generate comprehensive markdown documentation
+        const markdown = this.generateMarkdown();
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: this.mimeType,
+                    text: markdown
+                }
+            ]
+        };
+    }
+    generateMarkdown() {
+        const sections = [];
+        // Header
+        sections.push([
+            '# Mapbox Style Specification Guide',
+            '',
+            'This guide provides the Mapbox GL JS style specification for creating custom map styles.',
+            '',
+            '## Streets v8 Source Layers',
+            '',
+            '### Source Layer → Geometry Type Mapping',
+            '',
+            '**Polygon layers:**',
+            '- `landuse` - Land use areas (parks, residential, industrial, etc.)',
+            '- `water` - Water bodies (oceans, lakes, rivers as polygons)',
+            '- `building` - Building footprints with height data',
+            '- `landuse_overlay` - Overlay features (wetlands, national parks)',
+            '',
+            '**LineString layers:**',
+            '- `road` - All roads, paths, railways',
+            '- `admin` - Administrative boundaries',
+            '- `waterway` - Rivers, streams, canals as lines',
+            '- `aeroway` - Airport runways and taxiways',
+            '- `structure` - Bridges, tunnels, fences',
+            '',
+            '**Point/Symbol layers:**',
+            '- `place_label` - City, state, country labels',
+            '- `poi_label` - Points of interest',
+            '- `airport_label` - Airport labels',
+            '- `transit_stop_label` - Transit stops',
+            '- `motorway_junction` - Highway exits',
+            '- `housenum_label` - House numbers',
+            '- `natural_label` - Natural feature labels (mountains, water bodies, etc.)',
+            '',
+            '## Layer Types and Properties',
+            ''
+        ].join('\n'));
+        // Fill layer
+        sections.push([
+            '### fill',
+            'Used for: Polygon features (landuse, water, building, landuse_overlay)',
+            '',
+            '**Paint properties:**',
+            '- `fill-color` - The color of the filled area (default: `#000000`)',
+            '- `fill-opacity` - Opacity of the entire fill layer, 0-1 (default: `1`)',
+            '- `fill-outline-color` - Color of the outline; requires `fill-antialias: true` (disabled if unset)',
+            '- `fill-pattern` - Name of image in sprite to use for fill pattern',
+            '- `fill-antialias` - Whether to antialias the fill (default: `true`)',
+            '- `fill-translate` - Geometry translation [x, y] in pixels (default: `[0, 0]`)',
+            '- `fill-translate-anchor` - Reference for translate: `map` or `viewport` (default: `map`)',
+            '',
+            '**Layout properties:**',
+            '- `visibility` - Whether the layer is shown: `visible` or `none` (default: `visible`)',
+            '- `fill-sort-key` - Sort key for ordering fill features within a layer',
+            ''
+        ].join('\n'));
+        // Line layer
+        sections.push([
+            '### line',
+            'Used for: LineString features (road, admin, waterway, aeroway, structure, natural_label)',
+            '',
+            '**Paint properties:**',
+            '- `line-color` - The color of the line (default: `#000000`)',
+            '- `line-width` - Width of the line in pixels (default: `1`)',
+            '- `line-opacity` - Opacity of the line, 0-1 (default: `1`)',
+            '- `line-blur` - Blur applied to the line in pixels (default: `0`)',
+            '- `line-dasharray` - Dash pattern [dash, gap, dash, gap...] (solid if unset)',
+            '- `line-gap-width` - Width of inner gap in line (default: `0`)',
+            '- `line-offset` - Line offset perpendicular to direction (default: `0`)',
+            '- `line-pattern` - Name of image in sprite for line pattern',
+            '- `line-gradient` - Gradient along the line (requires `lineMetrics: true` in source)',
+            '- `line-translate` - Geometry translation [x, y] in pixels (default: `[0, 0]`)',
+            '- `line-translate-anchor` - Reference for translate: `map` or `viewport` (default: `map`)',
+            '',
+            '**Layout properties:**',
+            '- `visibility` - Whether the layer is shown: `visible` or `none` (default: `visible`)',
+            '- `line-cap` - Display of line ends: `butt`, `round`, `square` (default: `butt`)',
+            '- `line-join` - Display of line joins: `bevel`, `round`, `miter` (default: `miter`)',
+            '- `line-miter-limit` - Maximum miter length (default: `2`)',
+            '- `line-round-limit` - Maximum round join radius (default: `1.05`)',
+            '- `line-sort-key` - Sort key for layer ordering',
+            ''
+        ].join('\n'));
+        // Symbol layer
+        sections.push([
+            '### symbol',
+            'Used for: Point and LineString labels (all *_label layers, natural_label, motorway_junction)',
+            '',
+            '**Layout properties (symbol):**',
+            '- `visibility` - Whether the layer is shown: `visible` or `none` (default: `visible`)',
+            '- `symbol-placement` - Symbol placement: `point`, `line`, `line-center` (default: `point`)',
+            '- `symbol-spacing` - Distance between symbols on line (default: `250`)',
+            '- `symbol-avoid-edges` - Avoid symbols at tile edges (default: `false`)',
+            '- `symbol-sort-key` - Sort key for symbol ordering',
+            '- `symbol-z-order` - Z-order: `auto`, `viewport-y`, `source` (default: `auto`)',
+            '',
+            '**Layout properties (text):**',
+            '- `text-field` - Text to display, e.g., `["get", "name"]`',
+            '- `text-font` - Font stack array, e.g., `["DIN Pro Regular", "Arial Unicode MS Regular"]` (no spec default; required when text-field is set)',
+            '- `text-size` - Font size in pixels (default: `16`)',
+            '- `text-max-width` - Maximum text width in ems (default: `10`)',
+            '- `text-line-height` - Text line height in ems (default: `1.2`)',
+            '- `text-letter-spacing` - Letter spacing in ems (default: `0`)',
+            '- `text-justify` - Text justification: `auto`, `left`, `center`, `right` (default: `center`)',
+            '- `text-anchor` - Text anchor: `center`, `left`, `right`, `top`, `bottom`, `top-left`, etc.',
+            '- `text-max-angle` - Maximum angle for curved text (default: `45`)',
+            '- `text-rotate` - Text rotation in degrees (default: `0`)',
+            '- `text-padding` - Padding around text for collision (default: `2`)',
+            '- `text-keep-upright` - Keep text upright when map rotates (default: `true`)',
+            '- `text-transform` - Text case: `none`, `uppercase`, `lowercase` (default: `none`)',
+            '- `text-offset` - Text offset [x, y] in ems (default: `[0, 0]`)',
+            '- `text-allow-overlap` - Allow text to overlap (default: `false`)',
+            '- `text-ignore-placement` - Ignore placement collisions (default: `false`)',
+            '- `text-optional` - Hide text if icon collides (default: `false`)',
+            '',
+            '**Layout properties (icon):**',
+            '- `icon-image` - Name of icon in sprite, e.g., `["get", "maki"]`',
+            '- `icon-size` - Scale factor for icon (default: `1`)',
+            '- `icon-rotate` - Icon rotation in degrees (default: `0`)',
+            '- `icon-padding` - Padding around icon for collision (default: `2`)',
+            '- `icon-keep-upright` - Keep icon upright (default: `false`)',
+            '- `icon-offset` - Icon offset [x, y] in ems (default: `[0, 0]`)',
+            '- `icon-anchor` - Icon anchor: `center`, `left`, `right`, `top`, `bottom`, etc.',
+            '- `icon-pitch-alignment` - Icon alignment: `map`, `viewport`, `auto` (default: `auto`)',
+            '- `icon-text-fit` - Scale icon to text: `none`, `width`, `height`, `both` (default: `none`)',
+            '- `icon-text-fit-padding` - Padding for icon-text-fit [top, right, bottom, left]',
+            '- `icon-allow-overlap` - Allow icon to overlap (default: `false`)',
+            '- `icon-ignore-placement` - Ignore icon collisions (default: `false`)',
+            '- `icon-optional` - Hide icon if text collides (default: `false`)',
+            '',
+            '**Paint properties (text):**',
+            '- `text-color` - Color of the text (default: `#000000`)',
+            '- `text-halo-color` - Color of the halo around text (default: `rgba(0, 0, 0, 0)`)',
+            '- `text-halo-width` - Width of the halo (default: `0`)',
+            '- `text-halo-blur` - Blur of the halo (default: `0`)',
+            '- `text-opacity` - Opacity of the text, 0-1 (default: `1`)',
+            '- `text-translate` - Text translation [x, y] in pixels (default: `[0, 0]`)',
+            '- `text-translate-anchor` - Reference for translate: `map` or `viewport` (default: `map`)',
+            '',
+            '**Paint properties (icon):**',
+            '- `icon-color` - Tint color for SDF icons',
+            '- `icon-halo-color` - Color of icon halo for SDF icons',
+            '- `icon-halo-width` - Width of icon halo (default: `0`)',
+            '- `icon-halo-blur` - Blur of icon halo (default: `0`)',
+            '- `icon-opacity` - Opacity of the icon, 0-1 (default: `1`)',
+            '- `icon-translate` - Icon translation [x, y] in pixels (default: `[0, 0]`)',
+            '- `icon-translate-anchor` - Reference for translate: `map` or `viewport` (default: `map`)',
+            ''
+        ].join('\n'));
+        // Circle layer
+        sections.push([
+            '### circle',
+            'Used for: Point features (can be used with POI or custom point data)',
+            '',
+            '**Paint properties:**',
+            '- `circle-color` - The color of the circle (default: `#000000`)',
+            '- `circle-radius` - Circle radius in pixels (default: `5`)',
+            '- `circle-opacity` - Opacity of the circle, 0-1 (default: `1`)',
+            '- `circle-blur` - Amount to blur the circle (default: `0`)',
+            '- `circle-stroke-color` - Color of the circle stroke',
+            '- `circle-stroke-width` - Width of the circle stroke (default: `0`)',
+            '- `circle-stroke-opacity` - Opacity of the circle stroke, 0-1 (default: `1`)',
+            '- `circle-translate` - Circle translation [x, y] in pixels (default: `[0, 0]`)',
+            '- `circle-translate-anchor` - Reference for translate: `map` or `viewport` (default: `map`)',
+            '- `circle-pitch-scale` - Circle scaling: `map` or `viewport` (default: `map`)',
+            '- `circle-pitch-alignment` - Circle alignment: `map` or `viewport` (default: `viewport`)',
+            '',
+            '**Layout properties:**',
+            '- `visibility` - Whether the layer is shown: `visible` or `none` (default: `visible`)',
+            '- `circle-sort-key` - Sort key for circle ordering',
+            ''
+        ].join('\n'));
+        // Fill-extrusion layer
+        sections.push([
+            '### fill-extrusion',
+            'Used for: 3D buildings (building layer with height/min_height attributes)',
+            '',
+            '**Paint properties:**',
+            '- `fill-extrusion-color` - Base color of the extrusion (default: `#000000`)',
+            '- `fill-extrusion-height` - Height in meters, e.g., `["get", "height"]` (default: `0`)',
+            '- `fill-extrusion-base` - Base height in meters, e.g., `["get", "min_height"]` (default: `0`)',
+            '- `fill-extrusion-opacity` - Opacity of the extrusion, 0-1 (default: `1`)',
+            '- `fill-extrusion-pattern` - Name of image in sprite for pattern',
+            '- `fill-extrusion-translate` - Geometry translation [x, y] in pixels (default: `[0, 0]`)',
+            '- `fill-extrusion-translate-anchor` - Reference: `map` or `viewport` (default: `map`)',
+            '- `fill-extrusion-vertical-gradient` - Use vertical gradient (default: `true`)',
+            '',
+            '**Layout properties:**',
+            '- `visibility` - Whether the layer is shown: `visible` or `none` (default: `visible`)',
+            '- `fill-extrusion-edge-radius` - Radius of extrusion edges for a rounded look, 0-1 (default: `0`)',
+            ''
+        ].join('\n'));
+        // Common patterns and examples
+        sections.push([
+            '## Common Patterns',
+            '',
+            '### Filtering Examples',
+            '',
+            '**Parks only (not cemeteries or golf courses):**',
+            '```json',
+            '{',
+            '  "layer_type": "landuse",',
+            '  "filter_properties": { "class": "park" }',
+            '}',
+            '```',
+            '',
+            '**Major roads:**',
+            '```json',
+            '{',
+            '  "layer_type": "road",',
+            '  "filter_properties": { "class": ["motorway", "trunk", "primary"] }',
+            '}',
+            '```',
+            '',
+            '**Country boundaries:**',
+            '```json',
+            '{',
+            '  "layer_type": "admin",',
+            '  "filter_properties": { "admin_level": 0, "maritime": "false" }',
+            '}',
+            '```',
+            '',
+            '**3D Buildings:**',
+            '```json',
+            '{',
+            '  "layer_type": "building",',
+            '  "filter_properties": { "extrude": "true" }',
+            '}',
+            '```',
+            ''
+        ].join('\n'));
+        // Available fields reference
+        sections.push([
+            '## Available Filter Fields',
+            '',
+            'For detailed field values in each source layer, use the style_builder_tool.',
+            'The tool will provide specific guidance when a layer is not recognized.',
+            '',
+            '### Key Fields by Layer:',
+            '',
+            '**landuse:** class, type',
+            '**road:** class, type, structure, toll, oneway',
+            '**admin:** admin_level, disputed, maritime',
+            '**building:** type, height, min_height, extrude',
+            '**water:** (no filter fields - all water features)',
+            '**waterway:** class, type',
+            '**place_label:** class, type, capital',
+            '**poi_label:** maki, class, filterrank',
+            '**transit_stop_label:** mode, stop_type, network',
+            ''
+        ].join('\n'));
+        // Working with styles
+        sections.push([
+            '## Working with Styles',
+            '',
+            '### Using style_builder_tool',
+            '',
+            'The style_builder_tool is the primary way to create Mapbox styles. It:',
+            '- Automatically determines the correct geometry type for each source layer',
+            '- Applies appropriate paint properties based on the action (color, highlight, hide, show)',
+            '- Generates proper filters from filter_properties',
+            '- Provides helpful suggestions when layers are not recognized',
+            '',
+            '### Example Usage',
+            '',
+            '```',
+            'style_builder_tool({',
+            '  style_name: "Custom Style",',
+            '  base_style: "standard",',
+            '  layers: [',
+            '    {',
+            '      layer_type: "water",',
+            '      action: "color",',
+            '      color: "#0099ff"',
+            '    },',
+            '    {',
+            '      layer_type: "landuse",',
+            '      filter_properties: { class: "park" },',
+            '      action: "color",',
+            '      color: "#00ff00"',
+            '    },',
+            '    {',
+            '      layer_type: "road",',
+            '      filter_properties: { class: ["motorway", "trunk"] },',
+            '      action: "highlight"',
+            '    }',
+            '  ]',
+            '})',
+            '```'
+        ].join('\n'));
+        return sections.join('\n');
+    }
+}
+exports.MapboxStyleLayersResource = MapboxStyleLayersResource;
+//# sourceMappingURL=MapboxStyleLayersResource.js.map

package/dist/commonjs/resources/mapbox-style-layers-resource/MapboxStyleLayersResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxStyleLayersResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-style-layers-resource/MapboxStyleLayersResource.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/resources/mapbox-token-scopes-resource/MapboxTokenScopesResource.d.ts

@@ -0,0 +1,20 @@
+import { BaseResource } from '../BaseResource.js';
+/**
+ * Resource providing Mapbox token scope reference documentation
+ * Helps users and AI understand what each token scope allows
+ */
+export declare class MapboxTokenScopesResource extends BaseResource {
+    readonly name = "Mapbox Token Scopes Reference";
+    readonly uri = "resource://mapbox-token-scopes";
+    readonly description = "Reference guide for Mapbox access token scopes and their permissions. Use this to understand what each scope allows and which scopes are needed for different operations.";
+    readonly mimeType = "text/markdown";
+    readCallback(uri: URL, _extra: unknown): Promise<{
+        contents: {
+            uri: string;
+            mimeType: string;
+            text: string;
+        }[];
+    }>;
+    private generateMarkdown;
+}
+//# sourceMappingURL=MapboxTokenScopesResource.d.ts.map

package/dist/commonjs/resources/mapbox-token-scopes-resource/MapboxTokenScopesResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxTokenScopesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-token-scopes-resource/MapboxTokenScopesResource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,QAAQ,CAAC,IAAI,mCAAmC;IAChD,QAAQ,CAAC,GAAG,oCAAoC;IAChD,QAAQ,CAAC,WAAW,+KAC0J;IAC9K,QAAQ,CAAC,QAAQ,mBAAmB;IAEvB,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO;;;;;;;IAcnD,OAAO,CAAC,gBAAgB;CA8EzB"}

package/dist/commonjs/resources/mapbox-token-scopes-resource/MapboxTokenScopesResource.js

@@ -0,0 +1,108 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MapboxTokenScopesResource = void 0;
+const BaseResource_js_1 = require("../BaseResource.js");
+/**
+ * Resource providing Mapbox token scope reference documentation
+ * Helps users and AI understand what each token scope allows
+ */
+class MapboxTokenScopesResource extends BaseResource_js_1.BaseResource {
+    name = 'Mapbox Token Scopes Reference';
+    uri = 'resource://mapbox-token-scopes';
+    description = 'Reference guide for Mapbox access token scopes and their permissions. Use this to understand what each scope allows and which scopes are needed for different operations.';
+    mimeType = 'text/markdown';
+    async readCallback(uri, _extra) {
+        const markdown = this.generateMarkdown();
+        return {
+            contents: [
+                {
+                    uri: uri.href,
+                    mimeType: this.mimeType,
+                    text: markdown
+                }
+            ]
+        };
+    }
+    generateMarkdown() {
+        return `# Mapbox Token Scopes Reference
+
+Complete reference for Mapbox access token scopes. Source: https://docs.mapbox.com/accounts/guides/tokens/#scopes
+
+## Token Types
+
+### Public Tokens (\`pk.*\`)
+Used in client-side applications (web browsers, mobile apps). Can only be assigned public scopes.
+
+### Secret Tokens (\`sk.*\`)
+Used server-side. Can be assigned any scope including write operations. Never expose in client-side code.
+
+## Public Token Scopes
+
+| Scope | Purpose |
+|---|---|
+| \`styles:tiles\` | Read style as PNG tiles and static images (Static Images and Static Tiles APIs) |
+| \`styles:read\` | Initialize Mapbox map styles in GL JS and mobile SDKs |
+| \`fonts:read\` | Generate fonts for map styles; retrieve glyphs via Fonts API |
+| \`datasets:read\` | Retrieve dataset information through the Datasets API |
+
+## Secret Token Scopes
+
+| Scope | Purpose |
+|---|---|
+| \`scopes:list\` | List available scopes via the Tokens API |
+| \`map:read\` | Access tilesets, tilestats, and legacy projects |
+| \`map:write\` | Create and update tilesets and tilestats |
+| \`user:read\` | Retrieve account profile details |
+| \`user:write\` | Modify account information |
+| \`uploads:read\` | Track upload statuses |
+| \`uploads:list\` | Retrieve multiple upload statuses |
+| \`uploads:write\` | Create tileset uploads |
+| \`styles:write\` | Create and update styles |
+| \`styles:list\` | List account styles (metadata only) |
+| \`styles:protect\` | Protect style write access and assets |
+| \`tokens:read\` | List account tokens |
+| \`tokens:write\` | Create, update, and delete tokens |
+| \`datasets:list\` | List account datasets |
+| \`datasets:write\` | Create and update datasets |
+| \`tilesets:list\` | List tilesets and tileset sources |
+| \`tilesets:read\` | Read tilesets via Mapbox Tiling Service |
+| \`tilesets:write\` | Create, publish, and manage tilesets |
+| \`downloads:read\` | Download Maps and Navigation SDKs |
+| \`atlas:read\` | Access Mapbox Atlas data (Atlas accounts only) |
+
+## Common Scope Combinations
+
+### Minimal map display (public token)
+\`\`\`
+["styles:tiles", "fonts:read"]
+\`\`\`
+
+### Map display with custom dataset (public token)
+\`\`\`
+["styles:tiles", "fonts:read", "datasets:read"]
+\`\`\`
+
+### Style management (secret token)
+\`\`\`
+["styles:read", "styles:write", "styles:list", "fonts:read"]
+\`\`\`
+
+### Full DevKit server (secret token)
+\`\`\`
+["styles:read", "styles:write", "styles:list", "fonts:read",
+ "tokens:read", "tokens:write", "tilesets:read", "tilesets:list"]
+\`\`\`
+
+## Best Practices
+
+- **Minimal scopes**: Do not grant more scopes than necessary to each token
+- **Public tokens in client code**: Never expose secret tokens in browsers or mobile apps
+- **URL restrictions**: Restrict public tokens to specific domains via \`allowedUrls\`
+- **Rotate regularly**: Periodically rotate secret tokens used in production
+`;
+    }
+}
+exports.MapboxTokenScopesResource = MapboxTokenScopesResource;
+//# sourceMappingURL=MapboxTokenScopesResource.js.map

package/dist/commonjs/resources/mapbox-token-scopes-resource/MapboxTokenScopesResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxTokenScopesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-token-scopes-resource/MapboxTokenScopesResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,wDAAkD;AAElD;;;GAGG;AACH,MAAa,yBAA0B,SAAQ,8BAAY;IAChD,IAAI,GAAG,+BAA+B,CAAC;IACvC,GAAG,GAAG,gCAAgC,CAAC;IACvC,WAAW,GAClB,2KAA2K,CAAC;IACrK,QAAQ,GAAG,eAAe,CAAC;IAE7B,KAAK,CAAC,YAAY,CAAC,GAAQ,EAAE,MAAe;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAEzC,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,GAAG,CAAC,IAAI;oBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,IAAI,EAAE,QAAQ;iBACf;aACF;SACF,CAAC;IACJ,CAAC;IAEO,gBAAgB;QACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2EV,CAAC;IACA,CAAC;CACF;AAnGD,8DAmGC"}

package/dist/commonjs/resources/resourceRegistry.d.ts

@@ -0,0 +1,15 @@
+import { MapboxStyleLayersResource } from './mapbox-style-layers-resource/MapboxStyleLayersResource.js';
+import { MapboxStreetsV8FieldsResource } from './mapbox-streets-v8-fields-resource/MapboxStreetsV8FieldsResource.js';
+import { MapboxTokenScopesResource } from './mapbox-token-scopes-resource/MapboxTokenScopesResource.js';
+import { MapboxLayerTypeMappingResource } from './mapbox-layer-type-mapping-resource/MapboxLayerTypeMappingResource.js';
+import { MapboxDocumentationResource } from './mapbox-documentation-resource/MapboxDocumentationResource.js';
+import { MapboxApiReferenceResource } from './mapbox-api-reference-resource/MapboxApiReferenceResource.js';
+import { MapboxSdkDocsResource } from './mapbox-sdk-docs-resource/MapboxSdkDocsResource.js';
+import { MapboxGuidesResource } from './mapbox-guides-resource/MapboxGuidesResource.js';
+import { MapboxExamplesResource } from './mapbox-examples-resource/MapboxExamplesResource.js';
+import { MapboxReferenceResource } from './mapbox-reference-resource/MapboxReferenceResource.js';
+export declare const ALL_RESOURCES: readonly [MapboxStyleLayersResource, MapboxStreetsV8FieldsResource, MapboxTokenScopesResource, MapboxLayerTypeMappingResource, MapboxDocumentationResource, MapboxApiReferenceResource, MapboxSdkDocsResource, MapboxGuidesResource, MapboxExamplesResource, MapboxReferenceResource];
+export type ResourceInstance = (typeof ALL_RESOURCES)[number];
+export declare function getAllResources(): readonly ResourceInstance[];
+export declare function getResourceByUri(uri: string): ResourceInstance | undefined;
+//# sourceMappingURL=resourceRegistry.d.ts.map

package/dist/commonjs/resources/resourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.d.ts","sourceRoot":"","sources":["../../../src/resources/resourceRegistry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6DAA6D,CAAC;AACxG,OAAO,EAAE,6BAA6B,EAAE,MAAM,sEAAsE,CAAC;AACrH,OAAO,EAAE,yBAAyB,EAAE,MAAM,6DAA6D,CAAC;AACxG,OAAO,EAAE,8BAA8B,EAAE,MAAM,wEAAwE,CAAC;AACxH,OAAO,EAAE,2BAA2B,EAAE,MAAM,gEAAgE,CAAC;AAC7G,OAAO,EAAE,0BAA0B,EAAE,MAAM,+DAA+D,CAAC;AAC3G,OAAO,EAAE,qBAAqB,EAAE,MAAM,qDAAqD,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AACxF,OAAO,EAAE,sBAAsB,EAAE,MAAM,sDAAsD,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,MAAM,wDAAwD,CAAC;AAIjG,eAAO,MAAM,aAAa,uRAYhB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,wBAAgB,eAAe,IAAI,SAAS,gBAAgB,EAAE,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAE1E"}

package/dist/commonjs/resources/resourceRegistry.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_RESOURCES = void 0;
+exports.getAllResources = getAllResources;
+exports.getResourceByUri = getResourceByUri;
+const MapboxStyleLayersResource_js_1 = require("./mapbox-style-layers-resource/MapboxStyleLayersResource.js");
+const MapboxStreetsV8FieldsResource_js_1 = require("./mapbox-streets-v8-fields-resource/MapboxStreetsV8FieldsResource.js");
+const MapboxTokenScopesResource_js_1 = require("./mapbox-token-scopes-resource/MapboxTokenScopesResource.js");
+const MapboxLayerTypeMappingResource_js_1 = require("./mapbox-layer-type-mapping-resource/MapboxLayerTypeMappingResource.js");
+const MapboxDocumentationResource_js_1 = require("./mapbox-documentation-resource/MapboxDocumentationResource.js");
+const MapboxApiReferenceResource_js_1 = require("./mapbox-api-reference-resource/MapboxApiReferenceResource.js");
+const MapboxSdkDocsResource_js_1 = require("./mapbox-sdk-docs-resource/MapboxSdkDocsResource.js");
+const MapboxGuidesResource_js_1 = require("./mapbox-guides-resource/MapboxGuidesResource.js");
+const MapboxExamplesResource_js_1 = require("./mapbox-examples-resource/MapboxExamplesResource.js");
+const MapboxReferenceResource_js_1 = require("./mapbox-reference-resource/MapboxReferenceResource.js");
+const httpPipeline_js_1 = require("../utils/httpPipeline.js");
+// Central registry of all resources
+exports.ALL_RESOURCES = [
+    new MapboxStyleLayersResource_js_1.MapboxStyleLayersResource(),
+    new MapboxStreetsV8FieldsResource_js_1.MapboxStreetsV8FieldsResource(),
+    new MapboxTokenScopesResource_js_1.MapboxTokenScopesResource(),
+    new MapboxLayerTypeMappingResource_js_1.MapboxLayerTypeMappingResource(),
+    new MapboxDocumentationResource_js_1.MapboxDocumentationResource({ httpRequest: httpPipeline_js_1.httpRequest }), // Kept for backward compatibility
+    // New granular documentation resources
+    new MapboxApiReferenceResource_js_1.MapboxApiReferenceResource({ httpRequest: httpPipeline_js_1.httpRequest }),
+    new MapboxSdkDocsResource_js_1.MapboxSdkDocsResource({ httpRequest: httpPipeline_js_1.httpRequest }),
+    new MapboxGuidesResource_js_1.MapboxGuidesResource({ httpRequest: httpPipeline_js_1.httpRequest }),
+    new MapboxExamplesResource_js_1.MapboxExamplesResource({ httpRequest: httpPipeline_js_1.httpRequest }),
+    new MapboxReferenceResource_js_1.MapboxReferenceResource({ httpRequest: httpPipeline_js_1.httpRequest })
+];
+function getAllResources() {
+    return exports.ALL_RESOURCES;
+}
+function getResourceByUri(uri) {
+    return exports.ALL_RESOURCES.find((resource) => resource.uri === uri);
+}
+//# sourceMappingURL=resourceRegistry.js.map

package/dist/commonjs/resources/resourceRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.js","sourceRoot":"","sources":["../../../src/resources/resourceRegistry.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AA+BlC,0CAEC;AAED,4CAEC;AAnCD,8GAAwG;AACxG,2HAAqH;AACrH,8GAAwG;AACxG,8HAAwH;AACxH,mHAA6G;AAC7G,iHAA2G;AAC3G,kGAA4F;AAC5F,8FAAwF;AACxF,oGAA8F;AAC9F,uGAAiG;AACjG,8DAAuD;AAEvD,oCAAoC;AACvB,QAAA,aAAa,GAAG;IAC3B,IAAI,wDAAyB,EAAE;IAC/B,IAAI,gEAA6B,EAAE;IACnC,IAAI,wDAAyB,EAAE;IAC/B,IAAI,kEAA8B,EAAE;IACpC,IAAI,4DAA2B,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC,EAAE,kCAAkC;IACpF,uCAAuC;IACvC,IAAI,0DAA0B,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IAC/C,IAAI,gDAAqB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IAC1C,IAAI,8CAAoB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IACzC,IAAI,kDAAsB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;IAC3C,IAAI,oDAAuB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;CACpC,CAAC;AAIX,SAAgB,eAAe;IAC7B,OAAO,qBAAa,CAAC;AACvB,CAAC;AAED,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,OAAO,qBAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AAChE,CAAC"}

package/dist/commonjs/resources/utils/docParser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Parsed documentation section
+ */
+export interface DocSection {
+    title: string;
+    content: string;
+}
+/**
+ * Category type for documentation sections
+ */
+export type DocCategory = 'apis' | 'sdks' | 'guides' | 'examples' | 'reference';
+/**
+ * Parse Mapbox documentation into sections
+ */
+export declare function parseDocSections(content: string): DocSection[];
+/**
+ * Categorize a section based on its title
+ */
+export declare function categorizeSection(title: string): DocCategory;
+/**
+ * Filter sections by category
+ */
+export declare function filterSectionsByCategory(sections: DocSection[], category: DocCategory): DocSection[];
+/**
+ * Convert sections back to markdown
+ */
+export declare function sectionsToMarkdown(sections: DocSection[]): string;
+//# sourceMappingURL=docParser.d.ts.map

package/dist/commonjs/resources/utils/docParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docParser.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/docParser.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEhF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAoC9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA4C5D;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,UAAU,EAAE,EACtB,QAAQ,EAAE,WAAW,GACpB,UAAU,EAAE,CAId;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,CAIjE"}