@mailwoman/tiger 5.9.0 → 5.10.0

package/constants.ts

@@ -4,8 +4,8 @@
  * @author Teffen Ellis, et al.
  */
 
-import { TIGERClassCode } from "./class-code.js"
-import { TIGERFunctionalStatus } from "./functional-status.js"
+import { TIGERClassCode } from "./class-code.ts"
+import { TIGERFunctionalStatus } from "./functional-status.ts"
 import {
 	type FIPSBlockCode,
 	type FIPSBlockGroupCode,
@@ -15,9 +15,9 @@ import {
 	type FIPSPlaceCode,
 	type FIPSTractCode,
 	GeoIDPart,
-} from "./geoid.js"
-import { LegalStatisticalAreaDescription } from "./legal-statistical-area.js"
-import { FIPSStateCode } from "./state.js"
+} from "./geoid.ts"
+import { LegalStatisticalAreaDescription } from "./legal-statistical-area.ts"
+import { FIPSStateCode } from "./state.ts"
 
 /**
  * A code indicating the classification of the block, i.e. urban or rural.
@@ -27,84 +27,91 @@ import { FIPSStateCode } from "./state.js"
  * @minLength 1
  * @maxLength 1
  */
-export enum TIGERGeographicClassification {
-	Urban = "U",
-	Rural = "R",
-}
+export const TIGERGeographicClassification = {
+	Urban: "U",
+	Rural: "R",
+} as const
+
+export type TIGERGeographicClassification =
+	(typeof TIGERGeographicClassification)[keyof typeof TIGERGeographicClassification]
 
 /**
  * @title Land/Water Block Type
  *
  * A code indicating the type of feature represented by the land/water block.
  */
-export enum LandWaterBlockType {
+export const LandWaterBlockType = {
 	/**
 	 * Block is land.
 	 */
-	Land = "L",
+	Land: "L",
 	/**
 	 * Block is water.
 	 */
-	Water = "W",
-}
+	Water: "W",
+} as const
+
+export type LandWaterBlockType = (typeof LandWaterBlockType)[keyof typeof LandWaterBlockType]
 
 /**
  * @title TIGER Property
  */
-export enum TIGERProperty {
+export const TIGERProperty = {
 	/**
 	 * @title Geographic Identifier
 	 */
-	GeoID = "GEOID",
+	GeoID: "GEOID",
 	/**
 	 * @title Display Name
 	 */
-	DisplayName = "display_name",
+	DisplayName: "display_name",
 	/**
 	 * @title Urban/Rural Code
 	 */
-	UrbanRuralCode = "urban_rural_code",
+	UrbanRuralCode: "urban_rural_code",
 	/**
 	 * @title Urban Area Code
 	 */
-	UrbanizedAreaCode = "urbanized_area_code",
+	UrbanizedAreaCode: "urbanized_area_code",
 	/**
 	 * @title Land Area (square meters)
 	 */
-	LandAreaSqm = "land_area_sqm",
+	LandAreaSqm: "land_area_sqm",
 	/**
 	 * @title Water Area (square meters)
 	 */
-	WaterAreaSqm = "water_area_sqm",
+	WaterAreaSqm: "water_area_sqm",
 	/**
 	 * @title Housing Unit Count
 	 */
-	HousingUnitCount = "housing_unit_count",
+	HousingUnitCount: "housing_unit_count",
 	/**
 	 * @title Population Count
 	 */
-	Population = "population",
+	Population: "population",
 	/**
 	 * @title Functional Status
 	 */
-	FunctionalStatus = "functional_status",
+	FunctionalStatus: "functional_status",
 	/**
 	 * @title Centroid Latitude
 	 */
-	CentroidLatitude = "latitude",
+	CentroidLatitude: "latitude",
 	/**
 	 * @title Centroid Longitude
 	 */
-	CentroidLongitude = "longitude",
+	CentroidLongitude: "longitude",
 	/**
 	 * @title Legal/Statistical Area Description
 	 */
-	LegalStatisticalAreaDescription = "legal_statistical_area_description",
+	LegalStatisticalAreaDescription: "legal_statistical_area_description",
 	/**
 	 * @title MAF/TIGER Feature Class Code
 	 */
-	ClassCode = "class_code",
-}
+	ClassCode: "class_code",
+} as const
+
+export type TIGERProperty = (typeof TIGERProperty)[keyof typeof TIGERProperty]
 
 /**
  * Properties common to all Census.

package/county-subdivision.ts

@@ -4,10 +4,10 @@
  * @author Teffen Ellis, et al.
  */
 
