@liquidcars/atlas 0.1.47 → 0.1.49

package/README.md

@@ -421,3 +421,53 @@ selección se conserva durante las mutaciones del modelo siempre que el elemento
 siga existiendo. Se mantienen las correcciones de geometría, toolbar, etiquetas,
 paleta externa, edición en caliente y los modos `directed`, `bidirectional` y
 `broken` introducidos en las versiones anteriores.
+
+## Hyperlinked Atlas documents
+
+Entities and relations can keep their external `url` and also declare an
+`atlasRef` such as `atlas:actors/dealer.atlas.md#inventory`. A leading slash
+(`atlas:/overview.atlas.md`) starts at the root of the host's document
+collection; otherwise the path resolves beside the current document. The
+optional fragment selects an entity in the destination. Paths cannot escape
+the collection root.
+
+The information panel accepts `content: { format: "markdown", value: "…" }`
+or `content: { format: "html", value: "…" }`. It also accepts a `source`
+instead of an inline `value` when a content resolver is configured. HTML is
+restricted to text formatting and safe `atlas:` or HTTP(S) links. Existing
+`text` remains the fallback when `content` is absent.
+
+The host supplies documents and optional external content:
+
+```js
+atlas.setDocumentResolver(async ({ uri, from }) => ({
+  uri,
+  model: await loadAndCompileDocument(uri, from)
+}));
+atlas.setContentResolver(async ({ source, from, format }) =>
+  loadContent(source, from, format));
+await atlas.load(initialModel);
+atlas.setDocumentUri("atlas:/overview.atlas.md");
+```
+
+The component exposes `openAtlas(reference)`, `goHome()`, `goBack()`,
+`goForward()`, `goToVisit(index)` and `getDocumentHistory()`.
+Navigation and failures emit `lc-navigation` and `lc-navigation-error`.
+Home, Back and Forward appear in a top navigation bar; holding Back or Forward
+opens a visit list. Hosts with their own top bar can set
+`navigation-controls="external"` and connect those controls to the public
+history methods, as Atlas Studio does. Selecting a linked entity or relation shows a floating link button
+beside it. The information panel remains focused on descriptive content and
+external documentation. Studio's Markdown and visual views can open a local
+folder; they treat that folder as the root of `atlas:/`.
+Where supported, Studio requests read and write directory access. It discovers
+document names, reads files only as they are opened or referenced, and caches
+their text in the current tab. Save writes the active Markdown document back
+to its original file, including edits from the visual editor; switching editors
+preserves the document and visit history. Nothing is sent to a server. Browsers
+without the directory picker use a file-input fallback, whose native dialog may
+call the selection “Upload”; Studio still reads the files locally on demand.
+In that fallback, Save opens a picker or downloads a copy because the selected
+files cannot be written in place.
+See `examples/hyperlinks` for two linked documents and an external Markdown
+information file.

package/demo/index.html

@@ -1,5 +1,5 @@
 <!doctype html>
-<html lang="es">
+<html lang="en">
 <head>
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -19,7 +19,7 @@
 <body>
   <header>
     <h1>LiquidCars Atlas</h1>
-    <p>Prueba de distribución del componente <code>&lt;liquidcars-atlas&gt;</code> · v0.1.28</p>
+    <p>Distribution test for the <code>&lt;liquidcars-atlas&gt;</code> component · v0.1.28</p>
   </header>
   <main>
     <liquidcars-atlas id="atlas" height="720" relation-mode="selected" shell-labels="on"></liquidcars-atlas>
@@ -27,7 +27,7 @@
   <script type="module">
     const atlas = document.querySelector('#atlas');
     const model = await fetch(new URL('./model.json', import.meta.url)).then((response) => {
-      if (!response.ok) throw new Error(`No se pudo cargar el modelo (${response.status})`);
+      if (!response.ok) throw new Error(`Could not load the model (${response.status})`);
       return response.json();
     });
     atlas.model = model;

package/demo/model.json

