@poe-platform/safe-js 0.1.391 → 0.1.392

package/dist/safe-js/chunks/{chunk-2H5CQNFL.js → chunk-VN2F4GHQ.js}

@@ -27,7 +27,7 @@ import {
   validateMigrationSemantics,
   validateSnapshotData,
   validateSnapshotMigration
-} from "./chunk-MT4D4J5E.js";
+} from "./chunk-GYLSKXNZ.js";
 
 // packages/safe-js/src/migrate.ts
 import { createHash } from "node:crypto";
@@ -8249,4 +8249,4 @@ export {
   parseMcpConfig,
   makeMcpModule
 };
-//# sourceMappingURL=chunk-2H5CQNFL.js.map
+//# sourceMappingURL=chunk-VN2F4GHQ.js.map

package/dist/safe-js/cli.js

@@ -22,7 +22,7 @@ import {
   resolveFsConfig,
   splitFrontmatter,
   withBrokenPipeGuard
-} from "./chunks/chunk-2H5CQNFL.js";
+} from "./chunks/chunk-VN2F4GHQ.js";
 import {
   Budget,
   SandboxError,
@@ -34,7 +34,7 @@ import {
   replaceErrorStack,
   restore,
   run
-} from "./chunks/chunk-MT4D4J5E.js";
+} from "./chunks/chunk-GYLSKXNZ.js";
 import "./chunks/chunk-4YIDX44G.js";
 
 // packages/safe-js/src/cli.ts

package/dist/safe-js/core.js

@@ -5,7 +5,7 @@ import {
   defineExtension,
   lint,
   run
-} from "./chunks/chunk-MT4D4J5E.js";
+} from "./chunks/chunk-GYLSKXNZ.js";
 import "./chunks/chunk-4YIDX44G.js";
 export {
   Budget,

package/dist/safe-js/index.js

@@ -26,7 +26,7 @@ import {
   runWithSpawnUsageAccumulator,
   splitFrontmatter,
   supportsSpawnMode
-} from "./chunks/chunk-2H5CQNFL.js";
+} from "./chunks/chunk-VN2F4GHQ.js";
 import {
   Budget,
   FileSnapshotBackend,
@@ -50,7 +50,7 @@ import {
   registerPendingHostCallPolicy,
   restore,
   run
-} from "./chunks/chunk-MT4D4J5E.js";
+} from "./chunks/chunk-GYLSKXNZ.js";
 import "./chunks/chunk-4YIDX44G.js";
 
 // packages/safe-js/src/parse.ts

package/dist/safe-js/interp/generator-expression-state.d.ts

@@ -29,6 +29,7 @@ export type GeneratorExpressionState<T = SandboxValue, S = Scope, I = SandboxIte
     current: T;
     referenceObject?: T;
     referenceKey?: T;
