@camstack/system 1.2.316 → 1.2.318

package/dist/builtins/composer/composition-runtime.d.ts

@@ -1,55 +1,8 @@
-import { CapabilityLookup, ClaimOutcome, CompositionEventPlan, CompositionFieldPlan, CompositionFieldState, IScopedLogger, SourceReader, SystemEvent } from '@camstack/types';
-import { SlicePatch } from './slice-assembler.js';
+import { CapabilityLookup, CompositionEventPlan, CompositionFieldPlan, CompositionFieldRead, CompositionFieldState, IScopedLogger, SourceReader } from '@camstack/types';
+import { ComposedWriteTarget, CompositionEventEmitter, DeadlineTimer } from './composition-target.js';
 import { ReleasedField } from './field-record.js';
 export type { ReleasedField } from './field-record.js';
-export interface WriteOk {
-    readonly ok: true;
-}
-export interface WriteRefused {
-    readonly ok: false;
-    readonly error: string;
-}
-export type WriteOutcome = WriteOk | WriteRefused;
-/** Why an enqueued write did not land. `refused` carries the hub's code so the target can escalate by name (S5). */
-export type TargetAsyncFailure = {
-    readonly kind: 'threw';
-    readonly error: string;
-} | {
-    readonly kind: 'refused';
-    readonly code: Extract<ClaimOutcome, {
-        ok: false;
-    }>['code'];
-    readonly message: string;
-};
-/**
- * Where a composition writes. A write answers `{ ok: false }` rather than
- * throwing, and `setAvailable` does not throw. The runtime survives either
- * anyway: a throwing write is a failed write, a throwing `setAvailable` is
- * retried on the next pass. A target whose writes are asynchronous reports
- * what did not land through `onAsyncFailure`.
- */
-export interface ComposedWriteTarget {
-    readonly id: number;
-    seed(capName: string, slice: SlicePatch): WriteOutcome;
-    patch(capName: string, patch: SlicePatch): WriteOutcome;
-    setAvailable(available: boolean): void;
-    onAsyncFailure?(listener: (cap: string, failure: TargetAsyncFailure) => void): void;
-    /**
-     * S1b: these fields of `cap` are NOT the composition's to write right now
-     * (their `release`-mode source is unavailable). The claim is narrowed to the
-     * rest; an empty rest releases the whole cap. `[]` re-widens. Absent on a
-     * `new`-target device (`ComposedDevice`): `release` is planned only on
-     * existing targets.
-     */
-    withhold?(cap: string, fields: readonly string[]): WriteOutcome;
-}
-export interface DeadlineTimer {
-    arm(at: number, fire: () => void): void;
-    disarm(): void;
-}
-export interface CompositionEventEmitter {
-    emit(event: SystemEvent): void;
-}
+export type { ComposedWriteTarget, CompositionEventEmitter, DeadlineTimer, TargetAsyncFailure, WriteOk, WriteOutcome, WriteRefused, } from './composition-target.js';
 export interface CompositionRuntimeDeps {
     readonly blockId: string;
     readonly fields: readonly CompositionFieldPlan[];
@@ -60,6 +13,12 @@ export interface CompositionRuntimeDeps {
     /** Effective target slices captured before an existing-target runtime takes ownership. */
     readonly initialByCap?: ReadonlyMap<string, Readonly<Record<string, unknown>> | null>;
     readonly read: SourceReader;
+    /**
+     * Whether `read` is of this composition's OWN output (an added cap on its
+     * existing target, or its composed device): answered from the runtime's
+     * record, never from `read`. Absent = none is.
+     */
+    readonly isOwnRead?: (read: CompositionFieldRead) => boolean;
     readonly now: () => number;
     readonly timer: DeadlineTimer;
     readonly logger: IScopedLogger;
@@ -95,6 +54,8 @@ export declare class CompositionRuntime {
     private releaseFlaps;
     /** Caps the target refused for good (`TERMINAL_REFUSALS`): never written again by this runtime. */
     private terminal;
+    /** What `composition-evaluation.ts` reads and commits through. */
+    private readonly evaluation;
     constructor(deps: CompositionRuntimeDeps);
     start(): void;
     onSourcesChanged(sliceKeys: ReadonlySet<string>): void;
@@ -124,8 +85,6 @@ export declare class CompositionRuntime {
     /** Once per distinct failure, not once per pass: a reader that keeps throwing logs one line. */
     private logPassError;
     private pass;
-    private evaluate;
-    private emitStateEvent;
     private recordsOf;
     /** `retry`: write-pending caps this pass re-writes WHOLE, whether or not a value changed. */
     private writeCaps;

package/dist/builtins/composer/composition-target.d.ts

@@ -0,0 +1,50 @@
+import { ClaimOutcome, SystemEvent } from '@camstack/types';
+import { SlicePatch } from './slice-assembler.js';
+export interface WriteOk {
+    readonly ok: true;
+}
+export interface WriteRefused {
+    readonly ok: false;
+    readonly error: string;
+}
+export type WriteOutcome = WriteOk | WriteRefused;
+/** Why an enqueued write did not land. `refused` carries the hub's code so the target can escalate by name (S5). */
+export type TargetAsyncFailure = {
+    readonly kind: 'threw';
+    readonly error: string;
+} | {
+    readonly kind: 'refused';
+    readonly code: Extract<ClaimOutcome, {
+        ok: false;
+    }>['code'];
+    readonly message: string;
+};
+/**
+ * Where a composition writes. A write answers `{ ok: false }` rather than
+ * throwing, and `setAvailable` does not throw. The runtime survives either
+ * anyway: a throwing write is a failed write, a throwing `setAvailable` is
+ * retried on the next pass. A target whose writes are asynchronous reports
+ * what did not land through `onAsyncFailure`.
+ */
+export interface ComposedWriteTarget {
+    readonly id: number;
+    seed(capName: string, slice: SlicePatch): WriteOutcome;
+    patch(capName: string, patch: SlicePatch): WriteOutcome;
+    setAvailable(available: boolean): void;
+    onAsyncFailure?(listener: (cap: string, failure: TargetAsyncFailure) => void): void;
+    /**
+     * S1b: these fields of `cap` are NOT the composition's to write right now
+     * (their `release`-mode source is unavailable). The claim is narrowed to the
+     * rest; an empty rest releases the whole cap. `[]` re-widens. Absent on a
+     * `new`-target device (`ComposedDevice`): `release` is planned only on
+     * existing targets.
+     */
+    withhold?(cap: string, fields: readonly string[]): WriteOutcome;
+}
+export interface DeadlineTimer {
+    arm(at: number, fire: () => void): void;
+    disarm(): void;
+}
+export interface CompositionEventEmitter {
+    emit(event: SystemEvent): void;
+}

package/dist/builtins/composer/existing-target.d.ts

@@ -1,4 +1,4 @@
-import { ClaimsListing, CompositionFeaturePlan, CompositionFieldPlan, CompositionFieldState, CompositionSourceRef, CompositionTargetFound, deviceStateCapability, DeviceType, FieldClaimMode, IScopedLogger } from '@camstack/types';
+import { CapabilityLookup, ClaimsListing, CompositionFeaturePlan, CompositionFieldPlan, CompositionFieldState, CompositionSourceRef, CompositionTargetFound, deviceStateCapability, DeviceType, FieldClaimMode, IScopedLogger } from '@camstack/types';
 import { z } from 'zod';
 import { ReleasedField } from './composition-runtime.js';
 import { GraftOutcome } from './graft-host.js';
@@ -12,6 +12,24 @@ export interface ComposerClaimsApi extends OwnedFieldsApi {
 export interface ExistingTargetSeedRead {
     readonly byCap: ReadonlyMap<string, Readonly<Record<string, unknown>> | null>;
 }
+export interface SeedlessRestoredCapsInput {
+    readonly logger: IScopedLogger;
+    readonly blockId: string;
+    readonly deviceId: number;
+    readonly features: readonly CompositionFeaturePlan[];
+    readonly seed: ExistingTargetSeedRead;
+    readonly lookupCap: CapabilityLookup;
+}
+/**
+ * Review M3: an ADDED `restored` cap seeded from NOTHING says so, once per
+ * runtime build, on its device. After a restart its state comes from the
+ * target's runtime-state row; a row that lost the slice (D677: 615's doorbell,
+ * dropped at a hub boot) used to surface as "not seeded yet" and now seeds a
+ * clean `{ null, 0 }` — a lifetime count silently reset unless this line
+ * names it. A first composition of a device that never had the slice logs it
+ * too: the line cannot tell the two apart, and says both.
+ */
+export declare function reportSeedlessRestoredCaps(input: SeedlessRestoredCapsInput): void;
 /**
  * Read every affected effective capability exactly once, before the composer
  * grafts or claims any of them. A null slice is a successful empty seed; a

package/dist/builtins/composer/own-field-reads.d.ts

@@ -0,0 +1,19 @@
+import { SourceReading } from '@camstack/types';
+import { FieldRecord } from './field-record.js';
+/** `keys` in evaluation order: derived, then accumulators, then the rest; stable within a rank. */
+export declare function orderForEvaluation(keys: readonly string[], records: ReadonlyMap<string, FieldRecord>): readonly string[];
+/**
+ * The own field `key` as the runtime holds it right now (`records`: the pass in
+ * progress) — exactly what the runtime PUBLISHES for it, which is what the hub
+ * answered before (review H1). An unavailable field under the `null` or
+ * `unknown` policy is published as `null` / `'unknown'`, so a reader sees that
+ * value; only a field nothing is written for (`release`, `offline`) reads as
+ * unavailable. Answering those as unavailable left `count` unprimed while a
+ * source was late at boot, and it then swallowed the first press as its seed.
+ *
+ * Not evaluated yet is unavailable: nothing is published, and unknown is never
+ * `null` (D393). The evaluation order makes this unreachable for a derived
+ * reader of a derived field. Never fatal here: a gone source fails the block
+ * through the field that reads it directly.
+ */
+export declare function ownFieldReading(records: ReadonlyMap<string, FieldRecord>, key: string): SourceReading;

package/dist/builtins/console-logging/index.js

@@ -3,7 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-RAl10EfG.js");
+const require_dist = require("../../dist-Dcy0gVHu.js");
 const require_formatter = require("../../formatter-DqAKDlvN.js");
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/console-logging/index.mjs

@@ -1,4 +1,4 @@
-import { Gn as BaseAddon, Rt as logDestinationCapability } from "../../dist-BPvku43i.mjs";
+import { Gn as BaseAddon, Rt as logDestinationCapability } from "../../dist-CQ9vXSUh.mjs";
 import { t as formatLogLine } from "../../formatter-B7qW8bPJ.mjs";
 //#region src/builtins/console-logging/console-destination.ts
 var LEVEL_RANK = {

package/dist/builtins/core-blocks/core-blocks.addon.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_chunk = require("../../chunk-Cek0wNdY.js");
-const require_dist = require("../../dist-RAl10EfG.js");
-const require_composition_sources = require("../../composition-sources-BwE1POnF.js");
+const require_dist = require("../../dist-Dcy0gVHu.js");
+const require_composition_sources = require("../../composition-sources-BjRPhWtU.js");
 let node_crypto = require("node:crypto");
 let _camstack_types_node = require("@camstack/types/node");
 let node_fs_promises = require("node:fs/promises");

package/dist/builtins/core-blocks/core-blocks.addon.mjs

@@ -1,5 +1,5 @@
-import { $ as coreBlockAddonId, Gn as BaseAddon, In as compositionSourceKey, K as buildCapabilityLookup, Q as compositionSourceRefs, Wn as errMsg, Xt as planComposition, d as CORE_BLOCK_ADDON_PREFIX, et as coreBlockComposition, f as CoreBlockSchema, h as DeclaredDevices, jn as composedDeviceRef, l as COMPOSER_RUNNER_ID, nt as coreBlockSourceKind, rt as coreBlocksCapability, t as ALL_CAPABILITY_DEFINITIONS, tn as replacedFieldKeys, tt as coreBlockIdFromAddonId, u as CORE_BLOCKS_ADDON_ID, yn as validateComposition } from "../../dist-BPvku43i.mjs";
-import { t as describeCompositionSources } from "../../composition-sources-fUyF4z39.mjs";
+import { $ as coreBlockAddonId, Gn as BaseAddon, In as compositionSourceKey, K as buildCapabilityLookup, Q as compositionSourceRefs, Wn as errMsg, Xt as planComposition, d as CORE_BLOCK_ADDON_PREFIX, et as coreBlockComposition, f as CoreBlockSchema, h as DeclaredDevices, jn as composedDeviceRef, l as COMPOSER_RUNNER_ID, nt as coreBlockSourceKind, rt as coreBlocksCapability, t as ALL_CAPABILITY_DEFINITIONS, tn as replacedFieldKeys, tt as coreBlockIdFromAddonId, u as CORE_BLOCKS_ADDON_ID, yn as validateComposition } from "../../dist-CQ9vXSUh.mjs";
+import { t as describeCompositionSources } from "../../composition-sources-Cg2MP-qf.mjs";
 import { randomUUID } from "node:crypto";
 import { customizationBlockName } from "@camstack/types/node";
 import * as fs from "node:fs/promises";