@maplibre-yaml/core 0.1.0-alpha.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 mariogiampieri
+
+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/dist/components/index.d.ts

@@ -0,0 +1,106 @@
+import { M as MapRenderer } from '../map-renderer-RQc5_bdo.js';
+import 'maplibre-gl';
+import 'zod';
+import '../map.schema-EnZRrtIh.js';
+
+/**
+ * @file Custom HTML element for declarative map creation
+ * @module @maplibre-yaml/core/components
+ */
+
+/**
+ * Custom HTML element for creating maps declaratively
+ *
+ * @example
+ * ```html
+ * <!-- Using JSON attribute -->
+ * <ml-map config='{"config": {...}, "layers": [...]}'></ml-map>
+ *
+ * <!-- Using inline YAML -->
+ * <ml-map>
+ *   <script type="application/yaml">
+ *     config:
+ *       mapStyle: https://demotiles.maplibre.org/style.json
+ *       center: [-74.5, 40]
+ *       zoom: 9
+ *     layers:
+ *       - id: points
+ *         type: circle
+ *   </script>
+ * </ml-map>
+ *
+ * <!-- Using inline JSON -->
+ * <ml-map>
+ *   <script type="application/json">
+ *     {
+ *       "config": {
+ *         "mapStyle": "https://demotiles.maplibre.org/style.json",
+ *         "center": [-74.5, 40],
+ *         "zoom": 9
+ *       }
+ *     }
+ *   </script>
+ * </ml-map>
+ * ```
+ */
+declare class MLMap extends HTMLElement {
+    private renderer;
+    private container;
+    /**
+     * Observed attributes that trigger attributeChangedCallback
+     */
+    static get observedAttributes(): string[];
+    /**
+     * Called when element is added to the DOM
+     */
+    connectedCallback(): void;
+    /**
+     * Called when element is removed from the DOM
+     */
+    disconnectedCallback(): void;
+    /**
+     * Called when an observed attribute changes
+     */
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    /**
+     * Get configuration from one of three sources:
+     * 1. 'config' attribute (JSON string)
+     * 2. Inline <script type="application/yaml">
+     * 3. Inline <script type="application/json">
+     */
+    private getConfig;
+    /**
+     * Render the map with the given configuration
+     */
+    private render;
+    /**
+     * Get the underlying MapRenderer instance
+     */
+    getRenderer(): MapRenderer | null;
+    /**
+     * Get the underlying MapLibre Map instance
+     */
+    getMap(): any;
+}
+
+/**
+ * @file Default CSS styles for ml-map web component
+ * @module @maplibre-yaml/core/components
+ */
+/**
+ * Default CSS styles for the ml-map custom element
+ *
+ * These styles ensure:
+ * - The ml-map element behaves as a block-level container
+ * - The map fills the available space
+ * - Proper display defaults for embedded elements
+ */
+declare const defaultStyles = "\n  ml-map {\n    display: block;\n    position: relative;\n    width: 100%;\n    height: 400px;\n  }\n\n  ml-map > div {\n    width: 100%;\n    height: 100%;\n  }\n\n  ml-map script[type=\"application/yaml\"],\n  ml-map script[type=\"application/json\"] {\n    display: none;\n  }\n";
+/**
+ * Inject default styles into the document head
+ *
+ * This function is idempotent - it will only inject styles once even if called multiple times.
+ */
+declare function injectStyles(): void;
+
+export { MLMap, defaultStyles, injectStyles };