@springfield/ham-radio-utils 4.2.0 → 4.4.0

package/dist/memory/memory-map-ui.d.ts

@@ -1,4 +1,4 @@
-import type { RadioMemoryMap, RadioMemoryMapFieldUi, RadioMemoryMapValueKind } from '@springfield/ham-radio-api';
+import type { RadioMemoryMap, RadioMemoryMapFieldUi, RadioMemoryMapValueKind, RadioSettingValue } from '@springfield/ham-radio-api';
 /**
  * Flattened field descriptor for schema-driven settings UI.
  */
@@ -13,8 +13,18 @@ export interface RadioMemoryMapUiField {
 }
 /**
  * Collect writable UI fields from a memory map, in declaration order.
+ * Channel-bound structs are skipped (use {@link collectChannelMemoryMapUiFields}).
  */
 export declare function collectMemoryMapUiFields(memoryMap: RadioMemoryMap): RadioMemoryMapUiField[];
+/**
+ * Collect per-channel UI fields from the `channelBindings.records` struct.
+ * Skips reserved fields, fields without `ui`, and fields bound onto RadioChannel.
+ */
+export declare function collectChannelMemoryMapUiFields(memoryMap: RadioMemoryMap): RadioMemoryMapUiField[];
+/**
+ * Format a decoded memory-map field value for read-only display (e.g. channel table).
+ */
+export declare function formatMemoryMapFieldValue(value: RadioSettingValue | undefined, field: Pick<RadioMemoryMapUiField, 'value' | 'fieldId'>): string;
 /**
  * Group UI fields by their ui.group key, preserving first-seen group order.
  */

