@finbheara/domain 0.34.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -133,15 +133,21 @@ geocode("Prague", { near: "RCCEA", declared: true }).isPlace();
133
133
  // no namesake town is read
134
134
  geocode("Fife").isPlace(); // false: a town of Washington, and a council area
135
135
  // of Scotland
136
+ geocode("Prague").isPlace(); // false: a town of Oklahoma, and the capital of
137
+ // Czechia
138
+ geocode("Prague, Oklahoma").pl3; // "USA-OK/prague"
136
139
  ```
137
140
 
138
141
  The layer reads a bare town by its name alone, so it reads one only where nothing contradicts
139
142
  it. A context (a `country` or `near`, read by the store, never as a town of the layer) that
140
143
  reads to ONE place which neither holds the town nor shares its country stops the layer: `Prague`
141
144
  near `RCCEA` and `Whitecross` under `Ireland` and `Ulster` read nothing. A context the store
142
- reads nothing for, or reads as several places, stops nothing, so with no context
143
- `geocode("Prague")` is still Prague, Oklahoma. A town named like a GeoNames admin2 area of those
144
- six countries that does not hold it (`Fife`) reads only where a context places it. A print with a
145
+ reads nothing for, or reads as several places, stops nothing. A town named like a GeoNames admin2
146
+ area of those six countries that does not hold it (`Fife`) reads only where a qualifier or a
147
+ context places it. So does a town named like a capital or a major city elsewhere (a `cities500`
148
+ place outside the six countries that is a capital or holds a million people, and is more populous
149
+ than the town): bare `Prague` and `Copenhagen` read nothing, where they would read the towns of
150
+ Oklahoma and New York, and `Prague` in a USA context is the Oklahoma town. A print with a
145
151
  qualifier (`Yonkers, NY`) is never stopped: the context never overrules the print.
146
152
 
147
153
  A `Place` is one of four arms: `resolved`, `plural` (a print naming more than one place),