/**
 * Shared classification of TypeSpec scalar types for the numeric-bridging and
 * entry-shorthand paths.
 *
 * These live here rather than in a single backend because every backend that
 * expands an immediate scalar has to agree on two things: which TypeSpec scalars
 * are integral versus fractional, and the order the resulting runtime checks are
 * emitted in. Duplicating either per backend is how the coercion family drifted
 * apart in the first place.
 *
 * The sets cover the whole TypeSpec numeric tower rather than the handful a
 * particular schema happens to use, because a scalar that falls through every
 * classification produces no runtime arm at all — a silent degradation that is
 * far harder to notice than a compile error.
 */
import type { CollectionHelperDecl, EntryShorthandCase } from "./declarations.js";
/**
 * TypeSpec scalars that decode from a JSON integer token.
 *
 * Includes the sized and unsigned families and `safeint`; omitting them meant a
 * schema declaring `int16` got neither a numeric bridge nor a shorthand arm.
 */
export declare const INTEGRAL_SCALAR_TYPES: Set<string>;
/**
 * TypeSpec scalars that decode from a JSON fractional token.
 *
 * `numeric` is the root of the numeric tower and may carry a fraction, so it is
 * classified fractional. `decimal`/`decimal128` are included because they too
 * arrive as JSON numbers even though some runtimes widen them differently.
 */
export declare const FRACTIONAL_SCALAR_TYPES: Set<string>;
/**
 * TypeSpec scalars whose JSON encoding is a string.
 *
 * These are not interchangeable with `string` in the type system, but every one
 * of them arrives at a decoder as a JSON string, so the runtime check that
 * distinguishes them from numbers and booleans is exactly the `string` check.
 */
export declare const STRING_ENCODED_SCALAR_TYPES: Set<string>;
export declare function isIntegralScalar(scalarType: string): boolean;
export declare function isFractionalScalar(scalarType: string): boolean;
export declare function isStringEncodedScalar(scalarType: string): boolean;
export declare function isBooleanScalar(scalarType: string): boolean;
/**
 * The four runtime shapes a decoded JSON scalar can take.
 *
 * Backends map this, rather than the raw TypeSpec scalar name, onto their own
 * runtime checks. `null` means the scalar has no distinguishable JSON form and
 * the caller must decide whether to skip it or report it.
 */
export type ScalarRuntimeKind = "integral" | "fractional" | "string" | "boolean";
export declare function scalarRuntimeKind(scalarType: string): ScalarRuntimeKind | null;
/**
 * Order entry-shorthand cases so integral checks precede fractional ones.
 *
 * Every runtime that distinguishes the two must test integral first. Decoders
 * that preserve the token's int/float distinction (serde_json, yaml.v3,
 * `Number.isInteger`) will answer "is this a float?" affirmatively for an
 * integer under a widening check, so a fractional-first order silently collapses
 * every integer into a float — the exact defect fixed in the direct-coercion path.
 *
 * Cases whose scalar has no distinguishable JSON form are dropped here rather
 * than emitted as an unreachable arm; `unmappableShorthandScalars` reports them.
 */
export declare function orderedEntryShorthandCases(cases: readonly EntryShorthandCase[]): EntryShorthandCase[];
/** Scalar types in the shorthand table that no runtime check can recognise. */
export declare function unmappableShorthandScalars(cases: readonly EntryShorthandCase[]): string[];
/**
 * The field an immediate scalar entry value is assigned to.
 *
 * Prefers the explicit `@entryShorthand` declaration, then the field that direct
 * coercion targets, and only then falls back to the first declared field. That
 * last fallback is positional and unsound for a discriminated element type — it
 * lands the raw scalar in the discriminator — but it is the historical behaviour
 * and is preserved so undeclared schemas do not change shape.
 */
export declare function entryShorthandTarget(helper: CollectionHelperDecl, fallback?: string): string;