package/dist/memory/memory-map-ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-map-ui.d.ts","sourceRoot":"","sources":["../../src/memory/memory-map-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAEjH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,qBAAqB,CAAC;IAC1B,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,qBAAqB,EAAE,CAiC3F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAc5G"}
+{"version":3,"file":"memory-map-ui.d.ts","sourceRoot":"","sources":["../../src/memory/memory-map-ui.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,qBAAqB,CAAC;IAC1B,KAAK,CAAC,EAAE,uBAAuB,CAAC;CACjC;AAyBD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,cAAc,GAAG,qBAAqB,EAAE,CA8C3F;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,cAAc,GAAG,qBAAqB,EAAE,CA+BlG;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,SAAS,CAAC,GACtD,MAAM,CAkCR;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAc5G"}

package/dist/memory/memory-map-ui.js

@@ -1,9 +1,39 @@
+function channelBoundFieldIds(memoryMap) {
+    const bindings = memoryMap.channelBindings;
+    const ids = new Set();
+    if (!bindings) {
+        return ids;
+    }
+    for (const key of [
+        bindings.receiveFrequency,
+        bindings.transmitFrequency,
+        bindings.receiveTone,
+        bindings.transmitTone,
+        bindings.nameField,
+    ]) {
+        if (key) {
+            ids.add(key);
+        }
+    }
+    return ids;
+}
 /**
  * Collect writable UI fields from a memory map, in declaration order.
+ * Channel-bound structs are skipped (use {@link collectChannelMemoryMapUiFields}).
  */
 export function collectMemoryMapUiFields(memoryMap) {
     const fields = [];
+    const channelStructIds = new Set();
+    if (memoryMap.channelBindings) {
+        channelStructIds.add(memoryMap.channelBindings.records);
+        if (memoryMap.channelBindings.names) {
+            channelStructIds.add(memoryMap.channelBindings.names);
+        }
+    }
     for (const struct of memoryMap.structs) {
+        if (channelStructIds.has(struct.id)) {
+            continue;
+        }
         const count = struct.count ?? 1;
         for (let index = 0; index < count; index += 1) {
             for (const field of struct.fields) {
@@ -27,6 +57,65 @@ export function collectMemoryMapUiFields(memoryMap) {
     }
     return fields;
 }
+/**
+ * Collect per-channel UI fields from the `channelBindings.records` struct.
+ * Skips reserved fields, fields without `ui`, and fields bound onto RadioChannel.
+ */
+export function collectChannelMemoryMapUiFields(memoryMap) {
+    const bindings = memoryMap.channelBindings;
+    if (!bindings) {
+        return [];
+    }
+    const struct = memoryMap.structs.find((entry) => entry.id === bindings.records);
+    if (!struct) {
+        return [];
+    }
+    const boundIds = channelBoundFieldIds(memoryMap);
+    const fields = [];
+    for (const field of struct.fields) {
+        if (field.reserved || !field.ui || boundIds.has(field.id)) {
+            continue;
+        }
+        fields.push({
+            path: field.id,
+            structId: struct.id,
+            fieldId: field.id,
+            ui: field.ui,
+            value: field.value,
+        });
+    }
+    return fields;
+}
+/**
+ * Format a decoded memory-map field value for read-only display (e.g. channel table).
+ */
+export function formatMemoryMapFieldValue(value, field) {
+    if (value === undefined || value === null) {
+        return '';
+    }
+    if (field.value?.kind === 'enum' && typeof value === 'string') {
+        return value;
+    }
+    if (field.value?.kind === 'boolean' || typeof value === 'boolean') {
+        if (field.fieldId === 'wide') {
+            return value ? 'Wide' : 'Narrow';
+        }
+        if (field.fieldId === 'scan') {
+            return value ? 'On' : 'Off';
+        }
+        return value ? 'On' : 'Off';
+    }
+    if (field.fieldId === 'lowpower' && typeof value === 'number') {
+        return value === 0 ? 'High' : 'Low';
+    }
+    if (field.fieldId === 'scode' && typeof value === 'number') {
+        return String(value + 1);
+    }
+    if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    return '';
+}
 /**
  * Group UI fields by their ui.group key, preserving first-seen group order.
  */

package/dist/memory/memory-map-ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"memory-map-ui.js","sourceRoot":"","sources":["../../src/memory/memory-map-ui.ts"],"names":[],"mappings":"AAeA;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAAyB;IAChE,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC;QAEhC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC9C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;oBAChC,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GACR,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,KAAK,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,EAAE,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;gBAE/E,MAAM,KAAK,GACT,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;oBAC7C,CAAC,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE;oBAClC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC;gBAErB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,OAAO,EAAE,KAAK,CAAC,EAAE;oBACjB,UAAU,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;oBACzC,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE;oBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK;iBACnB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAA+B;IACpE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAmC,CAAC;IAE1D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAE5C,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import type { RadioMemoryMap, RadioMemoryMapFieldUi, RadioMemoryMapValueKind } from '@springfield/ham-radio-api';\n\n/**\n * Flattened field descriptor for schema-driven settings UI.\n */\nexport interface RadioMemoryMapUiField {\n  /** Dot path into decoded settings, e.g. settings.squelch or pttid.0.code */\n  path: string;\n  structId: string;\n  fieldId: string;\n  arrayIndex?: number;\n  ui: RadioMemoryMapFieldUi;\n  value?: RadioMemoryMapValueKind;\n}\n\n/**\n * Collect writable UI fields from a memory map, in declaration order.\n */\nexport function collectMemoryMapUiFields(memoryMap: RadioMemoryMap): RadioMemoryMapUiField[] {\n  const fields: RadioMemoryMapUiField[] = [];\n\n  for (const struct of memoryMap.structs) {\n    const count = struct.count ?? 1;\n\n    for (let index = 0; index < count; index += 1) {\n      for (const field of struct.fields) {\n        if (field.reserved || !field.ui) {\n          continue;\n        }\n\n        const path =\n          count > 1 ? `${struct.id}.${index}.${field.id}` : `${struct.id}.${field.id}`;\n\n        const label =\n          count > 1 && field.ui.label.indexOf('%') === -1\n            ? `${field.ui.label} ${index + 1}`\n            : field.ui.label;\n\n        fields.push({\n          path,\n          structId: struct.id,\n          fieldId: field.id,\n          arrayIndex: count > 1 ? index : undefined,\n          ui: { ...field.ui, label },\n          value: field.value,\n        });\n      }\n    }\n  }\n\n  return fields;\n}\n\n/**\n * Group UI fields by their ui.group key, preserving first-seen group order.\n */\nexport function groupMemoryMapUiFields(fields: RadioMemoryMapUiField[]): Map<string, RadioMemoryMapUiField[]> {\n  const groups = new Map<string, RadioMemoryMapUiField[]>();\n\n  for (const field of fields) {\n    const existing = groups.get(field.ui.group);\n\n    if (existing) {\n      existing.push(field);\n    } else {\n      groups.set(field.ui.group, [field]);\n    }\n  }\n\n  return groups;\n}\n"]}
+{"version":3,"file":"memory-map-ui.js","sourceRoot":"","sources":["../../src/memory/memory-map-ui.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  RadioMemoryMap,\n  RadioMemoryMapFieldUi,\n  RadioMemoryMapValueKind,\n  RadioSettingValue,\n} from '@springfield/ham-radio-api';\n\n/**\n * Flattened field descriptor for schema-driven settings UI.\n */\nexport interface RadioMemoryMapUiField {\n  /** Dot path into decoded settings, e.g. settings.squelch or pttid.0.code */\n  path: string;\n  structId: string;\n  fieldId: string;\n  arrayIndex?: number;\n  ui: RadioMemoryMapFieldUi;\n  value?: RadioMemoryMapValueKind;\n}\n\nfunction channelBoundFieldIds(memoryMap: RadioMemoryMap): Set<string> {\n  const bindings = memoryMap.channelBindings;\n  const ids = new Set<string>();\n\n  if (!bindings) {\n    return ids;\n  }\n\n  for (const key of [\n    bindings.receiveFrequency,\n    bindings.transmitFrequency,\n    bindings.receiveTone,\n    bindings.transmitTone,\n    bindings.nameField,\n  ]) {\n    if (key) {\n      ids.add(key);\n    }\n  }\n\n  return ids;\n}\n\n/**\n * Collect writable UI fields from a memory map, in declaration order.\n * Channel-bound structs are skipped (use {@link collectChannelMemoryMapUiFields}).\n */\nexport function collectMemoryMapUiFields(memoryMap: RadioMemoryMap): RadioMemoryMapUiField[] {\n  const fields: RadioMemoryMapUiField[] = [];\n  const channelStructIds = new Set<string>();\n\n  if (memoryMap.channelBindings) {\n    channelStructIds.add(memoryMap.channelBindings.records);\n\n    if (memoryMap.channelBindings.names) {\n      channelStructIds.add(memoryMap.channelBindings.names);\n    }\n  }\n\n  for (const struct of memoryMap.structs) {\n    if (channelStructIds.has(struct.id)) {\n      continue;\n    }\n\n    const count = struct.count ?? 1;\n\n    for (let index = 0; index < count; index += 1) {\n      for (const field of struct.fields) {\n        if (field.reserved || !field.ui) {\n          continue;\n        }\n\n        const path =\n          count > 1 ? `${struct.id}.${index}.${field.id}` : `${struct.id}.${field.id}`;\n\n        const label =\n          count > 1 && field.ui.label.indexOf('%') === -1\n            ? `${field.ui.label} ${index + 1}`\n            : field.ui.label;\n\n        fields.push({\n          path,\n          structId: struct.id,\n          fieldId: field.id,\n          arrayIndex: count > 1 ? index : undefined,\n          ui: { ...field.ui, label },\n          value: field.value,\n        });\n      }\n    }\n  }\n\n  return fields;\n}\n\n/**\n * Collect per-channel UI fields from the `channelBindings.records` struct.\n * Skips reserved fields, fields without `ui`, and fields bound onto RadioChannel.\n */\nexport function collectChannelMemoryMapUiFields(memoryMap: RadioMemoryMap): RadioMemoryMapUiField[] {\n  const bindings = memoryMap.channelBindings;\n\n  if (!bindings) {\n    return [];\n  }\n\n  const struct = memoryMap.structs.find((entry) => entry.id === bindings.records);\n\n  if (!struct) {\n    return [];\n  }\n\n  const boundIds = channelBoundFieldIds(memoryMap);\n  const fields: RadioMemoryMapUiField[] = [];\n\n  for (const field of struct.fields) {\n    if (field.reserved || !field.ui || boundIds.has(field.id)) {\n      continue;\n    }\n\n    fields.push({\n      path: field.id,\n      structId: struct.id,\n      fieldId: field.id,\n      ui: field.ui,\n      value: field.value,\n    });\n  }\n\n  return fields;\n}\n\n/**\n * Format a decoded memory-map field value for read-only display (e.g. channel table).\n */\nexport function formatMemoryMapFieldValue(\n  value: RadioSettingValue | undefined,\n  field: Pick<RadioMemoryMapUiField, 'value' | 'fieldId'>,\n): string {\n  if (value === undefined || value === null) {\n    return '';\n  }\n\n  if (field.value?.kind === 'enum' && typeof value === 'string') {\n    return value;\n  }\n\n  if (field.value?.kind === 'boolean' || typeof value === 'boolean') {\n    if (field.fieldId === 'wide') {\n      return value ? 'Wide' : 'Narrow';\n    }\n\n    if (field.fieldId === 'scan') {\n      return value ? 'On' : 'Off';\n    }\n\n    return value ? 'On' : 'Off';\n  }\n\n  if (field.fieldId === 'lowpower' && typeof value === 'number') {\n    return value === 0 ? 'High' : 'Low';\n  }\n\n  if (field.fieldId === 'scode' && typeof value === 'number') {\n    return String(value + 1);\n  }\n\n  if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') {\n    return String(value);\n  }\n\n  return '';\n}\n\n/**\n * Group UI fields by their ui.group key, preserving first-seen group order.\n */\nexport function groupMemoryMapUiFields(fields: RadioMemoryMapUiField[]): Map<string, RadioMemoryMapUiField[]> {\n  const groups = new Map<string, RadioMemoryMapUiField[]>();\n\n  for (const field of fields) {\n    const existing = groups.get(field.ui.group);\n\n    if (existing) {\n      existing.push(field);\n    } else {\n      groups.set(field.ui.group, [field]);\n    }\n  }\n\n  return groups;\n}\n"]}

package/dist/schemas/radio-memory-map-schema.json

@@ -18,6 +18,9 @@
       "items": {
         "$ref": "#/definitions/struct"
       }
+    },
+    "channelBindings": {
+      "$ref": "#/definitions/channelBindings"
     }
   },
   "definitions": {
@@ -27,6 +30,28 @@
         { "type": "string", "pattern": "^(0[xX][0-9a-fA-F]+|[0-9]+)$" }
       ]
     },