@@ -16,7 +16,7 @@
     {
       "id": "offers",
       "name": "OFFERS",
-      "sub": "Stock y servicios",
+      "sub": "Inventory and services",
       "p": [
         0,
         -3,
@@ -29,12 +29,12 @@
       ],
       "c": "offers",
       "type": "container",
-      "text": "La base del modelo contiene inventarios, ofertas y servicios. El dealer aporta la Base Offer, que referencia el vehículo físico; el proveedor aporta el servicio asociado."
+      "text": "The model base contains inventories, offers and services. The dealer provides the Base Offer, which references the physical vehicle; the provider supplies the associated service."
     },
     {
       "id": "ole",
       "name": "OLE",
-      "sub": "Cálculo de la oferta de canal",
+      "sub": "Channel offer calculation",
       "p": [
         -2.75,
         0.4,
@@ -47,12 +47,12 @@
       ],
       "c": "ole",
       "type": "container",
-      "text": "El Offer Listing Engine aplica revenue management, etiquetas y condiciones de distribución para calcular la oferta que observa cada canal."
+      "text": "The Offer Listing Engine applies revenue management, tags and distribution conditions to calculate the offer shown by each channel."
     },
     {
       "id": "agreements",
       "name": "AGREEMENTS",
-      "sub": "Reglas y operaciones",
+      "sub": "Rules and operations",
       "p": [
         2.75,
         0.4,
@@ -65,12 +65,12 @@
       ],
       "c": "agreements",
       "type": "container",
-      "text": "Agrupa el acuerdo de distribución y sus ámbitos funcionales: atribución, reservas y pedidos. El acuerdo vincula las ofertas y servicios con su distribución autorizada."
+      "text": "Groups the distribution agreement and its functional areas: attribution, bookings and orders. The agreement links offers and services to their authorised distribution."
     },
     {
       "id": "channels",
       "name": "CHANNELS",
-      "sub": "Presentación y acceso",
+      "sub": "Presentation and access",
       "p": [
         0,
         3.2,
@@ -83,13 +83,13 @@
       ],
       "c": "channels",
       "type": "container",
-      "text": "Agrupa los canales de distribución. Cada CHANNEL está contenido en CHANNELS y contiene la oferta de canal que presenta al comprador."
+      "text": "Groups the distribution channels. Each CHANNEL is contained in CHANNELS and contains the channel offer presented to the buyer."
     },
     {
       "id": "physical",
       "parent": "offers",
       "name": "Physical Inventory",
-      "sub": "Fuente directa",
+      "sub": "Direct source",
       "p": [
         -2.5,
         -0.8500000000000001,
@@ -102,13 +102,13 @@
       ],
       "c": "offers",
       "type": "container",
-      "text": "Colección de ofertas alimentada directamente por el dealer o su sistema de stock. Contiene la Base Offer y propaga sus actualizaciones."
+      "text": "A collection of offers supplied directly by the dealer or its inventory system. It contains the Base Offer and propagates its updates."
     },
     {
       "id": "baseoffer",
       "parent": "physical",
       "name": "Base Offer",
-      "sub": "Oferta de origen",
+      "sub": "Source offer",
       "p": [
         0.95,
         0,
@@ -120,7 +120,7 @@
         2.5
       ],
       "c": "dealer",
-      "text": "La oferta de origen referencia el vehículo físico y aporta las condiciones de base a las vistas posteriores. La representación separa el activo de su oferta comercial.",
+      "text": "The source offer references the physical vehicle and provides the base conditions for subsequent views. The representation separates the asset from its commercial offer.",
       "geometry": "cylinder",
       "radius": 0.08
     },
@@ -128,7 +128,7 @@
       "id": "vehicle",
       "parent": "physical",
       "name": "Vehicle",
-      "sub": "Activo físico único",
+      "sub": "Unique physical asset",
       "p": [
         -0.95,
         0,
@@ -140,7 +140,7 @@
         2.5
       ],
       "c": "dealer",
-      "text": "Activo físico único al que referencia la Base Offer. Su disponibilidad debe ser coherente en todas las ofertas y canales donde se distribuye.",
+      "text": "The unique physical asset referenced by the Base Offer. Its availability must remain consistent across every offer and channel through which it is distributed.",
       "geometry": "cylinder",
       "radius": 0.08
     },
@@ -148,7 +148,7 @@
       "id": "virtual",
       "parent": "offers",
       "name": "Virtual Inventory",
-      "sub": "Vista derivada",
+      "sub": "Derived view",
       "p": [
         -2.5,
         0.73,
@@ -161,13 +161,13 @@
       ],
       "c": "offers",
       "type": "container",