-import type { TIGERClassCode } from "./class-code.js"
-import type { TIGERFunctionalStatus } from "./functional-status.js"
-import type { LegalStatisticalAreaDescription } from "./legal-statistical-area.js"
-import type { AdminLevel1Code } from "./state.js"
+import type { TIGERClassCode } from "./class-code.ts"
+import type { TIGERFunctionalStatus } from "./functional-status.ts"
+import type { LegalStatisticalAreaDescription } from "./legal-statistical-area.ts"
+import type { AdminLevel1Code } from "./state.ts"
 
 /**
  * Census Geographic subdivision of a county.

package/county.ts

@@ -4,10 +4,10 @@
  * @author Teffen Ellis, et al.
  */
 
-import { TIGERClassCode } from "./class-code.js"
-import { TIGERFunctionalStatus } from "./functional-status.js"
-import type { LegalStatisticalAreaDescription } from "./legal-statistical-area.js"
-import type { AdminLevel1Code } from "./state.js"
+import { TIGERClassCode } from "./class-code.ts"
+import { TIGERFunctionalStatus } from "./functional-status.ts"
+import type { LegalStatisticalAreaDescription } from "./legal-statistical-area.ts"
+import type { AdminLevel1Code } from "./state.ts"
 
 /**
  * @title TIGER County

package/files.ts

@@ -6,7 +6,7 @@
  *   TIGER Census data utilities.
  */
 
-import { AdminLevel1Code } from "./state.js"
+import { AdminLevel1Code } from "./state.ts"
 
 //#region Constants
 
@@ -15,57 +15,61 @@ import { AdminLevel1Code } from "./state.js"
  *
  * @category Census
  */
-export enum TIGERLevel {
-	State = "us_state",
-	County = "county",
-	CountySubdivision = "cousub",
-	Tract = "tract",
-	BlockGroup = "bg",
-	Block = "tabblock20",
-}
+export const TIGERLevel = {
+	State: "us_state",
+	County: "county",
+	CountySubdivision: "cousub",
+	Tract: "tract",
+	BlockGroup: "bg",
+	Block: "tabblock20",
+} as const
+
+export type TIGERLevel = (typeof TIGERLevel)[keyof typeof TIGERLevel]
 
 /**
  * File extension for TIGER data files.
  *
  * @category Census
  */
