links-notation 0.22.0 → 0.24.0

package/index.d.ts

@@ -470,3 +470,99 @@ export function formatLinks(
   links: Link[],
   lessParentheses?: boolean | FormatOptions | FormatConfig
 ): string;
+
+/** Binary links notation v1: bigint preserves unsigned 64-bit references. */
+export class External {
+  value: bigint;
+  constructor(value: bigint | number);
+}
+export class ArityRange {
+  min: bigint;
+  max: bigint | null;
+  constructor(min?: bigint | number, max?: bigint | number | null);
+  contains(length: bigint | number): boolean;
+  readonly fixed: boolean;
+  static parse(text: string): ArityRange;
+}
+export interface BinaryLimits {
+  maxLinks: number;
+  maxReferences: number;
+  maxNodes: number;
+  maxStringBytes: number;
+  maxDepth: number;
+}
+export class DecodeLimits implements BinaryLimits {
+  maxLinks: number;
+  maxReferences: number;
+  maxNodes: number;
+  maxStringBytes: number;
+  maxDepth: number;
+  constructor(values?: Partial<BinaryLimits>);
+  static unlimited(): DecodeLimits;
+}
+export class BinaryLinoOptions {
+  externalReferences: boolean;
+  arity: ArityRange;
+  packedWidths: boolean;
+  constructor(
+    externalReferences?: boolean,
+    arity?: ArityRange,
+    packedWidths?: boolean
+  );
+  static ofPacket(packet: LinksPacket): BinaryLinoOptions;
+}
+export type PacketReference = bigint | number | External;
+export type AddressedLink = [bigint | number, PacketReference[]];
+export class Section {
+  gap: bigint;
+  arity: ArityRange;
+  width: number;
+  links: PacketReference[][];
+  constructor(
+    gap: bigint | number,
+    arity: ArityRange,
+    width: number,
+    links: PacketReference[][]
+  );
+}
+export class PacketReader {
+  bytes: Uint8Array;
+  offset: number;
+  constructor(bytes: Uint8Array, offset?: number);
+  read(limits?: DecodeLimits): LinksPacket | null;
+}
+export class LinksPacket {
+  externalReferences: boolean;
+  sections: Section[];
+  constructor(externalReferences?: boolean, sections?: Section[]);
+  links(): [bigint, (bigint | External)[]][];
+  validate(limits?: DecodeLimits): this;
+  toBytes(limits?: DecodeLimits): Uint8Array;
+  static fromBytes(bytes: Uint8Array, limits?: DecodeLimits): LinksPacket;
+  static parseLinks(text: string): [bigint, (bigint | External)[]][];
+  static pack(
+    externalReferences: boolean,
+    links: AddressedLink[],
+    packedWidths?: boolean
+  ): LinksPacket;
+}
+export class BinaryLinoCodec {
+  options: BinaryLinoOptions;
+  limits: DecodeLimits;
+  constructor(options?: BinaryLinoOptions, limits?: DecodeLimits);
+  encodePacket(document: Link[]): LinksPacket;
+  encode(document: Link[]): Uint8Array;
+  decodePacket(packet: LinksPacket): Link[];
+  decode(bytes: Uint8Array): Link[];
+  parseDocument(text: string, parser?: Parser): Link[];
+  formatDocument(document: Link[]): string;
+  encodeText(text: string, parser?: Parser): Uint8Array;
+  decodeText(bytes: Uint8Array): string;
+}
+export function formatBinaryDocument(document: Link[]): string;
+export function formatBinaryReference(reference: string): string;
+
+/** Encode exact Unicode as a version 1 UTF-8 hex literal (~1{...}). Throws on unpaired surrogates. */
+export function encodeReferenceLiteral(text: string): string;
+/** Decode a complete literal. Throws on malformed hex, UTF-8, or unsupported versions. */
+export function decodeReferenceLiteral(literal: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "links-notation",
-  "version": "0.22.0",
+  "version": "0.24.0",
   "description": "Links Notation parser for JavaScript",
   "main": "dist/index.js",
   "types": "index.d.ts",
@@ -32,10 +32,10 @@
   },
   "homepage": "https://github.com/link-foundation/links-notation#readme",
   "devDependencies": {
-    "bun-types": "^1.4.0",
-    "eslint": "^10.9.1",
+    "bun-types": "^1.4.2",
+    "eslint": "^10.12.0",
     "peggy": "^5.1.0",
-    "prettier": "^3.9.6",
+    "prettier": "^3.9.9",
     "typescript": "^7.0.2"
   }
 }