-      "text": "Vista calculada de un inventario mediante filtros y reglas. Está apoyada sobre el inventario físico para expresar su dependencia; no duplica el vehículo."
+      "text": "A calculated view of an inventory produced through filters and rules. It rests on the physical inventory to express that dependency; it does not duplicate the vehicle."
     },
     {
       "id": "virtualoffer",
       "parent": "virtual",
       "name": "Virtual Offer",
-      "sub": "Oferta en una vista",
+      "sub": "Offer in a view",
       "p": [
         0,
         0,
@@ -179,7 +179,7 @@
         2.5
       ],
       "c": "dealer",
-      "text": "Representa la oferta observada en el contexto de un inventario virtual. Conserva la referencia a la oferta de origen; las reglas de la vista determinan su inclusión y condiciones.",
+      "text": "Represents the offer observed in the context of a virtual inventory. It retains the reference to the source offer; the view rules determine its inclusion and conditions.",
       "geometry": "cylinder",
       "radius": 0.08
     },
@@ -187,7 +187,7 @@
       "id": "service",
       "parent": "offers",
       "name": "Service",
-      "sub": "Servicio asociado",
+      "sub": "Associated service",
       "p": [
         2.7,
         0,
@@ -199,7 +199,7 @@
         3
       ],
       "c": "serviceProvider",
-      "text": "Servicio que puede acompañar a la oferta o a la operación, como garantía o transporte. El proveedor externo lo aporta y el acuerdo gobierna su incorporación.",
+      "text": "A service that may accompany the offer or transaction, such as a warranty or transport. The external provider supplies it and the agreement governs its inclusion.",
       "geometry": "pyramid-square",
       "radius": 0.08,
       "segments": 12
@@ -208,7 +208,7 @@
       "id": "tags",
       "parent": "ole",
       "name": "RevMan Tag System",
-      "sub": "Condiciones y etiquetas",
+      "sub": "Conditions and tags",
       "p": [
         0,
         -1.05,
@@ -221,7 +221,7 @@
       ],
       "c": "ole",
       "type": "container",
-      "text": "Etiquetas estáticas o dinámicas, activas o inactivas, que alimentan las reglas de selección, precio y disponibilidad. Su efecto procede de las fórmulas donde se utilizan."
+      "text": "Static or dynamic, active or inactive tags that feed selection, pricing and availability rules. Their effect comes from the formulas in which they are used."
     },
     {
       "id": "tagA",
@@ -239,7 +239,7 @@
         0.5
       ],
       "c": "ole",
-      "text": "Etiqueta de revenue management que marca elmententos para condicionar el cálculo de precio y disponibilidad.",
+      "text": "A revenue management tag that marks items to influence price and availability calculations.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -260,7 +260,7 @@
         0.5
       ],
       "c": "ole",
-      "text": "Etiqueta de revenue management que marca elmententos para condicionar el cálculo de precio y disponibilidad.",
+      "text": "A revenue management tag that marks items to influence price and availability calculations.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -281,7 +281,7 @@
         0.5
       ],
       "c": "ole",
-      "text": "Etiqueta de revenue management que marca elmententos para condicionar el cálculo de precio y disponibilidad.",
+      "text": "A revenue management tag that marks items to influence price and availability calculations.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -302,7 +302,7 @@
         0.5
       ],
       "c": "ole",
-      "text": "Etiqueta de revenue management que marca elmententos para condicionar el cálculo de precio y disponibilidad.",
+      "text": "A revenue management tag that marks items to influence price and availability calculations.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -323,7 +323,7 @@
         0.5
       ],
       "c": "ole",
-      "text": "Etiqueta de revenue management que marca elmententos para condicionar el cálculo de precio y disponibilidad.",
+      "text": "A revenue management tag that marks items to influence price and availability calculations.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -344,7 +344,7 @@
         0.5
       ],
       "c": "ole",
-      "text": "Etiqueta de revenue management que marca elmententos para condicionar el cálculo de precio y disponibilidad.",
+      "text": "A revenue management tag that marks items to influence price and availability calculations.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -353,7 +353,7 @@
       "id": "rm",
       "parent": "ole",
       "name": "Revenue Management",
-      "sub": "Aplicación de reglas",
+      "sub": "Rule application",
       "p": [
         0,
         0.5499999999999999,
@@ -366,13 +366,13 @@
       ],
       "c": "ole",
       "type": "container",
-      "text": "Aplica las reglas comerciales autorizadas al contexto de distribución. Contiene la Channel Offer calculada; el sistema ejecuta las decisiones de las partes."
+      "text": "Applies authorised commercial rules to the distribution context. It contains the calculated Channel Offer; the system executes the parties' decisions."
     },
     {
       "id": "revmanoffer",
       "parent": "rm",
       "name": "RevMan Offer",
-      "sub": "Resultado contextual",
+      "sub": "Contextual result",
       "p": [
         0,
         0,
@@ -384,7 +384,7 @@
         2.5
       ],
       "c": "channelOffer",
-      "text": "Oferta calculada para un canal a partir de los inventarios, el acuerdo y las reglas de revenue management. Es el resultado que la capa CHANNELS presenta.",
+      "text": "An offer calculated for a channel from the inventories, agreement and revenue management rules. It is the result presented by the CHANNELS layer.",
       "geometry": "cylinder",
       "radius": 0.08
     },
