milsymbol-sidc 0.1.2 → 0.3.0

package/README.md

@@ -1,5 +1,10 @@
 # milsymbol-sidc
 
+[![npm version](https://img.shields.io/npm/v/milsymbol-sidc.svg)](https://www.npmjs.com/package/milsymbol-sidc)
+[![npm downloads](https://img.shields.io/npm/dm/milsymbol-sidc.svg)](https://www.npmjs.com/package/milsymbol-sidc)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-%E2%89%A55.7-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
 A fluent TypeScript builder for **20-character numeric SIDC strings** — the
 symbol identification code format used by [MIL-STD-2525E](https://en.wikipedia.org/wiki/MIL-STD-2525)
 and [APP-6](https://en.wikipedia.org/wiki/NATO_Joint_Military_Symbology) — made
@@ -7,6 +12,7 @@ for constructing symbols with the
 [milsymbol](https://github.com/spatialillusions/milsymbol) library.
 
 ```ts
+import ms from "milsymbol";
 import { Sidc, StandardIdentity, SymbolSet } from "milsymbol-sidc";
 
 const sidc = new Sidc()
@@ -23,15 +29,18 @@ new ms.Symbol(sidc).asSVG(); // friendly land unit icon
 - **Validated output** — invalid values throw; inconsistent combinations warn
   (or throw in `strict` mode), using the same rules milsymbol applies when it
   parses a SIDC.
-- **milsymbol-ready** — positions 8–20 are zero-filled so every generated
-  string is accepted by `new ms.Symbol(...)` out of the box.
+- **milsymbol-ready** — every generated 20-character string is accepted by
+  milsymbol's numeric parser. Full rendering depends on the entity and
+  modifier codes you supply, exactly as it does for any raw SIDC.
 
-> **Coverage:** positions 1–7 of the numeric SIDC (version, context, standard
-> identity, symbol set, status). Positions 8–20 (HQ/task force/dummy, echelon,
-> entity code, sector modifiers) are reserved for future releases.
+> **Coverage:** complete structural encoding for positions 1–20 of the numeric
+> SIDC. Positions 8–10 have named universal codes; positions 11–20 accept
+> validated raw entity and modifier codes. Symbol-set-specific entity and
+> modifier catalogs remain future work.
 
 ## Installation
 
+Published on npm as [`milsymbol-sidc`](https://www.npmjs.com/package/milsymbol-sidc).
 Requires Node.js >= 18.
 
 ```bash
@@ -42,6 +51,15 @@ yarn add milsymbol-sidc
 pnpm add milsymbol-sidc
 ```
 
+The rendering examples use [`milsymbol`](https://github.com/spatialillusions/milsymbol)
+to draw the generated SIDC. It is **not** a dependency of this package —
+`milsymbol-sidc` has zero runtime dependencies — so install it alongside when
+you want to render symbols:
+
+```bash
+npm install milsymbol
+```
+
 The package ships ESM with bundled TypeScript declarations (`dist/`).
 
 ## Quick start
@@ -50,6 +68,7 @@ The package ships ESM with bundled TypeScript declarations (`dist/`).
 import {
   Sidc,
   Context,
+  Standard,
   StandardIdentity,
   SymbolSet,
   Status,
@@ -72,44 +91,57 @@ The builder is **immutable**: each setter returns a new instance, so a base
 configuration can be safely reused:
 
 ```ts
-const base = new Sidc().version(Version.App6E);
+import { Sidc, Standard, StandardIdentity } from "milsymbol-sidc";
+
+const base = new Sidc({ standard: Standard.App6 });
 
 const friendly = base.identity(StandardIdentity.Friend).toString();
 const hostile = base.identity(StandardIdentity.SuspectJoker).toString();
-// base itself is unchanged
+// base itself is unchanged; both derived SIDCs use APP-6 E (version "14")
 ```
 
 ## Anatomy of the generated SIDC
 
-```
-1 3 0 3 1 0 | 0 0 0 0 0 0 0 0 0 0 0 0 0
-└─┬─┘ │ │ └─┬─┘ └──────────┬───────────┘
-  │   │ │   │              zero-filled (future fields)
-  │   │ │   └ status (7)
-  │   │ └ symbol set (5-6)
-  │   └ standard identity (4)
-  └ context (3)
-  version (1-2)
+```text
+13 0 3 10 0 2 16 123456 78 90
+│  │ │ │  │ │ │  │      │  │
+│  │ │ │  │ │ │  │      │  └   modifier 2 (19–20)
+│  │ │ │  │ │ │  │      └  │   modifier 1 (17–18)
+│  │ │ │  │ │ │  └      │  │   entity code (11–16)
+│  │ │ │  │ │ └  │      │  │   amplifier (9–10)
+│  │ │ │  │ └ │  │      │  │   HQ/task force/feint-dummy (8)
+│  │ │ │  └ │ │  │      │  │   status (7)
+│  │ │ └  │ │ │  │      │  │   symbol set (5–6)
+│  │ └ │  │ │ │  │      │  │   standard identity (4)
+│  └ │ │  │ │ │  │      │  │   context (3)
+└  │ │ │  │ │ │  │      │  │   version / edition (1–2)
 ```
 
-| Position | Field | Enum |
+| Position | Field | API |
 | -------- | ------------------ | ----------------- |
-| 1–2 | Version / edition | `Version` |
-| 3 | Context | `Context` |
-| 4 | Standard identity | `StandardIdentity` |
-| 5–6 | Symbol set | `SymbolSet` |
-| 7 | Status / condition | `Status` |
+| 1–2 | Version / edition | `Version`, `version()` |
+| 3 | Context | `Context`, `context()` |
+| 4 | Standard identity | `StandardIdentity`, `identity()` |
+| 5–6 | Symbol set | `SymbolSet`, `symbolSet()` |
+| 7 | Status / condition | `Status`, `status()` |
+| 8 | HQ/task force/feint-dummy | `HqTaskForceDummy`, `hqTaskForceDummy()` |
+| 9–10 | Amplifier | `Amplifier`, `amplifier()` |
+| 11–16 | Entity code | `entity()` — six raw digits |
+| 17–18 | Modifier 1 | `modifier1()` — two raw digits |
+| 19–20 | Modifier 2 | `modifier2()` — two raw digits |
 
 ## API
 
 ### `new Sidc(options?)`
 
 Creates a builder preconfigured to 2525E / Reality / Unknown / Unknown set /
-Present.
+Present. This remains the default for backward compatibility; configure
+`Standard.App6` to default to APP-6 E instead.
 
 | Option | Type | Default | Description |
 | ------ | ---- | ------- | ----------- |
 | `strict` | `boolean` | `false` | Throw on invalid field combinations during `toString()` instead of warning. Invalid values always throw immediately regardless of this flag. |
+| `standard` | `Standard` | Not configured (2525E behavior) | Select a standard family. `App6` defaults the version to APP-6 E (`"14"`); `MilStd2525` defaults it to MIL-STD-2525E (`"13"`). Explicit configuration also checks that later version choices belong to the selected family. |
 
 ### Methods
 
@@ -117,15 +149,88 @@ All setters validate their argument and return a new immutable `Sidc`.
 
 | Method | Field | Accepts |
 | ------ | ----- | ------- |
+| `standard(s)` | Version default + validation rules | A `Standard` constant. It retains a compatible current version; otherwise it selects that family's latest edition. |
 | `version(v)` | Positions 1–2 | A `Version` constant or any two-digit string (escape hatch for future editions) |
 | `context(c)` | Position 3 | A `Context` constant |
 | `identity(i)` | Position 4 | A `StandardIdentity` constant |
 | `symbolSet(s)` | Positions 5–6 | A `SymbolSet` constant or any two-digit string |
 | `status(s)` | Position 7 | A `Status` constant |
+| `hqTaskForceDummy(v)` | Position 8 | An `HqTaskForceDummy` constant |
+| `amplifier(v)` | Positions 9–10 | An `Amplifier` constant |
+| `entity(v)` | Positions 11–16 | Any six-digit string; symbol-set-specific catalogs are not included |
+| `modifier1(v)` | Positions 17–18 | Any two-digit string; symbol-set-specific catalogs are not included |
+| `modifier2(v)` | Positions 19–20 | Any two-digit string; symbol-set-specific catalogs are not included |
 | `toString()` | — | Validates combinations and renders the 20-character SIDC |
 
 ### Enum reference
 
+#### `Standard`
+
+Values match milsymbol's `standard` option and `ms.setStandard()` API, so the
+same constant can configure both libraries.
+
+| Constant | Value | Standard family |
+| -------- | ----- | --------------- |
+| `MilStd2525` | `"2525"` | US MIL-STD-2525 (**default behavior when omitted**) |
+| `App6` | `"APP6"` | NATO APP-6 |
+
+#### `HqTaskForceDummy`
+
+Position 8 values identify headquarters, task force, and feint/dummy variants.
+
+| Constant | Code | Meaning |
+| -------- | ---- | ------- |
+| `None` | `"0"` | None / not applicable |
+| `FeintDummy` | `"1"` | Feint/dummy |
+| `Headquarters` | `"2"` | Headquarters |
+| `FeintDummyHeadquarters` | `"3"` | Feint/dummy headquarters |
+| `TaskForce` | `"4"` | Task force |
+| `FeintDummyTaskForce` | `"5"` | Feint/dummy task force |
+| `TaskForceHeadquarters` | `"6"` | Task-force headquarters |
+| `FeintDummyTaskForceHeadquarters` | `"7"` | Feint/dummy task-force headquarters |
+
+#### `Amplifier`
+
+Position 9–10 values identify echelon, mobility, leadership, or auxiliary
+amplifiers. `None` writes the zero/no-amplifier code `"00"`.
+
+| Constant | Code | Meaning |
+| -------- | ---- | ------- |
+| `None` | `"00"` | None / not specified |
+| `TeamCrew` | `"11"` | Team/crew |
+| `Squad` | `"12"` | Squad |
+| `Section` | `"13"` | Section |
+| `PlatoonDetachment` | `"14"` | Platoon/detachment |
+| `CompanyBatteryTroop` | `"15"` | Company/battery/troop |
+| `BattalionSquadron` | `"16"` | Battalion/squadron |
+| `RegimentGroup` | `"17"` | Regiment/group |
+| `Brigade` | `"18"` | Brigade |
+| `Division` | `"21"` | Division |
+| `CorpsMef` | `"22"` | Corps/MEF |
+| `Army` | `"23"` | Army |
+| `ArmyGroupFront` | `"24"` | Army group/front |
+| `RegionTheater` | `"25"` | Region/theater |
+| `Command` | `"26"` | Command |
+| `WheeledLimitedCrossCountry` | `"31"` | Wheeled, limited cross-country |
+| `WheeledCrossCountry` | `"32"` | Wheeled, cross-country |
+| `Tracked` | `"33"` | Tracked |
+| `WheeledTrackedCombination` | `"34"` | Wheeled and tracked combination |
+| `Towed` | `"35"` | Towed |
+| `Rail` | `"36"` | Rail |
+| `PackAnimals` | `"37"` | Pack animals |
+| `OverSnowPrimeMover` | `"41"` | Over snow, prime mover |
+| `Sled` | `"42"` | Sled |
+| `Barge` | `"51"` | Barge |
+| `Amphibious` | `"52"` | Amphibious |
+| `ShortTowedArray` | `"61"` | Short towed array |
+| `LongTowedArray` | `"62"` | Long towed array |
+| `LeaderIndividual` | `"71"` | Leader individual |
+| `DeputyIndividual` | `"72"` | Deputy individual |
+
+Entity and modifier setters intentionally accept raw digit strings so callers
+can use codes specific to their symbol set and edition. They validate width and
+ASCII digits but do not validate catalog membership.
+
 #### `Version`
 
 | Constant | Code | Standard |
@@ -202,8 +307,10 @@ string escape hatch.
 Two layers of validation run at different times:
 
 1. **Setter-time (`SidcValidationError`)** — thrown immediately for malformed
-   input (wrong number of digits) or unknown enum codes. This catches bugs at
-   the call site rather than deep inside rendering code.
+   input (wrong number of digits) or unknown enum codes. Values must be
+   strings: passing a number or other non-string value throws rather than
+   being coerced. This catches bugs at the call site rather than deep inside
+   rendering code.
 2. **`toString()`-time combination checks** — cross-field rules mirroring
    milsymbol's parser. By default problems are emitted with `console.warn`;
    with `{ strict: true }` they throw `SidcCombinationError`.
@@ -216,10 +323,23 @@ Active combination rules:
   identity is pending/unknown.
 - Symbol set 27 is unsupported in MIL-STD-2525D; symbol set 60 is unsupported
   in APP-6 D.
+- When a `Standard` is explicitly configured, official version codes from the
+  other standard family are reported.
 - Raw version/symbol-set codes outside milsymbol's known tables are reported.
 
 ```ts
-import { Sidc, SidcValidationError, SidcCombinationError, Context, StandardIdentity, SymbolSet, Status } from "milsymbol-sidc";
+import {
+  Amplifier,
+  Context,
+  HqTaskForceDummy,
+  Sidc,
+  SidcCombinationError,
+  SidcValidationError,
+  Standard,
+  StandardIdentity,
+  Status,
+  SymbolSet,
+} from "milsymbol-sidc";
 
 // Throws immediately: "9" is not a valid identity code.
 new Sidc().identity("9" as never); // SidcValidationError
@@ -236,6 +356,17 @@ new Sidc({ strict: true })
   .symbolSet(SymbolSet.LandUnit)
   .toString(); // "13161000000000000000", no warnings
 
+// A complete structural 20-position SIDC using raw entity/modifier codes.
+new Sidc({ standard: Standard.App6, strict: true })
+  .identity(StandardIdentity.Friend)
+  .symbolSet(SymbolSet.LandUnit)
+  .hqTaskForceDummy(HqTaskForceDummy.Headquarters)
+  .amplifier(Amplifier.BattalionSquadron)
+  .entity("123456")
+  .modifier1("01")
+  .modifier2("09")
+  .toString(); // "14031002161234560109"
+
 // A real combination problem: condition status on a control measure.
 new Sidc({ strict: true })
   .symbolSet(SymbolSet.ControlMeasure)
@@ -268,12 +399,13 @@ parser, so codes from this package work without any configuration. The
 ### Node.js (ESM)
 
 ```js
-import ms from "milsymbol"; // bundles all standards incl. 2525E icons
-import { Sidc, StandardIdentity, SymbolSet } from "milsymbol-sidc";
+import ms from "milsymbol"; // bundles all numeric standards
+import { Sidc, Standard, StandardIdentity, SymbolSet } from "milsymbol-sidc";
 
-ms.setStandard("2525"); // or "APP6"
+const standard = Standard.App6;
+ms.setStandard(standard); // "APP6": use NATO styling
 
-const sidc = new Sidc()
+const sidc = new Sidc({ standard }) // defaults to APP-6 E (version "14")
   .identity(StandardIdentity.Friend)
   .symbolSet(SymbolSet.LandUnit)
   .toString();
@@ -287,30 +419,62 @@ const svg = symbol.asSVG();
 
 ### Node.js (CommonJS)
 
+`milsymbol-sidc` is ESM-only. From CommonJS, load it with dynamic `import()`.
+`milsymbol` itself can be `require`d directly:
+
 ```js
 const ms = require("milsymbol");
-// same API as above
+
+async function render() {
+  const { Sidc, Standard, StandardIdentity, SymbolSet } = await import(
+    "milsymbol-sidc"
+  );
+
+  const sidc = new Sidc({ standard: Standard.App6 })
+    .identity(StandardIdentity.Friend)
+    .symbolSet(SymbolSet.LandUnit)
+    .toString();
+
+  return new ms.Symbol(sidc, { size: 32 }).asSVG();
+}
 ```
 
+Node.js 20.19+ and 22.12+ can also `require("milsymbol-sidc")` directly via
+`require(esm)`; earlier Node 18/20 releases must use `import()`.
+
 ### Browser
 
 ```html
 <script src="https://unpkg.com/milsymbol@3/dist/milsymbol.js"></script>
 <script type="module">
-  import { Sidc, StandardIdentity, SymbolSet } from "https://unpkg.com/milsymbol-sidc/dist/src/index.js";
+  import { Sidc, Standard, StandardIdentity, SymbolSet } from "https://unpkg.com/milsymbol-sidc/dist/src/index.js";
 
-  const sidc = new Sidc()
+  const sidc = new Sidc({ standard: Standard.App6 })
     .identity(StandardIdentity.Neutral)
     .symbolSet(SymbolSet.SeaSurface)
     .toString();
 
-  document.body.innerHTML = new ms.Symbol(sidc).asSVG();
+  document.body.innerHTML = new ms.Symbol(sidc, {
+    standard: Standard.App6,
+  }).asSVG();
 </script>
 ```
 
 ### Recipes
 
 ```ts
+import {
+  Amplifier,
+  Context,
+  HqTaskForceDummy,
+  Sidc,
+  Standard,
+  StandardIdentity,
+  Status,
+  SymbolSet,
+  Version,
+} from "milsymbol-sidc";
+
 // Hostile planned armored unit
 new Sidc()
   .identity(StandardIdentity.SuspectJoker)
@@ -333,12 +497,27 @@ new Sidc()
   .toString(); // "13033640000000000000"
 
 // Exercise joker submarine under APP-6E
-new Sidc({ strict: true })
-  .version("14")
+new Sidc({ standard: Standard.App6, strict: true })
   .context(Context.Exercise)
   .identity(StandardIdentity.SuspectJoker)
   .symbolSet(SymbolSet.SeaSubsurface)
   .toString(); // "14153500000000000000"
+
+// APP-6 unit with structural entity and modifier fields
+new Sidc({ standard: Standard.App6, strict: true })
+  .identity(StandardIdentity.Friend)
+  .symbolSet(SymbolSet.LandUnit)
+  .entity("123456")
+  .modifier1("01")
+  .modifier2("09")
+  .toString(); // "14031000001234560109"
+
+// APP-6 D configuration retains an explicitly selected compatible edition
+new Sidc({ standard: Standard.App6, strict: true })
+  .version(Version.App6D)
+  .identity(StandardIdentity.Friend)
+  .symbolSet(SymbolSet.LandDismountedIndividual)
+  .toString(); // "11032700000000000000"
 ```
 
 ## Development
@@ -350,14 +529,15 @@ npm run build
 ```
 
 Test coverage includes per-field offset encoding for every enum member,
-defaults, immutability, setter validation errors, all combination rules in
-both warn and strict modes, raw-code escape hatches, and error class
-hierarchy.
+defaults, immutability, setter validation errors, extended-field offsets,
+all combination rules in both warn and strict modes, raw-code escape hatches,
+and error class hierarchy.
 
 ## Roadmap
 
-- Positions 8–20: HQ/task force/dummy, echelon/mobility, entity catalog with
-  named icon codes, sector modifiers.
+- Symbol-set-specific named entity and modifier catalogs with semantic
+  validation.
+- Official positions 21–30 / Set C extension data.
 - Parsing/decoding SIDC strings back into structured fields.
 
 ## License

package/dist/src/enums.d.ts

@@ -1,9 +1,67 @@
 /**
- * Field codes for positions 1-7 of the 20-character numeric SIDC
- * (MIL-STD-2525D/E and APP-6 D/E coding structure).
+ * Configuration values and field codes for positions 1-20 of the 20-character
+ * numeric SIDC (MIL-STD-2525D/E and APP-6 D/E coding structure).
  *
- * Values are the literal digit codes that appear in the SIDC string.
+ * SIDC field values are the literal digit codes that appear in the string.
  */
+/**
+ * Symbol standard family.
+ *
+ * Values match milsymbol's `standard` option and `ms.setStandard()` API.
+ */
+export declare const Standard: {
+    /** US MIL-STD-2525 (the default standard family). */
+    readonly MilStd2525: "2525";
+    /** NATO APP-6. */
+    readonly App6: "APP6";
+};
+export type Standard = (typeof Standard)[keyof typeof Standard];
+/** Position 8: headquarters, task force, and feint/dummy indicator. */
+export declare const HqTaskForceDummy: {
+    readonly None: "0";
+    readonly FeintDummy: "1";
+    readonly Headquarters: "2";
+    readonly FeintDummyHeadquarters: "3";
+    readonly TaskForce: "4";
+    readonly FeintDummyTaskForce: "5";
+    readonly TaskForceHeadquarters: "6";
+    readonly FeintDummyTaskForceHeadquarters: "7";
+};
+export type HqTaskForceDummy = (typeof HqTaskForceDummy)[keyof typeof HqTaskForceDummy];
+/** Positions 9-10: echelon, mobility, leadership, or auxiliary amplifier. */
+export declare const Amplifier: {
+    readonly None: "00";
+    readonly TeamCrew: "11";
+    readonly Squad: "12";
+    readonly Section: "13";
+    readonly PlatoonDetachment: "14";
+    readonly CompanyBatteryTroop: "15";
+    readonly BattalionSquadron: "16";
+    readonly RegimentGroup: "17";
+    readonly Brigade: "18";
+    readonly Division: "21";
+    readonly CorpsMef: "22";
+    readonly Army: "23";
+    readonly ArmyGroupFront: "24";
+    readonly RegionTheater: "25";
+    readonly Command: "26";
+    readonly WheeledLimitedCrossCountry: "31";
+    readonly WheeledCrossCountry: "32";
+    readonly Tracked: "33";
+    readonly WheeledTrackedCombination: "34";
+    readonly Towed: "35";
+    readonly Rail: "36";
+    readonly PackAnimals: "37";
+    readonly OverSnowPrimeMover: "41";
+    readonly Sled: "42";
+    readonly Barge: "51";
+    readonly Amphibious: "52";
+    readonly ShortTowedArray: "61";
+    readonly LongTowedArray: "62";
+    readonly LeaderIndividual: "71";
+    readonly DeputyIndividual: "72";
+};
+export type Amplifier = (typeof Amplifier)[keyof typeof Amplifier];
 /** Positions 1-2: Version / standard edition. */
 export declare const Version: {
     /** MIL-STD-2525D (edition D) */

package/dist/src/enums.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iDAAiD;AACjD,eAAO,MAAM,OAAO;IAClB,gCAAgC;;IAEhC,sBAAsB;;IAEtB,8CAA8C;;IAE9C,sBAAsB;;CAEd,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE7D,2BAA2B;AAC3B,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,gBAAgB;;;;;;IAM3B,sDAAsD;;IAEtD,sDAAsD;;CAE9C,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAExF,8EAA8E;AAC9E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;CAsBZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE,sCAAsC;AACtC,eAAO,MAAM,MAAM;;;;;;;CAOT,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACnB,qDAAqD;;IAErD,kBAAkB;;CAEV,CAAC;AACX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE,uEAAuE;AACvE,eAAO,MAAM,gBAAgB;;;;;;;;;CASnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,6EAA6E;AAC7E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE,iDAAiD;AACjD,eAAO,MAAM,OAAO;IAClB,gCAAgC;;IAEhC,sBAAsB;;IAEtB,8CAA8C;;IAE9C,sBAAsB;;CAEd,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE7D,2BAA2B;AAC3B,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,OAAO,OAAO,CAAC,CAAC;AAE7D,mDAAmD;AACnD,eAAO,MAAM,gBAAgB;;;;;;IAM3B,sDAAsD;;IAEtD,sDAAsD;;CAE9C,CAAC;AACX,MAAM,MAAM,gBAAgB,GAC1B,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAE3D,8EAA8E;AAC9E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;CAsBZ,CAAC;AACX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAC;AAEnE,sCAAsC;AACtC,eAAO,MAAM,MAAM;;;;;;;CAOT,CAAC;AACX,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,OAAO,MAAM,CAAC,CAAC"}

package/dist/src/enums.js

@@ -1,9 +1,64 @@
 /**
- * Field codes for positions 1-7 of the 20-character numeric SIDC
- * (MIL-STD-2525D/E and APP-6 D/E coding structure).
+ * Configuration values and field codes for positions 1-20 of the 20-character
+ * numeric SIDC (MIL-STD-2525D/E and APP-6 D/E coding structure).
  *
- * Values are the literal digit codes that appear in the SIDC string.
+ * SIDC field values are the literal digit codes that appear in the string.
  */
+/**
+ * Symbol standard family.
+ *
+ * Values match milsymbol's `standard` option and `ms.setStandard()` API.
+ */
+export const Standard = {
+    /** US MIL-STD-2525 (the default standard family). */
+    MilStd2525: "2525",
+    /** NATO APP-6. */
+    App6: "APP6",
+};
+/** Position 8: headquarters, task force, and feint/dummy indicator. */
+export const HqTaskForceDummy = {
+    None: "0",
+    FeintDummy: "1",
+    Headquarters: "2",
+    FeintDummyHeadquarters: "3",
+    TaskForce: "4",
+    FeintDummyTaskForce: "5",
+    TaskForceHeadquarters: "6",
+    FeintDummyTaskForceHeadquarters: "7",
+};
+/** Positions 9-10: echelon, mobility, leadership, or auxiliary amplifier. */
+export const Amplifier = {
+    None: "00",
+    TeamCrew: "11",
+    Squad: "12",
+    Section: "13",
+    PlatoonDetachment: "14",
+    CompanyBatteryTroop: "15",
+    BattalionSquadron: "16",
+    RegimentGroup: "17",
+    Brigade: "18",
+    Division: "21",
+    CorpsMef: "22",
+    Army: "23",
+    ArmyGroupFront: "24",
+    RegionTheater: "25",
+    Command: "26",
+    WheeledLimitedCrossCountry: "31",
+    WheeledCrossCountry: "32",
+    Tracked: "33",
+    WheeledTrackedCombination: "34",
+    Towed: "35",
+    Rail: "36",
+    PackAnimals: "37",
+    OverSnowPrimeMover: "41",
+    Sled: "42",
+    Barge: "51",
+    Amphibious: "52",
+    ShortTowedArray: "61",
+    LongTowedArray: "62",
+    LeaderIndividual: "71",
+    DeputyIndividual: "72",
+};
 /** Positions 1-2: Version / standard edition. */
 export const Version = {
     /** MIL-STD-2525D (edition D) */

package/dist/src/enums.js.map

@@ -1 +1 @@
-{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gCAAgC;IAChC,WAAW,EAAE,IAAI;IACjB,sBAAsB;IACtB,KAAK,EAAE,IAAI;IACX,8CAA8C;IAC9C,WAAW,EAAE,IAAI;IACjB,sBAAsB;IACtB,KAAK,EAAE,IAAI;CACH,CAAC;AAGX,2BAA2B;AAC3B,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;CACP,CAAC;AAGX,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,GAAG;IAClB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;IACZ,sDAAsD;IACtD,YAAY,EAAE,GAAG;IACjB,sDAAsD;IACtD,YAAY,EAAE,GAAG;CACT,CAAC;AAGX,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,OAAO,EAAE,IAAI;IACb,GAAG,EAAE,IAAI;IACT,UAAU,EAAE,IAAI;IAChB,KAAK,EAAE,IAAI;IACX,YAAY,EAAE,IAAI;IAClB,QAAQ,EAAE,IAAI;IACd,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,IAAI;IACnB,YAAY,EAAE,IAAI;IAClB,cAAc,EAAE,IAAI;IACpB,wBAAwB,EAAE,IAAI;IAC9B,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,WAAW,EAAE,IAAI;IACjB,QAAQ,EAAE,IAAI;IACd,wBAAwB,EAAE,IAAI;IAC9B,sBAAsB,EAAE,IAAI;IAC5B,uBAAuB,EAAE,IAAI;IAC7B,6BAA6B,EAAE,IAAI;IACnC,6BAA6B,EAAE,IAAI;IACnC,UAAU,EAAE,IAAI;CACR,CAAC;AAGX,sCAAsC;AACtC,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,GAAG;IACZ,OAAO,EAAE,GAAG;IACZ,YAAY,EAAE,GAAG;IACjB,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,GAAG;IACd,cAAc,EAAE,GAAG;CACX,CAAC"}
+{"version":3,"file":"enums.js","sourceRoot":"","sources":["../../src/enums.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -1,4 +1,4 @@
-export { Context, StandardIdentity, Status, SymbolSet, Version, } from "./enums.js";
+export { Amplifier, Context, HqTaskForceDummy, Standard, StandardIdentity, Status, SymbolSet, Version, } from "./enums.js";
 export { Sidc, type SidcOptions } from "./sidc.js";
 export { SidcCombinationError, SidcError, SidcValidationError, } from "./validate.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,mBAAmB,GACpB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/src/index.js

@@ -1,4 +1,4 @@
-export { Context, StandardIdentity, Status, SymbolSet, Version, } from "./enums.js";
+export { Amplifier, Context, HqTaskForceDummy, Standard, StandardIdentity, Status, SymbolSet, Version, } from "./enums.js";
 export { Sidc } from "./sidc.js";
 export { SidcCombinationError, SidcError, SidcValidationError, } from "./validate.js";
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AAEnD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,mBAAmB,GACpB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,QAAQ,EACR,gBAAgB,EAChB,MAAM,EACN,SAAS,EACT,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,IAAI,EAAoB,MAAM,WAAW,CAAC;AAEnD,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,mBAAmB,GACpB,MAAM,eAAe,CAAC"}

package/dist/src/sidc.d.ts

@@ -1,4 +1,4 @@
-import { Context, StandardIdentity, Status, SymbolSet, Version } from "./enums.js";
+import { Amplifier, Context, HqTaskForceDummy, Standard, StandardIdentity, Status, SymbolSet, Version } from "./enums.js";
 import { type SidcFields } from "./validate.js";
 export interface SidcOptions {
     /**
@@ -7,13 +7,19 @@ export interface SidcOptions {
      * Invalid individual values always throw immediately.
      */
     strict?: boolean;
+    /**
+     * Configure a standard family. This selects its latest edition by default
+     * (APP-6 E or MIL-STD-2525E) and enables standard/version consistency checks.
+     * Omit this option to preserve the original MIL-STD-2525E behavior.
+     */
+    standard?: Standard;
 }
 /**
  * Fluent builder for 20-character numeric SIDC strings
  * (MIL-STD-2525E / APP-6 coding structure).
  *
- * Covers positions 1-7; positions 8-20 are zero-filled so the result can be
- * passed straight to milsymbol's `new ms.Symbol(sidc)`.
+ * Covers all positions 1-20 of the numeric SIDC so the result can be passed
+ * straight to milsymbol's `new ms.Symbol(sidc)`.
  *
  * All setters are immutable: they return a new `Sidc` and leave the original
  * untouched.
@@ -33,8 +39,32 @@ export declare class Sidc {
     /**
      * @param options Builder behaviour flags.
      * @param fields Initial field values. Internal; used for immutable clones.
+     * Legacy records may omit the newly supported tail fields; omitted and
+     * explicitly-undefined values are normalized to their zero defaults. Every
+     * supplied value is validated, so this path cannot produce a malformed SIDC.
+     */
+    constructor(options?: SidcOptions, fields?: Partial<SidcFields> | null);
+    /**
+     * Configures the standard family and its validation rules.
+     *
+     * A version already belonging to the selected family is retained. Otherwise
+     * it is reset to that family's latest edition (APP-6 E or MIL-STD-2525E).
+     */
+    standard(standard: Standard): Sidc;
+    /**
+     * Position 8: headquarters, task force, and feint/dummy indicator.
+     */
+    hqTaskForceDummy(value: HqTaskForceDummy): Sidc;
+    /**
+     * Positions 9-10: echelon, mobility, leadership, or auxiliary amplifier.
      */
-    constructor(options?: SidcOptions, fields?: SidcFields);
+    amplifier(value: Amplifier): Sidc;
+    /** Positions 11-16: six-digit entity code. */
+    entity(value: string): Sidc;
+    /** Positions 17-18: two-digit modifier 1 code. */
+    modifier1(value: string): Sidc;
+    /** Positions 19-20: two-digit modifier 2 code. */
+    modifier2(value: string): Sidc;
     /** Positions 1-2: standard edition. Accepts known codes or a raw two-digit code. */
     version(version: Version | (string & {})): Sidc;
     /** Position 3: context. */