@k8ts/instruments 0.9.4 → 0.11.0

package/dist/expressions/data-sources/local-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-file.d.ts","sourceRoot":"","sources":["../../../src/expressions/data-sources/local-file.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,YAAY,CAAA;AAE7B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AACxC,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAA;AACjE,qBAAa,yBAAyB;IAG9B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;gBAEE,IAAI,EAAE,IAAI,EAC3B,OAAO,EAAE,MAAM;IAKnB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC;IACpE,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC;CAQlD;AAqBD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,6BAIxC"}
+{"version":3,"file":"local-file.d.ts","sourceRoot":"","sources":["../../../src/expressions/data-sources/local-file.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,YAAY,CAAA;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AAExC,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,CAAA;AAEpD;;;GAGG;AACH,cAAM,yBAAyB;IAUvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IATzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IAEnB;;;;;OAKG;gBAEkB,IAAI,EAAE,IAAI,EAC3B,OAAO,EAAE,MAAM;IAKnB;;;;;;OAMG;IACH,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,eAAe,CAAC,MAAM,CAAC;IAEpE;;;;;OAKG;IACH,EAAE,CAAC,IAAI,EAAE,QAAQ,GAAG,eAAe,CAAC,UAAU,CAAC;CASlD;AAmCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,6BAIxC"}

package/dist/expressions/data-sources/local-file.js

@@ -3,14 +3,23 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataSource_LocalFile_Path = void 0;
 exports.localRefFile = localRefFile;
 const pathlib_js_1 = __importDefault(require("pathlib-js"));
 const stacktracey_1 = __importDefault(require("stacktracey"));
 const base_1 = require("./base");
+/**
+ * Represents a local file path that can be read as text or binary data. Can be used instead of a
+ * primitive in some cases when building Kubernetes manifests.
+ */
 class DataSource_LocalFile_Path {
     _cwd;
     path;
+    /**
+     * Creates a local file path data source.
+     *
+     * @param _cwd - The current working directory
+     * @param relPath - Relative path to the file
+     */
     constructor(_cwd, relPath) {
         this._cwd = _cwd;
         this.path = this._cwd.join(relPath);
@@ -24,10 +33,16 @@ class DataSource_LocalFile_Path {
         }
     }
 }
-exports.DataSource_LocalFile_Path = DataSource_LocalFile_Path;
+/** Data source for reading local files as text with specified encoding. */
 class DataSource_LocalFile_Text extends base_1.DataSource_Lazy {
     _parent;
     encoding;
+    /**
+     * Creates a text file data source.
+     *
+     * @param _parent - Parent path object
+     * @param encoding - Text encoding (default: "utf-8")
+     */
     constructor(_parent, encoding = "utf-8") {
         super(async () => {
             return this._parent.path.readFile(this.encoding);
@@ -36,8 +51,14 @@ class DataSource_LocalFile_Text extends base_1.DataSource_Lazy {
         this.encoding = encoding;
     }
 }
+/** Data source for reading local files as binary (Uint8Array). */
 class DataSource_LocalFile_Binary extends base_1.DataSource_Lazy {
     _parent;
+    /**
+     * Creates a binary file data source.
+     *
+     * @param _parent - Parent path object
+     */
     constructor(_parent) {
         super(async () => {
             const x = await this._parent.path.readFile();
@@ -46,6 +67,20 @@ class DataSource_LocalFile_Binary extends base_1.DataSource_Lazy {
         this._parent = _parent;
     }
 }
+/**
+ * Creates a file path reference relative to the caller's file location. You must call `.as("text")`
+ * or `.as("binary")` on the returned object to get a data source.
+ *
+ * Can be used instead of a primitive in some cases when building Kubernetes manifests.
+ *
+ * @example
+ *     // In /project/src/config.ts:
+ *     const data = localRefFile("../data/config.json").as("text")
+ *     const content = await data.get() // Reads /project/data/config.json
+ *
+ * @param path - Relative path to the file from the caller's directory
+ * @returns File path object that can be read as text or binary
+ */
 function localRefFile(path) {
     const trace = new stacktracey_1.default().slice(1);
     const callerFile = trace.at(0).file;

package/dist/expressions/data-sources/local-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"local-file.js","sourceRoot":"","sources":["../../../src/expressions/data-sources/local-file.ts"],"names":[],"mappings":";;;;;;AA4CA,oCAIC;AAhDD,4DAA6B;AAC7B,8DAAqC;AAErC,iCAAwC;AAExC,MAAa,yBAAyB;IAGb;IAFZ,IAAI,CAAM;IACnB,YACqB,IAAU,EAC3B,OAAe;QADE,SAAI,GAAJ,IAAI,CAAM;QAG3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAID,EAAE,CAAC,IAAuB,EAAE,QAAyB;QACjD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAClB,OAAO,IAAI,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACxD,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAA;QAChD,CAAC;IACL,CAAC;CACJ;AAlBD,8DAkBC;AACD,MAAM,yBAA0B,SAAQ,sBAAuB;IAEtC;IACR;IAFb,YACqB,OAAkC,EAC1C,WAA2B,OAAO;QAE3C,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;QALe,YAAO,GAAP,OAAO,CAA2B;QAC1C,aAAQ,GAAR,QAAQ,CAA0B;IAK/C,CAAC;CACJ;AAED,MAAM,2BAA4B,SAAQ,sBAA2B;IACpC;IAA7B,YAA6B,OAAkC;QAC3D,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC5C,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAJuB,YAAO,GAAP,OAAO,CAA2B;IAK/D,CAAC;CACJ;AAED,SAAgB,YAAY,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,qBAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACnC,OAAO,IAAI,yBAAyB,CAAC,IAAI,oBAAI,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;AAC7E,CAAC"}
+{"version":3,"file":"local-file.js","sourceRoot":"","sources":["../../../src/expressions/data-sources/local-file.ts"],"names":[],"mappings":";;;;;AAoGA,oCAIC;AAxGD,4DAA6B;AAC7B,8DAAqC;AACrC,iCAAwC;AAKxC;;;GAGG;AACH,MAAM,yBAAyB;IAUN;IATZ,IAAI,CAAM;IAEnB;;;;;OAKG;IACH,YACqB,IAAU,EAC3B,OAAe;QADE,SAAI,GAAJ,IAAI,CAAM;QAG3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,CAAC;IAmBD,EAAE,CAAC,IAAuB,EAAE,QAAyB;QACjD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;YAClB,OAAO,IAAI,yBAAyB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;QACxD,CAAC;aAAM,CAAC;YACJ,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAA;QAChD,CAAC;IACL,CAAC;CACJ;AAED,2EAA2E;AAC3E,MAAM,yBAA0B,SAAQ,sBAAuB;IAQtC;IACR;IARb;;;;;OAKG;IACH,YACqB,OAAkC,EAC1C,WAA2B,OAAO;QAE3C,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QACpD,CAAC,CAAC,CAAA;QALe,YAAO,GAAP,OAAO,CAA2B;QAC1C,aAAQ,GAAR,QAAQ,CAA0B;IAK/C,CAAC;CACJ;AAED,kEAAkE;AAClE,MAAM,2BAA4B,SAAQ,sBAA2B;IAMpC;IAL7B;;;;OAIG;IACH,YAA6B,OAAkC;QAC3D,KAAK,CAAC,KAAK,IAAI,EAAE;YACb,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC5C,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAJuB,YAAO,GAAP,OAAO,CAA2B;IAK/D,CAAC;CACJ;AAED;;;;;;;;;;;;;GAaG;AACH,SAAgB,YAAY,CAAC,IAAY;IACrC,MAAM,KAAK,GAAG,IAAI,qBAAW,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACnC,OAAO,IAAI,yBAAyB,CAAC,IAAI,oBAAI,CAAC,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,CAAA;AAC7E,CAAC"}

package/dist/expressions/network/ports/index.d.ts

@@ -1,7 +1,7 @@
-import { PortSet } from "./set";
-import type { InputPortSetRecord } from "./types";
-export { PortMap } from "./map";
-export { PortSet } from "./set";
-export type { InputPortMapping, InputPortSetRecord, PortMapEntry, PortSetEntry } from "./types";
-export declare function ports<Names extends string>(input: InputPortSetRecord<Names>): PortSet<Names>;
+import type { Port_Exports_Input } from "./set";
+import { Port_Exports } from "./set";
+export { Port_Map, type PortMapping_Input } from "./map";
+export { Port_Exports, type Port_Exports_Input } from "./set";
+export type { Port_Full, Port_Mapping_Entry } from "./types";
+export declare function ports<Names extends string>(input: Port_Exports_Input<Names>): Port_Exports<Names>;
 //# sourceMappingURL=index.d.ts.map

package/dist/expressions/network/ports/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,YAAY,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC/F,wBAAgB,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAE5F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACpC,OAAO,EAAE,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,KAAK,kBAAkB,EAAE,MAAM,OAAO,CAAA;AAC7D,YAAY,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAC5D,wBAAgB,KAAK,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,CAEjG"}

package/dist/expressions/network/ports/index.js

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PortSet = exports.PortMap = void 0;
+exports.Port_Exports = exports.Port_Map = void 0;
 exports.ports = ports;
 const set_1 = require("./set");
 var map_1 = require("./map");
-Object.defineProperty(exports, "PortMap", { enumerable: true, get: function () { return map_1.PortMap; } });
+Object.defineProperty(exports, "Port_Map", { enumerable: true, get: function () { return map_1.Port_Map; } });
 var set_2 = require("./set");
-Object.defineProperty(exports, "PortSet", { enumerable: true, get: function () { return set_2.PortSet; } });
+Object.defineProperty(exports, "Port_Exports", { enumerable: true, get: function () { return set_2.Port_Exports; } });
 function ports(input) {
-    return set_1.PortSet.make(input);
+    return set_1.Port_Exports.make(input);
 }
 //# sourceMappingURL=index.js.map

package/dist/expressions/network/ports/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/expressions/network/ports/index.ts"],"names":[],"mappings":";;;AAKA,sBAEC;AAPD,+BAA+B;AAE/B,6BAA+B;AAAtB,8FAAA,OAAO,OAAA;AAChB,6BAA+B;AAAtB,8FAAA,OAAO,OAAA;AAEhB,SAAgB,KAAK,CAAuB,KAAgC;IACxE,OAAO,aAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAC9B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/expressions/network/ports/index.ts"],"names":[],"mappings":";;;AAKA,sBAEC;AAND,+BAAoC;AACpC,6BAAwD;AAA/C,+FAAA,QAAQ,OAAA;AACjB,6BAA6D;AAApD,mGAAA,YAAY,OAAA;AAErB,SAAgB,KAAK,CAAuB,KAAgC;IACxE,OAAO,kBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AACnC,CAAC"}

package/dist/expressions/network/ports/map.d.ts

@@ -1,12 +1,54 @@
-import type { PortMapEntry } from "./types";
-export declare class PortMap<Names extends string> {
+import type { Port_Mapping_Entry } from "./types";
+/**
+ * Represents an immutable mapping of named ports to their frontend/backend configuration.
+ *
+ * Used to define how container ports are exposed through services, mapping backend container ports
+ * to frontend service ports.
+ *
+ * @template Names The union type of all port names in the map.
+ */
+export declare class Port_Map<Names extends string> {
     private readonly _map;
-    constructor(_map: Map<string, PortMapEntry>);
+    constructor(_map: Map<string, Port_Mapping_Entry>);
     private _apply;
-    pick<InNames extends Names>(...name: InNames[]): PortMap<InNames>;
-    get values(): Map<string, PortMapEntry>;
-    map(mapping: Record<Names, number>): PortMap<Names>;
-    get(name: Names): PortMapEntry;
-    toMap(): Map<string, PortMapEntry>;
+    /**
+     * Creates a new Port_Map containing only the specified port names.
+     *
+     * @param name The port names to include in the new map.
+     * @returns A new Port_Map with only the selected ports.
+     */
+    pick<InNames extends Names>(...name: InNames[]): Port_Map<InNames>;
+    /** The underlying map of port names to their mapping entries. */
+    get values(): Map<string, Port_Mapping_Entry>;
+    /**
+     * Remaps the frontend ports to new values.
+     *
+     * @param mapping A record mapping port names to their new frontend port numbers.
+     * @returns A new Port_Map with updated frontend ports.
+     */
+    map(mapping: Record<Names, number>): Port_Map<Names>;
+    /**
+     * Retrieves a port mapping entry by name.
+     *
+     * @param name The name of the port to retrieve.
+     * @returns The port mapping entry.
+     * @throws {PortError} If the port name is not found in the map.
+     */
+    get(name: Names): Port_Mapping_Entry;
+    /** Converts this Port_Map to a standard Map. */
+    toMap(): Map<string, Port_Mapping_Entry>;
 }
+/**
+ * Input type for creating port mappings.
+ *
+ * Each port name maps to either:
+ *
+ * - A number specifying the frontend port
+ * - `true` to use the same port number as the backend
+ *
+ * @template Names The union type of port names.
+ */
+export type PortMapping_Input<Names extends string = string> = [Names] extends [never] ? never : {
+    [K in Names]: number | true;
+};
 //# sourceMappingURL=map.d.ts.map

package/dist/expressions/network/ports/map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,qBAAa,OAAO,CAAC,KAAK,SAAS,MAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAE5D,OAAO,CAAC,MAAM;IAId,IAAI,CAAC,OAAO,SAAS,KAAK,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE,IAAI,MAAM,8BAET;IAED,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAWnD,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY;IAO9B,KAAK;CAGR"}
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/map.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEjD;;;;;;;GAOG;AACH,qBAAa,QAAQ,CAAC,KAAK,SAAS,MAAM;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAElE,OAAO,CAAC,MAAM;IAMd;;;;;OAKG;IACH,IAAI,CAAC,OAAO,SAAS,KAAK,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,OAAO,CAAC;IAIlE,iEAAiE;IACjE,IAAI,MAAM,oCAET;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IAWpD;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,kBAAkB;IAOpC,gDAAgD;IAChD,KAAK;CAGR;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GAChF,KAAK,GACL;KACK,CAAC,IAAI,KAAK,GAAG,MAAM,GAAG,IAAI;CAC9B,CAAA"}

package/dist/expressions/network/ports/map.js

@@ -1,39 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PortMap = void 0;
+exports.Port_Map = void 0;
 const util_1 = require("@k8ts/metadata/util");
 const error_1 = require("./error");
-class PortMap {
+/**
+ * Represents an immutable mapping of named ports to their frontend/backend configuration.
+ *
+ * Used to define how container ports are exposed through services, mapping backend container ports
+ * to frontend service ports.
+ *
+ * @template Names The union type of all port names in the map.
+ */
+class Port_Map {
     _map;
     constructor(_map) {
         this._map = _map;
     }
     _apply(f) {
-        return new PortMap(f(this._map));
+        return new Port_Map(f(this._map));
     }
+    /**
+     * Creates a new Port_Map containing only the specified port names.
+     *
+     * @param name The port names to include in the new map.
+     * @returns A new Port_Map with only the selected ports.
+     */
     pick(...name) {
         return this._apply(map => (0, util_1.filterMap)(map, (_, key) => name.includes(key)));
     }
+    /** The underlying map of port names to their mapping entries. */
     get values() {
         return this._map;
     }
+    /**
+     * Remaps the frontend ports to new values.
+     *
+     * @param mapping A record mapping port names to their new frontend port numbers.
+     * @returns A new Port_Map with updated frontend ports.
+     */
     map(mapping) {
-        return new PortMap((0, util_1.mapValues)(this._map, entry => {
+        return new Port_Map((0, util_1.mapValues)(this._map, entry => {
             return {
                 ...entry,
                 frontend: mapping[entry.name]
             };
         }));
     }
+    /**
+     * Retrieves a port mapping entry by name.
+     *
+     * @param name The name of the port to retrieve.
+     * @returns The port mapping entry.
+     * @throws {PortError} If the port name is not found in the map.
+     */
     get(name) {
         if (!this._map.has(name)) {
             throw new error_1.PortError(`Port ${name} not found`);
         }
         return this._map.get(name);
     }
+    /** Converts this Port_Map to a standard Map. */
     toMap() {
         return this._map;
     }
 }
-exports.PortMap = PortMap;
+exports.Port_Map = Port_Map;
 //# sourceMappingURL=map.js.map

package/dist/expressions/network/ports/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../src/expressions/network/ports/map.ts"],"names":[],"mappings":";;;AAAA,8CAA0D;AAC1D,mCAAmC;AAEnC,MAAa,OAAO;IACa;IAA7B,YAA6B,IAA+B;QAA/B,SAAI,GAAJ,IAAI,CAA2B;IAAG,CAAC;IAExD,MAAM,CAAC,CAAgE;QAC3E,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACpC,CAAC;IAED,IAAI,CAAwB,GAAG,IAAe;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,gBAAS,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAc,CAAC,CAAC,CAAC,CAAA;IACxF,CAAC;IAED,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;IAED,GAAG,CAAC,OAA8B;QAC9B,OAAO,IAAI,OAAO,CACd,IAAA,gBAAS,EAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;YACzB,OAAO;gBACH,GAAG,KAAK;gBACR,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,IAA4B,CAAC;aACxD,CAAA;QACL,CAAC,CAAC,CACL,CAAA;IACL,CAAC;IAED,GAAG,CAAC,IAAW;QACX,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAA;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAiB,CAAA;IAC9C,CAAC;IAED,KAAK;QACD,OAAO,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;CACJ;AApCD,0BAoCC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../src/expressions/network/ports/map.ts"],"names":[],"mappings":";;;AAAA,8CAA0D;AAC1D,mCAAmC;AAGnC;;;;;;;GAOG;AACH,MAAa,QAAQ;IACY;IAA7B,YAA6B,IAAqC;QAArC,SAAI,GAAJ,IAAI,CAAiC;IAAG,CAAC;IAE9D,MAAM,CACV,CAA4E;QAE5E,OAAO,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;IACrC,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAwB,GAAG,IAAe;QAC1C,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAA,gBAAS,EAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAc,CAAC,CAAC,CAAC,CAAA;IACxF,CAAC;IAED,iEAAiE;IACjE,IAAI,MAAM;QACN,OAAO,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,OAA8B;QAC9B,OAAO,IAAI,QAAQ,CACf,IAAA,gBAAS,EAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE;YACzB,OAAO;gBACH,GAAG,KAAK;gBACR,QAAQ,EAAE,OAAO,CAAC,KAAK,CAAC,IAA4B,CAAC;aACxD,CAAA;QACL,CAAC,CAAC,CACL,CAAA;IACL,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAC,IAAW;QACX,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAS,CAAC,QAAQ,IAAI,YAAY,CAAC,CAAA;QACjD,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAuB,CAAA;IACpD,CAAC;IAED,gDAAgD;IAChD,KAAK;QACD,OAAO,IAAI,CAAC,IAAI,CAAA;IACpB,CAAC;CACJ;AA3DD,4BA2DC"}

package/dist/expressions/network/ports/set.d.ts

@@ -1,18 +1,93 @@
-import { PortMap } from "./map";
-import type { InputPort, InputPortMapping, InputPortSetEntry, InputPortSetRecord, InputProtocol, PortSetEntry } from "./types";
-export declare class PortSet<Names extends string = never> {
+import { Port_Map, PortMapping_Input } from "./map";
+import type { Port_Basic_Input, Port_Full, Port_Full_Input, Port_Input, Port_Protocol_Input } from "./types";
+/**
+ * An immutable dictionary of named network ports exported by a container. Each port also has an
+ * attached configuration.
+ *
+ * @template Names All exported port names.
+ */
+export declare class Port_Exports<Names extends string = never> {
     private readonly _map;
-    constructor(_map?: Map<Names, PortSetEntry>);
+    constructor(_map?: Map<Names, Port_Full>);
     private _apply;
-    union<InNames extends string>(other: PortSet<InNames>): PortSet<Names | InNames>;
-    add<Name extends string>(name: Name, port: InputPort, protocol: InputProtocol): PortSet<Names | Name>;
-    add<Name extends string>(name: Name, entry: InputPortSetEntry): PortSet<Names | Name>;
-    add<InNames extends string>(input?: InputPortSetRecord<InNames>): PortSet<Names | InNames>;
-    pick<InNames extends Names>(...name: InNames[]): PortSet<InNames>;
+    /**
+     * Creates a new Port_Exports that is the union of this and another Port_Exports.
+     *
+     * @param other The other Port_Exports to merge with.
+     * @returns A new Port_Exports containing ports from both dictionaries. The 2nd dictionary's
+     *   ports will overwrite any with the same name from the first.
+     */
+    union<InNames extends string>(other: Port_Exports<InNames>): Port_Exports<Names | InNames>;
+    /**
+     * Adds a port with explicit name, port number, and protocol.
+     *
+     * @param name The unique name for the port.
+     * @param port The port number.
+     * @param protocol The protocol (TCP or UDP).
+     */
+    add<Name extends string>(name: Name, port: Port_Basic_Input, protocol: Port_Protocol_Input): Port_Exports<Names | Name>;
+    /**
+     * Adds a port with a name and full port configuration.
+     *
+     * @param name The unique name for the port.
+     * @param entry The port configuration including number and protocol, and optional host
+     *   settings.
+     */
+    add<Name extends string>(name: Name, entry: Port_Full_Input): Port_Exports<Names | Name>;
+    /**
+     * Adds multiple ports from a record of port configurations.
+     *
+     * @param input A record mapping port names to their configurations.
+     */
+    add<InNames extends string>(input?: Port_Exports_Input<InNames>): Port_Exports<Names | InNames>;
+    /**
+     * Creates a new Port_Exports containing only the specified port names.
+     *
+     * @param name The port names to include.
+     * @returns A new Port_Exports with only the selected ports.
+     */
+    pick<InNames extends Names>(...name: InNames[]): Port_Exports<InNames>;
+    /** An array of all port names in this set. */
     get names(): Names[];
-    get(name: Names): PortSetEntry;
-    get values(): Map<Names, PortSetEntry>;
-    map(mapping: InputPortMapping<Names>): PortMap<Names>;
-    static make<Names extends string>(input?: InputPortSetRecord<Names>): PortSet<Names>;
+    /**
+     * Retrieves a port by name.
+     *
+     * @param name The name of the port to retrieve.
+     * @returns The full port configuration.
+     * @throws {PortError} If the port name is not found.
+     */
+    get(name: Names): Port_Full;
+    /** The underlying map of port names to their full configurations. */
+    get values(): Map<Names, Port_Full>;
+    /**
+     * Creates a Port_Map by mapping each port to a frontend port number.
+     *
+     * @param mapping A record where each port name maps to either a frontend port number or `true`
+     *   to use the backend port.
+     * @returns A new Port_Map with the specified frontend mappings.
+     * @throws {PortError} If a port name is missing from the mapping or has an invalid value.
+     */
+    map(mapping: PortMapping_Input<Names>): Port_Map<Names>;
+    /**
+     * Creates a new Port_Exports from a record of port configurations.
+     *
+     * @param input A record mapping port names to their configurations.
+     * @returns A new Port_Exports containing the specified ports.
+     */
+    static make<Names extends string>(input?: Port_Exports_Input<Names>): Port_Exports<Names>;
 }
+/**
+ * Input type for creating Port_Exports.
+ *
+ * A record mapping port names to their configurations, which can be:
+ *
+ * - A port number (uses TCP by default)
+ * - A tuple of `[port, protocol]`
+ * - A full port configuration object
+ *
+ * @template Names The union type of port names.
+ */
+export type Port_Exports_Input<Names extends string = string> = {
+    [K in Names]: Port_Input;
+};
 //# sourceMappingURL=set.d.ts.map

package/dist/expressions/network/ports/set.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/set.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAE/B,OAAO,KAAK,EACR,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,YAAY,EACf,MAAM,SAAS,CAAA;AAGhB,qBAAa,OAAO,CAAC,KAAK,SAAS,MAAM,GAAG,KAAK;IACjC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,GAAG,CAAC,KAAK,EAAE,YAAY,CAAa;IAMvE,OAAO,CAAC,MAAM;IAId,KAAK,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;IAGhF,GAAG,CAAC,IAAI,SAAS,MAAM,EACnB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,aAAa,GACxB,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IACrF,GAAG,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC;IAiB1F,IAAI,CAAC,OAAO,SAAS,KAAK,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAIjE,IAAI,KAAK,IAC4C,KAAK,EAAE,CAC3D;IAED,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,YAAY;IAO9B,IAAI,MAAM,6BAET;IAED,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IA2BrD,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC;CAGtE"}
+{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/set.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EACT,eAAe,EACf,UAAU,EACV,mBAAmB,EACtB,MAAM,SAAS,CAAA;AAEhB;;;;;GAKG;AACH,qBAAa,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,KAAK;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,GAAE,GAAG,CAAC,KAAK,EAAE,SAAS,CAAa;IAMpE,OAAO,CAAC,MAAM;IAId;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,KAAK,GAAG,OAAO,CAAC;IAI1F;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,SAAS,MAAM,EACnB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,mBAAmB,GAC9B,YAAY,CAAC,KAAK,GAAG,IAAI,CAAC;IAC7B;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,SAAS,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,GAAG,YAAY,CAAC,KAAK,GAAG,IAAI,CAAC;IACxF;;;;OAIG;IACH,GAAG,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,KAAK,GAAG,OAAO,CAAC;IAiB/F;;;;;OAKG;IACH,IAAI,CAAC,OAAO,SAAS,KAAK,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC;IAItE,8CAA8C;IAC9C,IAAI,KAAK,IAC4C,KAAK,EAAE,CAC3D;IAED;;;;;;OAMG;IACH,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,SAAS;IAO3B,qEAAqE;IACrE,IAAI,MAAM,0BAET;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;IA2BvD;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC;CAGtE;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI;KAC3D,CAAC,IAAI,KAAK,GAAG,UAAU;CAC3B,CAAA"}

package/dist/expressions/network/ports/set.js

@@ -1,13 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PortSet = void 0;
+exports.Port_Exports = void 0;
 const metadata_1 = require("@k8ts/metadata");
 const util_1 = require("@k8ts/metadata/util");
 const doddle_1 = require("doddle");
 const error_1 = require("./error");
 const map_1 = require("./map");
 const entry_1 = require("./tools/entry");
-class PortSet {
+/**
+ * An immutable dictionary of named network ports exported by a container. Each port also has an
+ * attached configuration.
+ *
+ * @template Names All exported port names.
+ */
+class Port_Exports {
     _map;
     constructor(_map = new Map()) {
         this._map = _map;
@@ -16,10 +22,17 @@ class PortSet {
         }
     }
     _apply(f) {
-        return new PortSet(f(this._map));
+        return new Port_Exports(f(this._map));
     }
+    /**
+     * Creates a new Port_Exports that is the union of this and another Port_Exports.
+     *
+     * @param other The other Port_Exports to merge with.
+     * @returns A new Port_Exports containing ports from both dictionaries. The 2nd dictionary's
+     *   ports will overwrite any with the same name from the first.
+     */
     union(other) {
-        return new PortSet((0, util_1.merge)(this._map, other._map));
+        return new Port_Exports((0, util_1.merge)(this._map, other._map));
     }
     add(a, b, c) {
         if (!a) {
@@ -36,23 +49,46 @@ class PortSet {
             return (0, util_1.merge)(map, processed);
         });
     }
+    /**
+     * Creates a new Port_Exports containing only the specified port names.
+     *
+     * @param name The port names to include.
+     * @returns A new Port_Exports with only the selected ports.
+     */
     pick(...name) {
         return this._apply(map => (0, util_1.filterMap)(map, (_, key) => name.includes(key)));
     }
+    /** An array of all port names in this set. */
     get names() {
         return (0, doddle_1.seq)(this._map.keys()).toArray().pull();
     }
+    /**
+     * Retrieves a port by name.
+     *
+     * @param name The name of the port to retrieve.
+     * @returns The full port configuration.
+     * @throws {PortError} If the port name is not found.
+     */
     get(name) {
         if (!this._map.has(name)) {
             throw new error_1.PortError(`Port ${name} not found`);
         }
         return this._map.get(name);
     }
+    /** The underlying map of port names to their full configurations. */
     get values() {
         return this._map;
     }
+    /**
+     * Creates a Port_Map by mapping each port to a frontend port number.
+     *
+     * @param mapping A record where each port name maps to either a frontend port number or `true`
+     *   to use the backend port.
+     * @returns A new Port_Map with the specified frontend mappings.
+     * @throws {PortError} If a port name is missing from the mapping or has an invalid value.
+     */
     map(mapping) {
-        return new map_1.PortMap((0, util_1.mapValues)(this._map, entry => {
+        return new map_1.Port_Map((0, util_1.mapValues)(this._map, entry => {
             if (!(entry.name in mapping)) {
                 throw new error_1.PortError(`Port ${entry.name} not found in mapping`);
             }
@@ -75,9 +111,15 @@ class PortSet {
             };
         }));
     }
+    /**
+     * Creates a new Port_Exports from a record of port configurations.
+     *
+     * @param input A record mapping port names to their configurations.
+     * @returns A new Port_Exports containing the specified ports.
+     */
     static make(input) {
-        return new PortSet().add(input);
+        return new Port_Exports().add(input);
     }
 }
-exports.PortSet = PortSet;
+exports.Port_Exports = Port_Exports;
 //# sourceMappingURL=set.js.map

package/dist/expressions/network/ports/set.js.map

@@ -1 +1 @@
-{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../src/expressions/network/ports/set.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../src/expressions/network/ports/set.ts"],"names":[],"mappings":"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"}

package/dist/expressions/network/ports/tools/entry.d.ts

@@ -1,5 +1,6 @@
-import { PortSet } from "../set";
-import type { InputPortSetRecord, InputPortSetSpec, PortSetEntry } from "../types";
-export declare function parsePortInput(name: string, input: InputPortSetSpec): PortSetEntry;
-export declare function portRecordInput(record: InputPortSetRecord<string> | PortSet<string>): Map<string, PortSetEntry>;
+import type { Port_Exports_Input } from "../set";
+import { Port_Exports } from "../set";
+import type { Port_Full, Port_Input } from "../types";
+export declare function parsePortInput(name: string, input: Port_Input): Port_Full;
+export declare function portRecordInput(record: Port_Exports_Input<string> | Port_Exports<string>): Map<string, Port_Full>;
 //# sourceMappingURL=entry.d.ts.map

package/dist/expressions/network/ports/tools/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/entry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAChC,OAAO,KAAK,EAER,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EAEf,MAAM,UAAU,CAAA;AAajB,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,YAAY,CAWlF;AAED,wBAAgB,eAAe,CAC3B,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GACrD,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAQ3B"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/entry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAmB,UAAU,EAAiB,MAAM,UAAU,CAAA;AAarF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CAWzE;AAED,wBAAgB,eAAe,CAC3B,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,GAC1D,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAQxB"}

package/dist/expressions/network/ports/tools/entry.js

@@ -28,7 +28,7 @@ function parsePortInput(name, input) {
     return portSetEntry(name, input);
 }
 function portRecordInput(record) {
-    if (record instanceof set_1.PortSet) {
+    if (record instanceof set_1.Port_Exports) {
         return record.values;
     }
     const inputMap = (0, doddle_1.seq)(Object.entries(record))

package/dist/expressions/network/ports/tools/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/entry.ts"],"names":[],"mappings":";;AAsBA,wCAWC;AAED,0CAUC;AA7CD,mCAA4B;AAC5B,iCAA8B;AAC9B,gCAAgC;AAQhC,mCAAuC;AAEvC,SAAS,YAAY,CAAC,IAAY,EAAE,KAAwB;IACxD,OAAO;QACH,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAc;QAClD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAA;AACL,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAuB;IAChE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,IAAI,EAAE,IAAA,qBAAa,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,IAAI,EAAE;YACtB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,KAAc;SAC3B,CAAC,CAAA;IACN,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACpC,CAAC;AAED,SAAgB,eAAe,CAC3B,MAAoD;IAEpD,IAAI,MAAM,YAAY,aAAO,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAA;IACxB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAA,YAAG,EAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SACvC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC5C,IAAI,EAAE,CAAA;IACX,OAAO,QAAQ,CAAA;AACnB,CAAC"}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/entry.ts"],"names":[],"mappings":";;AAiBA,wCAWC;AAED,0CAUC;AAxCD,mCAA4B;AAC5B,iCAA8B;AAE9B,gCAAqC;AAErC,mCAAuC;AAEvC,SAAS,YAAY,CAAC,IAAY,EAAE,KAAsB;IACtD,OAAO;QACH,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAmB;QACvD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,QAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;QACxD,QAAQ,EAAE,KAAK,CAAC,QAAQ;KAC3B,CAAA;AACL,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAiB;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,IAAI,EAAE,IAAA,qBAAa,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,YAAY,CAAC,IAAI,EAAE;YACtB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,KAAc;SAC3B,CAAC,CAAA;IACN,CAAC;IACD,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;AACpC,CAAC;AAED,SAAgB,eAAe,CAC3B,MAAyD;IAEzD,IAAI,MAAM,YAAY,kBAAY,EAAE,CAAC;QACjC,OAAO,MAAM,CAAC,MAAM,CAAA;IACxB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAA,YAAG,EAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;SACvC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC5C,IAAI,EAAE,CAAA;IACX,OAAO,QAAQ,CAAA;AACnB,CAAC"}

package/dist/expressions/network/ports/tools/parse.d.ts

@@ -1,3 +1,3 @@
-import type { InputPortSetEntry } from "../types";
-export declare function parsePortSpec(name: string, input: string): InputPortSetEntry;
+import type { Port_Full_Input } from "../types";
+export declare function parsePortSpec(name: string, input: string): Port_Full_Input;
 //# sourceMappingURL=parse.d.ts.map

package/dist/expressions/network/ports/tools/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/parse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAY,MAAM,UAAU,CAAA;AA4B3D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,qBAQxD"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/parse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,UAAU,CAAA;AA4B9D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,mBAQxD"}

package/dist/expressions/network/ports/tools/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/parse.ts"],"names":[],"mappings":";;AA+BA,sCAQC;AAvCD,iCAAgD;AAChD,mDAAiE;AACjE,oCAAoC;AAGpC,SAAS,YAAY,CAAC,IAAY;IAC9B,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC3B,OAAO;YACH,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,kCAAkC;SAC9C,CAAA;IACL,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC;AACD,MAAM,SAAS,GAAG,IAAA,mBAAW,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAC1D,IAAA,iBAAG,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAc,CAAC,CACxC,CAAA;AAED,MAAM,KAAK,GAAG,IAAA,WAAG,GAAE,CAAC,IAAI,CAAC,IAAA,kBAAI,EAAC,YAAY,CAAC,CAAC,CAAA;AAC5C,MAAM,aAAa,GAAG,IAAA,cAAM,EAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAA,mBAAK,EAAC,SAAS,CAAC,EAAE,IAAA,mBAAK,EAAC,KAAK,CAAC,CAAC,CAAA;AACtE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CACxB,IAAA,kBAAI,EAAC,aAAa,CAAC,EACnB,IAAA,iBAAG,EAAC,GAAG,CAAC,EAAE;IACN,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAA;IAC5B,OAAO;QACH,IAAI;QACJ,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,KAAK;KACxB,CAAA;AAC1B,CAAC,CAAC,CACL,CAAA;AAED,SAAgB,aAAa,CAAC,IAAY,EAAE,KAAa;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,KAAK,CAAA;IACvB,CAAC;IACD,MAAM,IAAI,iBAAS,CAAC,IAAI,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC,CAAA;AACN,CAAC"}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../../../../src/expressions/network/ports/tools/parse.ts"],"names":[],"mappings":";;AA+BA,sCAQC;AAvCD,iCAAgD;AAChD,mDAAiE;AACjE,oCAAoC;AAGpC,SAAS,YAAY,CAAC,IAAY;IAC9B,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAC3B,OAAO;YACH,IAAI,EAAE,MAAe;YACrB,OAAO,EAAE,kCAAkC;SAC9C,CAAA;IACL,CAAC;IACD,OAAO,IAAI,CAAA;AACf,CAAC;AACD,MAAM,SAAS,GAAG,IAAA,mBAAW,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,CAC1D,IAAA,iBAAG,EAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAmB,CAAC,CAC7C,CAAA;AAED,MAAM,KAAK,GAAG,IAAA,WAAG,GAAE,CAAC,IAAI,CAAC,IAAA,kBAAI,EAAC,YAAY,CAAC,CAAC,CAAA;AAC5C,MAAM,aAAa,GAAG,IAAA,cAAM,EAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAA,mBAAK,EAAC,SAAS,CAAC,EAAE,IAAA,mBAAK,EAAC,KAAK,CAAC,CAAC,CAAA;AACtE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CACxB,IAAA,kBAAI,EAAC,aAAa,CAAC,EACnB,IAAA,iBAAG,EAAC,GAAG,CAAC,EAAE;IACN,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,GAAG,CAAA;IAC5B,OAAO;QACH,IAAI;QACJ,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,KAAK;KAC1B,CAAA;AACxB,CAAC,CAAC,CACL,CAAA;AAED,SAAgB,aAAa,CAAC,IAAY,EAAE,KAAa;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,MAAM,CAAC,KAAK,CAAA;IACvB,CAAC;IACD,MAAM,IAAI,iBAAS,CAAC,IAAI,EAAE;QACtB,UAAU,EAAE,MAAM,CAAC,MAAM;KAC5B,CAAC,CAAA;AACN,CAAC"}