@urbankitstudio/atlas 0.6.8 → 0.6.9

package/README.md

@@ -76,7 +76,7 @@ For single-address owner lookups in the browser, the free [Owner Lookup](https:/
 
 | Function | Returns |
 |---|---|
-| `listStates()` | `StateIndexEntry[]` — all 50 states + `populated` flag |
+| `listStates()` | `StateIndexEntry[]` — all 50 states and DC + `populated` flag |
 | `findState(stateSlug)` | `StateFile \| undefined` |
 | `findCounty(stateSlug, countySlug)` | `CountyRecord \| undefined` |
 | `findCountyByFips(fips)` | `CountyRecord \| undefined` — match by 5-digit county FIPS |
@@ -134,9 +134,9 @@ Omit `?fips=` to get every tracked county in one call.
 
 ## Coverage today
 
-The atlas bundles **234 counties across all 50 US states** (246 verified endpoints), covering the largest counties in each. Call `listStates()` to enumerate the full set.
+The atlas bundles **235 counties across all 50 US states and DC** (247 verified endpoints), covering the largest counties in each. Call `listStates()` to enumerate the full set.
 
-Every state has at least one county on record, and 228 of the 234 carry a verified endpoint. The other 6 have `hasPublicRest: false` and an empty `endpoints` array, with `notes` recording the reason and who to contact. Those reasons vary: a subscription-only regional GIS partner, a statewide server that requires an auth token, a state with no county-level parcel authority, a county viewer with no public query API, a county that does not publish owner names online. They ship rather than being omitted, so `findCounty()` still resolves them. **Check `hasPublicRest`** rather than assuming every county has an endpoint; `totals.countiesWithEndpoint` gives the queryable count directly.
+Every state has at least one county on record, and 229 of the 235 carry a verified endpoint. The other 6 have `hasPublicRest: false` and an empty `endpoints` array, with `notes` recording the reason and who to contact. Those reasons vary: a subscription-only regional GIS partner, a statewide server that requires an auth token, a state with no county-level parcel authority, a county viewer with no public query API, a county that does not publish owner names online. They ship rather than being omitted, so `findCounty()` still resolves them. **Check `hasPublicRest`** rather than assuming every county has an endpoint; `totals.countiesWithEndpoint` gives the queryable count directly.
 
 Counties are added as their public REST endpoints are verified. Package versions bump when data refreshes — pin to a minor range (`^0.x`) to receive new counties without breaking changes.
 

package/data/district-of-columbia.json

@@ -0,0 +1,52 @@
+{
+  "stateSlug": "district-of-columbia",
+  "stateName": "District of Columbia",
+  "stateAbbrev": "DC",
+  "lastUpdated": "2026-09-26",
+  "counties": [
+    {
+      "id": "dc-district-of-columbia",
+      "state": "DC",
+      "stateName": "District of Columbia",
+      "stateSlug": "district-of-columbia",
+      "county": "District of Columbia",
+      "countySlug": "district-of-columbia",
+      "countyFips": "11001",
+      "hasPublicRest": true,
+      "endpoints": [
+        {
+          "url": "https://maps2.dcgis.dc.gov/dcgis/rest/services/DCGIS_DATA/Property_and_Land_WebMercator/FeatureServer/40",
+          "serviceType": "FeatureServer",
+          "layerIndex": 40,
+          "layerName": "Owner Polygons (Common Ownership Layer)",
+          "supportsQuery": true,
+          "corsEnabled": true,
+          "searchFields": [
+            { "name": "SSL", "label": "Square, Suffix, Lot (Parcel ID)", "searchable": true },
+            { "name": "OWNERNAME", "label": "Owner Name", "searchable": true },
+            { "name": "CAREOFNAME", "label": "Care Of Name", "searchable": false },
+            { "name": "PREMISEADD", "label": "Premise (Situs) Address", "searchable": true },
+            { "name": "ADDRESS1", "label": "Owner Mailing Address", "searchable": true },
+            { "name": "ADDRESS2", "label": "Owner Mailing Address 2", "searchable": false },
+            { "name": "CITYSTZIP", "label": "Owner Mailing City/State/ZIP", "searchable": true },
+            { "name": "USECODE", "label": "Use Code", "searchable": false },
+            { "name": "LANDAREA", "label": "Land Area", "searchable": false },
+            { "name": "ASSESSMENT", "label": "Assessment", "searchable": false }
+          ],
+          "sampleQuery": "https://maps2.dcgis.dc.gov/dcgis/rest/services/DCGIS_DATA/Property_and_Land_WebMercator/FeatureServer/40/query?where=OWNERNAME%20LIKE%20'SMITH%25'&outFields=SSL,OWNERNAME,PREMISEADD,ADDRESS1,CITYSTZIP&returnGeometry=false&f=json&resultRecordCount=10",
+          "license": "open-data",
+          "licenseUrl": "https://creativecommons.org/licenses/by/4.0/",
+          "status": "live",
+          "lastVerified": "2026-09-26",
+          "verifiedBy": "manual"
+        }
+      ],
+      "contact": {
+        "department": "DC Office of the Chief Technology Officer (OCTO) GIS and Office of the Surveyor; data attributed daily from the Office of Tax and Revenue's Real Property Tax Administration (RPTA) Integrated Tax System Public Extract (ITSPE)",
+        "url": "https://opendata.dc.gov/datasets/DCGIS::common-ownership-lots",
+        "email": null
+      },
+      "notes": "The District of Columbia is one county-equivalent (FIPS 11001) with no counties inside it. Layer 40, Owner Polygons (Common Ownership Layer), is the District's general ownership layer: 137,400 lot polygons merged from the Record, Tax, Parcel, Reservation and Air Rights lot layers and regenerated daily from the Office of Tax and Revenue's Integrated Tax System Public Extract (ITSPE). Layers 49 (District Land) and 50 (Federal Land) on the same service are narrower views of it. The parcel ID is the SSL (square, suffix, lot), written either as 'SQUARE SUFFIX LOT' (e.g. '1929    7056') or as 'PAR NNNNNNNN' for Parcel-type lots; both answer an SSL LIKE prefix search. The owner mailing address (ADDRESS1, ADDRESS2, CITYSTZIP) is separate from the premise address (PREMISEADD). Verified 2026-09-26: OWNERNAME LIKE 'SMITH%' returns 939 lots, and a PREMISEADD search returns individual homeowners alongside institutions.\n\nCoverage: the layer maps land, one polygon per lot. A condominium building is a single lot on it, and 3,921 of its 4,142 condominium lots carry no owner name, so an owner search finds lot owners, not unit owners. The tax extract published on the same service lists 221,622 records; unit-level condominium data sits in separate tables there, which this layer does not join. The service's ArcGIS Online item (Common Ownership Lots, item 1f6708b1f3774306bef2fa81e612a725, owner DCGISopendata) licenses the data under Creative Commons Attribution 4.0 International, so reuse credits the District of Columbia; the District's open-data terms apply CC0 only where no other license is noted, and this item notes one. OTR's Real Property Public Extract is a different product: a bulk file restricted to mortgage companies."
+    }
+  ]
+}

package/data/index.json

@@ -2,10 +2,10 @@
   "version": "0.3.0",
   "lastUpdated": "2026-09-26",
   "totals": {
-    "states": 50,
-    "counties": 234,
-    "endpoints": 246,
-    "countiesWithEndpoint": 228,
+    "states": 51,
+    "counties": 235,
+    "endpoints": 247,
+    "countiesWithEndpoint": 229,
     "countiesUnprobeable": 1
   },
   "states": [
@@ -73,6 +73,14 @@
       "endpointCount": 1,
       "populated": true
     },
+    {
+      "slug": "district-of-columbia",
+      "name": "District of Columbia",
+      "abbrev": "DC",
+      "countyCount": 1,
+      "endpointCount": 1,
+      "populated": true
+    },
     {
       "slug": "florida",
       "name": "Florida",

package/dist/index.cjs

@@ -17,10 +17,10 @@ var data_default = {
   version: "0.3.0",
   lastUpdated: "2026-09-26",
   totals: {
-    states: 50,
-    counties: 234,
-    endpoints: 246,
-    countiesWithEndpoint: 228,
+    states: 51,
+    counties: 235,
+    endpoints: 247,
+    countiesWithEndpoint: 229,
     countiesUnprobeable: 1
   },
   states: [
@@ -88,6 +88,14 @@ var data_default = {
       endpointCount: 1,
       populated: true
     },
+    {
+      slug: "district-of-columbia",
+      name: "District of Columbia",
+      abbrev: "DC",
+      countyCount: 1,
+      endpointCount: 1,
+      populated: true
+    },
     {
       slug: "florida",
       name: "Florida",
@@ -3119,6 +3127,60 @@ var delaware_default = {
   ]
 };
 
+// data/district-of-columbia.json
+var district_of_columbia_default = {
+  stateSlug: "district-of-columbia",
+  stateName: "District of Columbia",
+  stateAbbrev: "DC",
+  lastUpdated: "2026-09-26",
+  counties: [
+    {
+      id: "dc-district-of-columbia",
+      state: "DC",
+      stateName: "District of Columbia",
+      stateSlug: "district-of-columbia",
+      county: "District of Columbia",
+      countySlug: "district-of-columbia",
+      countyFips: "11001",
+      hasPublicRest: true,
+      endpoints: [
+        {
+          url: "https://maps2.dcgis.dc.gov/dcgis/rest/services/DCGIS_DATA/Property_and_Land_WebMercator/FeatureServer/40",
+          serviceType: "FeatureServer",
+          layerIndex: 40,
+          layerName: "Owner Polygons (Common Ownership Layer)",
+          supportsQuery: true,
+          corsEnabled: true,
+          searchFields: [
+            { name: "SSL", label: "Square, Suffix, Lot (Parcel ID)", searchable: true },
+            { name: "OWNERNAME", label: "Owner Name", searchable: true },
+            { name: "CAREOFNAME", label: "Care Of Name", searchable: false },
+            { name: "PREMISEADD", label: "Premise (Situs) Address", searchable: true },
+            { name: "ADDRESS1", label: "Owner Mailing Address", searchable: true },
+            { name: "ADDRESS2", label: "Owner Mailing Address 2", searchable: false },
+            { name: "CITYSTZIP", label: "Owner Mailing City/State/ZIP", searchable: true },
+            { name: "USECODE", label: "Use Code", searchable: false },
+            { name: "LANDAREA", label: "Land Area", searchable: false },
+            { name: "ASSESSMENT", label: "Assessment", searchable: false }
+          ],
+          sampleQuery: "https://maps2.dcgis.dc.gov/dcgis/rest/services/DCGIS_DATA/Property_and_Land_WebMercator/FeatureServer/40/query?where=OWNERNAME%20LIKE%20'SMITH%25'&outFields=SSL,OWNERNAME,PREMISEADD,ADDRESS1,CITYSTZIP&returnGeometry=false&f=json&resultRecordCount=10",
+          license: "open-data",
+          licenseUrl: "https://creativecommons.org/licenses/by/4.0/",
+          status: "live",
+          lastVerified: "2026-09-26",
+          verifiedBy: "manual"
+        }
+      ],
+      contact: {
+        department: "DC Office of the Chief Technology Officer (OCTO) GIS and Office of the Surveyor; data attributed daily from the Office of Tax and Revenue's Real Property Tax Administration (RPTA) Integrated Tax System Public Extract (ITSPE)",
+        url: "https://opendata.dc.gov/datasets/DCGIS::common-ownership-lots",
+        email: null
+      },
+      notes: "The District of Columbia is one county-equivalent (FIPS 11001) with no counties inside it. Layer 40, Owner Polygons (Common Ownership Layer), is the District's general ownership layer: 137,400 lot polygons merged from the Record, Tax, Parcel, Reservation and Air Rights lot layers and regenerated daily from the Office of Tax and Revenue's Integrated Tax System Public Extract (ITSPE). Layers 49 (District Land) and 50 (Federal Land) on the same service are narrower views of it. The parcel ID is the SSL (square, suffix, lot), written either as 'SQUARE SUFFIX LOT' (e.g. '1929    7056') or as 'PAR NNNNNNNN' for Parcel-type lots; both answer an SSL LIKE prefix search. The owner mailing address (ADDRESS1, ADDRESS2, CITYSTZIP) is separate from the premise address (PREMISEADD). Verified 2026-09-26: OWNERNAME LIKE 'SMITH%' returns 939 lots, and a PREMISEADD search returns individual homeowners alongside institutions.\n\nCoverage: the layer maps land, one polygon per lot. A condominium building is a single lot on it, and 3,921 of its 4,142 condominium lots carry no owner name, so an owner search finds lot owners, not unit owners. The tax extract published on the same service lists 221,622 records; unit-level condominium data sits in separate tables there, which this layer does not join. The service's ArcGIS Online item (Common Ownership Lots, item 1f6708b1f3774306bef2fa81e612a725, owner DCGISopendata) licenses the data under Creative Commons Attribution 4.0 International, so reuse credits the District of Columbia; the District's open-data terms apply CC0 only where no other license is noted, and this item notes one. OTR's Real Property Public Extract is a different product: a bulk file restricted to mortgage companies."
+    }
+  ]
+};
+
 // data/florida.json
 var florida_default = {
   stateSlug: "florida",
@@ -21880,6 +21942,7 @@ var POPULATED_STATES = {
   colorado: colorado_default,
   connecticut: connecticut_default,
   delaware: delaware_default,
+  "district-of-columbia": district_of_columbia_default,
   florida: florida_default,
   georgia: georgia_default,
   hawaii: hawaii_default,
@@ -21969,10 +22032,10 @@ function listCountiesByState(stateSlug) {
 function slugify(s) {
   return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
+var COUNTY_UNIT_SUFFIX = /\b(?:County|Parish|Borough|Municipality|Census Area|City|Statewide|Planning Region|District of Columbia)$/i;
 function countySlugFromName(county) {
-  const lc = county.toLowerCase();
-  const hasSuffix = lc.endsWith(" county") || lc.endsWith(" parish") || lc.endsWith(" borough") || lc.endsWith(" census area");
-  return slugify(hasSuffix ? county : `${county} County`);
+  const name = county.trim();
+  return slugify(COUNTY_UNIT_SUFFIX.test(name) ? name : `${name} County`);
 }
 function buildParcelLookupDeepLink(endpoint, base = "https://urbankitstudio.com/tools/parcel-lookup") {
   const params = new URLSearchParams();

package/dist/index.d.cts

@@ -218,8 +218,9 @@ declare function findCountyByFips(fips: string): CountyRecord | undefined;
 declare function findState(stateSlug: string): StateFile | undefined;
 
 /**
- * List all 50 US states from the atlas index, including those without
- * populated county data yet (use the `populated` flag to filter).
+ * List all 50 US states and the District of Columbia from the atlas index,
+ * including those without populated county data yet (use the `populated` flag
+ * to filter).
  */
 declare function listStates(): StateIndexEntry[];
 

package/dist/index.d.ts

@@ -218,8 +218,9 @@ declare function findCountyByFips(fips: string): CountyRecord | undefined;
 declare function findState(stateSlug: string): StateFile | undefined;
 
 /**
- * List all 50 US states from the atlas index, including those without
- * populated county data yet (use the `populated` flag to filter).
+ * List all 50 US states and the District of Columbia from the atlas index,
+ * including those without populated county data yet (use the `populated` flag
+ * to filter).
  */
 declare function listStates(): StateIndexEntry[];
 

package/dist/index.js

@@ -15,10 +15,10 @@ var data_default = {
   version: "0.3.0",
   lastUpdated: "2026-09-26",
   totals: {
-    states: 50,
-    counties: 234,
-    endpoints: 246,
-    countiesWithEndpoint: 228,
+    states: 51,
+    counties: 235,
+    endpoints: 247,
+    countiesWithEndpoint: 229,
     countiesUnprobeable: 1
   },
   states: [
@@ -86,6 +86,14 @@ var data_default = {
       endpointCount: 1,
       populated: true
     },
+    {
+      slug: "district-of-columbia",
+      name: "District of Columbia",
+      abbrev: "DC",
+      countyCount: 1,
+      endpointCount: 1,
+      populated: true
+    },
     {
       slug: "florida",
       name: "Florida",
@@ -3117,6 +3125,60 @@ var delaware_default = {
   ]
 };
 
+// data/district-of-columbia.json
+var district_of_columbia_default = {
+  stateSlug: "district-of-columbia",
+  stateName: "District of Columbia",
+  stateAbbrev: "DC",
+  lastUpdated: "2026-09-26",
+  counties: [
+    {
+      id: "dc-district-of-columbia",
+      state: "DC",
+      stateName: "District of Columbia",
+      stateSlug: "district-of-columbia",
+      county: "District of Columbia",
+      countySlug: "district-of-columbia",
+      countyFips: "11001",
+      hasPublicRest: true,
+      endpoints: [
+        {
+          url: "https://maps2.dcgis.dc.gov/dcgis/rest/services/DCGIS_DATA/Property_and_Land_WebMercator/FeatureServer/40",
+          serviceType: "FeatureServer",
+          layerIndex: 40,
+          layerName: "Owner Polygons (Common Ownership Layer)",
+          supportsQuery: true,
+          corsEnabled: true,
+          searchFields: [
+            { name: "SSL", label: "Square, Suffix, Lot (Parcel ID)", searchable: true },
+            { name: "OWNERNAME", label: "Owner Name", searchable: true },
+            { name: "CAREOFNAME", label: "Care Of Name", searchable: false },
+            { name: "PREMISEADD", label: "Premise (Situs) Address", searchable: true },
+            { name: "ADDRESS1", label: "Owner Mailing Address", searchable: true },
+            { name: "ADDRESS2", label: "Owner Mailing Address 2", searchable: false },
+            { name: "CITYSTZIP", label: "Owner Mailing City/State/ZIP", searchable: true },
+            { name: "USECODE", label: "Use Code", searchable: false },
+            { name: "LANDAREA", label: "Land Area", searchable: false },
+            { name: "ASSESSMENT", label: "Assessment", searchable: false }
+          ],
+          sampleQuery: "https://maps2.dcgis.dc.gov/dcgis/rest/services/DCGIS_DATA/Property_and_Land_WebMercator/FeatureServer/40/query?where=OWNERNAME%20LIKE%20'SMITH%25'&outFields=SSL,OWNERNAME,PREMISEADD,ADDRESS1,CITYSTZIP&returnGeometry=false&f=json&resultRecordCount=10",
+          license: "open-data",
+          licenseUrl: "https://creativecommons.org/licenses/by/4.0/",
+          status: "live",
+          lastVerified: "2026-09-26",
+          verifiedBy: "manual"
+        }
+      ],
+      contact: {
+        department: "DC Office of the Chief Technology Officer (OCTO) GIS and Office of the Surveyor; data attributed daily from the Office of Tax and Revenue's Real Property Tax Administration (RPTA) Integrated Tax System Public Extract (ITSPE)",
+        url: "https://opendata.dc.gov/datasets/DCGIS::common-ownership-lots",
+        email: null
+      },
+      notes: "The District of Columbia is one county-equivalent (FIPS 11001) with no counties inside it. Layer 40, Owner Polygons (Common Ownership Layer), is the District's general ownership layer: 137,400 lot polygons merged from the Record, Tax, Parcel, Reservation and Air Rights lot layers and regenerated daily from the Office of Tax and Revenue's Integrated Tax System Public Extract (ITSPE). Layers 49 (District Land) and 50 (Federal Land) on the same service are narrower views of it. The parcel ID is the SSL (square, suffix, lot), written either as 'SQUARE SUFFIX LOT' (e.g. '1929    7056') or as 'PAR NNNNNNNN' for Parcel-type lots; both answer an SSL LIKE prefix search. The owner mailing address (ADDRESS1, ADDRESS2, CITYSTZIP) is separate from the premise address (PREMISEADD). Verified 2026-09-26: OWNERNAME LIKE 'SMITH%' returns 939 lots, and a PREMISEADD search returns individual homeowners alongside institutions.\n\nCoverage: the layer maps land, one polygon per lot. A condominium building is a single lot on it, and 3,921 of its 4,142 condominium lots carry no owner name, so an owner search finds lot owners, not unit owners. The tax extract published on the same service lists 221,622 records; unit-level condominium data sits in separate tables there, which this layer does not join. The service's ArcGIS Online item (Common Ownership Lots, item 1f6708b1f3774306bef2fa81e612a725, owner DCGISopendata) licenses the data under Creative Commons Attribution 4.0 International, so reuse credits the District of Columbia; the District's open-data terms apply CC0 only where no other license is noted, and this item notes one. OTR's Real Property Public Extract is a different product: a bulk file restricted to mortgage companies."
+    }
+  ]
+};
+
 // data/florida.json
 var florida_default = {
   stateSlug: "florida",
@@ -21878,6 +21940,7 @@ var POPULATED_STATES = {
   colorado: colorado_default,
   connecticut: connecticut_default,
   delaware: delaware_default,
+  "district-of-columbia": district_of_columbia_default,
   florida: florida_default,
   georgia: georgia_default,
   hawaii: hawaii_default,
@@ -21967,10 +22030,10 @@ function listCountiesByState(stateSlug) {
 function slugify(s) {
   return s.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
 }
+var COUNTY_UNIT_SUFFIX = /\b(?:County|Parish|Borough|Municipality|Census Area|City|Statewide|Planning Region|District of Columbia)$/i;
 function countySlugFromName(county) {
-  const lc = county.toLowerCase();
-  const hasSuffix = lc.endsWith(" county") || lc.endsWith(" parish") || lc.endsWith(" borough") || lc.endsWith(" census area");
-  return slugify(hasSuffix ? county : `${county} County`);
+  const name = county.trim();
+  return slugify(COUNTY_UNIT_SUFFIX.test(name) ? name : `${name} County`);
 }
 function buildParcelLookupDeepLink(endpoint, base = "https://urbankitstudio.com/tools/parcel-lookup") {
   const params = new URLSearchParams();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@urbankitstudio/atlas",
-  "version": "0.6.8",
-  "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 234 counties across all 50 US states, 246 verified public ArcGIS REST endpoints for county parcel data, with searchable field metadata, sample queries and license info.",
+  "version": "0.6.9",
+  "description": "JS SDK for the UrbanKit County Parcel REST API Atlas: 235 counties across all 50 US states and DC, 247 verified public ArcGIS REST endpoints for county parcel data, with searchable field metadata, sample queries and license info.",
   "keywords": [
     "parcel",
     "arcgis",