canvas-globe-web-component 1.1.0 → 1.2.0

package/LICENSE.md

@@ -1,251 +1,251 @@
-# CanvasGlobe Software License Agreement
-
-**Version 2.0, effective September 16, 2026**
-
-This Commercial License Agreement ("Agreement") is between Harsh
-Jhunjhunuwala, an individual trading as Swiftools ("Licensor"), and the person
-or legal entity that downloads, installs, purchases, or uses the
-Software ("Customer"). Swiftools is an operating brand and is not a separate
-legal entity.
-
-By downloading, installing, purchasing, or using the Software,
-Customer accepts this Agreement. An individual accepting for an organization
-represents that they have authority to bind it. A Customer that does not agree
-must not use the Software.
-
-The applicable order, including its plan, price, developer count, product
-count, update period, and any negotiated terms, is the "Order". This Agreement
-and the Order form the complete commercial license for that Order.
-
-## 1. Definitions
-
-- "Software" means the CanvasGlobe source code, compiled artifacts,
-  documentation, and official updates supplied under an Order.
-- "Developer" means an employee or contractor who accesses the Software to
-  develop or modify a Customer Product.
-- "Customer Product" means a website, application, service, or other product
-  that Customer owns and controls and that is permitted by the Order.
-- "Internal Product" means a Customer Product used only by Customer and its
-  personnel and not sold, licensed, supplied, or made available to third
-  parties as a product or service.
-- "Redistributable Product" means an SDK, builder, template, component
-  library, white-label product, installable product, code generator, or other
-  product that supplies the Software or reusable copies of it to third
-  parties.
-- "Update Period" means the period stated in the Order during which Customer
-  may receive new Software versions and the included support.
-
-## 2. Commercial license grant
-
-Subject to payment and compliance with this Agreement, Licensor grants
-Customer a non-exclusive, worldwide, non-transferable license to use,
-reproduce, modify, and incorporate the Software into the Customer Products
-permitted by the Order, and to distribute those Customer Products in
-proprietary form for Customer's end users.
-
-This commercial grant applies only within the Developer, Customer Product,
-entity and redistribution limits in the Order.
-
-For a perpetual Order, Customer may continue using and distributing versions
-received during the Update Period after that period ends. Access to later
-versions, support, and development exceeding the purchased scope requires a
-renewal or a new Order.
-
-## 3. Standard plan scope
-
-Unless the Order expressly states different limits:
-
-- Solo permits one Developer and one Customer Product.
-- Team permits up to five Developers and five Customer Products.
-- Business permits up to twenty Developers and unlimited Internal Products
-  owned and controlled by the purchasing legal entity.
-- OEM, Builder, and Enterprise rights exist only to the extent expressly
-  stated in a negotiated Order.
-
-A production, staging, and development deployment of the same Customer
-Product count as one product. Separate offerings count separately. Customer
-may reassign a seat when a Developer permanently stops working on Customer's
-covered products, but may not rotate seats to avoid a Developer limit.
-
-## 4. Restrictions
-
-Except where an OEM, Builder, or Enterprise Order expressly permits it,
-Customer must not:
-
-- sell, sublicense, publish, or distribute the Software on a standalone basis;
-- use or include the Software in a Redistributable Product;
-- provide the Software's source code to anyone other than authorized
-  Developers working solely for Customer;
-- remove or obscure copyright, license, attribution, or third-party notices;
-- share or use a license key outside the Customer entity and purchased scope;
-- use one Order for an affiliate or other legal entity; or
-- represent CanvasGlobe or the Swiftools brand as Customer's own library or
-  brand.
-
-Customer may make reasonable internal backup copies. Contractors may access
-the Software only for Customer, count toward the Developer limit, and must be
-bound by confidentiality and use restrictions at least as protective as this
-Agreement. Customer is responsible for their compliance.
-
-## 5. License keys
-
-A valid commercial license key is required for the applicable use. The Software
-checks the key locally and does not contact a license server.
-
-Without a valid key, the Software may display watermarks, licensing
-notices, and console warnings, and later versions may limit functionality.
-Customer must keep license keys confidential and must report suspected
-disclosure or misuse. Keys associated with fraudulent, refunded, charged back,
-shared, revoked, or out-of-scope Orders are not licensed for use.
-
-## 6. Ownership and feedback
-
-Licensor and its contributors retain all right, title, and interest in the
-Software. Customer retains all right, title, and interest in Customer's code,
-content, and data. No trademark or brand license is granted.
-
-If Customer voluntarily provides suggestions or feedback, Customer grants
-Licensor a perpetual, worldwide, non-exclusive, irrevocable, royalty-free
-license to use and incorporate that feedback without restriction or payment.
-This does not grant Licensor rights in Customer's confidential information or
-Customer Product.
-
-## 7. Updates and support
-
-The Update Period and support level are stated in the Order. Unless the Order
-says otherwise, standard plans include twelve months of new versions and
-commercially reasonable email assistance for documented Software APIs.
-Support excludes custom implementation, unrelated application debugging,
-guaranteed response or resolution times, and support for versions or uses
-outside the Order.
-
-## 8. Orders, payment, taxes, and refunds
-
-Kelviq acts as Merchant of Record for online purchases. Kelviq processes the
-payment, tax, invoice, and refund transaction under the terms shown at
-checkout. All fees are final and non-refundable,
-and no credits are provided, except where a refund or other remedy is required
-by applicable law or expressly stated in the Order or at checkout. Mandatory
-rights under applicable law are not excluded.
-
-A refund or charge reversal may end the commercial rights and access associated
-with the refunded Order to the extent permitted by the applicable checkout
-terms and law.
-
-## 9. Privacy and order data
-
-Kelviq processes checkout and payment data under its own privacy terms.
-Licensor may receive order, contact, invoice, entitlement, and support
-information needed to fulfill the Order, provide support, prevent abuse, keep
-business records, and comply with law. Licensor's public privacy notice applies
-to information it receives and controls.
-
-The license-key check takes place locally in the Software. It does not add
-visitor analytics or a license-server request to Customer's Application and
-does not send visitor globe interactions or website activity to Licensor.
-
-Customer must not send secrets, regulated data, license keys, or personal data
-that is unnecessary for support.
-
-## 10. Confidentiality
-
-Each party must use reasonable care to protect the other party's non-public
-information and may use it only to perform or enforce this Agreement.
-Confidential information does not include information that the receiving party
-can show was already lawfully known, independently developed without use of
-the information, publicly available without breach, or lawfully received from
-another source without a confidentiality duty.
-
-A party may disclose information when legally required if it gives prior
-notice where lawful and reasonably assists the other party in seeking
-protection.
-
-## 11. Limited authority warranty and disclaimer
-
-Licensor warrants only that Licensor has authority to grant the commercial
-rights stated in this Agreement. Except for that express warranty, the
-Software, updates, support, and documentation are provided "as is" and "as
-available". To the maximum extent permitted by law, Licensor disclaims all
-other express, implied, and statutory warranties, including merchantability,
-fitness for a particular purpose, title, non-infringement, accuracy, security,
-and uninterrupted or error-free operation.
-
-Customer is responsible for evaluating the Software, maintaining backups,
-securing its systems, and confirming that its use satisfies applicable laws
-and requirements.
-
-## 12. Limitation of liability
-
-To the maximum extent permitted by law, neither party is liable under this
-Agreement for lost profits, lost revenue, lost data, business interruption, or
-indirect, incidental, special, exemplary, punitive, or consequential damages,
-even if advised that those damages are possible.
-
-To the maximum extent permitted by law, each party's total aggregate liability
-arising from an Order will not exceed the fees paid for that Order. This cap
-does not limit payment obligations, unauthorized use or distribution of the
-Software, infringement or misuse of the other party's intellectual property,
-breach of confidentiality, fraud, willful misconduct, or liability that law
-does not permit a party to limit.
-
-## 13. Indemnity
-
-No indemnity is included in a standard Solo, Team, or Business Order. Any
-indemnity must be expressly stated in a negotiated OEM or Enterprise Order.
-
-## 14. Term and termination
-
-This Agreement begins when Customer accepts it for an Order. Either party may
-terminate the affected Order for a material breach that remains uncured thirty
-days after written notice. Licensor may suspend access or terminate immediately
-for nonpayment, fraudulent purchase, unlawful use, or material unauthorized
-distribution.
-
-On termination for Customer's breach, Customer must stop new use and
-distribution under the commercial license and remove the Software from future
-releases of Customer Products. Sections that by their nature should survive
-will survive, including ownership, confidentiality, disclaimers, liability
-limits, accrued payments, and general terms.
-
-## 15. Earlier GPL releases
-
-CanvasGlobe versions through 0.1.6 were separately released under GNU GPLv3.
-Rights already received under those releases are not revoked by this Agreement.
-This Agreement governs CanvasGlobe 1.0 and later and does not provide access to
-future commercial versions under the earlier GPL terms.
-
-## 16. General terms
-
-This Agreement is governed by the laws of India, without regard to conflict of
-laws rules. Courts with territorial jurisdiction over Licensor's principal
-place of business or residence in India will have exclusive jurisdiction,
-except that either party may seek urgent injunctive relief in any court with
-appropriate jurisdiction.
-
-Formal notices must be sent to [globe@swiftools.com](mailto:globe@swiftools.com)
-and to the email address recorded for Customer's Order. A notice is effective
-when receipt is acknowledged or the sending party receives an automated proof
-of successful delivery without a rejection notice.
-
-Customer may not assign or transfer this Agreement or an Order without
-Licensor's written consent, except as part of a merger or sale of substantially
-all of Customer's relevant business if the successor accepts this Agreement
-and is not Licensor's direct competitor. Licensor may assign this Agreement to
-a successor to CanvasGlobe or the relevant business.
-
-Neither party is responsible for delay caused by events outside its reasonable
-control, except for payment obligations. A failure to enforce a term is not a
-waiver. If a term is unenforceable, it will be limited only as necessary and
-the remaining terms continue in effect.
-
-A negotiated Order controls over this Agreement only where it expressly says
-that it overrides a named section. This Agreement controls over public pricing,
-FAQ, documentation, marketing, and support pages. Changes apply only when
-accepted for a new Order or renewal unless both parties agree otherwise in
-writing.
-
-This Agreement and the applicable Order are the complete agreement about the
-commercial license and replace prior discussions about that Order. Electronic
-acceptance and electronic records have the same effect as paper signatures.
-
-Questions may be sent to [globe@swiftools.com](mailto:globe@swiftools.com).
+# CanvasGlobe Software License Agreement
+
+**Version 2.0, effective September 16, 2026**
+
+This Commercial License Agreement ("Agreement") is between Harsh
+Jhunjhunuwala, an individual trading as Swiftools ("Licensor"), and the person
+or legal entity that downloads, installs, purchases, or uses the
+Software ("Customer"). Swiftools is an operating brand and is not a separate
+legal entity.
+
+By downloading, installing, purchasing, or using the Software,
+Customer accepts this Agreement. An individual accepting for an organization
+represents that they have authority to bind it. A Customer that does not agree
+must not use the Software.
+
+The applicable order, including its plan, price, developer count, product
+count, update period, and any negotiated terms, is the "Order". This Agreement
+and the Order form the complete commercial license for that Order.
+
+## 1. Definitions
+
+- "Software" means the CanvasGlobe source code, compiled artifacts,
+  documentation, and official updates supplied under an Order.
+- "Developer" means an employee or contractor who accesses the Software to
+  develop or modify a Customer Product.
+- "Customer Product" means a website, application, service, or other product
+  that Customer owns and controls and that is permitted by the Order.
+- "Internal Product" means a Customer Product used only by Customer and its
+  personnel and not sold, licensed, supplied, or made available to third
+  parties as a product or service.
+- "Redistributable Product" means an SDK, builder, template, component
+  library, white-label product, installable product, code generator, or other
+  product that supplies the Software or reusable copies of it to third
+  parties.
+- "Update Period" means the period stated in the Order during which Customer
+  may receive new Software versions and the included support.
+
+## 2. Commercial license grant
+
+Subject to payment and compliance with this Agreement, Licensor grants
+Customer a non-exclusive, worldwide, non-transferable license to use,
+reproduce, modify, and incorporate the Software into the Customer Products
+permitted by the Order, and to distribute those Customer Products in
+proprietary form for Customer's end users.
+
+This commercial grant applies only within the Developer, Customer Product,
+entity and redistribution limits in the Order.
+
+For a perpetual Order, Customer may continue using and distributing versions
+received during the Update Period after that period ends. Access to later
+versions, support, and development exceeding the purchased scope requires a
+renewal or a new Order.
+
+## 3. Standard plan scope
+
+Unless the Order expressly states different limits:
+
+- Solo permits one Developer and one Customer Product.
+- Team permits up to five Developers and five Customer Products.
+- Business permits up to twenty Developers and unlimited Internal Products
+  owned and controlled by the purchasing legal entity.
+- OEM, Builder, and Enterprise rights exist only to the extent expressly
+  stated in a negotiated Order.
+
+A production, staging, and development deployment of the same Customer
+Product count as one product. Separate offerings count separately. Customer
+may reassign a seat when a Developer permanently stops working on Customer's
+covered products, but may not rotate seats to avoid a Developer limit.
+
+## 4. Restrictions
+
+Except where an OEM, Builder, or Enterprise Order expressly permits it,
+Customer must not:
+
+- sell, sublicense, publish, or distribute the Software on a standalone basis;
+- use or include the Software in a Redistributable Product;
+- provide the Software's source code to anyone other than authorized
+  Developers working solely for Customer;
+- remove or obscure copyright, license, attribution, or third-party notices;
+- share or use a license key outside the Customer entity and purchased scope;
+- use one Order for an affiliate or other legal entity; or
+- represent CanvasGlobe or the Swiftools brand as Customer's own library or
+  brand.
+
+Customer may make reasonable internal backup copies. Contractors may access
+the Software only for Customer, count toward the Developer limit, and must be
+bound by confidentiality and use restrictions at least as protective as this
+Agreement. Customer is responsible for their compliance.
+
+## 5. License keys
+
+A valid commercial license key is required for the applicable use. The Software
+checks the key locally and does not contact a license server.
+
+Without a valid key, the Software may display watermarks, licensing
+notices, and console warnings, and later versions may limit functionality.
+Customer must keep license keys confidential and must report suspected
+disclosure or misuse. Keys associated with fraudulent, refunded, charged back,
+shared, revoked, or out-of-scope Orders are not licensed for use.
+
+## 6. Ownership and feedback
+
+Licensor and its contributors retain all right, title, and interest in the
+Software. Customer retains all right, title, and interest in Customer's code,
+content, and data. No trademark or brand license is granted.
+
+If Customer voluntarily provides suggestions or feedback, Customer grants
+Licensor a perpetual, worldwide, non-exclusive, irrevocable, royalty-free
+license to use and incorporate that feedback without restriction or payment.
+This does not grant Licensor rights in Customer's confidential information or
+Customer Product.
+
+## 7. Updates and support
+
+The Update Period and support level are stated in the Order. Unless the Order
+says otherwise, standard plans include twelve months of new versions and
+commercially reasonable email assistance for documented Software APIs.
+Support excludes custom implementation, unrelated application debugging,
+guaranteed response or resolution times, and support for versions or uses
+outside the Order.
+
+## 8. Orders, payment, taxes, and refunds
+
+Kelviq acts as Merchant of Record for online purchases. Kelviq processes the
+payment, tax, invoice, and refund transaction under the terms shown at
+checkout. All fees are final and non-refundable,
+and no credits are provided, except where a refund or other remedy is required
+by applicable law or expressly stated in the Order or at checkout. Mandatory
+rights under applicable law are not excluded.
+
+A refund or charge reversal may end the commercial rights and access associated
+with the refunded Order to the extent permitted by the applicable checkout
+terms and law.
+
+## 9. Privacy and order data
+
+Kelviq processes checkout and payment data under its own privacy terms.
+Licensor may receive order, contact, invoice, entitlement, and support
+information needed to fulfill the Order, provide support, prevent abuse, keep
+business records, and comply with law. Licensor's public privacy notice applies
+to information it receives and controls.
+
+The license-key check takes place locally in the Software. It does not add
+visitor analytics or a license-server request to Customer's Application and
+does not send visitor globe interactions or website activity to Licensor.
+
+Customer must not send secrets, regulated data, license keys, or personal data
+that is unnecessary for support.
+
+## 10. Confidentiality
+
+Each party must use reasonable care to protect the other party's non-public
+information and may use it only to perform or enforce this Agreement.
+Confidential information does not include information that the receiving party
+can show was already lawfully known, independently developed without use of
+the information, publicly available without breach, or lawfully received from
+another source without a confidentiality duty.
+
+A party may disclose information when legally required if it gives prior
+notice where lawful and reasonably assists the other party in seeking
+protection.
+
+## 11. Limited authority warranty and disclaimer
+
+Licensor warrants only that Licensor has authority to grant the commercial
+rights stated in this Agreement. Except for that express warranty, the
+Software, updates, support, and documentation are provided "as is" and "as
+available". To the maximum extent permitted by law, Licensor disclaims all
+other express, implied, and statutory warranties, including merchantability,
+fitness for a particular purpose, title, non-infringement, accuracy, security,
+and uninterrupted or error-free operation.
+
+Customer is responsible for evaluating the Software, maintaining backups,
+securing its systems, and confirming that its use satisfies applicable laws
+and requirements.
+
+## 12. Limitation of liability
+
+To the maximum extent permitted by law, neither party is liable under this
+Agreement for lost profits, lost revenue, lost data, business interruption, or
+indirect, incidental, special, exemplary, punitive, or consequential damages,
+even if advised that those damages are possible.
+
+To the maximum extent permitted by law, each party's total aggregate liability
+arising from an Order will not exceed the fees paid for that Order. This cap
+does not limit payment obligations, unauthorized use or distribution of the
+Software, infringement or misuse of the other party's intellectual property,
+breach of confidentiality, fraud, willful misconduct, or liability that law
+does not permit a party to limit.
+
+## 13. Indemnity
+
+No indemnity is included in a standard Solo, Team, or Business Order. Any
+indemnity must be expressly stated in a negotiated OEM or Enterprise Order.
+
+## 14. Term and termination
+
+This Agreement begins when Customer accepts it for an Order. Either party may
+terminate the affected Order for a material breach that remains uncured thirty
+days after written notice. Licensor may suspend access or terminate immediately
+for nonpayment, fraudulent purchase, unlawful use, or material unauthorized
+distribution.
+
+On termination for Customer's breach, Customer must stop new use and
+distribution under the commercial license and remove the Software from future
+releases of Customer Products. Sections that by their nature should survive
+will survive, including ownership, confidentiality, disclaimers, liability
+limits, accrued payments, and general terms.
+
+## 15. Earlier GPL releases
+
+CanvasGlobe versions through 0.1.6 were separately released under GNU GPLv3.
+Rights already received under those releases are not revoked by this Agreement.
+This Agreement governs CanvasGlobe 1.0 and later and does not provide access to
+future commercial versions under the earlier GPL terms.
+
+## 16. General terms
+
+This Agreement is governed by the laws of India, without regard to conflict of
+laws rules. Courts with territorial jurisdiction over Licensor's principal
+place of business or residence in India will have exclusive jurisdiction,
+except that either party may seek urgent injunctive relief in any court with
+appropriate jurisdiction.
+
+Formal notices must be sent to [globe@swiftools.com](mailto:globe@swiftools.com)
+and to the email address recorded for Customer's Order. A notice is effective
+when receipt is acknowledged or the sending party receives an automated proof
+of successful delivery without a rejection notice.
+
+Customer may not assign or transfer this Agreement or an Order without
+Licensor's written consent, except as part of a merger or sale of substantially
+all of Customer's relevant business if the successor accepts this Agreement
+and is not Licensor's direct competitor. Licensor may assign this Agreement to
+a successor to CanvasGlobe or the relevant business.
+
+Neither party is responsible for delay caused by events outside its reasonable
+control, except for payment obligations. A failure to enforce a term is not a
+waiver. If a term is unenforceable, it will be limited only as necessary and
+the remaining terms continue in effect.
+
+A negotiated Order controls over this Agreement only where it expressly says
+that it overrides a named section. This Agreement controls over public pricing,
+FAQ, documentation, marketing, and support pages. Changes apply only when
+accepted for a new Order or renewal unless both parties agree otherwise in
+writing.
+
+This Agreement and the applicable Order are the complete agreement about the
+commercial license and replace prior discussions about that Order. Electronic
+acceptance and electronic records have the same effect as paper signatures.
+
+Questions may be sent to [globe@swiftools.com](mailto:globe@swiftools.com).