+    privateName?: string;
 } | {
     kind: "array-pattern";
     phase: "reference" | "binding";
@@ -38,6 +39,7 @@ export type GeneratorExpressionState<T = SandboxValue, S = Scope, I = SandboxIte
     iterator: I;
     referenceObject?: T;
     referenceKey?: T;
+    privateName?: string;
 } | {
     kind: "for-of-array";
     phase: "left" | "body";
@@ -83,6 +85,7 @@ export type GeneratorExpressionState<T = SandboxValue, S = Scope, I = SandboxIte
     current: T;
     key?: T;
     superReceiver?: T;
+    privateName?: string;
 } | {
     kind: "template";
     prefix: string;

package/dist/safe-js/interp/patterns.d.ts

@@ -8,6 +8,7 @@ type Pattern = VariableDeclarator["id"] | AssignmentPattern | MemberExpression |
 export type AssignmentReference = {
     object: SandboxValue;
     key: PropertyKey;
+    privateName?: string;
 };
 export type PatternTarget = {
     kind: VariableDeclarationKind;
@@ -31,6 +32,7 @@ export type PatternContext = {
     toPropertyKey(value: SandboxValue): string | symbol | Promise<string | symbol>;
     getProperty(value: SandboxValue, key: PropertyKey): SandboxValue | Promise<SandboxValue>;
     setProperty(target: SandboxValue, key: PropertyKey, value: SandboxValue): void | Promise<void>;
+    setPrivateProperty?(target: SandboxValue, name: string, value: SandboxValue): void | Promise<void>;
 };
 export type BindPatternResult = {
     ok: true;

package/dist/safe-js/interp/private-state.d.ts

@@ -0,0 +1,18 @@
+import type { SandboxClosure, SandboxValue } from "./values.js";
+export type PrivateName = {
+    readonly description: string;
+};
+export type PrivateElement = {
+    kind: "field";
+    value: SandboxValue;
+} | {
+    kind: "method";
+    value: SandboxClosure;
+} | {
+    kind: "accessor";
+    get?: SandboxClosure;
+    set?: SandboxClosure;
+};
+export declare const privateElements: WeakMap<object, Map<PrivateName, PrivateElement>>;
+export declare function findPrivateElement(receiver: SandboxValue, name: PrivateName): PrivateElement | undefined;
+export declare function addPrivateElement(receiver: SandboxValue, name: PrivateName, element: PrivateElement): void;

package/dist/safe-js/interp/scope.d.ts

@@ -1,4 +1,5 @@
 import type { VariableDeclarationKind } from "../parse.js";
+import type { PrivateName } from "./private-state.js";
 import type { InterpreterSnapshot, InterpreterValue } from "./interpreter.js";
 type ScopeLookupResult = {
     found: true;
@@ -12,6 +13,7 @@ type ScopeOptions = {
     chargeData?: boolean;
 };
 export type ScopeFrame = {
+    privateNames?: Array<[string, PrivateName]>;
     parent?: Scope;
     importMeta?: InterpreterValue;
     functionBoundary: boolean;
@@ -32,8 +34,11 @@ export declare class Scope {
     private readonly parent?;
     private importMeta?;
     private readonly options;
+    privateNames?: Map<string, PrivateName>;
     constructor(bindings?: Record<string, InterpreterValue>, parent?: Scope | undefined, importMeta?: InterpreterValue, options?: ScopeOptions, restoredBindings?: Record<string, InterpreterValue>);
     child(bindings?: Record<string, InterpreterValue>, options?: ScopeOptions): Scope;
+    declarePrivateName(description: string): PrivateName;
+    resolvePrivateName(description: string): PrivateName;
     consumeRestoredBinding(name: string): {
         found: true;
         value: InterpreterValue;

package/dist/safe-js/parse/function-source.d.ts

@@ -4,4 +4,4 @@ export type FunctionSource = {
     readonly start: number;
     readonly end: number;
 };
-export declare const functionSources: WeakMap<FunctionNode | ClassNode, FunctionSource>;
+export declare const functionSources: WeakMap<ClassNode | FunctionNode, FunctionSource>;

package/dist/safe-js/parse/parser.d.ts

@@ -19,6 +19,10 @@ export type Identifier = BaseNode & {
     type: "Identifier";
     name: string;
 };
+export type PrivateIdentifier = BaseNode & {
+    type: "PrivateIdentifier";
+    name: string;
+};
 export type ThisExpression = BaseNode & {
     type: "ThisExpression";
 };
@@ -397,7 +401,7 @@ export type ArrowFunctionExpression = BaseNode & {
     params: Array<AssignmentPattern | ArrayPattern | Identifier | ObjectPattern | RestElement>;
 };
 export type FunctionNode = ArrowFunctionExpression | FunctionDeclaration | FunctionExpression;
-export type Expression = ArrowFunctionExpression | AssignmentExpression | ArrayExpression | AwaitExpression | BinaryExpression | BooleanLiteral | CallExpression | ConditionalExpression | ClassExpression | FunctionExpression | Identifier | LogicalExpression | MemberExpression | MetaProperty | NewExpression | NewTargetExpression | NullLiteral | NumericLiteral | BigIntLiteral | ObjectExpression | RegexLiteral | SequenceExpression | StringLiteral | SuperExpression | TaggedTemplateExpression | TemplateLiteral | ThisExpression | UnaryExpression | UpdateExpression | UndefinedLiteral | YieldExpression;
+export type Expression = ArrowFunctionExpression | AssignmentExpression | ArrayExpression | AwaitExpression | BinaryExpression | BooleanLiteral | CallExpression | ConditionalExpression | ClassExpression | FunctionExpression | Identifier | PrivateIdentifier | LogicalExpression | MemberExpression | MetaProperty | NewExpression | NewTargetExpression | NullLiteral | NumericLiteral | BigIntLiteral | ObjectExpression | RegexLiteral | SequenceExpression | StringLiteral | SuperExpression | TaggedTemplateExpression | TemplateLiteral | ThisExpression | UnaryExpression | UpdateExpression | UndefinedLiteral | YieldExpression;
 export type ParseResult = Expression | Statement;
 export declare function parse(source: string, filename?: string, owner?: CompileOwner): ParseResult;
 export declare function parseModule(source: string, filename?: string, owner?: CompileOwner): Module;

package/dist/safe-js/parse/tokenizer.d.ts

@@ -4,7 +4,7 @@ export type Position = {
     column: number;
     offset: number;
 };
-export type TokenType = "identifier" | "keyword" | "numeric" | "regex" | "string" | "template" | "punctuator" | "eof";
+export type TokenType = "identifier" | "private-identifier" | "keyword" | "numeric" | "regex" | "string" | "template" | "punctuator" | "eof";
 export type Token = {
     type: TokenType;
     value: string;

package/dist/safe-js/snapshot/array-buffer.d.ts

@@ -1,4 +1,4 @@
-import type { GuestObjectState } from "./guest-heap.js";
+import { type GuestObjectState } from "./guest-heap.js";
 import type { Budget } from "../interp/budget.js";
 export type ArrayBufferData<TReference> = {
     kind: "arraybuffer";

package/dist/safe-js/snapshot/data-view.d.ts

@@ -1,4 +1,4 @@
-import type { GuestObjectState } from "./guest-heap.js";
+import { type GuestObjectState } from "./guest-heap.js";
 import type { Budget } from "../interp/budget.js";
 export type DataViewData<T> = {
     kind: "dataview";

package/dist/safe-js/snapshot/guest-heap.d.ts

@@ -3,6 +3,7 @@ import { type CollectionIterationMethod } from "../interp/collection-iterator.js
 import { type IteratorHelperState } from "../interp/iterator-helper.js";
 import { type ScopeFrame } from "../interp/scope.js";
 import { type PropertyDescriptorData } from "./property-descriptors.js";
+import { type PrivateName, type PrivateElement } from "../interp/private-state.js";
 import type { CompletionResult } from "../interp/exceptions.js";
 import type { GeneratorExpressionState } from "../interp/generator-expression-state.js";
 import { type IteratorSnapshot } from "../interp/iteration.js";
@@ -14,8 +15,32 @@ export type GeneratorFinallyCompletion<T> = Omit<CompletionResult, "value" | "no
 export type GuestObjectState<T> = {
     properties: PropertyDescriptorData<T>;
     prototype?: T;
+    privateElements?: PrivateElementData<T>[];
 };
+export type PrivateElementData<T> = {
+    name: T;
+} & ({
+    kind: "field" | "method";
+    value: T;
+} | {
+    kind: "accessor";
+    get: T;
+    set: T;
+});
 export type GuestHeapNode<T> = {
+    kind: "guest-regex";
+    source: string;
+    flags: string;
+    state: GuestObjectState<T>;
+} | {
+    kind: "guest-boxed";
+    value: T;
+    state: GuestObjectState<T>;
+} | {
+    kind: "guest-date";
+    value: T;
+    state: GuestObjectState<T>;
+} | {
     kind: "iterator-helper";
     method: IteratorHelperState["method"];
     status: "start" | "yield" | "done";
@@ -82,18 +107,22 @@ export type GuestHeapNode<T> = {
     fields: Array<{
         index: number;
         key: T;
+        privateName?: T;
     }>;
+    privateMethods?: PrivateElementData<T>[];
     state: GuestObjectState<T>;
 } | {
     kind: "map";
     entries: Array<[T, T]>;
     propertyState?: PropertyDescriptorData<T>;
     prototype?: T;
+    privateElements?: PrivateElementData<T>[];
 } | {
     kind: "set";
     values: T[];
     propertyState?: PropertyDescriptorData<T>;
     prototype?: T;
+    privateElements?: PrivateElementData<T>[];
 } | {
     kind: "raw-json";
     text: string;
@@ -147,6 +176,7 @@ export type GuestHeapNode<T> = {
     importMeta: T;
     functionBoundary: boolean;
     chargeData: boolean;
+    privateNames?: Array<[string, T]>;
     bindings: Array<[string, number]>;
     cells: Array<{
         kind: ScopeFrame["cells"][number]["kind"];
@@ -159,3 +189,4 @@ export type GuestHeapNode<T> = {
     restoredBindings?: Array<[string, T]>;
 };
 export declare function captureGuestHeapNode<T>(value: object, encode: (value: unknown) => T): GuestHeapNode<T> | undefined;
+export declare function capturePrivateElements<T>(elements: Map<PrivateName, PrivateElement>, encode: (value: unknown) => T): PrivateElementData<T>[];

package/dist/safe-js/snapshot/typed-array.d.ts

@@ -1,5 +1,5 @@
 import { numericTypedArrayConstructors, type NumericTypedArray } from "../interp/typed-array.js";
-import type { GuestObjectState } from "./guest-heap.js";
+import { type GuestObjectState } from "./guest-heap.js";
 import type { Budget } from "../interp/budget.js";
 export declare function captureTypedArrayState<T>(value: NumericTypedArray, encode: (value: unknown) => T): GuestObjectState<T>;
 export declare function restoreTypedArrayProperties<T>(value: NumericTypedArray, state: GuestObjectState<T>, decode: (value: T) => unknown): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-js",
-  "version": "0.1.391",
+  "version": "0.1.392",
   "description": "Budgeted JavaScript interpreter with explicit host capabilities and resumable execution",
   "type": "module",
   "license": "MIT",
@@ -58,7 +58,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.391",
+    "@poe-platform/safe-fs": "0.1.392",
     "@petamoriken/float16": "^3.9.3",
     "yaml": "^2.8.2",
     "jose": "^6.1.3",