/**
 * @copyright Sister Software.
 * @license AGPL-3.0
 * @author Teffen Ellis, et al.
 *
 *   TIGER Census data utilities.
 */
import type { AdminLevel1Code } from "./state.ts";
/**
 * Census TIGER levels for geographic data.
 *
 * @category Census
 */
export declare const TIGERLevel: {
    readonly State: "us_state";
    readonly County: "county";
    readonly CountySubdivision: "cousub";
    readonly Tract: "tract";
    readonly BlockGroup: "bg";
    readonly Block: "tabblock20";
};
export type TIGERLevel = (typeof TIGERLevel)[keyof typeof TIGERLevel];
/**
 * File extension for TIGER data files.
 *
 * @category Census
 */
export declare const TIGERFileExtension: {
    /**
     * Feature geometry, i.e. the shape of the geographic area.
     */
    readonly Shape: ".shp";
    /**
     * Index of the feature geometry for quick access.
     */
    readonly Index: ".shx";
    /**
     * Tabular attribute metadata.
     */
    readonly Attributes: ".dbf";
    /**
     * Coordinate system information. Describes the projection of the geographic data.
     */
    readonly Projection: ".prj";
    /**
     * Federal Geographic Data Committee (FGDC) metadata.
     */
    readonly FGDCMetadata: ".shp.xml";
    /**
     * International Organization for Standardization (ISO 191) metadata.
     */
    readonly ISOMetadata: ".shp.iso.xml";
    /**
     * ISO 191 (entity and attribute) metadata.
     */
    readonly EntityAttributeMetadata: ".shp.ea.iso.xml";
    /**
     * Compressed ZIP archive.
     */
    readonly Zip: ".zip";
    readonly None: "";
};
export type TIGERFileExtension = (typeof TIGERFileExtension)[keyof typeof TIGERFileExtension];
/**
 * Order of TIGER levels for processing, from largest to smallest.
 */
export declare const TIGERLevelOrder: ["us_state", "tract", "cousub", "bg", "tabblock20"];
/**
 * The current TIGER vintage.
 *
 * @category Census
 * @internal
 */
export declare const TIGERCurrentVintage = 2023;
export type TIGERCurrentVintage = typeof TIGERCurrentVintage;
/**
 * Type-helper for TIGER feature geometry file names.
 *
 * @category Census
 */
export type TIGERStateLevelFileName<SFC extends AdminLevel1Code, Level extends TIGERLevel, FileExtension extends TIGERFileExtension, Vintage extends number = TIGERCurrentVintage> = `tl_${Vintage}_${SFC}_${Level}${FileExtension}`;
/**
 * Template function to generate a TIGER file name.
 */
export declare function TIGERStateLevelFileName<SFC extends AdminLevel1Code, Level extends TIGERLevel, FileExtension extends TIGERFileExtension, Vintage extends number = TIGERCurrentVintage>(stateFIPSCode: SFC, level: Level, fileExtension: FileExtension, vintage?: Vintage): `tl_${Vintage}_${SFC}_${Level}${FileExtension}`;
export type TIGERStateLevelZIPPath<SFC extends AdminLevel1Code, Level extends TIGERLevel, Vintage extends number = TIGERCurrentVintage> = `/geo/tiger/TIGER${Vintage}/${Uppercase<Level>}/${TIGERStateLevelFileName<SFC, Level, typeof TIGERFileExtension.Zip, Vintage>}`;
/**
 * Template function to generate a TIGER ZIP file path.
 */
export declare function TIGERStateLevelZIPPath<SFC extends AdminLevel1Code, Level extends TIGERLevel, Vintage extends number = TIGERCurrentVintage>(stateFIPSCode: SFC, level: Level, vintage?: Vintage): `/geo/tiger/TIGER${Vintage}/${Uppercase<Level>}/tl_${Vintage}_${SFC}_${Level}.zip`;
/**
 * Template function to generate a TIGER ZIP file path.
 */
export declare function TIGERNationZIPPath<Vintage extends number = TIGERCurrentVintage>(vintage?: Vintage): `/geo/tiger/TIGER${Vintage}/STATE/tl_${Vintage}_us_state.zip`;
/**
 * A TIGER manifest for a specific state at a specific level of detail.
 *
 * @category Census
 */
export interface TIGERLevelManifest<SFC extends AdminLevel1Code, Level extends TIGERLevel, Vintage extends number = number> {
    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 declare function TIGERLevelManifest<SFC extends AdminLevel1Code, Level extends TIGERLevel, Vintage extends number = TIGERCurrentVintage>(stateFIPSCode: SFC, level: Level, vintage?: Vintage): TIGERLevelManifest<SFC, Level, Vintage>;
/**
 * A full TIGER manifest for a specific state.
 */
export interface TIGERStateManifest<SFC extends AdminLevel1Code, Vintage extends number = TIGERCurrentVintage> {
    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 declare function TIGERStateManifest<SFC extends AdminLevel1Code, Vintage extends number = TIGERCurrentVintage>(stateFIPSCode: SFC, vintage?: Vintage): TIGERStateManifest<SFC, Vintage>;
//# sourceMappingURL=files.d.ts.map