@@ -392,7 +392,7 @@
       "id": "da",
       "parent": "agreements",
       "name": "Distribution Agreement",
-      "sub": "Acuerdo aceptado",
+      "sub": "Accepted agreement",
       "p": [
         -1.25,
         0,
@@ -404,7 +404,7 @@
         2.35
       ],
       "c": "agreements",
-      "text": "Establece el stock y servicios incluidos, así como las condiciones comerciales y operativas aceptadas por las partes. Su versión vigente da contexto a cada operación.",
+      "text": "Defines the included inventory and services, together with the commercial and operational conditions accepted by the parties. Its current version provides context for each transaction.",
       "geometry": "icosahedron",
       "radius": 0.08
     },
@@ -412,7 +412,7 @@
       "id": "attribution",
       "parent": "agreements",
       "name": "Attribution",
-      "sub": "Contribución de canales",
+      "sub": "Channel contribution",
       "p": [
         1.5,
         1,
@@ -424,7 +424,7 @@
         2.5
       ],
       "c": "agreements",
-      "text": "Valora eventos y contribuciones conforme a pesos acordados. El enfoque actual no resuelve identidad del comprador entre canales y distingue reportante, canal contribuyente y sujeto.",
+      "text": "Values events and contributions according to agreed weights. The current approach does not resolve buyer identity across channels and distinguishes the reporter, contributing channel and subject.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -433,7 +433,7 @@
       "id": "bookings",
       "parent": "agreements",
       "name": "Bookings",
-      "sub": "Derecho exclusivo",
+      "sub": "Exclusive right",
       "p": [
         1.5,
         0,
@@ -445,7 +445,7 @@
         2.5
       ],
       "c": "agreements",
-      "text": "La reserva concede un derecho exclusivo de compra por un plazo bajo las reglas pactadas, manteniendo la coherencia de la disponibilidad del vehículo entre canales.",
+      "text": "A booking grants an exclusive right to purchase for a period under the agreed rules, while keeping vehicle availability consistent across channels.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -454,7 +454,7 @@
       "id": "orders",
       "parent": "agreements",
       "name": "Orders",
-      "sub": "Avance de la operación",
+      "sub": "Transaction progress",
       "p": [
         1.5,
         -1,
@@ -466,7 +466,7 @@
         2.5
       ],
       "c": "agreements",
-      "text": "El pedido articula el avance de la operación comercial bajo el acuerdo aplicable y conserva la trazabilidad de sus condiciones y estados.",
+      "text": "The order structures the progress of the commercial transaction under the applicable agreement and preserves the traceability of its conditions and states.",
       "geometry": "box",
       "radius": 0.08,
       "segments": 12
@@ -475,7 +475,7 @@
       "id": "buyeroffer",
       "parent": "channel",
       "name": "Buyer Offer",
-      "sub": "Vista para el comprador",
+      "sub": "Buyer view",
       "p": [
         -2,
         0,
@@ -487,7 +487,7 @@
         2.5
       ],
       "c": "channels",
-      "text": "Representa la presentación de la Channel Offer por el canal. Esta pieza de lectura conecta el resultado de OLE con el punto de acceso del comprador; no añade una nueva oferta de origen.",
+      "text": "Represents the channel's presentation of the Channel Offer. This read model connects the OLE result to the buyer's access point; it does not add a new source offer.",
       "geometry": "cylinder",
       "radius": 0.08
     },
@@ -495,7 +495,7 @@
       "id": "engagement",
       "parent": "channel",
       "name": "Engagement",
-      "sub": "Gestión de la interacción",
+      "sub": "Interaction management",
       "p": [
         2,
         0,
@@ -507,14 +507,14 @@
         2.5
       ],
       "c": "channels",