package/custom-elements.json

@@ -1,142 +1,142 @@
-{
-  "schemaVersion": "2.1.0",
-  "readme": "README.md",
-  "modules": [
-    {
-      "kind": "javascript-module",
-      "path": "src/element.js",
-      "declarations": [
-        {
-          "kind": "class",
-          "name": "GeoGlobeElement",
-          "description": "Framework-independent interactive globe and flat world map rendered with Canvas 2D.",
-          "customElement": true,
-          "tagName": "geo-globe",
-          "superclass": {
-            "name": "HTMLElement",
-            "package": "global:"
-          },
-          "members": [
-            {
-              "kind": "field",
-              "name": "globe",
-              "description": "Underlying GeoGlobe instance after the element is connected.",
-              "type": { "text": "GeoGlobe | null" }
-            },
-            {
-              "kind": "field",
-              "name": "markers",
-              "description": "Marker data displayed on the globe.",
-              "type": { "text": "Marker[]" }
-            },
-            {
-              "kind": "field",
-              "name": "arcs",
-              "description": "Great-circle route data displayed on the globe.",
-              "type": { "text": "Arc[]" }
-            },
-            {
-              "kind": "field",
-              "name": "options",
-              "description": "Applies options that cannot be represented as HTML attributes. Accepts Partial<GeoGlobeOptions>."
-            },
-            {
-              "kind": "method",
-              "name": "flyTo",
-              "description": "Animates the view to a longitude and latitude.",
-              "parameters": [
-                { "name": "lon", "type": { "text": "number" } },
-                { "name": "lat", "type": { "text": "number" } },
-                { "name": "opts", "type": { "text": "FlyToOptions" }, "optional": true }
-              ],
-              "return": { "type": { "text": "this" } }
-            },
-            {
-              "kind": "method",
-              "name": "fitTo",
-              "description": "Fits the view to geographic bounds.",
-              "parameters": [
-                { "name": "bounds", "type": { "text": "[number, number, number, number]" } },
-                { "name": "opts", "type": { "text": "FlyToOptions & { padding?: number }" }, "optional": true }
-              ],
-              "return": { "type": { "text": "this" } }
-            },
-            {
-              "kind": "method",
-              "name": "snapshot",
-              "description": "Returns a data URL snapshot of the current canvas.",
-              "parameters": [
-                { "name": "type", "type": { "text": "string" }, "optional": true },
-                { "name": "quality", "type": { "text": "number" }, "optional": true }
-              ],
-              "return": { "type": { "text": "string | undefined" } }
-            }
-          ],
-          "attributes": [
-            { "name": "mode", "description": "Rendering mode.", "type": { "text": "'globe' | 'map'" }, "default": "globe" },
-            { "name": "projection", "description": "Flat-map projection.", "type": { "text": "'equirectangular' | 'mercator' | 'naturalEarth'" }, "default": "equirectangular" },
-            { "name": "theme", "description": "Built-in theme name or serialized theme object.", "type": { "text": "string" }, "default": "atlas" },
-            { "name": "preset", "description": "Built-in visual preset.", "type": { "text": "string" } },
-            { "name": "land-style", "description": "Land rendering style.", "type": { "text": "'fill' | 'dots' | 'outline' | 'glow' | 'none'" }, "default": "fill" },
-            { "name": "marker-style", "description": "Marker rendering style.", "type": { "text": "string" } },
-            { "name": "aria-label", "description": "Accessible label for the canvas.", "type": { "text": "string" } },
-            { "name": "license-key", "description": "CanvasGlobe license key.", "type": { "text": "string" } },
-            { "name": "auto-rotate", "description": "Enables automatic rotation.", "type": { "text": "boolean" } },
-            { "name": "interactive", "description": "Enables pointer interaction.", "type": { "text": "boolean" }, "default": "true" },
-            { "name": "keyboard", "description": "Enables keyboard controls.", "type": { "text": "boolean" }, "default": "true" },
-            { "name": "graticule", "description": "Shows latitude and longitude grid lines.", "type": { "text": "boolean" } },
-            { "name": "stars", "description": "Shows the star background.", "type": { "text": "boolean" } },
-            { "name": "shade", "description": "Enables sphere shading.", "type": { "text": "boolean" } },
-            { "name": "terminator", "description": "Shows the day and night terminator.", "type": { "text": "boolean" } },
-            { "name": "cluster", "description": "Clusters nearby markers.", "type": { "text": "boolean" } },
-            { "name": "tooltip", "description": "Enables the built-in tooltip.", "type": { "text": "boolean" } },
-            { "name": "zoomable", "description": "Enables wheel and pinch zoom.", "type": { "text": "boolean" }, "default": "true" },
-            { "name": "zoom", "description": "Initial zoom level.", "type": { "text": "number" } },
-            { "name": "min-zoom", "description": "Minimum zoom level.", "type": { "text": "number" } },
-            { "name": "max-zoom", "description": "Maximum zoom level.", "type": { "text": "number" } },
-            { "name": "rotate-speed", "description": "Automatic rotation speed.", "type": { "text": "number" } },
-            { "name": "marker-scale", "description": "Global marker scale.", "type": { "text": "number" } },
-            { "name": "radius-ratio", "description": "Globe radius relative to its canvas.", "type": { "text": "number" } },
-            { "name": "fps", "description": "Maximum animation frame rate.", "type": { "text": "number" } },
-            { "name": "cluster-radius", "description": "Marker clustering radius in pixels.", "type": { "text": "number" } },
-            { "name": "arc-lift", "description": "Default arc lift above the sphere.", "type": { "text": "number" } },
-            { "name": "arc-speed", "description": "Default animated arc speed.", "type": { "text": "number" } },
-            { "name": "lat", "description": "Initial centre latitude.", "type": { "text": "number" } },
-            { "name": "lon", "description": "Initial centre longitude.", "type": { "text": "number" } },
-            { "name": "orbits", "description": "Number of decorative orbit rings.", "type": { "text": "number" } },
-            { "name": "dot-spacing", "description": "Dot land-style spacing in degrees.", "type": { "text": "number" } },
-            { "name": "dot-size", "description": "Dot land-style radius in pixels.", "type": { "text": "number" } },
-            { "name": "markers", "description": "Serialized marker array.", "type": { "text": "Marker[]" } },
-            { "name": "arcs", "description": "Serialized route array.", "type": { "text": "Arc[]" } },
-            { "name": "country-colors", "description": "Serialized country colour mapping.", "type": { "text": "Record<string, string>" } },
-            { "name": "lat-range", "description": "Serialized latitude range.", "type": { "text": "[number, number]" } }
-          ],
-          "events": [
-            { "name": "geo-hover", "description": "Fires when the hovered marker changes.", "type": { "text": "CustomEvent<{ marker: Marker | ClusterMarker | null; pos: { x: number; y: number } | null }>" } },
-            { "name": "geo-click", "description": "Fires when a marker is clicked.", "type": { "text": "CustomEvent<{ marker: Marker | ClusterMarker; pos: { x: number; y: number } }>" } },
-            { "name": "geo-country-hover", "description": "Fires when the hovered country changes.", "type": { "text": "CustomEvent<{ country: CountryShape | null; pos: { x: number; y: number } | null }>" } },
-            { "name": "geo-country-click", "description": "Fires when a country is clicked.", "type": { "text": "CustomEvent<{ country: CountryShape; pos: { x: number; y: number } }>" } },
-            { "name": "geo-render", "description": "Fires after CanvasGlobe renders a frame.", "type": { "text": "CustomEvent<{ globe: GeoGlobe }>" } }
-          ]
-        }
-      ],
-      "exports": [
-        {
-          "kind": "js",
-          "name": "GeoGlobeElement",
-          "declaration": { "name": "GeoGlobeElement", "module": "src/element.js" }
-        },
-        {
-          "kind": "js",
-          "name": "defineGeoGlobe",
-          "declaration": { "name": "defineGeoGlobe", "module": "src/element.js" }
-        },
-        {
-          "kind": "custom-element-definition",
-          "name": "geo-globe",
-          "declaration": { "name": "GeoGlobeElement", "module": "src/element.js" }
-        }
-      ]
-    }
-  ]
-}
+{
+  "schemaVersion": "2.1.0",
+  "readme": "README.md",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/element.js",
+      "declarations": [
+        {
+          "kind": "class",
+          "name": "GeoGlobeElement",
+          "description": "Framework-independent interactive globe and flat world map rendered with Canvas 2D.",
+          "customElement": true,
+          "tagName": "geo-globe",
+          "superclass": {
+            "name": "HTMLElement",
+            "package": "global:"
+          },
+          "members": [
+            {
+              "kind": "field",
+              "name": "globe",
+              "description": "Underlying GeoGlobe instance after the element is connected.",
+              "type": { "text": "GeoGlobe | null" }
+            },
+            {
+              "kind": "field",
+              "name": "markers",
+              "description": "Marker data displayed on the globe.",
+              "type": { "text": "Marker[]" }
+            },
+            {
+              "kind": "field",
+              "name": "arcs",
+              "description": "Great-circle route data displayed on the globe.",
+              "type": { "text": "Arc[]" }
+            },
+            {
+              "kind": "field",
+              "name": "options",
+              "description": "Applies options that cannot be represented as HTML attributes. Accepts Partial<GeoGlobeOptions>."
+            },
+            {
+              "kind": "method",
+              "name": "flyTo",
+              "description": "Animates the view to a longitude and latitude.",
+              "parameters": [
+                { "name": "lon", "type": { "text": "number" } },
+                { "name": "lat", "type": { "text": "number" } },
+                { "name": "opts", "type": { "text": "FlyToOptions" }, "optional": true }
+              ],
+              "return": { "type": { "text": "this" } }
+            },
+            {
+              "kind": "method",
+              "name": "fitTo",
+              "description": "Fits the view to geographic bounds.",
+              "parameters": [
+                { "name": "bounds", "type": { "text": "[number, number, number, number]" } },
+                { "name": "opts", "type": { "text": "FlyToOptions & { padding?: number }" }, "optional": true }
+              ],
+              "return": { "type": { "text": "this" } }
+            },
+            {
+              "kind": "method",
+              "name": "snapshot",
+              "description": "Returns a data URL snapshot of the current canvas.",
+              "parameters": [
+                { "name": "type", "type": { "text": "string" }, "optional": true },
+                { "name": "quality", "type": { "text": "number" }, "optional": true }
+              ],
+              "return": { "type": { "text": "string | undefined" } }
+            }
+          ],
+          "attributes": [
+            { "name": "mode", "description": "Rendering mode.", "type": { "text": "'globe' | 'map'" }, "default": "globe" },
+            { "name": "projection", "description": "Flat-map projection.", "type": { "text": "'equirectangular' | 'mercator' | 'naturalEarth'" }, "default": "equirectangular" },
+            { "name": "theme", "description": "Built-in theme name or serialized theme object.", "type": { "text": "string" }, "default": "atlas" },
+            { "name": "preset", "description": "Built-in visual preset.", "type": { "text": "string" } },
+            { "name": "land-style", "description": "Land rendering style.", "type": { "text": "'fill' | 'dots' | 'outline' | 'glow' | 'none'" }, "default": "fill" },
+            { "name": "marker-style", "description": "Marker rendering style.", "type": { "text": "string" } },
+            { "name": "aria-label", "description": "Accessible label for the canvas.", "type": { "text": "string" } },
+            { "name": "license-key", "description": "CanvasGlobe license key.", "type": { "text": "string" } },
+            { "name": "auto-rotate", "description": "Enables automatic rotation.", "type": { "text": "boolean" } },
+            { "name": "interactive", "description": "Enables pointer interaction.", "type": { "text": "boolean" }, "default": "true" },
+            { "name": "keyboard", "description": "Enables keyboard controls.", "type": { "text": "boolean" }, "default": "true" },
+            { "name": "graticule", "description": "Shows latitude and longitude grid lines.", "type": { "text": "boolean" } },
+            { "name": "stars", "description": "Shows the star background.", "type": { "text": "boolean" } },
+            { "name": "shade", "description": "Enables sphere shading.", "type": { "text": "boolean" } },
+            { "name": "terminator", "description": "Shows the day and night terminator.", "type": { "text": "boolean" } },
+            { "name": "cluster", "description": "Clusters nearby markers.", "type": { "text": "boolean" } },
+            { "name": "tooltip", "description": "Enables the built-in tooltip.", "type": { "text": "boolean" } },
+            { "name": "zoomable", "description": "Enables wheel and pinch zoom.", "type": { "text": "boolean" }, "default": "true" },
+            { "name": "zoom", "description": "Initial zoom level.", "type": { "text": "number" } },
+            { "name": "min-zoom", "description": "Minimum zoom level.", "type": { "text": "number" } },
+            { "name": "max-zoom", "description": "Maximum zoom level.", "type": { "text": "number" } },
+            { "name": "rotate-speed", "description": "Automatic rotation speed.", "type": { "text": "number" } },
+            { "name": "marker-scale", "description": "Global marker scale.", "type": { "text": "number" } },
+            { "name": "radius-ratio", "description": "Globe radius relative to its canvas.", "type": { "text": "number" } },
+            { "name": "fps", "description": "Maximum animation frame rate.", "type": { "text": "number" } },
+            { "name": "cluster-radius", "description": "Marker clustering radius in pixels.", "type": { "text": "number" } },
+            { "name": "arc-lift", "description": "Default arc lift above the sphere.", "type": { "text": "number" } },
+            { "name": "arc-speed", "description": "Default animated arc speed.", "type": { "text": "number" } },
+            { "name": "lat", "description": "Initial centre latitude.", "type": { "text": "number" } },
+            { "name": "lon", "description": "Initial centre longitude.", "type": { "text": "number" } },
+            { "name": "orbits", "description": "Number of decorative orbit rings.", "type": { "text": "number" } },
+            { "name": "dot-spacing", "description": "Dot land-style spacing in degrees.", "type": { "text": "number" } },
+            { "name": "dot-size", "description": "Dot land-style radius in pixels.", "type": { "text": "number" } },
+            { "name": "markers", "description": "Serialized marker array.", "type": { "text": "Marker[]" } },
+            { "name": "arcs", "description": "Serialized route array.", "type": { "text": "Arc[]" } },
+            { "name": "country-colors", "description": "Serialized country colour mapping.", "type": { "text": "Record<string, string>" } },
+            { "name": "lat-range", "description": "Serialized latitude range.", "type": { "text": "[number, number]" } }
+          ],
+          "events": [
+            { "name": "geo-hover", "description": "Fires when the hovered marker changes.", "type": { "text": "CustomEvent<{ marker: Marker | ClusterMarker | null; pos: { x: number; y: number } | null }>" } },
+            { "name": "geo-click", "description": "Fires when a marker is clicked.", "type": { "text": "CustomEvent<{ marker: Marker | ClusterMarker; pos: { x: number; y: number } }>" } },
+            { "name": "geo-country-hover", "description": "Fires when the hovered country changes.", "type": { "text": "CustomEvent<{ country: CountryShape | null; pos: { x: number; y: number } | null }>" } },
+            { "name": "geo-country-click", "description": "Fires when a country is clicked.", "type": { "text": "CustomEvent<{ country: CountryShape; pos: { x: number; y: number } }>" } },
+            { "name": "geo-render", "description": "Fires after CanvasGlobe renders a frame.", "type": { "text": "CustomEvent<{ globe: GeoGlobe }>" } }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "GeoGlobeElement",
+          "declaration": { "name": "GeoGlobeElement", "module": "src/element.js" }
+        },
+        {
+          "kind": "js",
+          "name": "defineGeoGlobe",
+          "declaration": { "name": "defineGeoGlobe", "module": "src/element.js" }
+        },
+        {
+          "kind": "custom-element-definition",
+          "name": "geo-globe",
+          "declaration": { "name": "GeoGlobeElement", "module": "src/element.js" }
+        }
+      ]
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "canvas-globe-web-component",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Web Component for interactive 3D globes and world maps rendered with Canvas 2D.",
   "license": "SEE LICENSE IN LICENSE.md",
   "author": {
@@ -37,7 +37,7 @@
   ],
   "sideEffects": true,
   "dependencies": {
-    "canvas-globe": "^1.1.0"
+    "canvas-globe": "^1.2.0"
   },
   "publishConfig": {
     "access": "public"