import { ArrayType } from './array.js';
import type { StructConstructor, StructInstance } from './structs.shared.js';
import { type Type, type Value } from './types.js';
export interface FieldOptions {
    bigEndian?: boolean;
    align?: number;
    typeName?: string;
    countedBy?: string | ((instance: StructInstance<any>) => number);
}
export interface FieldConfig<T extends Type> extends FieldOptions {
    type: T;
}
export interface Field<T extends Type<any> = Type> {
    name: string;
    type: T;
    /** The static offset of the field */
    offset: number;
    alignment: number;
    countedBy?: string | ((instance: StructInstance<any>) => number);
    /** A C-style type/name declaration string, used for diagnostics */
    readonly decl: string;
    /** Whether the field is little endian */
    littleEndian: boolean;
}
export type FieldConfigInit<T extends Type = Type> = FieldConfig<T> | T | FieldBuilder<T, any>;
export type FieldValue<Init extends FieldConfigInit> = Init extends StructConstructor<any> ? InstanceType<Init> : Init extends Type ? Value<Init> : Init extends FieldConfigInit<infer T extends Type> ? Value<T> : never;
export declare function parseFieldConfig<T extends Type>(init: FieldConfigInit<T>): FieldConfig<T>;
type _ToArray<T extends Type = Type, Config extends FieldOptions = {}> = {
    (length: number): FieldBuilder<ArrayType<T>, Config>;
};
export interface FieldBuilder<T extends Type = Type, Config extends FieldOptions = {}> extends _ToArray<T, Config> {
}
export declare class FieldBuilder<T extends Type = Type, Config extends FieldOptions = {}> {
    readonly type: T;
    private readonly init;
    constructor(type: T, init: Config);
    /**
     * Align the field to a given byte boundary.
     */
    align<const N extends number>(align: N): FieldBuilder<T, Config & {
        align: N;
    }>;
    countedBy<const K extends string>(field: K): FieldBuilder<T, Config & {
        countedBy: K;
    }>;
    countedBy(fn: (instance: StructInstance<any>) => number): FieldBuilder<T, Config & {
        countedBy: typeof fn;
    }>;
    /**
     * Set the field to big-endian.
     */
    bigEndian(): FieldBuilder<T, Config & {
        bigEndian: true;
    }>;
    toInit(): FieldConfig<T> & Config;
    /**
     * Override the typescript type of the field's value, for example to override `number` with an enum type.
     * This does not have any runtime effects.
     */
    $type<NewValue>(): FieldBuilder<T & Type<NewValue>, Config>;
}
export declare function array<T extends Type>(type: T, length?: number): FieldBuilder<ArrayType<T>>;
export {};