@nonext/husk 0.2.3

package/api/public-api.md

@@ -0,0 +1,1070 @@
+# `@nonext/husk` public API
+
+Generated by `pnpm --filter @nonext/husk api`. Do not edit by hand.
+
+Every line here is a promise to every consuming project. A diff in this file is a public
+API change and needs a changeset saying whether it is patch, minor, or breaking.
+`packages/cms/src/public-api.test.ts` fails while this file and the source disagree, and
+the `api-review` CI job fails when a pull request changes it without a changeset.
+
+**976 exported names across 12 entry points.**
+
+## `@nonext/husk`
+
+323 exports.
+
+```ts
+export type Action = EntryAction | AdminAction
+const ACTIONS: ReadonlyArray<Action>
+function addField: (type: ContentTypeLike, key: string, field: FieldDefinition) => ContentTypeLike
+const ADMIN_ACTIONS: readonly ["manage-schema", "manage-users", "manage-settings", "manage-media"]
+export type AdminAction = "manage-schema" | "manage-users" | "manage-settings" | "manage-media"
+const ALLOWED_MEDIA_TYPES: ReadonlyArray<MediaTypeRule>
+export type AnyContentTypeShape = { fields: FieldMap }
+export type AnyFieldTypeSpec = FieldTypeSpec<any, any>
+function applyPlan: (plan: readonly EntryMigration[], values: Record<string, unknown>, context: Omit<MigrationContext, "fromVersion">) => Record<string, unknown>
+function approximateBytes: (value: unknown) => number
+function assertDeletable: (type: KindShape) => void
+function assertListable: (type: KindShape) => void
+function assertSchemaWritable: (registry: Registry, slug: string) => RegistryEntry
+function assertSingletonCreatable: (type: KindShape, exists: boolean) => void
+function assertSingletonEntryId: (type: KindShape, entryId: string) => void
+function assertTypeSlugAvailable: (registry: Registry, slug: string) => void
+function assertValidContentType: (definition: { slug: string; kind: unknown; fields: FieldMap; removedFields?: RemovedFieldMap | undefined; titleField?: string | undefined; defaultSort?: { field: string; direction: "asc" | "desc"; } | undefined; permissions?: unknown; }) => void
+function assertValidPermissionMatrix: (slug: string, matrix: unknown) => void
+export interface AuthUser { uid: string email: string displayName: string | null role: Role disabled: boolean }
+export interface BooleanField extends FieldCommon { type: "boolean" defaultValue?: boolean }
+function buildCountQuery: (type: ContentTypeLike, state: ListViewState) => Pick<ListQuery, "filters" | "status" | "search">
+function buildListQuery: (type: ContentTypeLike, state: ListViewState, { pageSize }?: BuildListQueryOptions) => ListQuery
+export interface BuildListQueryOptions { pageSize?: number }
+function buildRegistry: (code: readonly ContentTypeLike[], database: readonly ContentTypeLike[]) => Registry
+function can: (user: AuthUser, action: Action, context?: PermissionContext) => boolean
+function canSaveEntry: (user: AuthUser, type: ContentTypeLike, entry: StatusSubject | null) => boolean
+function canSearch: (type: ContentTypeLike) => boolean
+function checkFieldKey: (type: ContentTypeLike, key: string) => FieldKeyAvailability
+function checkMediaFile: (file: MediaFileFacts) => MediaRejection | null
+function checkNestedFieldKey: (fields: FieldMap, key: string) => FieldKeyAvailability
+function checkTypeSlug: (registry: Registry, slug: string) => SlugAvailability
+function checkWritePayload: (values: Record<string, unknown>, limits?: PayloadLimits) => WriteLimitRejection | null
+export interface ClassifiedError { category: ErrorCategory treatment: ErrorTreatment title: string message: string fieldErrors: readonly FieldError[] retryable: boolean cause: unknown }
+function classifyError: (thrown: unknown, context?: ErrorContext) => ClassifiedError
+export type Clock = () => number
+export interface Cms<TTypes extends ContentTypeMap = ContentTypeMap> { collection<TSlug extends SlugOf<TTypes>>( slug: TSlug, ): CollectionReader<EntryOf<TTypes, TSlug>> single<TSlug extends SlugOf<TTypes>>(slug: TSlug): SingleReader<EntryOf<TTypes, TSlug>> media(): MediaReader settings(): SettingsReader readonly isPreview: boolean }
+export interface CmsAdapter { list(slug: string, query?: ListQuery): Promise<Page<Entry>> get(slug: string, entryId: string): Promise<Entry | null> getBySlug( slug: string, value: string, options?: Pick<ListQuery, "status">, ): Promise<Entry | null> getSingle(slug: string): Promise<Entry | null> create(slug: string, input: EntryInputData): Promise<Entry> update(slug: string, entryId: string, input: EntryInputData): Promise<Entry> delete(slug: string, entryId: string): Promise<void> count( slug: string, query?: Pick<ListQuery, "filters" | "status" | "search">, ): Promise<number> readonly media: MediaAdapter readonly schemas: SchemaAdapter readonly fieldData: FieldDataAdapter readonly migrations: MigrationAdapter readonly settings: SettingsAdapter }
+export interface CmsConfig< TTypes extends ContentTypeMap = ContentTypeMap, > extends CmsReadConfig<TTypes> { preview?: boolean }
+export type CmsCountQuery = Pick<CmsQuery, "filters" | "search">
+export type CmsQuery = Omit<ListQuery, "status">
+export interface CmsReadConfig<TTypes extends ContentTypeMap = ContentTypeMap> { adapter: CmsAdapter contentTypes?: TTypes }
+export interface CollectionReader<TEntry = Entry> { findMany(query?: CmsQuery): Promise<Page<TEntry>> findBySlug(value: string): Promise<TEntry | null> findById(entryId: string): Promise<TEntry | null> count(query?: CmsCountQuery): Promise<number> }
+function collectMediaIds: (data: Record<string, unknown>) => string[]
+export type ColumnAlign = "text" | "numeric" | "date"
+export type ColumnKind = "title" | "field" | "status" | "updated"
+function confirmationMatches: (expected: string, typed: string) => boolean
+export interface ContentType<TFields extends FieldMap = FieldMap> { slug: string kind: ContentTypeKind label: string labelPlural?: string description?: string icon?: string fields: TFields fieldOrder?: readonly string[] removedFields?: RemovedFieldMap locked?: boolean titleField?: keyof TFields & string defaultSort?: { field: keyof TFields & string; direction: "asc" | "desc" } permissions?: PermissionMatrix schemaVersion?: number }
+export type ContentTypeInputValues<TType extends { fields: FieldMap }> = FieldInputValues< TType["fields"] >
+export type ContentTypeKind = "collection" | "singleton"
+export interface ContentTypeLike { slug: string kind: ContentTypeKind label: string labelPlural?: string description?: string icon?: string fields: FieldMap fieldOrder?: readonly string[] removedFields?: RemovedFieldMap locked?: boolean titleField?: string defaultSort?: { field: string; direction: "asc" | "desc" } permissions?: PermissionMatrix schemaVersion?: number }
+export type ContentTypeMap = { readonly [slug: string]: KindShape & AnyContentTypeShape }
+export type ContentTypeSource = "code" | "database"
+function contentTypeTag: (slug: string) => string
+export type ContentTypeValues<TType extends { fields: FieldMap }> = FieldValues< TType["fields"] >
+function createCMS: <TTypes extends ContentTypeMap = ContentTypeMap>(config: CmsConfig<TTypes>) => Cms<TTypes>
+function createContentType: (registry: Registry, input: NewContentTypeInput) => ContentTypeLike
+function createMigrationRegistry: (migrations: readonly EntryMigration[]) => MigrationRegistry
+function createRegistryStore: (code: readonly ContentTypeLike[], initialDatabase?: readonly ContentTypeLike[]) => RegistryStore
+function createWriteRateLimiter: (clock?: Clock) => WriteRateLimiter
+export interface DateField extends FieldCommon { type: "date" precision?: "date" | "datetime" }
+export type Decision = "allow" | "deny" | "own-entry-only"
+const DEFAULT_PAGE_SIZE: 25
+function defaultListSort: (type: ContentTypeLike) => SortSpec
+function defaultRoles: (action: EntryAction) => readonly Role[]
+function defineContentType: <const TFields extends FieldMap>(definition: ContentType<TFields>) => ContentType<TFields>
+function deleteConfirmationName: (type: ContentTypeLike, entry: Entry) => string
+function deleteConfirmationPhrase: (type: ContentTypeLike, count: number) => string
+function deniedError: (what: string, role: Role | undefined) => ClassifiedError
+function draftIssues: (registry: FieldTypeRegistry, rows: readonly FieldRow[]) => readonly (FieldOptionIssue & { key: string; })[]
+export type Entry<TType extends AnyContentTypeShape = AnyContentTypeShape> = EntryMeta & ContentTypeValues<TType>
+const ENTRY_ACTIONS: readonly ["read", "create", "update", "delete"]
+const ENTRY_COLLECTION_GROUP: "entries"
+const ENTRY_STATUSES: readonly ["draft", "published", "archived"]
+export type EntryAction = "read" | "create" | "update" | "delete"
+function entryChangedSince: (baseline: Pick<EntryMeta, "updatedAt">, current: Pick<EntryMeta, "updatedAt">) => boolean
+export interface EntryFilter { field: string op: FilterOperator value: unknown }
+export type EntryInput<TType extends AnyContentTypeShape = AnyContentTypeShape> = ContentTypeInputValues<TType> & { status?: EntryStatus }
+export interface EntryInputData { values: Record<string, unknown> status?: EntryStatus }
+export interface EntryMeta { id: string status: EntryStatus createdAt: string createdBy: string updatedAt: string updatedBy: string publishedAt: string | null schemaVersion: number }
+export interface EntryMigration { slug: string from: number to: number describe: string migrate( values: Record<string, unknown>, context: MigrationContext, ): Record<string, unknown> }
+export type EntryOf< TTypes extends ContentTypeMap, TSlug extends string, > = TSlug extends keyof TTypes ? Entry<TTypes[TSlug]> : Entry
+export type EntryOwnership = Pick<EntryMeta, "createdBy">
+function entrySlugTag: (slug: string, value: string) => string
+export type EntryStatus = (typeof ENTRY_STATUSES)[number]
+function entryTag: (slug: string, entryId: string) => string
+function entryTags: (slug: string, entryId: string) => readonly string[]
+function entryTitle: (type: ContentTypeLike, entry: Entry) => string
+function entryUniqueCheck: (options: EntryUniqueOptions) => (path: string, value: string) => Promise<boolean>
+export interface EntryUniqueOptions { adapter: CmsAdapter type: ContentTypeLike entryId: string | null }
+const ERROR_CATEGORIES: readonly ["validation", "permission", "not-found", "conflict", "transport", "unknown"]
+export type ErrorCategory = (typeof ERROR_CATEGORIES)[number]
+export interface ErrorContext { role?: Role | undefined action?: string | undefined subject?: string | undefined }
+export type ErrorOrigin = "client" | "server"
+function errorsUnder: <TError extends FieldError>(errors: readonly TError[], path: string) => TError[]
+export type ErrorTreatment = "field" | "banner" | "state" | "resolve" | "retry"
+const FALLBACK_SORT: SortSpec
+const FIELD_TYPES: readonly ["text", "textarea", "number", "boolean", "select", "date", "slug", "richtext", "image", "file", "relation", "repeater"]
+export interface FieldDataAdapter { count(slug: string, key: string): Promise<number> purge(slug: string, key: string, options?: FieldPurgeOptions): Promise<FieldPurgeResult> }
+export type FieldDefinition = | TextField | TextareaField | NumberField | BooleanField | SelectField | DateField | SlugField | RichtextField | ImageField | FileField | RelationField | RepeaterField
+export interface FieldEditorSpec { label: string description: string rules: readonly (keyof ValidationRules)[] options: readonly FieldOptionDescriptor[] defaults: Record<string, unknown> }
+export interface FieldError { path: string rule: string message: string }
+export type FieldInputComponent< TValue, TField extends FieldDefinition = FieldDefinition, > = ComponentType<FieldInputProps<TValue, TField>>
+export interface FieldInputProps< TValue, TField extends FieldDefinition = FieldDefinition, > { path: string field: TField value: TValue | null onChange: (value: TValue | null) => void onBlur?: (() => void) | undefined errors: readonly FieldError[] disabled?: boolean | undefined readonly?: boolean | undefined }
+export type FieldInputValues<TFields extends FieldMap> = { [K in keyof TFields as IsRequired<TFields[K]> extends true ? K : never]: FieldValue< TFields[K] > } & { [K in keyof TFields as IsRequired<TFields[K]> extends true ? never : K]?: FieldValue< TFields[K] > | null }
+export interface FieldKeyAvailability { available: boolean reason?: FieldKeyRejection message?: string }
+export type FieldKeyRejection = "invalid" | "reserved" | "live" | "removed"
+function fieldKeyState: (type: ContentTypeLike, key: string) => FieldKeyState
+export type FieldKeyState = "free" | "live" | "removed"
+export type FieldMap = { readonly [key: string]: FieldDefinition }
+function fieldMapSignature: (fields: FieldMap) => string
+export type FieldOptionControl = | "text" | "number" | "boolean" | "choice" | "select-options" | "content-type" | "field-key" | "string-list" | "fields"
+export interface FieldOptionDescriptor { key: string label: string control: FieldOptionControl help?: string required?: boolean choices?: readonly { value: string; label: string }[] }
+export interface FieldOptionIssue { option: string message: string }
+function fieldOptionIssues: (registry: FieldTypeRegistry, field: FieldDefinition) => readonly FieldOptionIssue[]
+export interface FieldPurgeOptions { limit?: number }
+export interface FieldPurgeResult { purged: number remaining: boolean }
+export interface FieldRow { key: string field: FieldDefinition }
+export type FieldTsType<TField extends FieldDefinition = FieldDefinition> = string | ((field: TField, resolve: TsTypeResolver) => string)
+export type FieldType = (typeof FIELD_TYPES)[number]
+export interface FieldTypeRegistry { get(name: string): AnyFieldTypeSpec | undefined require(name: string): AnyFieldTypeSpec has(name: string): boolean readonly names: readonly FieldType[] }
+export interface FieldTypeSpec<TValue, TField extends FieldDefinition = FieldDefinition> { name: FieldType toStored(value: TValue | null, field: TField, nested?: NestedConverter): unknown fromStored(raw: unknown, field: TField, nested?: NestedConverter): TValue | null Input: FieldInputComponent<TValue, TField> validate( value: TValue | null, rules: ValidationRules, ctx: ValidateCtx, field: TField, ): FieldError[] tsType: FieldTsType<TField> defaultValue(field: TField): TValue | null editor: FieldEditorSpec }
+export type FieldValue<TField extends FieldDefinition> = TField extends TextField | TextareaField | SlugField ? string : TField extends NumberField ? number : TField extends BooleanField ? boolean : TField extends DateField ? string : TField extends SelectField<infer TOption> ? TField extends { multiple: true } ? TOption[] : TOption : TField extends RichtextField ? RichTextValue : TField extends ImageField | FileField ? MediaReference : TField extends RelationField ? TField extends { many: true } ? string[] : string : TField extends RepeaterField<infer TFields> ? FieldValues<TFields>[] : never
+export type FieldValues<TFields extends FieldMap> = { [K in keyof TFields]: IsRequired<TFields[K]> extends true ? FieldValue<TFields[K]> : FieldValue<TFields[K]> | null }
+function fileExtension: (name: string) => string
+export interface FileField extends FieldCommon { type: "file" accept?: readonly string[] }
+export type FilterOperator = | "==" | "!=" | "<" | "<=" | ">" | ">=" | "in" | "not-in" | "array-contains" | "array-contains-any"
+const FIRESTORE_DOCUMENT_BYTES: 1048576
+export interface FirestoreIndex { collectionGroup: string queryScope: "COLLECTION" fields: readonly FirestoreIndexField[] }
+export interface FirestoreIndexField { fieldPath: string order: IndexOrder }
+function forgetRemovedField: (type: ContentTypeLike, key: string) => ContentTypeLike
+export interface FormField { key: string field: FieldDefinition }
+function formFields: (type: ContentTypeLike) => readonly FormField[]
+export interface FormIssue extends FieldError { origin: ErrorOrigin }
+function formValuesFromEntry: (type: ContentTypeLike, entry: Entry, registry: FieldTypeRegistry) => Record<string, unknown>
+const HUSK_TAG_PREFIX: "husk"
+export interface HuskConfig { generatedWith: string adminRoute: string projectId: string storageBucket: string media: boolean auth: boolean emulators: boolean }
+export interface ImageField extends FieldCommon { type: "image" accept?: readonly string[] }
+function indexCovered: (file: { indexes?: readonly FirestoreIndex[]; }, required: FirestoreIndex) => boolean
+export type IndexOrder = "ASCENDING" | "DESCENDING"
+const INITIAL_FIELD_KEY: "title"
+const INITIAL_SCHEMA_VERSION: 1
+function initialFormValues: (type: ContentTypeLike, registry: FieldTypeRegistry) => Record<string, unknown>
+function initialListState: (type: ContentTypeLike) => ListViewState
+export interface InvalidContentType { slug: string reason: string definition: unknown }
+function isCollection: (type: KindShape) => boolean
+function isEntryAction: (action: Action) => action is EntryAction
+function isFilterableField: (field: FieldDefinition) => boolean
+function isHuskTag: (value: string) => boolean
+function isNarrowed: (state: ListViewState) => boolean
+function isSchemaReadOnly: (entry: RegistryEntry) => boolean
+function isSearching: (state: ListViewState) => boolean
+function isSingleton: (type: KindShape) => boolean
+export type KnownSlug<TTypes extends ContentTypeMap> = keyof TTypes & string
+export interface ListColumn { key: string label: string kind: ColumnKind align: ColumnAlign sortable: boolean }
+export interface ListColumnOptions { maxFieldColumns?: number }
+function listColumns: (type: ContentTypeLike, { maxFieldColumns }?: ListColumnOptions) => readonly ListColumn[]
+export interface ListFilterDescriptor { key: string label: string options: readonly ListFilterOption[] op: EntryFilter["op"] valueType: "string" | "boolean" }
+export interface ListFilterOption { value: string label: string }
+function listFilterQuery: (type: ContentTypeLike, filters: Readonly<Record<string, string>>) => readonly EntryFilter[]
+function listFilters: (type: ContentTypeLike) => readonly ListFilterDescriptor[]
+export interface ListQuery { filters?: readonly EntryFilter[] sort?: SortSpec search?: string limit?: number cursor?: string | null status?: EntryStatus | "any" }
+export interface ListViewState { search: string status: EntryStatus | "any" filters: Readonly<Record<string, string>> sort: SortSpec cursor: string | null }
+export class LockedTypeError extends Error { override readonly name = "LockedTypeError" readonly slug: string constructor(slug: string, reason?: string) { super( reason ?? `Content type "${slug}" is locked. It is defined in code and cannot be changed through the Schema Builder or the adapter.`, ) this.slug = slug } }
+const MATRIX_ACTIONS: ReadonlyArray<EntryAction>
+const MATRIX_LIMITS: { readonly admin: "An admin is never restricted by a matrix. Removing every other role from an action leaves it admin-only; there is no way to lock an admin out of their own project."; readonly ownership: "An author may only ever update or delete entries they created. Ticking an author here grants the action on their own entries, never on somebody else's."; readonly narrowing: "A matrix can only take permissions away. Ticking a role that its own role does not grant changes nothing, and the row says so."; readonly publicRead: "Denying read hides entries from the admin, not from the public website. A published entry is readable by anyone with its address by design; unpublish it to take it down."; }
+export interface MatrixCell { role: Role listed: boolean decision: MatrixDecision fixed: boolean }
+function matrixDecision: (type: Pick<ContentTypeLike, "permissions"> | undefined, role: Role, action: EntryAction) => MatrixDecision
+export type MatrixDecision = Decision
+export interface MatrixRow { action: EntryAction cells: readonly MatrixCell[] }
+const MAX_ARRAY_ITEMS: 1000
+const MAX_CONTENT_TYPE_FIELDS: 100
+const MAX_ENTRY_FIELDS: 200
+const MAX_ENTRY_INDEXES: 200
+const MAX_FIELD_COLUMNS: 2
+const MAX_FIELD_PURGE: 250
+const MAX_IMAGE_BYTES: number
+const MAX_MEDIA_BYTES: number
+const MAX_MEDIA_REFS: 100
+const MAX_NESTING_DEPTH: 20
+const MAX_PAGE_SIZE: 100
+const MAX_SETTINGS_FIELDS: 100
+const MAX_WRITE_BYTES: 900000
+const MEDIA_ACCEPT_ATTRIBUTE: string
+const MEDIA_REFS_KEY: "mediaRefs"
+const MEDIA_USAGE_LIMIT: 25
+export interface MediaAdapter { list(query?: MediaQuery): Promise<Page<MediaItem>> getById(mediaId: string): Promise<MediaItem | null> getMany(mediaIds: readonly string[]): Promise<readonly MediaItem[]> reserveId(): string create(input: MediaInput, mediaId?: string): Promise<MediaItem> update(mediaId: string, patch: Partial<MediaInput>): Promise<MediaItem> delete(mediaId: string): Promise<void> usages( mediaId: string, query?: MediaUsageQuery, ): Promise<readonly MediaUsageReference[]> refreshReferences(mediaId: string, url: string): Promise<MediaRefreshResult> usage(): Promise<MediaUsage> }
+export type MediaCategory = "image" | "video" | "audio" | "document"
+export interface MediaFileFacts { name: string type: string size: number }
+export interface MediaInput { name: string type: string size: number url: string path: string alt?: string | null width?: number | null height?: number | null }
+export interface MediaItem { id: string name: string type: string size: number url: string path: string alt: string | null width: number | null height: number | null createdAt: string createdBy: string }
+export interface MediaQuery { limit?: number cursor?: string | null type?: string }
+export interface MediaReader { getById(mediaId: string): Promise<MediaItem | null> getMany(mediaIds: readonly string[]): Promise<readonly MediaItem[]> }
+export interface MediaReference { mediaId: string url: string }
+export interface MediaRefreshResult { updated: number failed: readonly MediaUsageReference[] }
+export interface MediaRejection { code: MediaRejectionCode message: string }
+export type MediaRejectionCode = "type-not-allowed" | "too-large" | "empty" | "extension-mismatch"
+function mediaTag: (mediaId: string) => string
+function mediaTypeRule: (type: string) => MediaTypeRule | null
+export interface MediaTypeRule { readonly type: string readonly category: MediaCategory readonly maxBytes: number readonly extensions: readonly string[] }
+export interface MediaUsage { count: number bytes: number }
+export interface MediaUsageQuery { limit?: number }
+export interface MediaUsageReference { contentType: string entryId: string title: string | null }
+function mergeIssues: (client: readonly FieldError[], server: readonly FieldError[]) => readonly FormIssue[]
+const MIGRATION_BATCH_SIZE: 50
+const MIGRATION_MAX_BATCHES: 20
+export interface MigrationAdapter { countBehind(slug: string, targetVersion: number): Promise<number> listBehind( slug: string, targetVersion: number, query?: { limit?: number }, ): Promise<Page<StoredEntryRecord>> applyMigration( slug: string, entryId: string, values: Record<string, unknown>, write: MigrationWrite, ): Promise<boolean> }
+export interface MigrationContext { entryId: string slug: string fromVersion: number }
+export interface MigrationFailure { entryId: string fromVersion: number reason: string }
+export interface MigrationRegistry { forType(slug: string): readonly EntryMigration[] plan(type: ContentTypeLike, fromVersion: number): readonly EntryMigration[] }
+export interface MigrationRunDeps { migrations: MigrationAdapter registry: MigrationRegistry type: ContentTypeLike }
+export interface MigrationRunOptions { batchSize?: number maxBatches?: number onProgress?: (progress: { scanned: number; migrated: number }) => void }
+export interface MigrationRunResult { slug: string targetVersion: number scanned: number migrated: number skipped: number failed: readonly MigrationFailure[] remaining: boolean }
+export interface MigrationWrite { expectedVersion: number nextVersion: number }
+const MIN_WRITE_INTERVAL_MS: 200
+function missingEntryIndexes: (file: { indexes?: readonly FirestoreIndex[]; }, types: readonly ContentTypeLike[]) => readonly FirestoreIndex[]
+function missingError: (subject: string) => ClassifiedError
+function moveFieldRow: (rows: readonly FieldRow[], from: number, to: number) => FieldRow[]
+function moveItem: <TItem>(items: readonly TItem[], from: number, to: number) => TItem[]
+export interface NestedConverter { toStored(fields: FieldMap, values: Record<string, unknown>): Record<string, unknown> fromStored(fields: FieldMap, data: Record<string, unknown>): Record<string, unknown> }
+function newContentType: (input: NewContentTypeInput) => ContentTypeLike
+export interface NewContentTypeInput { name: string slug: string kind: ContentTypeKind icon?: string namePlural?: string description?: string }
+function newFieldDefinition: (registry: FieldTypeRegistry, type: FieldType, label: string) => FieldDefinition
+function nextSchemaVersion: (previous: ContentTypeLike | null, next: ContentTypeLike) => number
+function nextSort: (current: SortSpec, column: ListColumn, key?: string) => SortSpec
+function normalizeConfirmation: (value: string) => string
+function normalizeLimit: (limit: number | undefined) => number
+function normalizeMediaType: (type: string) => string
+function normalizePermissionMatrix: (matrix: PermissionMatrix | undefined) => PermissionMatrix | undefined
+export interface NumberField extends FieldCommon { type: "number" step?: number defaultValue?: number }
+function orderedFieldKeys: (type: Pick<ContentTypeLike, "fields" | "fieldOrder">) => readonly string[]
+function orderedFields: (type: Pick<ContentTypeLike, "fields" | "fieldOrder">) => readonly FieldRow[]
+export interface Page<TItem> { items: readonly TItem[] cursor: string | null hasMore: boolean }
+const PATTERN_PRESETS: { readonly email: "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"; readonly slug: "^[a-z0-9]+(?:-[a-z0-9]+)*$"; readonly url: "^https?://[^\\s]+$"; }
+export interface PayloadLimits { maxFields?: number maxBytes?: number }
+export interface Permission { action: Action contentType?: string }
+const PERMISSION_DEFAULTS: Readonly<Record<"admin" | "editor" | "author", Readonly<Record<Action, Decision>>>>
+export interface PermissionContext { type?: ContentTypeLike entry?: EntryOwnership }
+export class PermissionError extends Error { override readonly name = "PermissionError" readonly action: string readonly contentType: string | undefined constructor(action: string, contentType?: string, message?: string) { super( message ?? (contentType === undefined ? `This account may not ${action}.` : `This account may not ${action} entries of "${contentType}".`), ) this.action = action this.contentType = contentType } }
+export type PermissionMatrix = Partial<Record<EntryAction, readonly Role[]>>
+function permissionMatrixRows: (type: Pick<ContentTypeLike, "permissions"> | undefined) => readonly MatrixRow[]
+function registerFieldTypes: (specs: readonly AnyFieldTypeSpec[]) => FieldTypeRegistry
+export interface Registry { readonly types: readonly RegistryEntry[] readonly conflicts: readonly RegistryEntry[] readonly invalid: readonly InvalidContentType[] get(slug: string): RegistryEntry | undefined require(slug: string): RegistryEntry has(slug: string): boolean bySource(source: ContentTypeSource): readonly RegistryEntry[] }
+export interface RegistryEntry { type: ContentTypeLike source: ContentTypeSource locked: boolean conflict?: { source: "database"; type: ContentTypeLike } }
+export interface RegistryStore { readonly registry: Registry setDatabaseTypes(types: readonly ContentTypeLike[]): boolean subscribe(listener: (registry: Registry) => void): () => void readonly revision: number }
+export interface RelationField<TTo extends string = string> extends FieldCommon { type: "relation" to: TTo many?: boolean }
+export interface RemovalContext { removedBy: string removedAt?: string }
+export interface RemovedField { field: FieldDefinition removedAt: string removedBy: string }
+function removedFieldEntries: (type: ContentTypeLike) => readonly (RemovedField & { key: string; })[]
+export type RemovedFieldMap = { readonly [key: string]: RemovedField }
+function removeField: (type: ContentTypeLike, key: string, context: RemovalContext) => ContentTypeLike
+export interface RepeaterField<TFields extends FieldMap = FieldMap> extends FieldCommon { type: "repeater" fields: TFields min?: number max?: number }
+function requiredEntryIndexes: (types: readonly ContentTypeLike[]) => readonly FirestoreIndex[]
+const RESERVED_FIELD_KEYS: readonly ["id", "status", "createdAt", "createdBy", "updatedAt", "updatedBy", "publishedAt", "schemaVersion"]
+const RESERVED_TYPE_SLUGS: ReadonlyArray<string>
+export type ReservedFieldKey = (typeof RESERVED_FIELD_KEYS)[number]
+function resolveDecision: (role: Role, action: Action, type: Pick<ContentTypeLike, "permissions"> | undefined) => Decision
+function resolveTsType: (registry: FieldTypeRegistry, field: FieldDefinition) => string
+function restoreField: (type: ContentTypeLike, key: string, options?: RestoreOptions) => ContentTypeLike
+export interface RestoreOptions { field?: FieldDefinition }
+function retargetMediaUrls: (data: Record<string, unknown>, mediaId: string, url: string) => Record<string, unknown> | null
+export interface RichtextField extends FieldCommon { type: "richtext" features?: readonly string[] }
+export interface RichTextValue { format: "husk-richtext-v1" content: unknown }
+export type Role = (typeof ROLES)[number]
+const ROLES: readonly ["admin", "editor", "author"]
+function runMigration: (deps: MigrationRunDeps, options?: MigrationRunOptions) => Promise<MigrationRunResult>
+function safeFileName: (name: string, type: string) => string
+function sameDefinition: (left: ContentTypeLike, right: ContentTypeLike) => boolean
+export interface SchemaAdapter { list(): Promise<readonly ContentTypeLike[]> get(slug: string): Promise<ContentTypeLike | null> create(type: ContentTypeLike): Promise<ContentTypeLike> update(slug: string, type: ContentTypeLike): Promise<ContentTypeLike> delete(slug: string): Promise<void> watch( listener: (types: readonly ContentTypeLike[]) => void, onError?: (error: Error) => void, ): () => void }
+export class SchemaError extends Error { override readonly name = "SchemaError" constructor(message: string) { super(message) } }
+function schemaVersionOf: (type: Pick<ContentTypeLike, "schemaVersion">) => number
+export interface SelectField<TValue extends string = string> extends FieldCommon { type: "select" options: readonly SelectOption<TValue>[] multiple?: boolean defaultValue?: TValue }
+export interface SelectOption<TValue extends string = string> { value: TValue label: string }
+export interface SettingsAdapter { get(key: string): Promise<Record<string, unknown> | null> set(key: string, value: Record<string, unknown>): Promise<void> }
+export interface SettingsReader { get(key: string): Promise<Record<string, unknown> | null> }
+function settingsTag: (key: string) => string
+export interface SingleReader<TEntry = Entry> { get(): Promise<TEntry | null> }
+function singletonEntryId: (slug: string) => string
+export class SingletonError extends Error { override readonly name = "SingletonError" readonly slug: string constructor(slug: string, message: string) { super(message) this.slug = slug } }
+export interface SlugAvailability { available: boolean reason?: SlugRejection message?: string source?: ContentTypeSource }
+export interface SlugField extends FieldCommon { type: "slug" from?: string }
+function slugFieldKey: (type: ContentTypeLike) => string | null
+export type SlugOf<TTypes extends ContentTypeMap> = KnownSlug<TTypes> | (string & Record<never, never>)
+export type SlugRejection = "invalid" | "reserved" | "taken-by-code" | "taken-by-database"
+function sortableFieldKeys: (type: ContentTypeLike) => readonly string[]
+export interface SortSpec { field: string direction: "asc" | "desc" }
+function staleWriteError: (subject: string) => ClassifiedError
+const STATUS_EFFECT: Readonly<Record<"draft" | "published" | "archived", string>>
+export type StatusSubject = Pick<EntryMeta, "status" | "createdBy">
+export interface StatusTransition { to: EntryStatus label: string effect: string allowed: boolean reason: string | null }
+function statusTransitions: (user: AuthUser, type: ContentTypeLike, entry: StatusSubject | null) => readonly StatusTransition[]
+function storageShapeChanged: (previous: ContentTypeLike, next: ContentTypeLike) => boolean
+function storageSignature: (type: Pick<ContentTypeLike, "kind" | "fields">) => string
+function storageSignatureOf: (field: FieldDefinition) => string
+export interface StoredEntryRecord { id: string schemaVersion: number values: Record<string, unknown> }
+function storesTheSameWay: (left: FieldDefinition, right: FieldDefinition) => boolean
+function suggestFieldKey: (label: string) => string
+export interface TextareaField extends FieldCommon { type: "textarea" rows?: number defaultValue?: string }
+export interface TextField extends FieldCommon { type: "text" defaultValue?: string }
+function treatmentFor: (category: ErrorCategory) => ErrorTreatment
+export type TsTypeResolver = (field: FieldDefinition) => string
+function uniqueFieldPaths: (type: AnyContentTypeShape) => string[]
+const UNKNOWN_TS_TYPE: "unknown"
+function unroutableIssues: <TError extends FieldError>(issues: readonly TError[], type: ContentTypeLike) => readonly TError[]
+const UNTITLED_ENTRY: "Untitled"
+export interface ValidateCtx { path: string contentType: AnyContentTypeShape entry: Record<string, unknown> }
+function validateEntry: (type: AnyContentTypeShape, values: Record<string, unknown>, options?: ValidateOptions) => FieldError[]
+export interface ValidateOptions { skipRequired?: boolean fieldTypes?: FieldTypeRegistry }
+const VALIDATION_RULE_CONTROLS: { readonly required: ValidationRuleControl; readonly minLength: ValidationRuleControl; readonly maxLength: ValidationRuleControl; readonly min: ValidationRuleControl; readonly max: ValidationRuleControl; readonly pattern: ValidationRuleControl; readonly unique: ValidationRuleControl; }
+export class ValidationError extends Error { override readonly name = "ValidationError" readonly errors: readonly FieldError[] constructor(errors: readonly FieldError[]) { super( errors.length === 1 && errors[0] ? `${errors[0].path}: ${errors[0].message}` : `${errors.length} fields failed validation`, ) this.errors = errors } }
+export interface ValidationRuleControl { label: string control: "boolean" | "number" | "text" help: string }
+export type ValidationRuleName = keyof ValidationRules
+export interface ValidationRules { required?: boolean minLength?: number maxLength?: number min?: number max?: number pattern?: string unique?: boolean }
+function valuesChanged: (baseline: Record<string, unknown>, current: Record<string, unknown>) => boolean
+function withFieldOption: (field: FieldDefinition, option: string, value: unknown) => FieldDefinition
+function withFieldRows: (type: ContentTypeLike, rows: readonly FieldRow[]) => ContentTypeLike
+function withMatrixRole: (matrix: PermissionMatrix | undefined, action: EntryAction, role: Role, listed: boolean) => PermissionMatrix | undefined
+function withValidationRule: (field: FieldDefinition, rule: ValidationRuleName, value: string | number | boolean | undefined) => FieldDefinition
+const WRITE_BURST_LIMIT: 200
+const WRITE_BURST_WINDOW_MS: 10000
+export type WriteLimitCode = "too-many-fields" | "too-large" | "too-deep" | "too-many-items" | "too-fast"
+export class WriteLimitError extends Error { override readonly name = "WriteLimitError" readonly code: string readonly path: string constructor(rejection: { code: string; path: string; message: string }) { super(rejection.message) this.code = rejection.code this.path = rejection.path } }
+export interface WriteLimitRejection { code: WriteLimitCode path: string message: string }
+export interface WriteRateLimiter { check(): WriteLimitRejection | null }
+```
+
+## `@nonext/husk/admin`
+
+35 exports.
+
+```ts
+const ADMIN_TITLE: "Husk"
+export type AdminAccess = | { outcome: "allow"; user: AuthUser } | { outcome: "sign-in"; location: string; reason: "required" | "expired" } | { outcome: "unauthorized"; user: AuthUser; action: Action }
+export interface AdminNavGroup { key: string label?: string items: readonly AdminNavItem[] }
+export interface AdminNavItem { key: string label: string href: string icon: IconName exact?: boolean }
+function adminPageTitle: (navigation: readonly AdminNavGroup[], pathname: string) => string | undefined
+function buildAdminNavigation: ({ registry, user, basePath, }: BuildNavigationOptions) => readonly AdminNavGroup[]
+export interface BuildNavigationOptions { registry: Registry user: AuthUser basePath?: string }
+function clearedSessionCookie: (options: { secure: boolean; }) => string
+function contentTypeIcon: (type: ContentTypeLike) => IconName
+function contentTypeLabel: (type: ContentTypeLike) => string
+export interface CookieReader { get(name: string): { value: string } | undefined }
+function createEmulatorTokenVerifier: (options: EmulatorTokenVerifierOptions) => TokenVerifier
+function createSessionRoutes: (options: SessionRouteOptions) => SessionRoutes
+function createUnavailableTokenVerifier: () => TokenVerifier
+function decodeIdTokenPayload: (token: string) => Record<string, unknown>
+const DEFAULT_LOGIN_PATH: "/admin/login"
+export interface EmulatorTokenVerifierOptions { projectId: string now?: () => number }
+function isNavItemActive: (item: AdminNavItem, pathname: string) => boolean
+function navItemForPath: (navigation: readonly AdminNavGroup[], pathname: string) => AdminNavItem | undefined
+function readSession: (cookies: CookieReader, verifier: TokenVerifier, cookieName: string) => Promise<SessionState>
+function readSessionCookie: (header: string | null) => string | undefined
+export interface ResolveAccessOptions { session: SessionState pathname: string action?: Action context?: PermissionContext loginPath?: string }
+function resolveAdminAccess: (options: ResolveAccessOptions) => AdminAccess
+function safeReturnPath: (next: string | null | undefined, adminBasePath?: string) => string
+function serializeSessionCookie: (token: string, options: SessionCookieOptions) => string
+const SESSION_COOKIE: "husk_session"
+export interface SessionClaims { uid: string email: string | null displayName: string | null role: Role disabled: boolean expiresAt: number }
+export interface SessionCookieOptions { maxAge: number secure: boolean }
+export interface SessionRouteOptions { verifier: TokenVerifier secure: boolean now?: () => number }
+export interface SessionRoutes { POST(request: Request): Promise<Response> DELETE(): Promise<Response> }
+export type SessionState = | { status: "authenticated"; user: AuthUser } | { status: "anonymous" } | { status: "expired" } | { status: "invalid"; reason: string }
+export type TokenErrorCode = "malformed" | "expired" | "untrusted"
+export class TokenVerificationError extends Error { override readonly name = "TokenVerificationError" readonly code: TokenErrorCode constructor(code: TokenErrorCode, message: string) { super(message) this.code = code } }
+export interface TokenVerifier { verify(token: string): Promise<SessionClaims> }
+function toSessionUser: (claims: SessionClaims) => AuthUser
+```
+
+## `@nonext/husk/admin/ui`
+
+208 exports.
+
+```ts
+function AdminMediaPickerProvider: ({ adapter, user, uploader, contentTypeLabel, children, }: AdminMediaPickerProviderProps) => JSX.Element
+export interface AdminMediaPickerProviderProps { adapter: CmsAdapter user: AuthUser uploader?: MediaUploader | undefined contentTypeLabel?: ((slug: string) => string) | undefined children: ReactNode }
+function AdminShell: ({ navigation, user, accountMenu, children }: AdminShellProps) => JSX.Element
+export interface AdminShellProps { navigation: readonly AdminNavGroup[] user: AuthUser accountMenu?: ReactNode children: ReactNode }
+function AdminSidebar: ({ navigation, pathname, user, accountMenu, className, panelRef, onNavigate, onKeyDown, }: AdminSidebarProps) => JSX.Element
+export interface AdminSidebarProps { navigation: readonly AdminNavGroup[] pathname: string user: AuthUser accountMenu?: ReactNode className?: string panelRef?: Ref<HTMLElement> onNavigate?: () => void onKeyDown?: (event: KeyboardEvent<HTMLElement>) => void }
+export interface AuthorInfo { uid: string displayName?: string | null email?: string | null }
+export type AuthorLookup = (uid: string) => Promise<AuthorInfo | null>
+function Avatar: ({ name, src, size }: AvatarProps) => JSX.Element
+export interface AvatarProps { name: string src?: string size?: AvatarSize }
+export type AvatarSize = 20 | 24 | 32
+function Badge: ({ children, variant, icon }: BadgeProps) => JSX.Element
+export interface BadgeProps { children: ReactNode variant?: BadgeVariant icon?: IconName }
+export type BadgeVariant = "neutral" | "success" | "warning" | "danger" | "info" | "accent"
+function Breadcrumb: ({ items, className }: BreadcrumbProps) => JSX.Element | null
+export interface BreadcrumbItem { label: string href?: string }
+export interface BreadcrumbProps { items: readonly BreadcrumbItem[] className?: string }
+function Button: ({ variant, size, loading, icon, children, className, disabled, type, ref, ...rest }: ButtonProps) => JSX.Element
+export interface ButtonProps extends Omit< ButtonHTMLAttributes<HTMLButtonElement>, "type" > { variant?: ButtonVariant size?: ButtonSize loading?: boolean icon?: IconName type?: "button" | "submit" | "reset" ref?: Ref<HTMLButtonElement> }
+export type ButtonSize = "sm" | "md" | "lg"
+export type ButtonVariant = "primary" | "secondary" | "ghost" | "danger"
+function canDeleteMedia: (user: AuthUser) => boolean
+function canReplaceMedia: (user: AuthUser, item: MediaItem) => boolean
+function Checkbox: ({ checked, onChange, label, ariaLabel, name, value, disabled, id, "aria-describedby": describedBy, }: CheckboxProps) => JSX.Element
+export interface CheckboxProps { checked: boolean | "indeterminate" onChange: (checked: boolean) => void label?: string ariaLabel?: string name?: string value?: string disabled?: boolean id?: string "aria-describedby"?: string | undefined }
+export type ClipboardOutcome = "copied" | "unavailable"
+function CollectionList: ({ adapter, type, user, onOpen, onCreate, onDelete, refreshToken, pageSize, }: CollectionListProps) => JSX.Element
+export interface CollectionListProps { adapter: CmsAdapter type: ContentTypeLike user: AuthUser onOpen?: (entryId: string) => void onCreate?: () => void onDelete?: (entryIds: readonly string[]) => void refreshToken?: unknown pageSize?: number }
+function ContentTypeEditor: ({ adapter, registry, entry, user, backHref, }: ContentTypeEditorProps) => JSX.Element
+export interface ContentTypeEditorProps { adapter: CmsAdapter registry: Registry entry: RegistryEntry user: AuthUser backHref?: string }
+function ContentTypesScreen: ({ registry, adapter, user, onOpen, onCreated, liveError, }: ContentTypesScreenProps) => JSX.Element
+export interface ContentTypesScreenProps { registry: Registry adapter: CmsAdapter user: AuthUser onOpen: (slug: string) => void onCreated?: (slug: string) => void liveError?: Error | null }
+function copyText: (text: string) => Promise<ClipboardOutcome>
+function CreateContentTypeDialog: (props: CreateContentTypeDialogProps) => JSX.Element | null
+export interface CreateContentTypeDialogProps { open: boolean registry: Registry adapter: CmsAdapter onClose: () => void onCreated: (slug: string) => void }
+function Dashboard: ({ adapter, types, recentLimit }: DashboardProps) => JSX.Element
+export interface DashboardCount { slug: string label: string kind: ContentTypeKind icon: IconName count: number }
+export interface DashboardData { counts: readonly DashboardCount[] recent: readonly DashboardRecentEntry[] media: MediaUsage | null }
+export interface DashboardProps { adapter: CmsAdapter types: readonly ContentTypeLike[] recentLimit?: number }
+export interface DashboardRecentEntry { key: string entryId: string title: string typeSlug: string typeLabel: string status: EntryStatus updatedAt: string }
+const DEFAULT_RECENT_LIMIT: 8
+function DeleteEntriesDialog: ({ adapter, type, entryIds, onCancel, onDeleted, role, }: DeleteEntriesDialogProps) => JSX.Element | null
+export interface DeleteEntriesDialogProps { adapter: CmsAdapter type: ContentTypeLike entryIds: readonly string[] onCancel: () => void onDeleted: (entryIds: readonly string[], complete: boolean) => void role?: Role | undefined }
+function describeUsage: (usages: readonly MediaUsageReference[], limit?: number) => string
+function EmptyState: ({ icon, heading, description, action }: EmptyStateProps) => JSX.Element
+export interface EmptyStateProps { icon?: IconName heading: string description?: string action?: ReactNode }
+const ENTRY_STATUS_LABEL: { readonly draft: "Draft"; readonly published: "Published"; readonly archived: "Archived"; }
+const ENTRY_STATUS_VARIANT: { readonly draft: "neutral"; readonly published: "success"; readonly archived: "warning"; readonly error: "danger"; }
+function EntryEditor: ({ adapter, type, user, entryId, onSaved, onCancel, onDirtyChange, onDelete, resolveAuthor, getType, registry, }: EntryEditorProps) => JSX.Element
+export interface EntryEditorProps { adapter: CmsAdapter type: ContentTypeLike user: AuthUser entryId?: string | undefined onSaved?: ((entry: Entry, created: boolean) => void) | undefined onCancel?: (() => void) | undefined onDirtyChange?: ((dirty: boolean) => void) | undefined onDelete?: ((entryId: string) => void) | undefined resolveAuthor?: AuthorLookup | undefined getType?: ((slug: string) => ContentTypeLike | undefined) | undefined registry?: FieldTypeRegistry | undefined }
+function EntryMetadata: ({ user, entry, status, pending, transitions, onTransition, busy, resolveAuthor, actions, }: EntryMetadataProps) => JSX.Element
+export interface EntryMetadataProps { user: AuthUser entry: Entry | null status: EntryStatus pending?: EntryStatus | null transitions: readonly StatusTransition[] onTransition: (to: EntryStatus) => void busy?: boolean resolveAuthor?: AuthorLookup | undefined actions?: ReactNode }
+function ErrorCapture: ({ onCapture }: ErrorCaptureProps) => null
+export interface ErrorCaptureProps { onCapture?: ((error: ClassifiedError) => void) | undefined }
+function ErrorNotice: ({ error, onRetry, actions, className }: ErrorNoticeProps) => JSX.Element
+export interface ErrorNoticeProps { error: ClassifiedError onRetry?: (() => void) | undefined actions?: ReactNode className?: string }
+function ErrorScreen: ({ error, title, onRetry, children }: ErrorScreenProps) => JSX.Element
+export interface ErrorScreenProps { error: ClassifiedError title?: string | undefined onRetry?: (() => void) | undefined children?: ReactNode }
+function Field: ({ label, required, optional, help, error, children, }: FieldProps) => JSX.Element
+export interface FieldFormContextValue { values: Record<string, unknown> fields?: FieldMap | undefined checkUnique?: UniqueCheck | undefined }
+function FieldFormProvider: ({ value, children }: FieldFormProviderProps) => JSX.Element
+export interface FieldFormProviderProps { value: FieldFormContextValue children: ReactNode }
+export interface FieldProps { label: string required?: boolean optional?: boolean help?: string | undefined error?: string | undefined children: (control: { id: string describedBy: string | undefined invalid: boolean }) => ReactNode }
+function FieldRows: ({ rows, registry, contentTypes, readOnly, reorderable, checkKey, onChange, onRemove, label, issues, }: FieldRowsProps) => JSX.Element
+export interface FieldRowsProps { rows: readonly FieldRow[] registry: FieldTypeRegistry contentTypes: readonly SelectOption[] readOnly: boolean reorderable?: boolean checkKey: (key: string) => FieldKeyAvailability onChange: (rows: readonly FieldRow[]) => void onRemove?: (key: string) => void label: string issues?: readonly (FieldOptionIssue & { key: string })[] }
+function FieldShell: ({ field, errors, help, children }: FieldShellProps) => JSX.Element
+export interface FieldShellProps { field: FieldDefinition errors: readonly FieldError[] help?: string | undefined children: FieldProps["children"] }
+const fieldTypes: FieldTypeRegistry
+function formatBytes: (bytes: number) => string
+function formatCellValue: (value: unknown, align: ColumnAlign) => string | null
+function formatDate: (value: string) => string
+function formatDateTime: (iso: string) => string
+function formatDimensions: (item: MediaItem) => string | null
+function FormError: ({ children }: { children: ReactNode; }) => JSX.Element
+function Icon: ({ name, size, label, className }: IconProps) => JSX.Element
+function IconButton: (props: IconButtonProps) => JSX.Element
+export type IconButtonProps = IconButtonBase & ({ icon: IconName; morph?: false } | { icon: MorphIconName; morph: true })
+export type IconName = (typeof ICON_NAMES)[number]
+export interface IconProps { name: IconName size?: IconSize label?: string className?: string }
+const ICONS: { readonly brand: LucideIcon; readonly create: LucideIcon; readonly edit: LucideIcon; readonly delete: LucideIcon; readonly save: LucideIcon; readonly close: LucideIcon; readonly search: LucideIcon; readonly filter: LucideIcon; readonly "sort-asc": LucideIcon; readonly "sort-desc": LucideIcon; readonly "navigate-into": LucideIcon; readonly "page-previous": LucideIcon; readonly "page-next": LucideIcon; readonly expand: LucideIcon; readonly collapse: LucideIcon; readonly selected: LucideIcon; readonly indeterminate: LucideIcon; readonly "more-actions": LucideIcon; readonly "drag-handle": LucideIcon; readonly locked: LucideIcon; readonly dashboard: LucideIcon; readonly collection: LucideIcon; readonly singleton: LucideIcon; readonly media: LucideIcon; readonly settings: LucideIcon; readonly users: LucideIcon; readonly permissions: LucideIcon; readonly "content-types": LucideIcon; readonly system: LucideIcon; readonly success: LucideIcon; readonly warning: LucideIcon; readonly error: LucideIcon; readonly info: LucideIcon; readonly "external-link": LucideIcon; readonly upload: LucideIcon; readonly copy: LucideIcon; readonly retry: LucideIcon; readonly "open-navigation": LucideIcon; readonly bold: LucideIcon; readonly italic: LucideIcon; readonly strikethrough: LucideIcon; readonly link: LucideIcon; readonly unlink: LucideIcon; readonly "bullet-list": LucideIcon; readonly "numbered-list": LucideIcon; readonly quote: LucideIcon; readonly undo: LucideIcon; readonly redo: LucideIcon; }
+export type IconSize = 12 | 14 | 16 | 18 | 20 | 24
+function initials: (name: string) => string
+function isDeletableType: (type: ContentTypeLike) => boolean
+function isImageItem: (item: MediaItem) => boolean
+export interface LiveRegistry { registry: Registry synced: boolean error: Error | null }
+function loadDashboard: (adapter: CmsAdapter, types: readonly ContentTypeLike[], { recentLimit }?: LoadDashboardOptions) => Promise<DashboardData>
+export interface LoadDashboardOptions { recentLimit?: number }
+export interface LoginCredentials { email: string password: string }
+function LoginScreen: ({ onSignIn, expired }: LoginScreenProps) => JSX.Element
+export interface LoginScreenProps { onSignIn: (credentials: LoginCredentials) => Promise<void> expired?: boolean }
+const MEDIA_FILTERS: ReadonlyArray<{ value: string; label: string; }>
+function MediaDeleteDialog: ({ adapter, item, onCancel, onDeleted, contentTypeLabel, }: MediaDeleteDialogProps) => JSX.Element | null
+export interface MediaDeleteDialogProps { adapter: CmsAdapter item: MediaItem | null onCancel: () => void onDeleted: (mediaId: string) => void contentTypeLabel?: ((slug: string) => string) | undefined }
+function MediaDetail: ({ adapter, user, item, onClose, onUpdated, onDelete, onReplace, contentTypeLabel, }: MediaDetailProps) => JSX.Element
+export interface MediaDetailProps { adapter: CmsAdapter user: AuthUser item: MediaItem onClose: () => void onUpdated: (item: MediaItem) => void onDelete?: ((item: MediaItem) => void) | undefined onReplace?: ((item: MediaItem) => void) | undefined contentTypeLabel?: ((slug: string) => string) | undefined }
+function MediaLibrary: ({ adapter, user, uploader, accept, onPick, contentTypeLabel, }: MediaLibraryProps) => JSX.Element
+export interface MediaLibraryProps { adapter: CmsAdapter user: AuthUser uploader?: MediaUploader | undefined accept?: readonly string[] | undefined onPick?: ((item: MediaItem) => void) | undefined contentTypeLabel?: ((slug: string) => string) | undefined }
+export type MediaLookup = | { kind: "empty" } | { kind: "unavailable" } | { kind: "loading" } | { kind: "found"; item: MediaItem } | { kind: "missing" }
+export interface MediaPickerApi { resolve(mediaIds: readonly string[]): Promise<readonly MediaItem[]> pick(request: MediaPickRequest): Promise<MediaItem | null> }
+function MediaPickerProvider: ({ value, children }: MediaPickerProviderProps) => JSX.Element
+export interface MediaPickerProviderProps { value: MediaPickerApi children: ReactNode }
+export interface MediaPickRequest { accept?: readonly string[] | undefined }
+function MediaTile: ({ item, selected, unused, onOpen, }: MediaTileProps) => JSX.Element
+export interface MediaTileProps { item: MediaItem selected?: boolean unused?: boolean onOpen: (item: MediaItem) => void }
+export interface MediaUploader { create(file: File, options?: MediaUploadRequest): MediaUploadHandle replace( existing: MediaItem, file: File, options?: MediaUploadRequest, ): MediaUploadHandle }
+export interface MediaUploadHandle { readonly mediaId: string readonly path: string readonly fileName: string progress(): MediaUploadProgress start(): Promise<MediaItem> retry(): Promise<MediaItem> cancel(): void }
+export type MediaUploadPhase = "idle" | "uploading" | "storing" | "done" | "cancelled" | "failed"
+export interface MediaUploadProgress { phase: MediaUploadPhase bytesTransferred: number totalBytes: number fraction: number attempt: number }
+export interface MediaUploadRequest { onProgress?: (progress: MediaUploadProgress) => void alt?: string | null }
+function Menu: ({ items, onSelect, label, triggerLabel, triggerIcon, triggerVariant, triggerSize, align, side, }: MenuProps) => JSX.Element
+export type MenuEntry = | { kind: "item" id: string label: string icon?: IconName selected?: boolean destructive?: boolean disabled?: boolean shortcut?: string } | { kind: "separator"; id: string } | { kind: "section"; id: string; label: string }
+export interface MenuProps { items: readonly MenuEntry[] onSelect: (id: string) => void label: string triggerLabel?: string triggerIcon?: IconName triggerVariant?: ButtonVariant triggerSize?: ButtonSize align?: "start" | "end" side?: "top" | "bottom" }
+function Metric: ({ label, value, caption, icon, loading, unavailable, className, }: MetricProps) => JSX.Element
+export interface MetricProps { label: string value?: string | number caption?: string icon?: IconName loading?: boolean unavailable?: string className?: string }
+function Modal: ({ open, onClose, title, description, width, dismissible, footer, children, }: ModalProps) => ReactPortal | null
+export interface ModalProps { open: boolean onClose: () => void title: string description?: string width?: ModalWidth dismissible?: boolean footer?: ReactNode children?: ReactNode }
+export type ModalWidth = "sm" | "md" | "lg" | "xl"
+export type MorphIconName = keyof typeof MORPH_GLYPHS
+function MorphingIcon: ({ name, size, label, className }: MorphingIconProps) => JSX.Element
+export interface MorphingIconProps { name: MorphIconName size?: 12 | 14 | 16 | 18 | 20 | 24 label?: string className?: string }
+function NotFoundScreen: ({ children }: NotFoundScreenProps) => JSX.Element
+export interface NotFoundScreenProps { children?: ReactNode }
+function PageHeader: ({ title, description, breadcrumb, actions, className, }: PageHeaderProps) => JSX.Element
+export interface PageHeaderProps { title: string description?: string breadcrumb?: readonly BreadcrumbItem[] actions?: ReactNode className?: string }
+function PageSections: ({ children, className, }: { children: ReactNode; className?: string; }) => JSX.Element
+function Pagination: ({ from, to, total, hasPrevious, hasNext, onPrevious, onNext, label, }: PaginationProps) => JSX.Element
+export interface PaginationProps { from: number to: number total?: number | undefined hasPrevious: boolean hasNext: boolean onPrevious: () => void onNext: () => void label: string }
+function Panel: ({ children, padding, raised, className, }: PanelProps) => JSX.Element
+export type PanelPadding = "none" | "compact" | "standard" | "large"
+export interface PanelProps { children: ReactNode padding?: PanelPadding raised?: boolean className?: string }
+function PermissionMatrixEditor: ({ type, readOnly, onChange, }: PermissionMatrixEditorProps) => JSX.Element
+export interface PermissionMatrixEditorProps { type: ContentTypeLike readOnly: boolean onChange: (next: PermissionMatrix | undefined) => void }
+function pickableItems: (items: readonly MediaItem[], accept: readonly string[] | undefined) => readonly MediaItem[]
+function Progress: ({ value, label, className }: ProgressProps) => JSX.Element
+export interface ProgressProps { value: number label: string className?: string }
+function PurgeFieldDialog: (props: PurgeFieldDialogProps) => JSX.Element | null
+export interface PurgeFieldDialogProps { adapter: CmsAdapter type: ContentTypeLike fieldKey: string | null onCancel: () => void onPurged: (fieldKey: string) => void }
+function queryTypeFilter: (accept: readonly string[] | undefined) => string | undefined
+export interface RelationOption { id: string title: string status: EntryStatus }
+export interface RelationSearchRequest { contentType: string search: string limit?: number cursor?: string | null }
+export interface RelationSource { describe(contentType: string): RelationTypeInfo search(request: RelationSearchRequest): Promise<Page<RelationOption>> resolve(contentType: string, ids: readonly string[]): Promise<readonly RelationOption[]> }
+function relationSourceFromAdapter: ({ adapter, getType, }: RelationSourceOptions) => RelationSource
+export interface RelationSourceOptions { adapter: CmsAdapter getType: (slug: string) => ContentTypeLike | undefined }
+function RelationSourceProvider: ({ value, children }: RelationSourceProviderProps) => JSX.Element
+export interface RelationSourceProviderProps { value: RelationSource children: ReactNode }
+export interface RelationTypeInfo { label: string searchable: boolean known: boolean }
+function RemoveFieldDialog: (props: RemoveFieldDialogProps) => JSX.Element | null
+export interface RemoveFieldDialogProps { adapter: CmsAdapter type: ContentTypeLike fieldKey: string | null onCancel: () => void onConfirm: (fieldKey: string) => void }
+function RouteError: ({ error, reset, title, role, children }: RouteErrorProps) => JSX.Element
+export interface RouteErrorProps { error: Error & { digest?: string } reset: () => void title?: string | undefined role?: Role | undefined children?: ReactNode }
+export type SchemaWatch = ( listener: (types: readonly ContentTypeLike[]) => void, onError?: (error: Error) => void, ) => () => void
+function SearchInput: ({ value, onChange, label, placeholder, disabled, describedBy, className, }: SearchInputProps) => JSX.Element
+export interface SearchInputProps { value: string onChange: (value: string) => void label: string placeholder?: string disabled?: boolean describedBy?: string | undefined className?: string }
+function Section: ({ heading, description, actions, children, className, }: SectionProps) => JSX.Element
+export interface SectionProps { heading?: string description?: string actions?: ReactNode children: ReactNode className?: string }
+function Select: ({ options, value, onChange, id, name, placeholder, invalid, disabled, "aria-describedby": describedBy, "aria-label": ariaLabel, }: SelectProps) => JSX.Element
+export interface SelectOption { value: string label: string disabled?: boolean }
+export interface SelectProps { options: readonly SelectOption[] value: string | null onChange: (value: string) => void id?: string name?: string placeholder?: string invalid?: boolean disabled?: boolean "aria-describedby"?: string | undefined "aria-label"?: string | undefined }
+function Skeleton: ({ line, radius, className, label }: SkeletonProps) => JSX.Element
+export type SkeletonLine = | "heading-md" | "heading-sm" | "body" | "body-sm" | "label" | "caption" | "micro" | "metric-lg" | "metric-md"
+export interface SkeletonProps { line?: SkeletonLine radius?: keyof typeof RADII className?: string label?: string }
+export type SortDirection = "asc" | "desc"
+function Spinner: ({ size, label }: SpinnerProps) => JSX.Element
+export interface SpinnerProps { size?: 14 | 16 label?: string }
+function StatusDot: ({ tone, label }: StatusDotProps) => JSX.Element
+export interface StatusDotProps { tone?: StatusTone label?: string }
+export type StatusTone = "neutral" | "success" | "warning" | "danger" | "info"
+function Switch: ({ checked, onChange, label, showLabel, disabled, id, "aria-describedby": describedBy, }: SwitchProps) => JSX.Element
+export interface SwitchProps { checked: boolean onChange: (checked: boolean) => void label: string showLabel?: boolean disabled?: boolean id?: string "aria-describedby"?: string | undefined }
+function Table: ({ children, label, className }: TableProps) => JSX.Element
+function TableBody: ({ children }: { children: ReactNode; }) => JSX.Element
+function TableCell: ({ children, primary, numeric, date, width, className, ...rest }: TableCellProps) => JSX.Element
+export interface TableCellProps extends TdHTMLAttributes<HTMLTableCellElement> { children?: ReactNode primary?: boolean numeric?: boolean date?: boolean width?: "selection" | "action" }
+function TableEmptyRow: ({ colSpan, children, }: { colSpan: number; children: ReactNode; }) => JSX.Element
+function TableHead: ({ children }: { children: ReactNode; }) => JSX.Element
+function TableHeaderCell: ({ children, numeric, width, sort, className, ...rest }: TableHeaderCellProps) => JSX.Element
+export interface TableHeaderCellProps extends Omit< ThHTMLAttributes<HTMLTableCellElement>, "onClick" > { children?: ReactNode numeric?: boolean width?: "selection" | "action" sort?: { direction: SortDirection | null; onSort: () => void } }
+export interface TableProps { children: ReactNode label?: string className?: string }
+function TableRow: ({ children, selected, disabled, onActivate, className, }: TableRowProps) => JSX.Element
+export interface TableRowProps { children: ReactNode selected?: boolean disabled?: boolean onActivate?: () => void className?: string }
+function Textarea: ({ invalid, className, readOnly, rows, ...rest }: TextareaProps) => JSX.Element
+export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> { invalid?: boolean }
+function TextInput: ({ invalid, loading, className, readOnly, ...rest }: TextInputProps) => JSX.Element
+export interface TextInputProps extends InputHTMLAttributes<HTMLInputElement> { invalid?: boolean loading?: boolean }
+export interface ToastApi { notify: (options: ToastOptions) => string dismiss: (id: string) => void }
+export interface ToastOptions { title: string description?: string tone?: ToastTone }
+function ToastProvider: ({ children }: { children: ReactNode; }) => JSX.Element
+export type ToastTone = "success" | "warning" | "error" | "info"
+function Tooltip: ({ content, placement, children }: TooltipProps) => JSX.Element
+export interface TooltipProps { content: string placement?: "top" | "bottom" children: ReactElement<{ "aria-describedby"?: string | undefined }> }
+function UnauthorizedScreen: ({ action, role, children }: UnauthorizedScreenProps) => JSX.Element
+export interface UnauthorizedScreenProps { action?: Action role?: string children?: ReactNode }
+export type UniqueCheck = (path: string, value: string) => Promise<boolean>
+function UnsavedChangesProvider: ({ navigate, children, }: UnsavedChangesProviderProps) => JSX.Element
+export interface UnsavedChangesProviderProps { navigate?: ((href: string) => void) | undefined children: ReactNode }
+function uploadAccept: (accept: readonly string[] | undefined) => string
+function UsageList: ({ usages, contentTypeLabel }: UsageListProps) => JSX.Element | null
+export interface UsageListProps { usages: readonly MediaUsageReference[] contentTypeLabel?: ((slug: string) => string) | undefined }
+function useBeforeUnloadWarning: (dirty: boolean) => void
+function useConfirmLeave: () => (proceed: () => void) => void
+function useFieldForm: () => FieldFormContextValue
+function useLiveRegistry: (store: RegistryStore, watch?: SchemaWatch) => LiveRegistry
+function useMediaLookup: (reference: MediaReference | null) => MediaLookup
+function useMediaPicker: () => MediaPickerApi | null
+function useOptionalToast: () => ToastApi | null
+function useRelationSource: () => RelationSource | null
+function useToast: () => ToastApi
+function useUnsavedChanges: (dirty: boolean) => void
+```
+
+## `@nonext/husk/auth`
+
+19 exports.
+
+```ts
+export class AuthError extends Error { override readonly name = "AuthError" readonly code: AuthErrorCode constructor(code: AuthErrorCode, message: string) { super(message) this.code = code } }
+export type AuthErrorCode = "disabled" | "invalid-credentials"
+export interface AuthUser { uid: string email: string displayName: string | null role: Role disabled: boolean }
+export interface ClaimSet { role: Role disabled: boolean }
+export interface ClaimSync { sync(uid: string, claims: ClaimSet): Promise<void> }
+export class ClaimSyncError extends Error { override readonly name = "ClaimSyncError" readonly uid: string constructor(uid: string, message: string) { super(message) this.uid = uid } }
+function createEmulatorClaimSync: (options: EmulatorClaimSyncOptions) => ClaimSync
+function createHuskAuth: (deps: HuskAuthDeps) => HuskAuth
+function createUnavailableClaimSync: (reason?: string) => ClaimSync
+export interface EmulatorClaimSyncOptions { authHost: string projectId: string }
+export interface HuskAuth { signIn(email: string, password: string): Promise<AuthUser> signUp(input: SignUpInput): Promise<AuthUser> signOut(): Promise<void> currentUser(): Promise<AuthUser | null> onChange( listener: (user: AuthUser | null) => void, onError?: (error: unknown) => void, ): () => void getUser(uid: string): Promise<StoredUser | null> updateProfile( uid: string, patch: Omit<UserPatch, "role" | "disabled">, ): Promise<StoredUser> setRole(uid: string, role: Role): Promise<StoredUser> setDisabled(uid: string, disabled: boolean): Promise<StoredUser> }
+export interface HuskAuthDeps { auth: Auth db: Firestore claimSync: ClaimSync defaultRole?: Role }
+export interface NewUser { uid: string email: string displayName?: string | null role: Role }
+export type Role = (typeof ROLES)[number]
+const ROLES: readonly ["admin", "editor", "author"]
+export interface SignUpInput { email: string password: string displayName?: string }
+export interface StoredUser { uid: string email: string displayName: string | null role: Role createdAt: string disabled: boolean }
+function toAuthUser: (stored: StoredUser) => AuthUser
+export interface UserPatch { displayName?: string | null role?: Role disabled?: boolean }
+```
+
+## `@nonext/husk/client`
+
+11 exports.
+
+```ts
+export type ClientCmsConfig<TTypes extends ContentTypeMap = ContentTypeMap> = CmsReadConfig<TTypes>
+export interface Cms<TTypes extends ContentTypeMap = ContentTypeMap> { collection<TSlug extends SlugOf<TTypes>>( slug: TSlug, ): CollectionReader<EntryOf<TTypes, TSlug>> single<TSlug extends SlugOf<TTypes>>(slug: TSlug): SingleReader<EntryOf<TTypes, TSlug>> media(): MediaReader settings(): SettingsReader readonly isPreview: boolean }
+export type CmsCountQuery = Pick<CmsQuery, "filters" | "search">
+export type CmsQuery = Omit<ListQuery, "status">
+export interface CollectionReader<TEntry = Entry> { findMany(query?: CmsQuery): Promise<Page<TEntry>> findBySlug(value: string): Promise<TEntry | null> findById(entryId: string): Promise<TEntry | null> count(query?: CmsCountQuery): Promise<number> }
+export type ContentTypeMap = { readonly [slug: string]: KindShape & AnyContentTypeShape }
+function createClientCMS: <TTypes extends ContentTypeMap = ContentTypeMap>(config: ClientCmsConfig<TTypes>) => Cms<TTypes>
+export type EntryOf< TTypes extends ContentTypeMap, TSlug extends string, > = TSlug extends keyof TTypes ? Entry<TTypes[TSlug]> : Entry
+export interface MediaReader { getById(mediaId: string): Promise<MediaItem | null> getMany(mediaIds: readonly string[]): Promise<readonly MediaItem[]> }
+export interface SettingsReader { get(key: string): Promise<Record<string, unknown> | null> }
+export interface SingleReader<TEntry = Entry> { get(): Promise<TEntry | null> }
+```
+
+## `@nonext/husk/core`
+
+233 exports.
+
+```ts
+function addField: (type: ContentTypeLike, key: string, field: FieldDefinition) => ContentTypeLike
+const ALLOWED_MEDIA_TYPES: ReadonlyArray<MediaTypeRule>
+function applyPlan: (plan: readonly EntryMigration[], values: Record<string, unknown>, context: Omit<MigrationContext, "fromVersion">) => Record<string, unknown>
+function approximateBytes: (value: unknown) => number
+function assertDeletable: (type: KindShape) => void
+function assertListable: (type: KindShape) => void
+function assertSchemaWritable: (registry: Registry, slug: string) => RegistryEntry
+function assertSingletonCreatable: (type: KindShape, exists: boolean) => void
+function assertSingletonEntryId: (type: KindShape, entryId: string) => void
+function assertTypeSlugAvailable: (registry: Registry, slug: string) => void
+function assertValidContentType: (definition: { slug: string; kind: unknown; fields: FieldMap; removedFields?: RemovedFieldMap | undefined; titleField?: string | undefined; defaultSort?: { field: string; direction: "asc" | "desc"; } | undefined; permissions?: unknown; }) => void
+function buildCountQuery: (type: ContentTypeLike, state: ListViewState) => Pick<ListQuery, "filters" | "status" | "search">
+function buildListQuery: (type: ContentTypeLike, state: ListViewState, { pageSize }?: BuildListQueryOptions) => ListQuery
+export interface BuildListQueryOptions { pageSize?: number }
+function buildRegistry: (code: readonly ContentTypeLike[], database: readonly ContentTypeLike[]) => Registry
+function canSaveEntry: (user: AuthUser, type: ContentTypeLike, entry: StatusSubject | null) => boolean
+function canSearch: (type: ContentTypeLike) => boolean
+function checkFieldKey: (type: ContentTypeLike, key: string) => FieldKeyAvailability
+function checkMediaFile: (file: MediaFileFacts) => MediaRejection | null
+function checkNestedFieldKey: (fields: FieldMap, key: string) => FieldKeyAvailability
+function checkTypeSlug: (registry: Registry, slug: string) => SlugAvailability
+function checkWritePayload: (values: Record<string, unknown>, limits?: PayloadLimits) => WriteLimitRejection | null
+export interface ClassifiedError { category: ErrorCategory treatment: ErrorTreatment title: string message: string fieldErrors: readonly FieldError[] retryable: boolean cause: unknown }
+function classifyError: (thrown: unknown, context?: ErrorContext) => ClassifiedError
+export type Clock = () => number
+export interface Cms<TTypes extends ContentTypeMap = ContentTypeMap> { collection<TSlug extends SlugOf<TTypes>>( slug: TSlug, ): CollectionReader<EntryOf<TTypes, TSlug>> single<TSlug extends SlugOf<TTypes>>(slug: TSlug): SingleReader<EntryOf<TTypes, TSlug>> media(): MediaReader settings(): SettingsReader readonly isPreview: boolean }
+export interface CmsAdapter { list(slug: string, query?: ListQuery): Promise<Page<Entry>> get(slug: string, entryId: string): Promise<Entry | null> getBySlug( slug: string, value: string, options?: Pick<ListQuery, "status">, ): Promise<Entry | null> getSingle(slug: string): Promise<Entry | null> create(slug: string, input: EntryInputData): Promise<Entry> update(slug: string, entryId: string, input: EntryInputData): Promise<Entry> delete(slug: string, entryId: string): Promise<void> count( slug: string, query?: Pick<ListQuery, "filters" | "status" | "search">, ): Promise<number> readonly media: MediaAdapter readonly schemas: SchemaAdapter readonly fieldData: FieldDataAdapter readonly migrations: MigrationAdapter readonly settings: SettingsAdapter }
+export interface CmsConfig< TTypes extends ContentTypeMap = ContentTypeMap, > extends CmsReadConfig<TTypes> { preview?: boolean }
+export type CmsCountQuery = Pick<CmsQuery, "filters" | "search">
+export type CmsQuery = Omit<ListQuery, "status">
+export interface CmsReadConfig<TTypes extends ContentTypeMap = ContentTypeMap> { adapter: CmsAdapter contentTypes?: TTypes }
+export interface CollectionReader<TEntry = Entry> { findMany(query?: CmsQuery): Promise<Page<TEntry>> findBySlug(value: string): Promise<TEntry | null> findById(entryId: string): Promise<TEntry | null> count(query?: CmsCountQuery): Promise<number> }
+function collectMediaIds: (data: Record<string, unknown>) => string[]
+export type ColumnAlign = "text" | "numeric" | "date"
+export type ColumnKind = "title" | "field" | "status" | "updated"
+function confirmationMatches: (expected: string, typed: string) => boolean
+export type ContentTypeMap = { readonly [slug: string]: KindShape & AnyContentTypeShape }
+function contentTypeTag: (slug: string) => string
+function createCMS: <TTypes extends ContentTypeMap = ContentTypeMap>(config: CmsConfig<TTypes>) => Cms<TTypes>
+function createContentType: (registry: Registry, input: NewContentTypeInput) => ContentTypeLike
+function createMigrationRegistry: (migrations: readonly EntryMigration[]) => MigrationRegistry
+function createRegistryStore: (code: readonly ContentTypeLike[], initialDatabase?: readonly ContentTypeLike[]) => RegistryStore
+function createWriteRateLimiter: (clock?: Clock) => WriteRateLimiter
+const DEFAULT_PAGE_SIZE: 25
+function defaultListSort: (type: ContentTypeLike) => SortSpec
+function defineContentType: <const TFields extends FieldMap>(definition: ContentType<TFields>) => ContentType<TFields>
+function deleteConfirmationName: (type: ContentTypeLike, entry: Entry) => string
+function deleteConfirmationPhrase: (type: ContentTypeLike, count: number) => string
+function deniedError: (what: string, role: Role | undefined) => ClassifiedError
+function draftIssues: (registry: FieldTypeRegistry, rows: readonly FieldRow[]) => readonly (FieldOptionIssue & { key: string; })[]
+const ENTRY_COLLECTION_GROUP: "entries"
+function entryChangedSince: (baseline: Pick<EntryMeta, "updatedAt">, current: Pick<EntryMeta, "updatedAt">) => boolean
+export interface EntryFilter { field: string op: FilterOperator value: unknown }
+export interface EntryInputData { values: Record<string, unknown> status?: EntryStatus }
+export interface EntryMigration { slug: string from: number to: number describe: string migrate( values: Record<string, unknown>, context: MigrationContext, ): Record<string, unknown> }
+export type EntryOf< TTypes extends ContentTypeMap, TSlug extends string, > = TSlug extends keyof TTypes ? Entry<TTypes[TSlug]> : Entry
+function entrySlugTag: (slug: string, value: string) => string
+function entryTag: (slug: string, entryId: string) => string
+function entryTags: (slug: string, entryId: string) => readonly string[]
+function entryTitle: (type: ContentTypeLike, entry: Entry) => string
+function entryUniqueCheck: (options: EntryUniqueOptions) => (path: string, value: string) => Promise<boolean>
+export interface EntryUniqueOptions { adapter: CmsAdapter type: ContentTypeLike entryId: string | null }
+const ERROR_CATEGORIES: readonly ["validation", "permission", "not-found", "conflict", "transport", "unknown"]
+export type ErrorCategory = (typeof ERROR_CATEGORIES)[number]
+export interface ErrorContext { role?: Role | undefined action?: string | undefined subject?: string | undefined }
+export type ErrorOrigin = "client" | "server"
+function errorsUnder: <TError extends FieldError>(errors: readonly TError[], path: string) => TError[]
+export type ErrorTreatment = "field" | "banner" | "state" | "resolve" | "retry"
+const FALLBACK_SORT: SortSpec
+export interface FieldDataAdapter { count(slug: string, key: string): Promise<number> purge(slug: string, key: string, options?: FieldPurgeOptions): Promise<FieldPurgeResult> }
+export interface FieldKeyAvailability { available: boolean reason?: FieldKeyRejection message?: string }
+export type FieldKeyRejection = "invalid" | "reserved" | "live" | "removed"
+function fieldKeyState: (type: ContentTypeLike, key: string) => FieldKeyState
+export type FieldKeyState = "free" | "live" | "removed"
+function fieldMapSignature: (fields: FieldMap) => string
+export interface FieldOptionIssue { option: string message: string }
+function fieldOptionIssues: (registry: FieldTypeRegistry, field: FieldDefinition) => readonly FieldOptionIssue[]
+export interface FieldPurgeOptions { limit?: number }
+export interface FieldPurgeResult { purged: number remaining: boolean }
+export interface FieldRow { key: string field: FieldDefinition }
+function fileExtension: (name: string) => string
+export type FilterOperator = | "==" | "!=" | "<" | "<=" | ">" | ">=" | "in" | "not-in" | "array-contains" | "array-contains-any"
+const FIRESTORE_DOCUMENT_BYTES: 1048576
+export interface FirestoreIndex { collectionGroup: string queryScope: "COLLECTION" fields: readonly FirestoreIndexField[] }
+export interface FirestoreIndexField { fieldPath: string order: IndexOrder }
+function forgetRemovedField: (type: ContentTypeLike, key: string) => ContentTypeLike
+export interface FormField { key: string field: FieldDefinition }
+function formFields: (type: ContentTypeLike) => readonly FormField[]
+export interface FormIssue extends FieldError { origin: ErrorOrigin }
+function formValuesFromEntry: (type: ContentTypeLike, entry: Entry, registry: FieldTypeRegistry) => Record<string, unknown>
+const HUSK_TAG_PREFIX: "husk"
+function indexCovered: (file: { indexes?: readonly FirestoreIndex[]; }, required: FirestoreIndex) => boolean
+export type IndexOrder = "ASCENDING" | "DESCENDING"
+const INITIAL_FIELD_KEY: "title"
+const INITIAL_SCHEMA_VERSION: 1
+function initialFormValues: (type: ContentTypeLike, registry: FieldTypeRegistry) => Record<string, unknown>
+function initialListState: (type: ContentTypeLike) => ListViewState
+export interface InvalidContentType { slug: string reason: string definition: unknown }
+function isCollection: (type: KindShape) => boolean
+function isFilterableField: (field: FieldDefinition) => boolean
+function isHuskTag: (value: string) => boolean
+function isNarrowed: (state: ListViewState) => boolean
+function isSchemaReadOnly: (entry: RegistryEntry) => boolean
+function isSearching: (state: ListViewState) => boolean
+function isSingleton: (type: KindShape) => boolean
+export type KnownSlug<TTypes extends ContentTypeMap> = keyof TTypes & string
+export interface ListColumn { key: string label: string kind: ColumnKind align: ColumnAlign sortable: boolean }
+export interface ListColumnOptions { maxFieldColumns?: number }
+function listColumns: (type: ContentTypeLike, { maxFieldColumns }?: ListColumnOptions) => readonly ListColumn[]
+export interface ListFilterDescriptor { key: string label: string options: readonly ListFilterOption[] op: EntryFilter["op"] valueType: "string" | "boolean" }
+export interface ListFilterOption { value: string label: string }
+function listFilterQuery: (type: ContentTypeLike, filters: Readonly<Record<string, string>>) => readonly EntryFilter[]
+function listFilters: (type: ContentTypeLike) => readonly ListFilterDescriptor[]
+export interface ListQuery { filters?: readonly EntryFilter[] sort?: SortSpec search?: string limit?: number cursor?: string | null status?: EntryStatus | "any" }
+export interface ListViewState { search: string status: EntryStatus | "any" filters: Readonly<Record<string, string>> sort: SortSpec cursor: string | null }
+export class LockedTypeError extends Error { override readonly name = "LockedTypeError" readonly slug: string constructor(slug: string, reason?: string) { super( reason ?? `Content type "${slug}" is locked. It is defined in code and cannot be changed through the Schema Builder or the adapter.`, ) this.slug = slug } }
+const MAX_ARRAY_ITEMS: 1000
+const MAX_CONTENT_TYPE_FIELDS: 100
+const MAX_ENTRY_FIELDS: 200
+const MAX_ENTRY_INDEXES: 200
+const MAX_FIELD_COLUMNS: 2
+const MAX_FIELD_PURGE: 250
+const MAX_IMAGE_BYTES: number
+const MAX_MEDIA_BYTES: number
+const MAX_MEDIA_REFS: 100
+const MAX_NESTING_DEPTH: 20
+const MAX_PAGE_SIZE: 100
+const MAX_SETTINGS_FIELDS: 100
+const MAX_WRITE_BYTES: 900000
+const MEDIA_ACCEPT_ATTRIBUTE: string
+const MEDIA_REFS_KEY: "mediaRefs"
+const MEDIA_USAGE_LIMIT: 25
+export interface MediaAdapter { list(query?: MediaQuery): Promise<Page<MediaItem>> getById(mediaId: string): Promise<MediaItem | null> getMany(mediaIds: readonly string[]): Promise<readonly MediaItem[]> reserveId(): string create(input: MediaInput, mediaId?: string): Promise<MediaItem> update(mediaId: string, patch: Partial<MediaInput>): Promise<MediaItem> delete(mediaId: string): Promise<void> usages( mediaId: string, query?: MediaUsageQuery, ): Promise<readonly MediaUsageReference[]> refreshReferences(mediaId: string, url: string): Promise<MediaRefreshResult> usage(): Promise<MediaUsage> }
+export type MediaCategory = "image" | "video" | "audio" | "document"
+export interface MediaFileFacts { name: string type: string size: number }
+export interface MediaInput { name: string type: string size: number url: string path: string alt?: string | null width?: number | null height?: number | null }
+export interface MediaQuery { limit?: number cursor?: string | null type?: string }
+export interface MediaReader { getById(mediaId: string): Promise<MediaItem | null> getMany(mediaIds: readonly string[]): Promise<readonly MediaItem[]> }
+export interface MediaRefreshResult { updated: number failed: readonly MediaUsageReference[] }
+export interface MediaRejection { code: MediaRejectionCode message: string }
+export type MediaRejectionCode = "type-not-allowed" | "too-large" | "empty" | "extension-mismatch"
+function mediaTag: (mediaId: string) => string
+function mediaTypeRule: (type: string) => MediaTypeRule | null
+export interface MediaTypeRule { readonly type: string readonly category: MediaCategory readonly maxBytes: number readonly extensions: readonly string[] }
+export interface MediaUsage { count: number bytes: number }
+export interface MediaUsageQuery { limit?: number }
+export interface MediaUsageReference { contentType: string entryId: string title: string | null }
+function mergeIssues: (client: readonly FieldError[], server: readonly FieldError[]) => readonly FormIssue[]
+const MIGRATION_BATCH_SIZE: 50
+const MIGRATION_MAX_BATCHES: 20
+export interface MigrationAdapter { countBehind(slug: string, targetVersion: number): Promise<number> listBehind( slug: string, targetVersion: number, query?: { limit?: number }, ): Promise<Page<StoredEntryRecord>> applyMigration( slug: string, entryId: string, values: Record<string, unknown>, write: MigrationWrite, ): Promise<boolean> }
+export interface MigrationContext { entryId: string slug: string fromVersion: number }
+export interface MigrationFailure { entryId: string fromVersion: number reason: string }
+export interface MigrationRegistry { forType(slug: string): readonly EntryMigration[] plan(type: ContentTypeLike, fromVersion: number): readonly EntryMigration[] }
+export interface MigrationRunDeps { migrations: MigrationAdapter registry: MigrationRegistry type: ContentTypeLike }
+export interface MigrationRunOptions { batchSize?: number maxBatches?: number onProgress?: (progress: { scanned: number; migrated: number }) => void }
+export interface MigrationRunResult { slug: string targetVersion: number scanned: number migrated: number skipped: number failed: readonly MigrationFailure[] remaining: boolean }
+export interface MigrationWrite { expectedVersion: number nextVersion: number }
+const MIN_WRITE_INTERVAL_MS: 200
+function missingEntryIndexes: (file: { indexes?: readonly FirestoreIndex[]; }, types: readonly ContentTypeLike[]) => readonly FirestoreIndex[]
+function missingError: (subject: string) => ClassifiedError
+function moveFieldRow: (rows: readonly FieldRow[], from: number, to: number) => FieldRow[]
+function moveItem: <TItem>(items: readonly TItem[], from: number, to: number) => TItem[]
+function newContentType: (input: NewContentTypeInput) => ContentTypeLike
+export interface NewContentTypeInput { name: string slug: string kind: ContentTypeKind icon?: string namePlural?: string description?: string }
+function newFieldDefinition: (registry: FieldTypeRegistry, type: FieldType, label: string) => FieldDefinition
+function nextSchemaVersion: (previous: ContentTypeLike | null, next: ContentTypeLike) => number
+function nextSort: (current: SortSpec, column: ListColumn, key?: string) => SortSpec
+function normalizeConfirmation: (value: string) => string
+function normalizeLimit: (limit: number | undefined) => number
+function normalizeMediaType: (type: string) => string
+function orderedFieldKeys: (type: Pick<ContentTypeLike, "fields" | "fieldOrder">) => readonly string[]
+function orderedFields: (type: Pick<ContentTypeLike, "fields" | "fieldOrder">) => readonly FieldRow[]
+export interface Page<TItem> { items: readonly TItem[] cursor: string | null hasMore: boolean }
+export interface PayloadLimits { maxFields?: number maxBytes?: number }
+export class PermissionError extends Error { override readonly name = "PermissionError" readonly action: string readonly contentType: string | undefined constructor(action: string, contentType?: string, message?: string) { super( message ?? (contentType === undefined ? `This account may not ${action}.` : `This account may not ${action} entries of "${contentType}".`), ) this.action = action this.contentType = contentType } }
+export interface Registry { readonly types: readonly RegistryEntry[] readonly conflicts: readonly RegistryEntry[] readonly invalid: readonly InvalidContentType[] get(slug: string): RegistryEntry | undefined require(slug: string): RegistryEntry has(slug: string): boolean bySource(source: ContentTypeSource): readonly RegistryEntry[] }
+export interface RegistryEntry { type: ContentTypeLike source: ContentTypeSource locked: boolean conflict?: { source: "database"; type: ContentTypeLike } }
+export interface RegistryStore { readonly registry: Registry setDatabaseTypes(types: readonly ContentTypeLike[]): boolean subscribe(listener: (registry: Registry) => void): () => void readonly revision: number }
+export interface RemovalContext { removedBy: string removedAt?: string }
+function removedFieldEntries: (type: ContentTypeLike) => readonly (RemovedField & { key: string; })[]
+function removeField: (type: ContentTypeLike, key: string, context: RemovalContext) => ContentTypeLike
+function requiredEntryIndexes: (types: readonly ContentTypeLike[]) => readonly FirestoreIndex[]
+const RESERVED_TYPE_SLUGS: ReadonlyArray<string>
+function restoreField: (type: ContentTypeLike, key: string, options?: RestoreOptions) => ContentTypeLike
+export interface RestoreOptions { field?: FieldDefinition }
+function retargetMediaUrls: (data: Record<string, unknown>, mediaId: string, url: string) => Record<string, unknown> | null
+function runMigration: (deps: MigrationRunDeps, options?: MigrationRunOptions) => Promise<MigrationRunResult>
+function safeFileName: (name: string, type: string) => string
+function sameDefinition: (left: ContentTypeLike, right: ContentTypeLike) => boolean
+export interface SchemaAdapter { list(): Promise<readonly ContentTypeLike[]> get(slug: string): Promise<ContentTypeLike | null> create(type: ContentTypeLike): Promise<ContentTypeLike> update(slug: string, type: ContentTypeLike): Promise<ContentTypeLike> delete(slug: string): Promise<void> watch( listener: (types: readonly ContentTypeLike[]) => void, onError?: (error: Error) => void, ): () => void }
+export class SchemaError extends Error { override readonly name = "SchemaError" constructor(message: string) { super(message) } }
+function schemaVersionOf: (type: Pick<ContentTypeLike, "schemaVersion">) => number
+export interface SettingsAdapter { get(key: string): Promise<Record<string, unknown> | null> set(key: string, value: Record<string, unknown>): Promise<void> }
+export interface SettingsReader { get(key: string): Promise<Record<string, unknown> | null> }
+function settingsTag: (key: string) => string
+export interface SingleReader<TEntry = Entry> { get(): Promise<TEntry | null> }
+function singletonEntryId: (slug: string) => string
+export class SingletonError extends Error { override readonly name = "SingletonError" readonly slug: string constructor(slug: string, message: string) { super(message) this.slug = slug } }
+export interface SlugAvailability { available: boolean reason?: SlugRejection message?: string source?: ContentTypeSource }
+function slugFieldKey: (type: ContentTypeLike) => string | null
+export type SlugOf<TTypes extends ContentTypeMap> = KnownSlug<TTypes> | (string & Record<never, never>)
+export type SlugRejection = "invalid" | "reserved" | "taken-by-code" | "taken-by-database"
+function sortableFieldKeys: (type: ContentTypeLike) => readonly string[]
+export interface SortSpec { field: string direction: "asc" | "desc" }
+function staleWriteError: (subject: string) => ClassifiedError
+const STATUS_EFFECT: Readonly<Record<"draft" | "published" | "archived", string>>
+export type StatusSubject = Pick<EntryMeta, "status" | "createdBy">
+export interface StatusTransition { to: EntryStatus label: string effect: string allowed: boolean reason: string | null }
+function statusTransitions: (user: AuthUser, type: ContentTypeLike, entry: StatusSubject | null) => readonly StatusTransition[]
+function storageShapeChanged: (previous: ContentTypeLike, next: ContentTypeLike) => boolean
+function storageSignature: (type: Pick<ContentTypeLike, "kind" | "fields">) => string
+function storageSignatureOf: (field: FieldDefinition) => string
+export interface StoredEntryRecord { id: string schemaVersion: number values: Record<string, unknown> }
+function storesTheSameWay: (left: FieldDefinition, right: FieldDefinition) => boolean
+function suggestFieldKey: (label: string) => string
+function treatmentFor: (category: ErrorCategory) => ErrorTreatment
+function unroutableIssues: <TError extends FieldError>(issues: readonly TError[], type: ContentTypeLike) => readonly TError[]
+const UNTITLED_ENTRY: "Untitled"
+const VALIDATION_RULE_CONTROLS: { readonly required: ValidationRuleControl; readonly minLength: ValidationRuleControl; readonly maxLength: ValidationRuleControl; readonly min: ValidationRuleControl; readonly max: ValidationRuleControl; readonly pattern: ValidationRuleControl; readonly unique: ValidationRuleControl; }
+export class ValidationError extends Error { override readonly name = "ValidationError" readonly errors: readonly FieldError[] constructor(errors: readonly FieldError[]) { super( errors.length === 1 && errors[0] ? `${errors[0].path}: ${errors[0].message}` : `${errors.length} fields failed validation`, ) this.errors = errors } }
+export interface ValidationRuleControl { label: string control: "boolean" | "number" | "text" help: string }
+export type ValidationRuleName = keyof ValidationRules
+function valuesChanged: (baseline: Record<string, unknown>, current: Record<string, unknown>) => boolean
+function withFieldOption: (field: FieldDefinition, option: string, value: unknown) => FieldDefinition
+function withFieldRows: (type: ContentTypeLike, rows: readonly FieldRow[]) => ContentTypeLike
+function withValidationRule: (field: FieldDefinition, rule: ValidationRuleName, value: string | number | boolean | undefined) => FieldDefinition
+const WRITE_BURST_LIMIT: 200
+const WRITE_BURST_WINDOW_MS: 10000
+export type WriteLimitCode = "too-many-fields" | "too-large" | "too-deep" | "too-many-items" | "too-fast"
+export class WriteLimitError extends Error { override readonly name = "WriteLimitError" readonly code: string readonly path: string constructor(rejection: { code: string; path: string; message: string }) { super(rejection.message) this.code = rejection.code this.path = rejection.path } }
+export interface WriteLimitRejection { code: WriteLimitCode path: string message: string }
+export interface WriteRateLimiter { check(): WriteLimitRejection | null }
+```
+
+## `@nonext/husk/firebase`
+
+36 exports.
+
+```ts
+export class AuthError extends Error { override readonly name = "AuthError" readonly code: AuthErrorCode constructor(code: AuthErrorCode, message: string) { super(message) this.code = code } }
+export type AuthErrorCode = "disabled" | "invalid-credentials"
+const browserImageSize: ImageSizeReader
+export interface ClaimSet { role: Role disabled: boolean }
+export interface ClaimSync { sync(uid: string, claims: ClaimSet): Promise<void> }
+export class ClaimSyncError extends Error { override readonly name = "ClaimSyncError" readonly uid: string constructor(uid: string, message: string) { super(message) this.uid = uid } }
+function createEmulatorClaimSync: (options: EmulatorClaimSyncOptions) => ClaimSync
+function createFirestoreAdapter: (deps: FirestoreAdapterDeps) => CmsAdapter
+function createHuskAuth: (deps: HuskAuthDeps) => HuskAuth
+function createMediaReplace: (deps: MediaUploadDeps, existing: MediaItem, file: File, options?: MediaUploadOptions) => MediaUpload
+function createMediaUpload: (deps: MediaUploadDeps, file: File, options?: MediaUploadOptions) => MediaUpload
+function createMediaUploader: (deps: MediaUploadDeps) => MediaUploader
+function createUnavailableClaimSync: (reason?: string) => ClaimSync
+export interface EmulatorClaimSyncOptions { authHost: string projectId: string }
+export interface FirestoreAdapterDeps { db: Firestore registry: () => Registry currentUser: () => AuthUser session?: () => AuthUser | null fieldTypes?: FieldTypeRegistry rateLimiter?: WriteRateLimiter | null }
+export interface HuskAuth { signIn(email: string, password: string): Promise<AuthUser> signUp(input: SignUpInput): Promise<AuthUser> signOut(): Promise<void> currentUser(): Promise<AuthUser | null> onChange( listener: (user: AuthUser | null) => void, onError?: (error: unknown) => void, ): () => void getUser(uid: string): Promise<StoredUser | null> updateProfile( uid: string, patch: Omit<UserPatch, "role" | "disabled">, ): Promise<StoredUser> setRole(uid: string, role: Role): Promise<StoredUser> setDisabled(uid: string, disabled: boolean): Promise<StoredUser> }
+export interface HuskAuthDeps { auth: Auth db: Firestore claimSync: ClaimSync defaultRole?: Role }
+export interface ImageSize { width: number height: number }
+export type ImageSizeReader = (file: Blob, type: string) => Promise<ImageSize | null>
+export interface MediaUpload { readonly mediaId: string readonly path: string readonly fileName: string progress(): UploadProgress start(): Promise<MediaItem> retry(): Promise<MediaItem> cancel(): void }
+export interface MediaUploadDeps { storage: FirebaseStorage media: MediaAdapter currentUser: () => AuthUser readImageSize?: ImageSizeReader }
+export class MediaUploadError extends Error { override readonly name = "MediaUploadError" readonly code: MediaUploadErrorCode readonly rejection: MediaRejection | null readonly orphanedPath: string | null constructor( code: MediaUploadErrorCode, message: string, detail: { rejection?: MediaRejection; orphanedPath?: string; cause?: unknown } = {}, ) { super(message, detail.cause === undefined ? undefined : { cause: detail.cause }) this.code = code this.rejection = detail.rejection ?? null this.orphanedPath = detail.orphanedPath ?? null } }
+export type MediaUploadErrorCode = "rejected" | "cancelled" | "storage-failed" | "metadata-failed"
+export interface MediaUploadOptions { onProgress?: (progress: UploadProgress) => void alt?: string | null }
+export interface NewUser { uid: string email: string displayName?: string | null role: Role }
+function patchUser: (db: Firestore, uid: string, patch: UserPatch) => Promise<StoredUser>
+function readUser: (db: Firestore, uid: string) => Promise<StoredUser | null>
+function removeOrphan: (storage: FirebaseStorage, path: string) => Promise<boolean>
+export interface SignUpInput { email: string password: string displayName?: string }
+export interface StoredUser { uid: string email: string displayName: string | null role: Role createdAt: string disabled: boolean }
+function toAuthUser: (stored: StoredUser) => AuthUser
+function uploadMedia: (deps: MediaUploadDeps, file: File, options?: MediaUploadOptions) => Promise<MediaItem>
+export type UploadPhase = "idle" | "uploading" | "storing" | "done" | "cancelled" | "failed"
+export interface UploadProgress { phase: UploadPhase bytesTransferred: number totalBytes: number fraction: number attempt: number }
+export interface UserPatch { displayName?: string | null role?: Role disabled?: boolean }
+function writeUser: (db: Firestore, user: NewUser) => Promise<StoredUser>
+```
+
+## `@nonext/husk/permissions`
+
+20 exports.
+
+```ts
+const ACTIONS: ReadonlyArray<Action>
+const ADMIN_ACTIONS: readonly ["manage-schema", "manage-users", "manage-settings", "manage-media"]
+function assertValidPermissionMatrix: (slug: string, matrix: unknown) => void
+function can: (user: AuthUser, action: Action, context?: PermissionContext) => boolean
+export type Decision = "allow" | "deny" | "own-entry-only"
+function defaultRoles: (action: EntryAction) => readonly Role[]
+export type EntryOwnership = Pick<EntryMeta, "createdBy">
+function isEntryAction: (action: Action) => action is EntryAction
+const MATRIX_ACTIONS: ReadonlyArray<EntryAction>
+const MATRIX_LIMITS: { readonly admin: "An admin is never restricted by a matrix. Removing every other role from an action leaves it admin-only; there is no way to lock an admin out of their own project."; readonly ownership: "An author may only ever update or delete entries they created. Ticking an author here grants the action on their own entries, never on somebody else's."; readonly narrowing: "A matrix can only take permissions away. Ticking a role that its own role does not grant changes nothing, and the row says so."; readonly publicRead: "Denying read hides entries from the admin, not from the public website. A published entry is readable by anyone with its address by design; unpublish it to take it down."; }
+export interface MatrixCell { role: Role listed: boolean decision: MatrixDecision fixed: boolean }
+function matrixDecision: (type: Pick<ContentTypeLike, "permissions"> | undefined, role: Role, action: EntryAction) => MatrixDecision
+export type MatrixDecision = Decision
+export interface MatrixRow { action: EntryAction cells: readonly MatrixCell[] }
+function normalizePermissionMatrix: (matrix: PermissionMatrix | undefined) => PermissionMatrix | undefined
+const PERMISSION_DEFAULTS: Readonly<Record<"admin" | "editor" | "author", Readonly<Record<Action, Decision>>>>
+export interface PermissionContext { type?: ContentTypeLike entry?: EntryOwnership }
+function permissionMatrixRows: (type: Pick<ContentTypeLike, "permissions"> | undefined) => readonly MatrixRow[]
+function resolveDecision: (role: Role, action: Action, type: Pick<ContentTypeLike, "permissions"> | undefined) => Decision
+function withMatrixRole: (matrix: PermissionMatrix | undefined, action: EntryAction, role: Role, listed: boolean) => PermissionMatrix | undefined
+```
+
+## `@nonext/husk/richtext`
+
+9 exports.
+
+```ts
+function isEmptyRichTextContent: (content: unknown) => boolean
+function isRichTextValue: (raw: unknown) => raw is RichTextValue
+function RichText: ({ value }: RichTextProps) => ReactNode
+const RICHTEXT_FORMAT: "husk-richtext-v1"
+export interface RichTextNodeJSON { type?: string attrs?: Record<string, unknown> content?: RichTextNodeJSON[] marks?: { type: string; attrs?: Record<string, unknown> }[] text?: string }
+export interface RichTextProps { value: RichTextValue | null }
+function richTextToPlainText: (content: unknown) => string
+export interface RichTextValue { format: "husk-richtext-v1" content: unknown }
+function safeHref: (value: unknown) => string | null
+```
+
+## `@nonext/husk/schema`
+
+19 exports.
+
+```ts
+export type AnyFieldTypeSpec = FieldTypeSpec<any, any>
+export interface FieldEditorSpec { label: string description: string rules: readonly (keyof ValidationRules)[] options: readonly FieldOptionDescriptor[] defaults: Record<string, unknown> }
+export type FieldInputComponent< TValue, TField extends FieldDefinition = FieldDefinition, > = ComponentType<FieldInputProps<TValue, TField>>
+export interface FieldInputProps< TValue, TField extends FieldDefinition = FieldDefinition, > { path: string field: TField value: TValue | null onChange: (value: TValue | null) => void onBlur?: (() => void) | undefined errors: readonly FieldError[] disabled?: boolean | undefined readonly?: boolean | undefined }
+export type FieldOptionControl = | "text" | "number" | "boolean" | "choice" | "select-options" | "content-type" | "field-key" | "string-list" | "fields"
+export interface FieldOptionDescriptor { key: string label: string control: FieldOptionControl help?: string required?: boolean choices?: readonly { value: string; label: string }[] }
+export type FieldTsType<TField extends FieldDefinition = FieldDefinition> = string | ((field: TField, resolve: TsTypeResolver) => string)
+export interface FieldTypeRegistry { get(name: string): AnyFieldTypeSpec | undefined require(name: string): AnyFieldTypeSpec has(name: string): boolean readonly names: readonly FieldType[] }
+export interface FieldTypeSpec<TValue, TField extends FieldDefinition = FieldDefinition> { name: FieldType toStored(value: TValue | null, field: TField, nested?: NestedConverter): unknown fromStored(raw: unknown, field: TField, nested?: NestedConverter): TValue | null Input: FieldInputComponent<TValue, TField> validate( value: TValue | null, rules: ValidationRules, ctx: ValidateCtx, field: TField, ): FieldError[] tsType: FieldTsType<TField> defaultValue(field: TField): TValue | null editor: FieldEditorSpec }
+export interface NestedConverter { toStored(fields: FieldMap, values: Record<string, unknown>): Record<string, unknown> fromStored(fields: FieldMap, data: Record<string, unknown>): Record<string, unknown> }
+const PATTERN_PRESETS: { readonly email: "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$"; readonly slug: "^[a-z0-9]+(?:-[a-z0-9]+)*$"; readonly url: "^https?://[^\\s]+$"; }
+function registerFieldTypes: (specs: readonly AnyFieldTypeSpec[]) => FieldTypeRegistry
+function resolveTsType: (registry: FieldTypeRegistry, field: FieldDefinition) => string
+export type TsTypeResolver = (field: FieldDefinition) => string
+function uniqueFieldPaths: (type: AnyContentTypeShape) => string[]
+const UNKNOWN_TS_TYPE: "unknown"
+export interface ValidateCtx { path: string contentType: AnyContentTypeShape entry: Record<string, unknown> }
+function validateEntry: (type: AnyContentTypeShape, values: Record<string, unknown>, options?: ValidateOptions) => FieldError[]
+export interface ValidateOptions { skipRequired?: boolean fieldTypes?: FieldTypeRegistry }
+```
+
+## `@nonext/husk/server`
+
+12 exports.
+
+```ts
+export interface Cms<TTypes extends ContentTypeMap = ContentTypeMap> { collection<TSlug extends SlugOf<TTypes>>( slug: TSlug, ): CollectionReader<EntryOf<TTypes, TSlug>> single<TSlug extends SlugOf<TTypes>>(slug: TSlug): SingleReader<EntryOf<TTypes, TSlug>> media(): MediaReader settings(): SettingsReader readonly isPreview: boolean }
+export type CmsCountQuery = Pick<CmsQuery, "filters" | "search">
+export type CmsQuery = Omit<ListQuery, "status">
+export interface CollectionReader<TEntry = Entry> { findMany(query?: CmsQuery): Promise<Page<TEntry>> findBySlug(value: string): Promise<TEntry | null> findById(entryId: string): Promise<TEntry | null> count(query?: CmsCountQuery): Promise<number> }
+export type ContentTypeMap = { readonly [slug: string]: KindShape & AnyContentTypeShape }
+function createServerCMS: <TTypes extends ContentTypeMap = ContentTypeMap>(config: ServerCmsConfig<TTypes>) => ServerCms<TTypes>
+export type EntryOf< TTypes extends ContentTypeMap, TSlug extends string, > = TSlug extends keyof TTypes ? Entry<TTypes[TSlug]> : Entry
+export interface MediaReader { getById(mediaId: string): Promise<MediaItem | null> getMany(mediaIds: readonly string[]): Promise<readonly MediaItem[]> }
+export interface ServerCms< TTypes extends ContentTypeMap = ContentTypeMap, > extends Cms<TTypes> { preview(): ServerCms<TTypes> }
+export type ServerCmsConfig<TTypes extends ContentTypeMap = ContentTypeMap> = CmsConfig<TTypes>
+export interface SettingsReader { get(key: string): Promise<Record<string, unknown> | null> }
+export interface SingleReader<TEntry = Entry> { get(): Promise<TEntry | null> }
+```
+
+## `@nonext/husk/types`
+
+51 exports.
+
+```ts
+export type Action = EntryAction | AdminAction
+export type AdminAction = "manage-schema" | "manage-users" | "manage-settings" | "manage-media"
+export type AnyContentTypeShape = { fields: FieldMap }
+export interface AuthUser { uid: string email: string displayName: string | null role: Role disabled: boolean }
+export interface BooleanField extends FieldCommon { type: "boolean" defaultValue?: boolean }
+export interface ContentType<TFields extends FieldMap = FieldMap> { slug: string kind: ContentTypeKind label: string labelPlural?: string description?: string icon?: string fields: TFields fieldOrder?: readonly string[] removedFields?: RemovedFieldMap locked?: boolean titleField?: keyof TFields & string defaultSort?: { field: keyof TFields & string; direction: "asc" | "desc" } permissions?: PermissionMatrix schemaVersion?: number }
+export type ContentTypeInputValues<TType extends { fields: FieldMap }> = FieldInputValues< TType["fields"] >
+export type ContentTypeKind = "collection" | "singleton"
+export interface ContentTypeLike { slug: string kind: ContentTypeKind label: string labelPlural?: string description?: string icon?: string fields: FieldMap fieldOrder?: readonly string[] removedFields?: RemovedFieldMap locked?: boolean titleField?: string defaultSort?: { field: string; direction: "asc" | "desc" } permissions?: PermissionMatrix schemaVersion?: number }
+export type ContentTypeSource = "code" | "database"
+export type ContentTypeValues<TType extends { fields: FieldMap }> = FieldValues< TType["fields"] >
+export interface DateField extends FieldCommon { type: "date" precision?: "date" | "datetime" }
+export type Entry<TType extends AnyContentTypeShape = AnyContentTypeShape> = EntryMeta & ContentTypeValues<TType>
+const ENTRY_ACTIONS: readonly ["read", "create", "update", "delete"]
+const ENTRY_STATUSES: readonly ["draft", "published", "archived"]
+export type EntryAction = "read" | "create" | "update" | "delete"
+export type EntryInput<TType extends AnyContentTypeShape = AnyContentTypeShape> = ContentTypeInputValues<TType> & { status?: EntryStatus }
+export interface EntryMeta { id: string status: EntryStatus createdAt: string createdBy: string updatedAt: string updatedBy: string publishedAt: string | null schemaVersion: number }
+export type EntryStatus = (typeof ENTRY_STATUSES)[number]
+const FIELD_TYPES: readonly ["text", "textarea", "number", "boolean", "select", "date", "slug", "richtext", "image", "file", "relation", "repeater"]
+export type FieldDefinition = | TextField | TextareaField | NumberField | BooleanField | SelectField | DateField | SlugField | RichtextField | ImageField | FileField | RelationField | RepeaterField
+export interface FieldError { path: string rule: string message: string }
+export type FieldInputValues<TFields extends FieldMap> = { [K in keyof TFields as IsRequired<TFields[K]> extends true ? K : never]: FieldValue< TFields[K] > } & { [K in keyof TFields as IsRequired<TFields[K]> extends true ? never : K]?: FieldValue< TFields[K] > | null }
+export type FieldMap = { readonly [key: string]: FieldDefinition }
+export type FieldType = (typeof FIELD_TYPES)[number]
+export type FieldValue<TField extends FieldDefinition> = TField extends TextField | TextareaField | SlugField ? string : TField extends NumberField ? number : TField extends BooleanField ? boolean : TField extends DateField ? string : TField extends SelectField<infer TOption> ? TField extends { multiple: true } ? TOption[] : TOption : TField extends RichtextField ? RichTextValue : TField extends ImageField | FileField ? MediaReference : TField extends RelationField ? TField extends { many: true } ? string[] : string : TField extends RepeaterField<infer TFields> ? FieldValues<TFields>[] : never
+export type FieldValues<TFields extends FieldMap> = { [K in keyof TFields]: IsRequired<TFields[K]> extends true ? FieldValue<TFields[K]> : FieldValue<TFields[K]> | null }
+export interface FileField extends FieldCommon { type: "file" accept?: readonly string[] }
+export interface HuskConfig { generatedWith: string adminRoute: string projectId: string storageBucket: string media: boolean auth: boolean emulators: boolean }
+export interface ImageField extends FieldCommon { type: "image" accept?: readonly string[] }
+export interface MediaItem { id: string name: string type: string size: number url: string path: string alt: string | null width: number | null height: number | null createdAt: string createdBy: string }
+export interface MediaReference { mediaId: string url: string }
+export interface NumberField extends FieldCommon { type: "number" step?: number defaultValue?: number }
+export interface Permission { action: Action contentType?: string }
+export type PermissionMatrix = Partial<Record<EntryAction, readonly Role[]>>
+export interface RelationField<TTo extends string = string> extends FieldCommon { type: "relation" to: TTo many?: boolean }
+export interface RemovedField { field: FieldDefinition removedAt: string removedBy: string }
+export type RemovedFieldMap = { readonly [key: string]: RemovedField }
+export interface RepeaterField<TFields extends FieldMap = FieldMap> extends FieldCommon { type: "repeater" fields: TFields min?: number max?: number }
+const RESERVED_FIELD_KEYS: readonly ["id", "status", "createdAt", "createdBy", "updatedAt", "updatedBy", "publishedAt", "schemaVersion"]
+export type ReservedFieldKey = (typeof RESERVED_FIELD_KEYS)[number]
+export interface RichtextField extends FieldCommon { type: "richtext" features?: readonly string[] }
+export interface RichTextValue { format: "husk-richtext-v1" content: unknown }
+export type Role = (typeof ROLES)[number]
+const ROLES: readonly ["admin", "editor", "author"]
+export interface SelectField<TValue extends string = string> extends FieldCommon { type: "select" options: readonly SelectOption<TValue>[] multiple?: boolean defaultValue?: TValue }
+export interface SelectOption<TValue extends string = string> { value: TValue label: string }
+export interface SlugField extends FieldCommon { type: "slug" from?: string }
+export interface TextareaField extends FieldCommon { type: "textarea" rows?: number defaultValue?: string }
+export interface TextField extends FieldCommon { type: "text" defaultValue?: string }
+export interface ValidationRules { required?: boolean minLength?: number maxLength?: number min?: number max?: number pattern?: string unique?: boolean }
+```