UNPKG

@freeword/meta

Version:

Meta package for Freeword: exports all core types, constants, and utilities from the src/ directory.

74 lines 3.58 kB
import type { ExtError } from '../types.ts'; export interface PathinfoDNA { barename: string; fext: string; dirpath: string; abspath?: string; } export interface PathinfoT { barename: string; fext: string; dirpath: string; abspath: string; ok: true; } export type CoreFileGist = 'badPath' | 'badInput' | 'blankPath' | 'parseErr' | 'pathErr' | 'fsErr'; export type CoreReadGist = CoreFileGist | 'readErr' | 'fileNotFound' | 'decompressErr' | 'consumeErr'; export type CoreWriteGist = CoreFileGist | 'writeErr'; export type FilerGist = 'ok' | CoreReadGist | CoreWriteGist | 'callerErr' | 'storageErr' | 'otherErr' | 'badStorekeyErr' | 'mistypeErr' | 'stringifyErr' | 'skipped' | 'noLocalStorageErr' | 'noBrowser' | 'ready'; export interface FilerResult<VT = any> extends Omit<Partial<PathinfoT>, 'ok'> { ok: boolean; gist?: FilerGist; val?: VT; err?: ExtError; raw?: any; tmi?: Record<string, any>; } /** Absolute pathstring (starts at the root directory, all symlinks resolved) */ export type Abspath = string; /** Absolute directory pathstring (starts at the root directory, all symlinks resolved, is a directory) */ export type Dirpath = string; /** A relative pathstring (may or may not be absolute) */ export type Relpath = string; /** The bare basename of a path, without the extension or directory; this should be the filename with the elements following the last dot removed (after first removing any compression extension eg. `.gz`) */ export type Barename = string; /** The extension of a filename, without the dot; this should have all letters following the last dot, including a compression extension eg. `.gz` */ export type Fext = string; /** The basename of a path, including the extension, without the directory */ export type Basename = string; /** A pathstring, absolute or relative */ export type Pathname = Relpath | Abspath; /** A pathstring or a partial pathinfo */ export type Anypath = PathinfoDNA | Pathname; export interface GoodFilerResult<VT = any> extends FilerResult<VT> { ok: true; gist: 'ok'; val: VT; } export interface GoodFilerPathedResult<VT = any> extends Omit<GoodFilerResult<VT>, keyof PathinfoT>, Omit<PathinfoT, 'ok'> { ok: true; } export interface BadFilerResult<GT extends FilerGist = FilerGist> extends FilerResult<never> { ok: false; gist: GT; err: ExtError; val?: never; origmsg?: string; } export interface GoodFilerReadResult<VT = PathinfoT> extends GoodFilerPathedResult<VT> { } export interface BadFilerReadResult<GT extends CoreReadGist> extends BadFilerResult<GT> { } export interface GoodFilerWriteResult<VT = PathinfoT> extends GoodFilerPathedResult<VT> { } export interface BadFilerWriteResult<GT extends CoreWriteGist> extends BadFilerResult<GT> { } export interface GoodFilerMkdirResult extends GoodFilerPathedResult<PathinfoT> { } export interface BadFilerMkdirResult extends BadFilerResult<'fsErr' | 'badPath' | 'badInput' | 'blankPath'> { } export type FilerOtherResult<VT = any, GT extends FilerGist = FilerGist> = GoodFilerResult<VT> | BadFilerResult<GT>; export type FilerReadResult<VT = PathinfoT, GT extends CoreReadGist = CoreReadGist, AlsoVT extends object = {}> = GoodFilerReadResult<VT> & AlsoVT | BadFilerReadResult<GT>; export type FilerWriteResult<VT = PathinfoT, GT extends CoreWriteGist = CoreWriteGist, AlsoVT extends object = {}> = GoodFilerWriteResult<VT> & AlsoVT | BadFilerWriteResult<GT>; export type FilerMkdirResult = GoodFilerMkdirResult | BadFilerMkdirResult; //# sourceMappingURL=FilerTypes.d.ts.map