+    "channelBindings": {
+      "type": "object",
+      "required": ["records", "receiveFrequency", "transmitFrequency", "receiveTone", "transmitTone"],
+      "properties": {
+        "records": { "type": "string", "minLength": 1 },
+        "names": { "type": "string", "minLength": 1 },
+        "nameField": { "type": "string", "minLength": 1 },
+        "receiveFrequency": { "type": "string", "minLength": 1 },
+        "transmitFrequency": { "type": "string", "minLength": 1 },
+        "receiveTone": { "type": "string", "minLength": 1 },
+        "transmitTone": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "emptyWhen": {
+      "type": "object",
+      "required": ["equals"],
+      "properties": {
+        "equals": { "type": "integer", "minimum": 0, "maximum": 255 }
+      },
+      "additionalProperties": false
+    },
     "ui": {
       "type": "object",
       "required": ["group", "label", "widget"],
@@ -112,6 +137,31 @@
             "length": { "type": "integer", "minimum": 1 }
           },
           "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["kind", "length"],
+          "properties": {
+            "kind": { "const": "lbcd" },
+            "length": { "type": "integer", "minimum": 1 },
+            "scale": { "type": "number" }
+          },
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "required": ["kind", "values"],
+          "properties": {
+            "kind": { "const": "tone" },
+            "values": {
+              "type": "array",
+              "items": { "type": "integer" },
+              "minItems": 1
+            },
+            "ctcssMin": { "type": "integer" },
+            "reverseOffset": { "type": "integer" }
+          },
+          "additionalProperties": false
         }
       ]
     },
