@k8ts/instruments 0.9.4 → 0.11.0

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

@@ -1,36 +1,27 @@
 import type { Ip4, Ip4_String } from "../ip";
-export interface PortSpecObj {
-    port: Port;
-    protocol: Protocol;
-}
-export type Port = number;
-export type InputPort = Port | `${Port}`;
-export type InputProtocol = Protocol | Lowercase<Protocol>;
-export type Protocol = "TCP" | "UDP";
-export type InputPortProto = `${Port}/${InputProtocol}`;
-export interface PortMapEntry {
+type Port = number;
+export type Port_Basic_Input = Port | `${Port}`;
+export type Port_Protocol_Input = Port_Protocol | Lowercase<Port_Protocol>;
+export type Port_Protocol = "TCP" | "UDP";
+export type Port_WithProto_Input = `${Port}/${Port_Protocol_Input}`;
+export interface Port_Mapping_Entry {
     name: string;
-    protocol: Protocol;
+    protocol: Port_Protocol;
     frontend: number;
 }
-export interface PortSetEntry {
+export interface Port_Full {
     name: string;
     port: number;
-    protocol: Protocol;
+    protocol: Port_Protocol;
     hostIp?: Ip4;
     hostPort?: number;
 }
-export interface InputPortSetEntry {
+export interface Port_Full_Input {
     port: Port;
-    protocol: InputProtocol;
+    protocol: Port_Protocol_Input;
     hostIp?: Ip4_String;
     hostPort?: Port;
 }
-export type InputPortSetSpec = InputPortSetEntry | InputPort | InputPortProto;
-export type InputPortSetRecord<Names extends string = string> = {
-    [K in Names]: InputPortSetSpec;
-};
-export type InputPortMapping<Names extends string = string> = [Names] extends [never] ? never : {
-    [K in Names]: number | true;
-};
+export type Port_Input = Port_Full_Input | Port_Basic_Input | Port_WithProto_Input;
+export {};
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAE5C,MAAM,WAAW,WAAW;IACxB,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,QAAQ,CAAA;CACrB;AAED,MAAM,MAAM,IAAI,GAAG,MAAM,CAAA;AACzB,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,GAAG,IAAI,EAAE,CAAA;AACxC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;AAC1D,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAA;AACpC,MAAM,MAAM,cAAc,GAAG,GAAG,IAAI,IAAI,aAAa,EAAE,CAAA;AACvD,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,QAAQ,CAAC,EAAE,IAAI,CAAA;CAClB;AAED,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,SAAS,GAAG,cAAc,CAAA;AAE7E,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI;KAC3D,CAAC,IAAI,KAAK,GAAG,gBAAgB;CACjC,CAAA;AACD,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,GAC/E,KAAK,GACL;KACK,CAAC,IAAI,KAAK,GAAG,MAAM,GAAG,IAAI;CAC9B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/expressions/network/ports/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAE5C,KAAK,IAAI,GAAG,MAAM,CAAA;AAClB,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,GAAG,IAAI,EAAE,CAAA;AAC/C,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,SAAS,CAAC,aAAa,CAAC,CAAA;AAC1E,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAA;AACzC,MAAM,MAAM,oBAAoB,GAAG,GAAG,IAAI,IAAI,mBAAmB,EAAE,CAAA;AACnE,MAAM,WAAW,kBAAkB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,aAAa,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,aAAa,CAAA;IACvB,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,IAAI,CAAA;IACV,QAAQ,EAAE,mBAAmB,CAAA;IAC7B,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,QAAQ,CAAC,EAAE,IAAI,CAAA;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,gBAAgB,GAAG,oBAAoB,CAAA"}

package/dist/expressions/quantities/reqlem/objects.d.ts

@@ -2,7 +2,7 @@ import { type Parjser } from "parjs";
 import type { UnitParser, UnitValue } from "../units";
 import { AnyUnitParser } from "../units/unit-parser";
 import type { ReqLimit, Resources_ReqLimits_Trait, Resources_UnitMap_Trait } from "./types";
-export declare class Resources_Map<const RM extends Resources_UnitMap_Trait<RM>> {
+export declare class Resources_UnitMap<const RM extends Resources_UnitMap_Trait<RM>> {
     private _map;
     constructor(_map: Map<string, ReqLimit>);
     toObject(): any;
@@ -16,7 +16,7 @@ export declare class ResourcesSpec<const RM extends Resources_UnitMap_Trait<RM>>
     private _parseUnitValue;
     private _parseReqLimit;
     __INPUT__: Resources_ReqLimits_Trait<RM>;
-    parse<const R extends Resources_ReqLimits_Trait<RM>>(input: R): Resources_Map<RM>;
+    parse<const R extends Resources_ReqLimits_Trait<RM>>(input: R): Resources_UnitMap<RM>;
     static make<const RM extends Resources_UnitMap_Trait<RM>>(unitMap: {
         [K in keyof RM]: UnitParser<RM[K]>;
     }): ResourcesSpec<RM>;

package/dist/expressions/quantities/reqlem/objects.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../../src/expressions/quantities/reqlem/objects.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,OAAO,CAAA;AAG5C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAE3F,qBAAa,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAAE,CAAC;IACvD,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;IAE/C,QAAQ;CAqBX;AAED,qBAAa,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAAE,CAAC;IACnE,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAA;IAClE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,QAAQ,CAAC,cAAc,gBAAuB;IAC9C,QAAQ,CAAC,kBAAkB,4BAA4C;gBAC3D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAQ7C,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAOtB,SAAS,EAAG,yBAAyB,CAAC,EAAE,CAAC,CAAA;IAEzC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,yBAAyB,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,EAAE,CAAC;IAkCjF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE;SAC9D,CAAC,IAAI,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACrC;CAGJ"}
+{"version":3,"file":"objects.d.ts","sourceRoot":"","sources":["../../../../src/expressions/quantities/reqlem/objects.ts"],"names":[],"mappings":"AAGA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,OAAO,CAAA;AAG5C,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,yBAAyB,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAE3F,qBAAa,iBAAiB,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAAE,CAAC;IAC3D,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;IAE/C,QAAQ;CAqBX;AAED,qBAAa,aAAa,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAAE,CAAC;IACnE,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAAC,CAAA;IAClE,QAAQ,CAAC,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAA;IACzD,QAAQ,CAAC,cAAc,gBAAuB;IAC9C,QAAQ,CAAC,kBAAkB,4BAA4C;gBAC3D,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC;IAQ7C,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,cAAc;IAOtB,SAAS,EAAG,yBAAyB,CAAC,EAAE,CAAC,CAAA;IAEzC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,yBAAyB,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC;IAkCrF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,SAAS,uBAAuB,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE;SAC9D,CAAC,IAAI,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;KACrC;CAGJ"}

package/dist/expressions/quantities/reqlem/objects.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ResourcesSpec = exports.Resources_Map = void 0;
+exports.ResourcesSpec = exports.Resources_UnitMap = void 0;
 const util_1 = require("@k8ts/metadata/util");
 const doddle_1 = require("doddle");
 const lodash_1 = require("lodash");
@@ -9,7 +9,7 @@ const combinators_1 = require("parjs/combinators");
 const error_1 = require("../../../error");
 const unit_parser_1 = require("../units/unit-parser");
 const parser_1 = require("./parser");
-class Resources_Map {
+class Resources_UnitMap {
     _map;
     constructor(_map) {
         this._map = _map;
@@ -35,7 +35,7 @@ class Resources_Map {
         return (0, lodash_1.merge)({}, ...kubernetesForm.values());
     }
 }
-exports.Resources_Map = Resources_Map;
+exports.Resources_UnitMap = Resources_UnitMap;
 class ResourcesSpec {
     _unitParsers;
     _reqLimitParsers;
@@ -93,7 +93,7 @@ class ResourcesSpec {
             return [key, getVal()];
         })
             .pull();
-        return new Resources_Map(map);
+        return new Resources_UnitMap(map);
     }
     static make(unitMap) {
         return new ResourcesSpec((0, util_1.mapFromObject)(unitMap));

package/dist/expressions/quantities/reqlem/objects.js.map

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

package/dist/expressions/quantities/units/unit-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unit-parser.d.ts","sourceRoot":"","sources":["../../../../src/expressions/quantities/units/unit-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,OAAO,CAAA;AAajD,qBAAa,SAAS,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IAE3C,QAAQ,CAAC,IAAI,EAAE,IAAI;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAFZ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM;IAGzB,IAAI,GAAG,WAEN;IAED,IAAI,GAAG,oBAKN;IAED,QAAQ;CAGX;AAED,8BAAsB,UAAU,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IAGnD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAFhD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IACzC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;gBACjC,SAAS,EAAE,MAAM;IAUhD,KAAK,GAAI,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,qBASjC;CACJ;AAED,qBAAa,aAAc,SAAQ,UAAU,CAAC,MAAM,CAAC;;IAKjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,MAAM,CAAC,IAAI;CAGd;AAED,qBAAa,aAAa,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,UAAU,CAAC,IAAI,CAAC;IAG/E,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADvB,QAAQ,EAAE,MAAM,EACC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;IAKtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;IAM7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC;CAG5E"}
+{"version":3,"file":"unit-parser.d.ts","sourceRoot":"","sources":["../../../../src/expressions/quantities/units/unit-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,OAAO,CAAA;AAYjD,qBAAa,SAAS,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IAE3C,QAAQ,CAAC,IAAI,EAAE,IAAI;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAFZ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM;IAGzB,IAAI,GAAG,WAEN;IAED,IAAI,GAAG,oBAKN;IAED,QAAQ;CAGX;AAED,8BAAsB,UAAU,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM;IAGnD,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAFhD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;IACzC,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;gBACjC,SAAS,EAAE,MAAM;IAUhD,KAAK,GAAI,OAAO,GAAG,MAAM,GAAG,IAAI,EAAE,qBASjC;CACJ;AAED,qBAAa,aAAc,SAAQ,UAAU,CAAC,MAAM,CAAC;;IAKjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,MAAM,CAAC,IAAI;CAGd;AAED,qBAAa,aAAa,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,UAAU,CAAC,IAAI,CAAC;IAG/E,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADvB,QAAQ,EAAE,MAAM,EACC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;IAKtC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,IAAI,IAAI;IAM7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC;CAG5E"}

package/dist/expressions/quantities/units/unit-parser.js

@@ -9,7 +9,6 @@ const pValueUnit = (0, parjs_1.int)().pipe((0, combinators_1.then)(pUnit), (0, c
     const [value, unit] = arr;
     return { value, unit };
 }));
-// TODO: Simplify unit parser to allow for arbitrary resources/units
 class UnitValue {
     unit;
     value;

package/dist/expressions/quantities/units/unit-parser.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@k8ts/instruments",
-  "version": "0.9.4",
+  "version": "0.11.0",
   "description": "A collection of utilities and core components for k8ts.",
   "keywords": [
     "k8ts",
@@ -61,7 +61,7 @@
   "dependencies": {
     "chalk": "4.1.2",
     "dayjs": "^1.11.13",
-    "doddle": "^7.2.0",
+    "doddle": "^7.3.1",
     "eventemitter3": "^5.0.1",
     "ip-address": "^10.0.1",
     "lodash": "^4.17.21",
@@ -74,10 +74,10 @@
     "what-are-you": "^0.2.0"
   },
   "devDependencies": {
-    "@k8ts/metadata": "^0.7.4",
+    "@k8ts/metadata": "^0.10.0",
     "@types/jest": "^30.0.0",
     "@types/lodash": "^4.17.16",
-    "@types/node": "20.9.1",
+    "@types/node": "22",
     "declare-it": "^2.1.0",
     "jest": "^30.2.0",
     "npm-run-all": "^4.1.5",
@@ -89,7 +89,7 @@
     "yamprint": "^0.8.4"
   },
   "peerDependencies": {
-    "@k8ts/metadata": "^0.7.4"
+    "@k8ts/metadata": "^0.10.0"
   },
   "engines": {
     "node": ">=16.0.0"

package/src/core/graph/entities.md

@@ -0,0 +1 @@
+Entities represent unique, mutable objects

package/src/core/graph/entity.ts

@@ -1,33 +1,60 @@
+import { getNiceClassName, type AnyCtor } from "what-are-you"
 import type { Node } from "./node"
-import { FwReference } from "./resource/reference/fw-ref"
 export type LiteralModes = "simple" | "pretty" | "prefix"
 
 let globalEntityId = 0
+
+type AbsCtor<T> = abstract new (...args: any[]) => any
+export type RefLike = {
+    get ref(): {
+        kind: string
+        name: string
+        namespace?: string
+    }
+    kind: any
+    name: string
+    assert<Inst extends RefLike>(cls: abstract new (...args: any[]) => Inst): Inst
+    is<Inst extends RefLike>(cls: abstract new (...args: any[]) => Inst): this is Inst
+}
 export abstract class Entity<
     _Node extends Node<_Node, _Ent> = Node<any, any>,
-    _Ent extends Entity<_Node, _Ent> = Entity<any, any>
+    _Ent extends Entity<_Node, _Ent> = Entity<any, any>,
+    _EntRefType extends RefLike = RefLike
 > {
+    abstract get ref(): RefLike["ref"]
+    abstract readonly kind: any
     private readonly _ID = (() => {
         return globalEntityId++
     })()
     abstract readonly node: _Node
     abstract readonly name: string
-    equals(other: any): boolean {
-        if (FwReference.is(other)) {
-            return this.equals(other["__pull__"]())
+    assert<Inst extends _EntRefType>(cls: AnyCtor<Inst>): Inst {
+        if (this.is(cls)) {
+            return this as any as Inst
+        }
+        throw new Error(
+            `This Resource ${this} is not compatible with the class ${getNiceClassName(cls)}.`
+        )
+    }
+    is<K extends this["kind"]>(kind: K): this is { kind: K }
+    is<Inst extends _EntRefType = _EntRefType>(cls: AnyCtor<Inst>): this is Inst
+    is(cls: any): boolean {
+        if (typeof cls === "function") {
+            return this instanceof cls
         }
-        return Object.is(this, other)
+        return this.kind.equals(cls)
     }
+    abstract equals(other: any): boolean
 
-    protected __kids__(): Iterable<_Ent> {
+    protected __kids__(): Iterable<_EntRefType> {
         return []
     }
 
-    protected __parent__(): _Ent | undefined {
+    protected __parent__(): _EntRefType | undefined {
         return undefined
     }
 
-    protected __needs__(): Record<string, _Ent | undefined | _Ent[]> {
+    protected __needs__(): Record<string, _EntRefType | undefined | _EntRefType[]> {
         return {}
     }
 }

package/src/core/graph/node.ts

@@ -1,46 +1,74 @@
 import { seq, type Seq } from "doddle"
-import type { Entity } from "./entity"
+import { Entity } from "./entity"
 import { Relation } from "./relation"
-import { FwReference } from "./resource/reference"
-
+import { FwRef } from "./resource/reference/fw-ref"
+/**
+ * The {@link Node} is a wrapper around a {@link Entity} that provides traversal, display, and other
+ * utilities. Note that the {@link Node} itself is immutable. Changes only happen to the underlying
+ * {@link Entity}.
+ *
+ * Two {@link Node} instances are considered equal if they wrap the same {@link Entity}, even if
+ * they're different instances.
+ *
+ * Node classes are primarily used for traversal in the graph structure formed by {@link Entity}
+ * instances. They provide methods to navigate parent-child relationships, access metadata, and
+ * explore dependencies between entities.
+ *
+ * This is mainly done in the manifestation pipeline, but users can also rely on it to construct
+ * resources dynamically.
+ *
+ * Accessing the `Node` of an `Entity` always forces any `FwRef` instances to resolve.
+ */
 export abstract class Node<
     _Node extends Node<_Node, _Entity> = Node<any, any>,
     _Entity extends Entity<_Node, _Entity> = Entity<any, any>
 > {
+    /** The nodes of child entities. */
+
+    private readonly _ID: number
+    constructor(readonly entity: _Entity) {
+        this._ID = this.entity["_ID"]
+    }
     get kids() {
-        return seq(this.entity["__kids__"]()).map(x => x.node)
+        return seq(this.entity["__kids__"]()).map(x => x.assert(Entity).node as _Node)
     }
+    /** The direct **needs** of this this node's entity. */
     get relations() {
-        const needs = this.entity["__needs__"]()
+        const needs = seq(() => {
+            return seq.fromObject(this.entity["__needs__"]())
+        })
         return seq(function* () {
-            for (const [relName, target] of Object.entries(needs)) {
+            for (const [relName, target] of needs) {
                 if (Array.isArray(target)) {
                     for (const t of target) {
                         if (t) {
-                            yield new Relation<_Node>(relName, t.node)
+                            yield new Relation<_Node>(
+                                relName,
+                                t.assert(Entity<_Node, _Entity>).node
+                            )
                         }
                     }
                 } else {
                     if (target) {
-                        yield new Relation<_Node>(relName, target.node)
+                        yield new Relation<_Node>(
+                            relName,
+                            target.assert(Entity<_Node, _Entity>).node
+                        )
                     }
                 }
             }
         })
     }
 
+    /** The node for this node's parent entity. */
     get parent(): _Node | null {
-        return this.entity["__parent__"]()?.node ?? null
-    }
-
-    protected get _asNode() {
-        return this as any as _Node
-    }
-    private readonly _ID: number
-    constructor(readonly entity: _Entity) {
-        this._ID = this.entity["_ID"]
+        return (this.entity["__parent__"]()?.assert(Entity).node as any) ?? null
     }
 
+    /**
+     * The root node of this node's entity tree. Doesn't cross tree boundaries, so the root of a
+     * Resource-level tree.
+     */
     get root(): _Node {
         return (this.ancestors.at(-1).pull() as any) ?? (this as any)
     }
@@ -51,7 +79,10 @@ export abstract class Node<
         return this.parent === null
     }
     equals(other: any): boolean {
-        if (FwReference.is(other)) {
+        if (!other) {
+            return false
+        }
+        if (FwRef.is(other)) {
             return this.equals(other["__pull__"]())
         }
         if (other instanceof Node === false) {
@@ -60,23 +91,23 @@ export abstract class Node<
         return this.entity.equals(other.entity)
     }
 
-    readonly ancestors = seq((): _Node[] => {
-        const seen = [] as _Node[]
-        const recurse = function (from: _Node) {
+    readonly ancestors = seq((): Node[] => {
+        const seen = [] as Node[]
+        const recurse = function (from: Node) {
             const parent = from.parent
             if (parent && !seen.find(x => x.equals(parent))) {
                 seen.push(parent)
                 recurse(parent)
             }
         }
-        recurse(this._asNode)
+        recurse(this)
         return seen
-    })
+    }).as<_Node>()
 
-    readonly descendants = seq((): _Node[] => {
+    readonly descendants = seq((): Node[] => {
         const self = this
-        let seen = [] as _Node[]
-        const recurse = function (from: _Node) {
+        let seen = [] as Node[]
+        const recurse = function (from: Node) {
             for (const kid of from.kids) {
                 if (seen.find(x => x.equals(kid))) {
                     continue
@@ -85,40 +116,40 @@ export abstract class Node<
                 recurse(kid)
             }
         }
-        recurse(this._asNode)
+        recurse(this)
         return seen
-    })
+    }).as<_Node>()
 
-    isParentOf(other: _Node): boolean {
-        if (FwReference.is(other)) {
-            return other.isChildOf(this._asNode)
+    isParentOf(other: Node): boolean {
+        if (FwRef.is(other)) {
+            return other.isChildOf(this)
         }
         return other.equals(this) || other.ancestors.some(x => x.equals(this)).pull()
     }
 
-    isChildOf(other: _Node): boolean {
-        if (FwReference.is(other)) {
-            return other.isParentOf(this._asNode)
+    isChildOf(other: Node): boolean {
+        if (FwRef.is(other)) {
+            return other.isParentOf(this)
         }
         return this.equals(other) || this.ancestors.some(x => x.equals(other)).pull()
     }
 
-    hasRelationTo(other: _Node): boolean {
+    hasRelationTo(other: Node): boolean {
         return this.recursiveRelations.some(x => x.needed.equals(other)).pull()
     }
 
-    readonly recursiveRelationsSubtree = seq((): Seq<Relation<_Node>> => {
+    readonly recursiveRelationsSubtree = seq((): Seq<Relation<Node>> => {
         const self = this
         return seq(function* () {
-            for (const child of [self, ...self.descendants] as _Node[]) {
+            for (const child of [self, ...self.descendants] as Node[]) {
                 yield* child.recursiveRelations
             }
         }) as any
-    })
+    }).as<Relation<_Node>>()
 
     readonly recursiveRelations = seq(() => {
-        let resources = [] as _Node[]
-        const recurseIntoDependency = function* (root: Relation<_Node>): Iterable<Relation<_Node>> {
+        let resources = [] as Node[]
+        const recurseIntoDependency = function* (root: Relation<Node>): Iterable<Relation<Node>> {
             yield root
             if (resources.find(r => r.equals(root.needed))) {
                 return
@@ -130,7 +161,7 @@ export abstract class Node<
                 yield* recurseIntoDependency(needsEdge)
             }
         }
-        return seq(recurseIntoDependency.bind(null, new Relation<_Node>("self", this._asNode)))
+        return seq(recurseIntoDependency.bind(null, new Relation<_Node>("self", this)))
             .after(() => {
                 resources = []
             })

package/src/core/graph/origin/entity.ts

@@ -4,8 +4,8 @@ import { seq } from "doddle"
 import { mapValues } from "lodash"
 import { displayers } from "../../../utils/displayers"
 import { Entity } from "../entity"
-import type { Resource_Entity } from "../resource/entity"
-import type { Ref2_Of } from "../resource/reference/refable"
+import { Rsc_Entity } from "../resource/entity"
+import type { Rsc_Ref } from "../resource/reference/refable"
 import { OriginEventsEmitter, type Origin_EventMap } from "./events"
 import { KindMap } from "./kind-map"
 import { OriginNode, type Origin_Props } from "./node"
@@ -24,12 +24,31 @@ export abstract class Origin_Entity<Props extends Origin_Props = Origin_Props> e
     OriginNode,
     Origin_Entity
 > {
+    get ref() {
+        return {
+            kind: this.kind,
+            name: this.name
+        }
+    }
     abstract get kind(): string
     private _emitter = OriginEventsEmitter()
-    private readonly _ownResources: Resource_Entity[] = []
+    private readonly _ownResources: Rsc_Entity[] = []
     private readonly _ownKids: Origin_Entity[] = []
     readonly meta: Meta
 
+    equals(other: any): boolean {
+        const FwRef_Exports = require("../resource/reference/fw-ref-exports").FwRef_Exports
+        if (!other) {
+            return false
+        }
+        if (other instanceof Origin_Entity) {
+            return Object.is(this, other)
+        }
+        if (FwRef_Exports.is(other)) {
+            return other.equals(this)
+        }
+        return false
+    }
     constructor(
         readonly name: string,
         protected readonly _props: Props
@@ -63,11 +82,12 @@ export abstract class Origin_Entity<Props extends Origin_Props = Origin_Props> e
         const values = mapValues(data, v => `${v}`)
 
         for (const target of [this.node, ...this.node.ancestors]) {
-            target.entity._emitter.emit(event, data)
+            target.entity.assert(Origin_Entity)._emitter.emit(event, data)
         }
     }
     protected __resource_kinds__(): KindMap {
-        const parentKindsIfAny = this.__parent__()?.__resource_kinds__() ?? []
+        const parent = this.__parent__()?.assert(Origin_Entity)
+        const parentKindsIfAny = parent?.__resource_kinds__() ?? []
         return new KindMap([...(this._props.kinds ?? []), ...parentKindsIfAny])
     }
 
@@ -83,7 +103,7 @@ export abstract class Origin_Entity<Props extends Origin_Props = Origin_Props> e
         })
     }
 
-    protected __attach_resource__(resources: Resource_Entity | Iterable<Resource_Entity>) {
+    protected __attach_resource__(resources: Rsc_Entity | Iterable<Rsc_Entity>) {
         resources = Symbol.iterator in resources ? resources : [resources]
         for (const resource of resources) {
             this._ownResources.push(resource)
@@ -104,7 +124,7 @@ export abstract class Origin_Entity<Props extends Origin_Props = Origin_Props> e
     }
 
     // We don't cache this because resources can be added dynamically
-    get resources(): Iterable<Ref2_Of> {
+    get resources(): Iterable<Rsc_Ref> {
         const self = this
         return seq(function* () {
             for (const resource of self._ownResources) {

package/src/core/graph/origin/events.ts

@@ -1,7 +1,7 @@
 import { doddle } from "doddle"
 import EventEmitter from "eventemitter3"
 import type { Manifest } from "../../manifest"
-import type { Resource_Entity, Resource_Top } from "../resource"
+import type { Rsc_Entity, Rsc_Top } from "../resource"
 import type { Origin_Entity } from "./entity"
 
 export function OriginEventsEmitter() {
@@ -45,24 +45,24 @@ export function SubscribeFn(self: Origin_Entity, em: EventEmitter<Origin_EventMa
 export interface Origin_EventMap {
     "resource/exported": {
         readonly origin: Origin_Entity
-        readonly resource: Resource_Top
+        readonly resource: Rsc_Top
     }
     "resource/attached": {
         readonly origin: Origin_Entity
-        readonly resource: Resource_Entity
+        readonly resource: Rsc_Entity
     }
     "resource/manifested": {
         readonly origin: Origin_Entity
         readonly manifest: Manifest
-        readonly resource: Resource_Top
+        readonly resource: Rsc_Top
     }
     "resource/loaded": {
         readonly origin: Origin_Entity
-        readonly resource: Resource_Top
+        readonly resource: Rsc_Top
     }
     "resource/serialized": {
         readonly origin: Origin_Entity
-        readonly resource: Resource_Top
+        readonly resource: Rsc_Top
         readonly manifest: Manifest
         content: string
     }