IsoParseOptions — @gj-kit/format

A public interface from @gj-kit/format. The signature below is taken directly from the 0.1.1 release declaration.

Verified import example

import { IsoParseOptions } from '@gj-kit/format';

Signature, parameters, and return type

interface IsoParseOptions {
    /**
     * Required policy for ISO strings that carry no UTC offset, e.g.
     * `'2026-06-08T09:05:00'`. There is no safe default: the `Date` constructor
     * resolves these against the device zone, so the same string is a different
     * instant on a Seoul phone (`00:05Z`) and a New York phone (`13:05Z`).
     * - `'utc'`    — read the wall clock as UTC.
     * - `'device'` — read it as device-local time. Same behaviour the source apps
     *                had, now spelled out at the call site.
     * - `'reject'` — return null; the caller renders its fallback.
     *
     * Date-only strings (`'2026-06-08'`) are always UTC midnight — that reading is
     * unambiguous per ECMA-262 and this option does not affect them.
     */
    readonly assumeNoOffset: 'utc' | 'device' | 'reject';
}

This declaration is the source of truth for parameters, optionality, generics, return values, and public union/type contracts. Check the package golden path and this subpath’s import conditions for required environment, permission, and error boundaries before calling it.

Release context

• Package: @gj-kit/format
• Version: 0.1.1
• Public entry: .
• Source: GitHub