@@ -143,7 +193,9 @@
           "items": { "$ref": "#/definitions/field" }
         },
         "count": { "type": "integer", "minimum": 1 },
-        "stride": { "type": "integer", "minimum": 1 }
+        "stride": { "type": "integer", "minimum": 1 },
+        "emptyWhen": { "$ref": "#/definitions/emptyWhen" },
+        "clearEmpty": { "type": "boolean" }
       },
       "additionalProperties": false
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@springfield/ham-radio-utils",
-  "version": "4.2.0",
+  "version": "4.4.0",
   "author": "Bryan Hunt",
   "license": "MIT",
   "readme": "README.md",
@@ -30,7 +30,7 @@
     "test:unit": "tsx --test test/unit/**/*.test.ts"
   },
   "dependencies": {
-    "@springfield/ham-radio-api": "^17.1.0",
+    "@springfield/ham-radio-api": "^17.2.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "fishery": "^2.4.0",

package/src/index.ts

@@ -1,5 +1,6 @@
 export * from './memory/segmented-memory.js';
 export * from './memory/memory-map-codec.js';
+export * from './memory/memory-map-channels.js';
 export * from './memory/memory-map-ui.js';
 
 export * from './test-utils/radio-channel-factory.js';

package/src/memory/memory-map-channels.ts

@@ -0,0 +1,264 @@
+import {
+  Frequency,
+  type RadioChannel,
+  type RadioMemoryConfig,
+  type RadioMemoryMap,
+  type RadioMemoryMapToneValue,
+  type RadioProgram,
+  type RadioProgrammedChannel,
+  type RadioSettings,
+  type RadioSettingValue,
+  type RadioTone,
+  RadioToneType,
+} from '@springfield/ham-radio-api';
+import { decodeMemoryMap, encodeMemoryMap } from './memory-map-codec.js';
+
+function isToneValue(value: RadioSettingValue | undefined): value is RadioMemoryMapToneValue {
+  return Boolean(value && typeof value === 'object' && !Array.isArray(value) && 'mode' in value);
+}
+
+function toneToRadioTone(value: RadioSettingValue | undefined): RadioTone {
+  if (!isToneValue(value) || value.mode === 'none') {
+    return { tone: 0, type: RadioToneType.CTCSS };
+  }
+
+  if (value.mode === 'ctcss') {
+    return { tone: value.value, type: RadioToneType.CTCSS };
+  }
+
+  return { tone: value.code, type: RadioToneType.DCS };
+}
+
+function radioToneToMapTone(tone: RadioTone | undefined): RadioMemoryMapToneValue {
+  if (!tone || !tone.tone) {
+    return { mode: 'none' };
+  }
+
+  if (tone.type === RadioToneType.DCS) {
+    return { mode: 'dcs', code: Number(tone.tone), polarity: 'N' };
+  }
+
+  return { mode: 'ctcss', value: Number(tone.tone) };
+}
+
+function asRecord(value: RadioSettingValue | undefined): Record<string, RadioSettingValue> | undefined {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return undefined;
+  }
+
+  return value as Record<string, RadioSettingValue>;
+}
+
+/**
+ * Project decoded memory-map channel structs into RadioProgrammedChannel[].
+ */
+export function bindingsToChannels(
+  memoryMap: RadioMemoryMap,
+  settings: RadioSettings,
+): RadioProgrammedChannel[] {
+  const bindings = memoryMap.channelBindings;
+
+  if (!bindings) {
+    return [];
+  }
+
+  const records = settings[bindings.records];
+  const names = bindings.names ? settings[bindings.names] : undefined;
+  const recordItems = Array.isArray(records) ? records : [];
+  const nameItems = Array.isArray(names) ? names : [];
+  const nameField = bindings.nameField ?? 'name';
+  const boundFieldIds = new Set([
+    bindings.receiveFrequency,
+    bindings.transmitFrequency,
+    bindings.receiveTone,
+    bindings.transmitTone,
+  ]);
+
+  const channels: RadioProgrammedChannel[] = [];
+
+  for (let index = 0; index < recordItems.length; index += 1) {
+    const record = asRecord(recordItems[index]);
+
+    if (!record) {
+      continue;
+    }
+
+    const nameRecord = asRecord(nameItems[index]);
+    const nameValue = nameRecord?.[nameField];
+    const name = typeof nameValue === 'string' ? nameValue : '';
+
+    const receiveFrequency = Number(record[bindings.receiveFrequency] ?? 0);
+    const transmitFrequency = Number(record[bindings.transmitFrequency] ?? 0);
+
+    const channelSettings: RadioSettings = {};
+
+    for (const [fieldId, fieldValue] of Object.entries(record)) {
+      if (boundFieldIds.has(fieldId) || fieldId.startsWith('_')) {
+        continue;
+      }
+
+      channelSettings[fieldId] = fieldValue;
+    }
+
+    // Map Chirp lowpower index onto legacy transmitPower watts for UV-5R UI compatibility.
+    if (typeof channelSettings.lowpower === 'number') {
+      channelSettings.transmitPower = channelSettings.lowpower === 0 ? 5 : 1;
+    }
+
+    if (typeof channelSettings.wide === 'boolean') {
+      channelSettings.mode = channelSettings.wide ? 'FM' : 'NFM';
+    }
+
+    if (typeof channelSettings.scan === 'boolean') {
+      channelSettings.skip = channelSettings.scan ? '' : 'S';
+    }
+
+    const radioChannel: RadioChannel = {
+      name,
+      receiveFrequency: Frequency(receiveFrequency),
+      transmitFrequency: Frequency(transmitFrequency),
+      receiveTone: toneToRadioTone(record[bindings.receiveTone]),
+      transmitTone: toneToRadioTone(record[bindings.transmitTone]),
+    };
+
+    channels.push({
+      channelNumber: index,
+      radioChannel,
+      settings: Object.keys(channelSettings).length > 0 ? channelSettings : undefined,
+    });
+  }
+
+  return channels;
+}
+
+/**
+ * Strip channel-bound structs from decoded settings so RadioProgram.settings
+ * only contains radio-wide settings.
+ */
+export function settingsWithoutChannels(memoryMap: RadioMemoryMap, settings: RadioSettings): RadioSettings {
+  const bindings = memoryMap.channelBindings;
+
+  if (!bindings) {
+    return settings;
+  }
+
+  const next: RadioSettings = { ...settings };
+  delete next[bindings.records];
+
+  if (bindings.names) {
+    delete next[bindings.names];
+  }
+
+  return next;
+}
+
+/**
+ * Merge RadioProgram channels back into a memory-map settings bag for encode.
+ */
+export function programToChannelSettings(memoryMap: RadioMemoryMap, program: RadioProgram): RadioSettings {
+  const bindings = memoryMap.channelBindings;
+
+  if (!bindings) {
+    return program.settings;
+  }
+
+  const recordsStruct = memoryMap.structs.find((struct) => struct.id === bindings.records);
+  const namesStruct = bindings.names ? memoryMap.structs.find((struct) => struct.id === bindings.names) : undefined;
+  const count = recordsStruct?.count ?? 0;
+  const nameField = bindings.nameField ?? 'name';
+
+  const records: RadioSettingValue[] = Array.from({ length: count }, () => null);
+  const names: RadioSettingValue[] = Array.from({ length: count }, () => null);
+
+  for (const programmed of program.channels) {
+    const index = programmed.channelNumber;
+
+    if (index < 0 || index >= count) {
+      continue;
+    }
+
+    if (typeof programmed.radioChannel === 'string') {
+      continue;
+    }
+
+    const channel = programmed.radioChannel;
+    const channelSettings = programmed.settings ?? {};
+    const record: Record<string, RadioSettingValue> = {
+      [bindings.receiveFrequency]: channel.receiveFrequency,
+      [bindings.transmitFrequency]: channel.transmitFrequency,
+      [bindings.receiveTone]: radioToneToMapTone(channel.receiveTone),
+      [bindings.transmitTone]: radioToneToMapTone(channel.transmitTone),
+    };
+
+    for (const [key, value] of Object.entries(channelSettings)) {
+      if (key === 'transmitPower') {
+        record.lowpower = value === 5 || value === 4 || value === 0 ? 0 : 1;
+        continue;
+      }
+
+      if (key === 'mode') {
+        record.wide = value === 'FM';
+        continue;
+      }
+
+      if (key === 'skip') {
+        record.scan = value !== 'S';
+        continue;
+      }
+
+      record[key] = value;
+    }
+
+    if (record.lowpower === undefined) {
+      record.lowpower = 0;
+    }
+
+    if (record.wide === undefined) {
+      record.wide = true;
+    }
+
+    if (record.scan === undefined) {
+      record.scan = true;
+    }
+
+    records[index] = record;
+    names[index] = { [nameField]: channel.name ?? '' };
+  }
+
+  const bag: RadioSettings = { ...program.settings, [bindings.records]: records };
+
+  if (bindings.names && namesStruct) {
+    bag[bindings.names] = names;
+  }
+
+  return bag;
+}
+
+/**
+ * Decode a full RadioProgram (channels + radio-wide settings) from memory.
+ */
+export function decodeRadioProgram(
+  memoryMap: RadioMemoryMap,
+  contents: Uint8Array,
+  memoryConfig: RadioMemoryConfig,
+): RadioProgram {
+  const decoded = decodeMemoryMap(memoryMap, contents, memoryConfig);
+
+  return {
+    channels: bindingsToChannels(memoryMap, decoded),
+    settings: settingsWithoutChannels(memoryMap, decoded),
+  };
+}
+
+/**
+ * Encode a RadioProgram into an existing memory image (patch in place).
+ */
+export function encodeRadioProgram(
+  memoryMap: RadioMemoryMap,
+  program: RadioProgram,
+  contents: Uint8Array,
+  memoryConfig: RadioMemoryConfig,
+): Uint8Array {
+  const bag = programToChannelSettings(memoryMap, program);
+  return encodeMemoryMap(memoryMap, bag, contents, memoryConfig);
+}