-export enum TIGERFileExtension {
+export const TIGERFileExtension = {
 	/**
 	 * Feature geometry, i.e. the shape of the geographic area.
 	 */
-	Shape = ".shp",
+	Shape: ".shp",
 	/**
 	 * Index of the feature geometry for quick access.
 	 */
-	Index = ".shx",
+	Index: ".shx",
 	/**
 	 * Tabular attribute metadata.
 	 */
-	Attributes = ".dbf",
+	Attributes: ".dbf",
 	/**
 	 * Coordinate system information. Describes the projection of the geographic data.
 	 */
-	Projection = ".prj",
+	Projection: ".prj",
 	/**
 	 * Federal Geographic Data Committee (FGDC) metadata.
 	 */
-	FGDCMetadata = ".shp.xml",
+	FGDCMetadata: ".shp.xml",
 	/**
 	 * International Organization for Standardization (ISO 191) metadata.
 	 */
-	ISOMetadata = ".shp.iso.xml",
+	ISOMetadata: ".shp.iso.xml",
 	/**
 	 * ISO 191 (entity and attribute) metadata.
 	 */
-	EntityAttributeMetadata = ".shp.ea.iso.xml",
+	EntityAttributeMetadata: ".shp.ea.iso.xml",
 
 	/**
 	 * Compressed ZIP archive.
 	 */
-	Zip = ".zip",
+	Zip: ".zip",
 
-	None = "",
-}
+	None: "",
+} as const
+
+export type TIGERFileExtension = (typeof TIGERFileExtension)[keyof typeof TIGERFileExtension]
 
 /**
  * Order of TIGER levels for processing, from largest to smallest.
@@ -126,7 +130,7 @@ export type TIGERStateLevelZIPPath<
 	SFC extends AdminLevel1Code,
 	Level extends TIGERLevel,
 	Vintage extends number = TIGERCurrentVintage,
-> = `/geo/tiger/TIGER${Vintage}/${Uppercase<Level>}/${TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.Zip, Vintage>}`
+> = `/geo/tiger/TIGER${Vintage}/${Uppercase<Level>}/${TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.Zip, Vintage>}`
 
 /**
  * Template function to generate a TIGER ZIP file path.
@@ -176,13 +180,18 @@ export interface TIGERLevelManifest<
 	Level extends TIGERLevel,
 	Vintage extends number = number,
 > {
-	Shape: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.Shape, Vintage>
-	Index: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.Index, Vintage>
-	Attributes: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.Attributes, Vintage>
-	Projection: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.Projection, Vintage>
-	FGDCMetadata: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.FGDCMetadata, Vintage>
-	ISOMetadata: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.ISOMetadata, Vintage>
-	EntityAttributeMetadata: TIGERStateLevelFileName<SFC, Level, TIGERFileExtension.EntityAttributeMetadata, Vintage>
+	Shape: TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.Shape, Vintage>
+	Index: TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.Index, Vintage>
+	Attributes: TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.Attributes, Vintage>
+	Projection: TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.Projection, Vintage>
+	FGDCMetadata: TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.FGDCMetadata, Vintage>
+	ISOMetadata: TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.ISOMetadata, Vintage>
+	EntityAttributeMetadata: TIGERStateLevelFileName<
+		SFC,
+		Level,
+		typeof TIGERFileExtension.EntityAttributeMetadata,
+		Vintage
+	>
 }
 
 export function TIGERLevelManifest<
@@ -222,10 +231,10 @@ export function TIGERLevelManifest<
  * A full TIGER manifest for a specific state.
  */
 export interface TIGERStateManifest<SFC extends AdminLevel1Code, Vintage extends number = TIGERCurrentVintage> {
-	Tract: TIGERLevelManifest<SFC, TIGERLevel.Tract, Vintage>
-	CountySubdivision: TIGERLevelManifest<SFC, TIGERLevel.CountySubdivision, Vintage>
-	BlockGroup: TIGERLevelManifest<SFC, TIGERLevel.BlockGroup, Vintage>
-	Block: TIGERLevelManifest<SFC, TIGERLevel.Block, Vintage>
+	Tract: TIGERLevelManifest<SFC, typeof TIGERLevel.Tract, Vintage>
+	CountySubdivision: TIGERLevelManifest<SFC, typeof TIGERLevel.CountySubdivision, Vintage>
+	BlockGroup: TIGERLevelManifest<SFC, typeof TIGERLevel.BlockGroup, Vintage>
+	Block: TIGERLevelManifest<SFC, typeof TIGERLevel.Block, Vintage>
 }
 
 export function TIGERStateManifest<SFC extends AdminLevel1Code, Vintage extends number = TIGERCurrentVintage>(

package/functional-status.ts

@@ -9,54 +9,56 @@
  *
  * @title TIGER Functional Status
  */
-export enum TIGERFunctionalStatus {
+export const TIGERFunctionalStatus = {
 	/**
 	 * Active government providing primary general-purpose functions. Active entity (federally recognized entities only).
 	 */
-	ActiveGovernment = "A",
+	ActiveGovernment: "A",
 	/**
 	 * Active government that is partially consolidated with another government but with separate officials providing
 	 * primary general-purpose functions.
 	 */
-	PartiallyConsolidatedActiveGovernment = "B",
+	PartiallyConsolidatedActiveGovernment: "B",
 	/**
 	 * Active government consolidated with another government with a single set of officials.
 	 */
-	ActiveGovernmentConsolidated = "C",
+	ActiveGovernmentConsolidated: "C",
 	/**
 	 * Active government providing special-purpose functions.
 	 */
-	ActiveGovernmentSpecialPurpose = "E",
+	ActiveGovernmentSpecialPurpose: "E",
 	/**
 	 * Fictitious entity created to fill the Census Bureau geographic hierarchy
 	 */
-	FictitiousEntity = "F",
+	FictitiousEntity: "F",
 	/**
 	 * Active government that is subordinate to another unit of government.
 	 */
-	SubordinateActiveGovernment = "G",
+	SubordinateActiveGovernment: "G",
 	/**
 	 * Inactive governmental unit that has the power to provide primary special-purpose functions.
 	 */
-	InActiveGovernmentalUnit = "I",
+	InActiveGovernmentalUnit: "I",
 	/**
 	 * Inactive, nonfunctioning legal real property entity with potential quasi-legal administrative functions.
 	 */
-	InactiveNonFunctioningLegalRealPropertyEntity = "L",
+	InactiveNonFunctioningLegalRealPropertyEntity: "L",
 	/**
 	 * Active legal real property entity with quasi-legal functions.
 	 */
-	ActiveLegalRealPropertyEntity = "M",
+	ActiveLegalRealPropertyEntity: "M",
 	/**
 	 * Non-functioning legal entity.
 	 */
-	NonFunctioningLegalEntity = "N",
+	NonFunctioningLegalEntity: "N",
 	/**
 	 * Statistical entity.
 	 */
-	StatisticalEntity = "S",
+	StatisticalEntity: "S",
 	/**
 	 * Active state-recognized entity.
 	 */
-	ActiveStateRecognizedEntity = "T",
-}
+	ActiveStateRecognizedEntity: "T",
+} as const
+
+export type TIGERFunctionalStatus = (typeof TIGERFunctionalStatus)[keyof typeof TIGERFunctionalStatus]

package/geoid.ts

@@ -6,7 +6,7 @@
 
 import type { Tagged } from "type-fest"
 
-import { AdminLevel1Code, FIPSStateCode } from "./state.js"
+import { AdminLevel1Code, FIPSStateCode } from "./state.ts"
 
 //#region Tagged FIPS types
 
@@ -210,46 +210,48 @@ export type FIPSCongressionalDistrictCode = Tagged<string, "FIPSConressionalDist
  *
  * @internal
  */
-export enum GeoIDPart {
+export const GeoIDPart = {
 	/**
 	 * The state code part of a GeoID.
 	 *
 	 * Sometimes considered the administrative area level 1 code.
 	 */
-	State = "state_code",
+	State: "state_code",
 	/**
 	 * The county code part of a GeoID.
 	 *
 	 * Sometimes considered the administrative area level 2 code.
 	 */
-	County = "county_code",
+	County: "county_code",
 	/**
 	 * The county subdivision code part of a GeoID.
 	 *
 	 * Sometimes considered the administrative area level 3 code.
 	 */
-	CountySubDivision = "county_sub_division_code",
+	CountySubDivision: "county_sub_division_code",
 	/**
 	 * The congressional district code part of a GeoID.
 	 */
-	CongressionalDistrict = "congressional_district_code",
+	CongressionalDistrict: "congressional_district_code",
 	/**
 	 * A place as defined by the Census, such as a city or town.
 	 */
-	Place = "place_code",
+	Place: "place_code",
 	/**
 	 * The tract code part of a GeoID. The third most granular part.
 	 */
-	Tract = "tract_code",
+	Tract: "tract_code",
 	/**
 	 * The block group code part of a GeoID. The second most granular part.
 	 */
-	BlockGroup = "block_group_code",
+	BlockGroup: "block_group_code",
 	/**
 	 * The block code part of a GeoID. The most granular part.
 	 */
-	Block = "block_code",
-}
+	Block: "block_code",
+} as const
+
+export type GeoIDPart = (typeof GeoIDPart)[keyof typeof GeoIDPart]
 
 /**
  * Mapping of GeoID parts to their respective FIPS codes types.

package/index.ts

@@ -4,15 +4,15 @@
  * @author Teffen Ellis, et al.
  */
 
-export * from "./block-group.js"
-export * from "./class-code.js"
-export * from "./constants.js"
-export * from "./county-subdivision.js"
-export * from "./county.js"
-export * from "./files.js"
-export * from "./functional-status.js"
-export * from "./geoid.js"
-export * from "./legal-statistical-area.js"
-export * from "./state.js"
-export * from "./tabulation-block.js"
-export * from "./tract.js"
+export * from "./block-group.ts"
+export * from "./class-code.ts"
+export * from "./constants.ts"
+export * from "./county-subdivision.ts"
+export * from "./county.ts"
+export * from "./files.ts"
+export * from "./functional-status.ts"
+export * from "./geoid.ts"
+export * from "./legal-statistical-area.ts"
+export * from "./state.ts"
+export * from "./tabulation-block.ts"
+export * from "./tract.ts"