@escape-game-over/atlas 0.1.95 → 0.1.96

package/docs/rich-text.md

@@ -253,7 +253,7 @@ per `[v:name]` and one for links — usually in a small wrapper
 ```
 
 A `[tel]` link renders with `dir="ltr"`: a number has no letters to set its
-direction, and on a right-to-left page it would otherwise read "2227 0244 965+".
+direction, and on a right-to-left page it would otherwise read "0100 555 202 1+".
 A number on its own, outside copy, is `@escape-game-over/atlas/astro/phone`.
 
 `attrs` puts attributes on a variant's run, so a script can find it and rewrite

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@escape-game-over/atlas",
-    "version": "0.1.95",
+    "version": "0.1.96",
     "type": "module",
     "description": "Typed, data-driven machinery for static multi-locale, multi-deployment Astro sites.",
     "private": false,

package/src/astro/Phone.astro

@@ -6,8 +6,8 @@
  * <a href={telHref(phone)}><Phone phone={phone} /></a>
  * ```
  *
- * "+965 2227 0244" has no letters to set its direction, so on an Arabic page
- * the browser would lay it out right to left and show "2227 0244 965+". Its own
+ * "+1 202 555 0100" has no letters to set its direction, so on an Arabic page
+ * the browser would lay it out right to left and show "0100 555 202 1+". Its own
  * element with `dir="ltr"` keeps it whole, the way the page expects a number
  * to read, and copies as just the number. An email needs none of this: its
  * letters already make it read left to right.

package/src/astro/RichText.astro

@@ -82,7 +82,7 @@ const variantAttrs = (variant: string) =>
                 </a>
             );
         // A number has no letters to set its direction; on a right-to-left
-        // page it would read "2227 0244 965+". See `Phone.astro`.
+        // page it would read "0100 555 202 1+". See `Phone.astro`.
         case "tel":
             return (
                 <a

package/src/jsonld/business.ts

@@ -15,8 +15,17 @@ import { geoCoordinates, openingHours, postalAddress } from "./place.ts";
 
 export interface LocalBusinessInput {
     readonly name: string;
-    /** The site's own origin. Also the node's identity, see `@id` below. */
+    /**
+     * The page about it: the site, or one location's page on a site with
+     * several. Its origin carries the node's identity, see `@id` below.
+     */
     readonly url: HttpsUrl;
+    /**
+     * Which of the site's businesses this is, on a site with several: `north`
+     * makes the `@id` `<origin>#business-north`. Point at it with
+     * `businessId(url, location)`.
+     */
+    readonly location?: string;
     readonly address: PostalAddress;
     /**
      * Another name this venue actually goes by.
@@ -162,7 +171,7 @@ export interface LocalBusinessInput {
 export function localBusiness(business: LocalBusinessInput): JsonLdNode {
     return {
         "@type": schemaType(business.type ?? "LocalBusiness"),
-        "@id": businessId(business.url),
+        "@id": businessId(business.url, business.location),
         name: business.name,
         ...alternateName(business.name, business.alternateName),
         url: business.url,

package/src/jsonld/ids.ts

@@ -1,4 +1,4 @@
-import { type HttpsUrl, normalizeOrigin } from "../url.ts";
+import { type HttpsUrl, isHttpsUrl, normalizeOrigin } from "../url.ts";
 
 /**
  * The `@id` each addressable node takes, and the types that keep them apart.
@@ -43,7 +43,9 @@ import { type HttpsUrl, normalizeOrigin } from "../url.ts";
  * -checks, while the mistake this exists to stop — passing a bare URL where a
  * reference belongs — does not.
  */
-export type BusinessId = `${HttpsUrl}#business`;
+export type BusinessId =
+    | `${HttpsUrl}#business`
+    | `${HttpsUrl}#business-${string}`;
 
 /** The identity of a brand node. See `BusinessId`. */
 export type OrganizationId = `${HttpsUrl}#organization`;
@@ -68,15 +70,25 @@ export type WebsiteId = `${HttpsUrl}#website`;
 export type ServiceId = `${HttpsUrl}#service`;
 
 /**
- * The `@id` a business node takes, from the site's origin.
+ * The `@id` a business node takes: on the origin of `url`, whichever page of
+ * the site that is.
  *
  * Exported because a reference has to be built by whoever points at it, and the
  * fragment must match exactly — a node linking to `#local-business` when the
  * business calls itself `#business` is a dangling reference that no validator
  * reports and no crawler resolves. One definition, used by both ends.
+ *
+ * A site with several businesses — one per location — names each:
+ * `businessId(origin, "north")` is `<origin>#business-north`.
+ * Without a name they would all be `#business`, and a crawler merges nodes
+ * that share an id, so the locations would read as one place.
  */
-export function businessId(url: HttpsUrl): BusinessId {
-    return `${normalizeOrigin(url)}#business`;
+export function businessId(url: HttpsUrl, location?: string): BusinessId {
+    const origin = new URL(url).origin;
+    if (!isHttpsUrl(origin)) throw new Error(`"${url}" has no https origin.`);
+    return location === undefined
+        ? `${origin}#business`
+        : `${origin}#business-${location}`;
 }
 
 /** The `@id` a brand node takes. See `businessId`. */