-      "text": "Toda la lógica de interacción con el comprador se gestiona en la pieza Engagement. Contiene la información de contacto, el estado de la interacción y los eventos que alimentan la atribución.",
+      "text": "All buyer interaction logic is managed by Engagement. It contains contact information, interaction state and the events that feed attribution.",
       "geometry": "box",
       "radius": 0.08
     },
     {
       "id": "buyer",
       "name": "BUYER",
-      "sub": "Comprador",
+      "sub": "Buyer",
       "p": [
         0,
         5.6,
@@ -527,14 +527,14 @@
       ],
       "c": "buyer",
       "type": "actor",
-      "text": "Accede a la propuesta comercial a través del canal y puede iniciar las acciones de compra bajo las condiciones mostradas.",
+      "text": "Accesses the commercial proposition through the channel and can initiate purchase actions under the displayed conditions.",
       "geometry": "sphere"
     },
     {
       "id": "channel",
       "parent": "channels",
       "name": "CHANNEL",
-      "sub": "Canal de distribución",
+      "sub": "Distribution channel",
       "p": [
         0,
         0,
@@ -547,12 +547,12 @@
       ],
       "c": "channels",
       "type": "container",
-      "text": "Representa un canal de distribución dentro de CHANNELS: un marketplace, la web del dealer u otro canal autorizado. Contiene la oferta de canal presentada al comprador."
+      "text": "Represents a distribution channel within CHANNELS: a marketplace, the dealer's website or another authorised channel. It contains the channel offer presented to the buyer."
     },
     {
       "id": "dealer",
       "name": "DEALER",
-      "sub": "Titular y control comercial",
+      "sub": "Ownership and commercial control",
       "p": [
         -8,
         -3,
@@ -565,13 +565,13 @@
       ],
       "c": "dealer",
       "type": "actor",
-      "text": "Aporta y mantiene el stock. Conserva la titularidad del vehículo y el control de sus decisiones comerciales, y acepta las condiciones de distribución.",
+      "text": "Provides and maintains the inventory. It retains ownership of the vehicle and control over its commercial decisions, and accepts the distribution conditions.",
       "geometry": "dodecahedron"
     },
     {
       "id": "provider",
       "name": "SERVICE PROVIDER",
-      "sub": "Proveedor externo",
+      "sub": "External provider",
       "p": [
         8,
         -3,
@@ -584,7 +584,7 @@
       ],
       "c": "serviceProvider",
       "type": "actor",
-      "text": "Aporta los servicios asociados a la oferta o a la operación. Su posición externa distingue al proveedor de la pieza Service contenida en OFFERS.",
+      "text": "Provides the services associated with the offer or transaction. Its external position distinguishes the provider from the Service item contained in OFFERS.",
       "geometry": "dodecahedron"
     }
   ],
@@ -592,87 +592,87 @@
     [
       "dealer",
       "vehicle",
-      "alimenta"
+      "supplies"
     ],
     [
       "baseoffer",
       "vehicle",
-      "referencia"
+      "references"
     ],
     [
       "baseoffer",
       "virtualoffer",
-      "da origen a"
+      "originates"
     ],
     [
       "virtualoffer",
       "da",
-      "se distribuye bajo"
+      "is distributed under"
     ],
     [
       "baseoffer",
       "da",
-      "se distribuye bajo"
+      "is distributed under"
     ],
     [
       "provider",
       "service",
-      "aporta"
+      "provides"
     ],
     [
       "service",
       "da",
-      "se incorpora bajo"
+      "is included under"
     ],
     [
       "tagA",
       "revmanoffer",
-      "alimenta reglas"
+      "feeds rules"
     ],
     [
       "tagB",
       "revmanoffer",
-      "alimenta reglas"
+      "feeds rules"
     ],
     [
       "tagC",
       "revmanoffer",
-      "alimenta reglas"
+      "feeds rules"
     ],
     [
       "tagD",
       "revmanoffer",
-      "alimenta reglas"
+      "feeds rules"
     ],
     [
       "tagE",
       "revmanoffer",
-      "alimenta reglas"
+      "feeds rules"
     ],
     [
       "tagF",
       "revmanoffer",
-      "alimenta reglas"
+      "feeds rules"
     ],
     [
       "da",
       "revmanoffer",
-      "calcula"
+      "calculates"
     ],
     [
       "revmanoffer",
       "buyeroffer",
-      "se presenta como"
+      "is presented as"
     ],
     [
       "buyeroffer",
       "buyer",
-      "accede a través de"
+      "accesses through"
     ],
     [
       "buyer",
       "engagement",
-      "interactua con"
+      "interacts with"
     ],
     [
       "engagement",
@@ -682,19 +682,20 @@
     [
       "da",
       "attribution",
-      "gobierna"
+      "governs"
     ],
     [
       "da",
       "bookings",
-      "gobierna"
+      "governs"
     ],
     [
       "da",
       "orders",
-      "gobierna"
+      "governs"
     ]
   ]
 }
 
 
+