@adaas/a-frame 0.0.22 → 0.0.23

package/dist/node/logger.d.ts

@@ -0,0 +1,150 @@
+import { A_Component } from '@adaas/a-concept';
+
+/**
+ * Public API surface for A_FrameLogger — shared between node and browser.
+ */
+type A_FrameLogLevelType = 'debug' | 'info' | 'success' | 'warn' | 'error';
+interface A_FrameLogEntry {
+    level: A_FrameLogLevelType;
+    message: string;
+    timestamp: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Handle returned by `logger.progress()`. Calling code drives the bar by
+ * `tick()`-ing once per processed item, then `succeed()` or `fail()` at the end.
+ */
+interface A_FrameProgressBar {
+    /** Advance by one and optionally update the trailing label */
+    tick(label?: string): void;
+    /** Mark the bar complete (even if not all items ticked) */
+    succeed(label?: string): void;
+    /** Mark the bar failed at current position */
+    fail(label?: string): void;
+    /** Set the absolute current value (for non-monotonic progress) */
+    update(current: number, label?: string): void;
+}
+/**
+ * Constructor / runtime configuration. All fields optional — sensible defaults
+ * are applied so `new A_FrameLogger()` always works.
+ */
+interface A_FrameLoggerConfig {
+    /** Minimum level to emit. Levels below are silently dropped. Default: 'debug'. */
+    level?: A_FrameLogLevelType;
+    /** Override TTY detection (Node only). Default: auto-detect via process.stdout.isTTY. */
+    color?: boolean;
+    /** Optional prefix prepended to every line, e.g. "[a-frame]" */
+    prefix?: string;
+}
+interface IA_FrameLogger {
+    debug(message: string, metadata?: Record<string, unknown>): void;
+    info(message: string, metadata?: Record<string, unknown>): void;
+    success(message: string, metadata?: Record<string, unknown>): void;
+    warn(message: string, metadata?: Record<string, unknown>): void;
+    error(message: string, metadata?: Record<string, unknown>): void;
+    section(title: string): void;
+    divider(): void;
+    progress(label: string, total: number): A_FrameProgressBar;
+    increment(key: string, by?: number): void;
+    set(key: string, value: number): void;
+    get(key: string): number;
+    resetTimer(): void;
+    elapsed(): string;
+    summary(title?: string): void;
+}
+
+/**
+ * Abstract base for `A_FrameLogger` — environment-agnostic state and behaviour.
+ *
+ * Concrete subclasses (`A-FrameLogger.component.env-node` and
+ * `A-FrameLogger.component.env-browser`) implement `write()` and `progress()`
+ * since each runtime renders to a different surface (TTY vs DevTools console).
+ */
+declare abstract class A_FrameLoggerBase extends A_Component implements IA_FrameLogger {
+    protected level: A_FrameLogLevelType;
+    protected prefix: string;
+    protected counters: Map<string, number>;
+    protected startTime: number;
+    constructor(config?: A_FrameLoggerConfig);
+    /** Render a fully-built log entry to the runtime-specific output. */
+    protected abstract write(entry: A_FrameLogEntry): void;
+    /** Create a runtime-specific progress bar. */
+    abstract progress(label: string, total: number): A_FrameProgressBar;
+    setLevel(level: A_FrameLogLevelType): void;
+    /** Returns true when the entry passes the current level filter. */
+    protected shouldEmit(level: A_FrameLogLevelType): boolean;
+    private emit;
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    success(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+    /** Default implementation that subclasses may override for nicer headings. */
+    section(title: string): void;
+    divider(): void;
+    increment(key: string, by?: number): void;
+    set(key: string, value: number): void;
+    get(key: string): number;
+    resetTimer(): void;
+    elapsed(): string;
+    /**
+     * Print a left-aligned table of all counters plus elapsed time.
+     * Concrete subclasses can override for richer rendering.
+     */
+    summary(title?: string): void;
+}
+
+/**
+ * A_FrameLogger — Node.js environment.
+ *
+ * Renders to stdout with ANSI colour codes and inline progress bars when
+ * stdout is a TTY. Falls back to plain text otherwise (CI, log files).
+ */
+declare class A_FrameLogger extends A_FrameLoggerBase {
+    private readonly useColor;
+    constructor(config?: A_FrameLoggerConfig);
+    private c;
+    protected write(entry: A_FrameLogEntry): void;
+    section(title: string): void;
+    divider(): void;
+    summary(title?: string): void;
+    progress(label: string, total: number): A_FrameProgressBar;
+}
+
+declare const A_FrameLogLevel: {
+    readonly Debug: "debug";
+    readonly Info: "info";
+    readonly Success: "success";
+    readonly Warn: "warn";
+    readonly Error: "error";
+};
+/** Numeric priority used for level filtering. Higher = more severe. */
+declare const A_FRAME_LOG_LEVEL_PRIORITY: Record<A_FrameLogLevelType, number>;
+/** Glyphs used as the leading symbol for each log level. */
+declare const A_FrameLogIcon: Record<A_FrameLogLevelType, string>;
+/** ANSI escape sequences. Used by the Node implementation only. */
+declare const A_FRAME_ANSI: {
+    readonly reset: "\u001B[0m";
+    readonly bold: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly gray: "\u001B[90m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly blue: "\u001B[34m";
+    readonly cyan: "\u001B[36m";
+};
+/**
+ * Browser console CSS — used with `console.log('%c...', style)` for coloured
+ * output in DevTools. Mirrors the ANSI palette by intent.
+ */
+declare const A_FRAME_BROWSER_CSS: Record<A_FrameLogLevelType, string>;
+/** Defaults applied when building a logger without explicit options. */
+declare const A_FRAME_LOG_DEFAULTS: {
+    readonly progressBarWidth: 24;
+    readonly summaryTitle: "Summary";
+    /** Update progress at most this often (ms) for non-TTY/browser output. */
+    readonly progressThrottleMs: 250;
+};
+
+export { A_FRAME_ANSI, A_FRAME_BROWSER_CSS, A_FRAME_LOG_DEFAULTS, A_FRAME_LOG_LEVEL_PRIORITY, type A_FrameLogEntry, A_FrameLogIcon, A_FrameLogLevel, type A_FrameLogLevelType, A_FrameLogger, A_FrameLoggerBase, type A_FrameLoggerConfig, type A_FrameProgressBar, type IA_FrameLogger };

package/dist/node/logger.mjs

@@ -0,0 +1,4 @@
+export { A_FRAME_ANSI, A_FRAME_BROWSER_CSS, A_FRAME_LOG_DEFAULTS, A_FRAME_LOG_LEVEL_PRIORITY, A_FrameLogIcon, A_FrameLogLevel, A_FrameLogger, A_FrameLoggerBase } from './chunk-IIVYTS5M.mjs';
+import './chunk-OI76LHVT.mjs';
+//# sourceMappingURL=logger.mjs.map
+//# sourceMappingURL=logger.mjs.map

package/dist/node/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"logger.mjs"}

package/dist/node/namespace.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+require('./chunk-KK64VLZN.cjs');
+var chunkKLG6HKFU_cjs = require('./chunk-KLG6HKFU.cjs');
+require('./chunk-ZM2RLVVH.cjs');
+require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-QFHZIG7Y.cjs');
+
+
+
+Object.defineProperty(exports, "A_FRAME_DEFAULT_NAMESPACE_KEY", {
+  enumerable: true,
+  get: function () { return chunkKLG6HKFU_cjs.A_FRAME_DEFAULT_NAMESPACE_KEY; }
+});
+Object.defineProperty(exports, "A_FrameNamespace", {
+  enumerable: true,
+  get: function () { return chunkKLG6HKFU_cjs.A_FrameNamespace; }
+});
+Object.defineProperty(exports, "A_FrameNamespaceFeatures", {
+  enumerable: true,
+  get: function () { return chunkKLG6HKFU_cjs.A_FrameNamespaceFeatures; }
+});
+//# sourceMappingURL=namespace.cjs.map
+//# sourceMappingURL=namespace.cjs.map

package/dist/node/namespace.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"namespace.cjs"}

package/dist/node/namespace.d.mts

@@ -0,0 +1,13 @@
+export { A as A_FrameNamespace, a as A_FrameNamespace_EmbeddingMeta, b as A_FrameNamespace_Init, c as A_FrameNamespace_Record, d as A_FrameNamespace_SearchResult, e as A_FrameNamespace_Serialized } from './A-FrameNamespace.entity-rCm1AavP.mjs';
+import '@adaas/a-concept';
+import './vector.mjs';
+
+declare const A_FRAME_DEFAULT_NAMESPACE_KEY = "default";
+declare const A_FrameNamespaceFeatures: {
+    readonly Load: "_A_FRAME_NAMESPACE_LOAD";
+    readonly Save: "_A_FRAME_NAMESPACE_SAVE";
+    readonly Embed: "_A_FRAME_NAMESPACE_EMBED";
+    readonly Destroy: "_A_FRAME_NAMESPACE_DESTROY";
+};
+
+export { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespaceFeatures };

package/dist/node/namespace.d.ts

@@ -0,0 +1,13 @@
+export { A as A_FrameNamespace, a as A_FrameNamespace_EmbeddingMeta, b as A_FrameNamespace_Init, c as A_FrameNamespace_Record, d as A_FrameNamespace_SearchResult, e as A_FrameNamespace_Serialized } from './A-FrameNamespace.entity-D3fZBGDx.js';
+import '@adaas/a-concept';
+import './vector.js';
+
+declare const A_FRAME_DEFAULT_NAMESPACE_KEY = "default";
+declare const A_FrameNamespaceFeatures: {
+    readonly Load: "_A_FRAME_NAMESPACE_LOAD";
+    readonly Save: "_A_FRAME_NAMESPACE_SAVE";
+    readonly Embed: "_A_FRAME_NAMESPACE_EMBED";
+    readonly Destroy: "_A_FRAME_NAMESPACE_DESTROY";
+};
+
+export { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespaceFeatures };

package/dist/node/namespace.mjs

@@ -0,0 +1,7 @@
+import './chunk-K4MZY4ME.mjs';
+export { A_FRAME_DEFAULT_NAMESPACE_KEY, A_FrameNamespace, A_FrameNamespaceFeatures } from './chunk-APRYHBEF.mjs';
+import './chunk-442DXGOD.mjs';
+import './chunk-3TD2PEDZ.mjs';
+import './chunk-OI76LHVT.mjs';
+//# sourceMappingURL=namespace.mjs.map
+//# sourceMappingURL=namespace.mjs.map

package/dist/node/namespace.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"namespace.mjs"}

package/dist/node/storage.cjs

@@ -0,0 +1,42 @@
+'use strict';
+
+var chunk7A6XGT5J_cjs = require('./chunk-7A6XGT5J.cjs');
+var chunkQFUZVN4Y_cjs = require('./chunk-QFUZVN4Y.cjs');
+require('./chunk-B7ZDJXD3.cjs');
+require('./chunk-KK64VLZN.cjs');
+require('./chunk-KLG6HKFU.cjs');
+require('./chunk-3LOMGNWA.cjs');
+require('./chunk-YVX4W6SI.cjs');
+require('./chunk-GBTFMT3K.cjs');
+require('./chunk-ZM2RLVVH.cjs');
+require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-QFHZIG7Y.cjs');
+
+
+
+Object.defineProperty(exports, "A_FrameNodeStorage", {
+  enumerable: true,
+  get: function () { return chunk7A6XGT5J_cjs.A_FrameNodeStorage; }
+});
+Object.defineProperty(exports, "A_FrameStorage", {
+  enumerable: true,
+  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorage; }
+});
+Object.defineProperty(exports, "A_FrameStorageError", {
+  enumerable: true,
+  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorageError; }
+});
+Object.defineProperty(exports, "A_FrameStorageFeatures", {
+  enumerable: true,
+  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorageFeatures; }
+});
+Object.defineProperty(exports, "A_FrameStorageOperation", {
+  enumerable: true,
+  get: function () { return chunk7A6XGT5J_cjs.A_FrameStorageOperation; }
+});
+Object.defineProperty(exports, "A_FrameStorageCodec", {
+  enumerable: true,
+  get: function () { return chunkQFUZVN4Y_cjs.A_FrameStorageCodec; }
+});
+//# sourceMappingURL=storage.cjs.map
+//# sourceMappingURL=storage.cjs.map

package/dist/node/storage.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"storage.cjs"}

package/dist/node/storage.d.mts

@@ -0,0 +1,110 @@
+import { A as A_FrameStorage, a as A_FrameContext, b as A_FrameStorageSaveDefinitionOperation, c as A_FrameStorageLoadDefinitionsOperation, d as A_FrameStorageDestroyDefinitionsOperation, e as A_FrameStorageSaveNamespaceOperation, f as A_FrameStorageLoadNamespacesOperation, g as A_FrameStorageDestroyNamespacesOperation } from './A-FrameStorage.component-BYjHfHJJ.mjs';
+export { h as A_FrameStorageDestroyDefinitionsOperationParams, i as A_FrameStorageDestroyDefinitionsOperationResult, j as A_FrameStorageDestroyNamespacesOperationParams, k as A_FrameStorageDestroyNamespacesOperationResult, l as A_FrameStorageLoadDefinitionsOperationParams, m as A_FrameStorageLoadDefinitionsOperationResult, n as A_FrameStorageLoadNamespacesOperationParams, o as A_FrameStorageLoadNamespacesOperationResult, p as A_FrameStorageOperation, q as A_FrameStorageSaveDefinitionOperationParams, r as A_FrameStorageSaveDefinitionOperationResult, s as A_FrameStorageSaveNamespaceOperationParams, t as A_FrameStorageSaveNamespaceOperationResult, I as IA_FrameStorage } from './A-FrameStorage.component-BYjHfHJJ.mjs';
+import { A_Fragment, A_Error } from '@adaas/a-concept';
+import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-rCm1AavP.mjs';
+import { c as A_FrameDefinition_Serialized, A as A_FrameDefinition } from './A-FrameDefinition.entity-DWGN_Ujr.mjs';
+import { A_FrameEnv } from './env.mjs';
+import { A_FrameCrypto } from './crypto.mjs';
+import './A-FrameChannel.types-DQF-IiRq.mjs';
+import './vector.mjs';
+
+/**
+ * A-FrameStorage binary codec — shared between node and browser environments.
+ *
+ * Binary payload format (decrypted) — used for BOTH definition records and namespace records:
+ *   [HEADER 20B]
+ *     magic    4B = 0x454D424B ("EMBK")
+ *     version  1B = 0x01
+ *     count    4B (uint32 LE)
+ *     dims     2B (uint16 LE)
+ *     reserved 9B
+ *   [RECORD × count]
+ *     aseidLen 2B  (uint16 LE)
+ *     aseid    NB  utf-8  (primary entity ID, e.g. "app@root:123@v2")
+ *     nameLen  2B  (uint16 LE)
+ *     name     NB  utf-8
+ *     vector   dims×4B  Float32 LE
+ *     metaLen  4B  (uint32 LE)
+ *     meta     NB  JSON
+ */
+
+declare class A_FrameStorageCodec extends A_Fragment {
+    protected enc: TextEncoder;
+    protected dec: TextDecoder;
+    A_FRAME_FILE_MAGIC: number;
+    A_FRAME_FILE_VERSION: number;
+    A_FRAME_HEADER_SIZE: number;
+    static get fileExtension(): string;
+    getFileName(namespace: string): string;
+    getNamespaceFileName(): string;
+    encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array;
+    decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[];
+    encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array;
+    decodeNamespacePayload(data: Uint8Array): A_FrameNamespace_Serialized[];
+}
+
+declare class A_FrameStorageError extends A_Error {
+    static readonly SaveDefinitionFailed = "SaveDefinitionFailed";
+    static readonly LoadDefinitionsFailed = "LoadDefinitionsFailed";
+    static readonly DestroyDefinitionsFailed = "DestroyDefinitionsFailed";
+    static readonly SaveNamespaceFailed = "SaveNamespaceFailed";
+    static readonly LoadNamespacesFailed = "LoadNamespacesFailed";
+    static readonly DestroyNamespacesFailed = "DestroyNamespacesFailed";
+}
+
+declare const A_FrameStorageFeatures: {
+    readonly SaveDefinitions: "_A_FRAME_STORAGE_SAVE";
+    readonly LoadDefinitions: "_A_FRAME_STORAGE_LOAD";
+    readonly DestroyDefinitions: "_A_FRAME_STORAGE_DESTROY";
+    readonly SaveNamespaces: "_A_FRAME_STORAGE_SAVE_NAMESPACES";
+    readonly LoadNamespaces: "_A_FRAME_STORAGE_LOAD_NAMESPACES";
+    readonly DestroyNamespaces: "_A_FRAME_STORAGE_DESTROY_NAMESPACES";
+};
+
+/** Reserved filename for the namespace binary index */
+/**
+ * A_FrameStorageProvider — Node.js environment
+ *
+ * Reads and writes encrypted binary index files (*.bin) on the local filesystem.
+ * Definition records are grouped by namespace into <namespace>.bin files.
+ * Namespace records are stored in the reserved __namespaces.bin file.
+ *
+ * File layout on disk:  [IV 12B][AuthTag 16B][Ciphertext ...]
+ */
+declare class A_FrameNodeStorage extends A_FrameStorage {
+    /** Returns file contents, or null when the file does not exist yet. Re-throws all other I/O errors. */
+    private tryReadFile;
+    /**
+     * Save a single definition to local file storage. This is called as part of A_FrameDefinition.save() when using the local file storage provider. It reads the existing namespace file, merges in the new or updated definition, and writes back the encrypted file.
+     *
+     * @param definition
+     * @param env
+     * @param context
+     * @param codec
+     */
+    saveDefinitionToDisk(definition: A_FrameDefinition, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    /**
+     * Load a single definition from local file storage. This is called as part of A_FrameDefinition.load() when using the local file storage provider. It reads the namespace file, finds the record for the requested definition, and if found and hash matches, populates the definition with the stored data.
+     */
+    loadDefinitionFromDisk(definition: A_FrameDefinition, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    /**
+     * Delete a single definition from local file storage. This is called as part of A_FrameDefinition.destroy() when using the local file storage provider. It reads the namespace file, removes the record for the requested definition, and writes back the encrypted file.
+     *
+     * @param definition
+     * @param env
+     * @param context
+     * @param codec
+     */
+    destroyDefinitionFromDisk(definition: A_FrameDefinition, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    saveNamespaceToDisk(namespace: A_FrameNamespace, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    loadNamespaceFromDisk(namespace: A_FrameNamespace, env: A_FrameEnv, context: A_FrameContext, aFrameCrypto: A_FrameCrypto, codec: A_FrameStorageCodec): Promise<void>;
+    destroyNamespaceFromLocalFileStorage(namespace: A_FrameNamespace, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    saveDefinitionsToDisk(env: A_FrameEnv, operation: A_FrameStorageSaveDefinitionOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    loadDefinitionsFromDisk(env: A_FrameEnv, operation: A_FrameStorageLoadDefinitionsOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    destroyDefinitionsFromDisk(env: A_FrameEnv, operation: A_FrameStorageDestroyDefinitionsOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    saveNamespacesToDisk(env: A_FrameEnv, operation: A_FrameStorageSaveNamespaceOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    loadNamespacesFromDisk(env: A_FrameEnv, operation: A_FrameStorageLoadNamespacesOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    destroyNamespacesFromDisk(env: A_FrameEnv, operation: A_FrameStorageDestroyNamespacesOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+}
+
+export { A_FrameNodeStorage, A_FrameStorage, A_FrameStorageCodec, A_FrameStorageDestroyDefinitionsOperation, A_FrameStorageDestroyNamespacesOperation, A_FrameStorageError, A_FrameStorageFeatures, A_FrameStorageLoadDefinitionsOperation, A_FrameStorageLoadNamespacesOperation, A_FrameStorageSaveDefinitionOperation, A_FrameStorageSaveNamespaceOperation };

package/dist/node/storage.d.ts

@@ -0,0 +1,110 @@
+import { A as A_FrameStorage, a as A_FrameContext, b as A_FrameStorageSaveDefinitionOperation, c as A_FrameStorageLoadDefinitionsOperation, d as A_FrameStorageDestroyDefinitionsOperation, e as A_FrameStorageSaveNamespaceOperation, f as A_FrameStorageLoadNamespacesOperation, g as A_FrameStorageDestroyNamespacesOperation } from './A-FrameStorage.component-CT01fs-t.js';
+export { h as A_FrameStorageDestroyDefinitionsOperationParams, i as A_FrameStorageDestroyDefinitionsOperationResult, j as A_FrameStorageDestroyNamespacesOperationParams, k as A_FrameStorageDestroyNamespacesOperationResult, l as A_FrameStorageLoadDefinitionsOperationParams, m as A_FrameStorageLoadDefinitionsOperationResult, n as A_FrameStorageLoadNamespacesOperationParams, o as A_FrameStorageLoadNamespacesOperationResult, p as A_FrameStorageOperation, q as A_FrameStorageSaveDefinitionOperationParams, r as A_FrameStorageSaveDefinitionOperationResult, s as A_FrameStorageSaveNamespaceOperationParams, t as A_FrameStorageSaveNamespaceOperationResult, I as IA_FrameStorage } from './A-FrameStorage.component-CT01fs-t.js';
+import { A_Fragment, A_Error } from '@adaas/a-concept';
+import { e as A_FrameNamespace_Serialized, A as A_FrameNamespace } from './A-FrameNamespace.entity-D3fZBGDx.js';
+import { c as A_FrameDefinition_Serialized, A as A_FrameDefinition } from './A-FrameDefinition.entity-CAUOdEvU.js';
+import { A_FrameEnv } from './env.js';
+import { A_FrameCrypto } from './crypto.js';
+import './A-FrameChannel.types-DQF-IiRq.js';
+import './vector.js';
+
+/**
+ * A-FrameStorage binary codec — shared between node and browser environments.
+ *
+ * Binary payload format (decrypted) — used for BOTH definition records and namespace records:
+ *   [HEADER 20B]
+ *     magic    4B = 0x454D424B ("EMBK")
+ *     version  1B = 0x01
+ *     count    4B (uint32 LE)
+ *     dims     2B (uint16 LE)
+ *     reserved 9B
+ *   [RECORD × count]
+ *     aseidLen 2B  (uint16 LE)
+ *     aseid    NB  utf-8  (primary entity ID, e.g. "app@root:123@v2")
+ *     nameLen  2B  (uint16 LE)
+ *     name     NB  utf-8
+ *     vector   dims×4B  Float32 LE
+ *     metaLen  4B  (uint32 LE)
+ *     meta     NB  JSON
+ */
+
+declare class A_FrameStorageCodec extends A_Fragment {
+    protected enc: TextEncoder;
+    protected dec: TextDecoder;
+    A_FRAME_FILE_MAGIC: number;
+    A_FRAME_FILE_VERSION: number;
+    A_FRAME_HEADER_SIZE: number;
+    static get fileExtension(): string;
+    getFileName(namespace: string): string;
+    getNamespaceFileName(): string;
+    encodePayload(records: A_FrameDefinition_Serialized[]): Uint8Array;
+    decodePayload(data: Uint8Array): A_FrameDefinition_Serialized[];
+    encodeNamespacePayload(records: A_FrameNamespace_Serialized[]): Uint8Array;
+    decodeNamespacePayload(data: Uint8Array): A_FrameNamespace_Serialized[];
+}
+
+declare class A_FrameStorageError extends A_Error {
+    static readonly SaveDefinitionFailed = "SaveDefinitionFailed";
+    static readonly LoadDefinitionsFailed = "LoadDefinitionsFailed";
+    static readonly DestroyDefinitionsFailed = "DestroyDefinitionsFailed";
+    static readonly SaveNamespaceFailed = "SaveNamespaceFailed";
+    static readonly LoadNamespacesFailed = "LoadNamespacesFailed";
+    static readonly DestroyNamespacesFailed = "DestroyNamespacesFailed";
+}
+
+declare const A_FrameStorageFeatures: {
+    readonly SaveDefinitions: "_A_FRAME_STORAGE_SAVE";
+    readonly LoadDefinitions: "_A_FRAME_STORAGE_LOAD";
+    readonly DestroyDefinitions: "_A_FRAME_STORAGE_DESTROY";
+    readonly SaveNamespaces: "_A_FRAME_STORAGE_SAVE_NAMESPACES";
+    readonly LoadNamespaces: "_A_FRAME_STORAGE_LOAD_NAMESPACES";
+    readonly DestroyNamespaces: "_A_FRAME_STORAGE_DESTROY_NAMESPACES";
+};
+
+/** Reserved filename for the namespace binary index */
+/**
+ * A_FrameStorageProvider — Node.js environment
+ *
+ * Reads and writes encrypted binary index files (*.bin) on the local filesystem.
+ * Definition records are grouped by namespace into <namespace>.bin files.
+ * Namespace records are stored in the reserved __namespaces.bin file.
+ *
+ * File layout on disk:  [IV 12B][AuthTag 16B][Ciphertext ...]
+ */
+declare class A_FrameNodeStorage extends A_FrameStorage {
+    /** Returns file contents, or null when the file does not exist yet. Re-throws all other I/O errors. */
+    private tryReadFile;
+    /**
+     * Save a single definition to local file storage. This is called as part of A_FrameDefinition.save() when using the local file storage provider. It reads the existing namespace file, merges in the new or updated definition, and writes back the encrypted file.
+     *
+     * @param definition
+     * @param env
+     * @param context
+     * @param codec
+     */
+    saveDefinitionToDisk(definition: A_FrameDefinition, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    /**
+     * Load a single definition from local file storage. This is called as part of A_FrameDefinition.load() when using the local file storage provider. It reads the namespace file, finds the record for the requested definition, and if found and hash matches, populates the definition with the stored data.
+     */
+    loadDefinitionFromDisk(definition: A_FrameDefinition, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    /**
+     * Delete a single definition from local file storage. This is called as part of A_FrameDefinition.destroy() when using the local file storage provider. It reads the namespace file, removes the record for the requested definition, and writes back the encrypted file.
+     *
+     * @param definition
+     * @param env
+     * @param context
+     * @param codec
+     */
+    destroyDefinitionFromDisk(definition: A_FrameDefinition, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    saveNamespaceToDisk(namespace: A_FrameNamespace, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    loadNamespaceFromDisk(namespace: A_FrameNamespace, env: A_FrameEnv, context: A_FrameContext, aFrameCrypto: A_FrameCrypto, codec: A_FrameStorageCodec): Promise<void>;
+    destroyNamespaceFromLocalFileStorage(namespace: A_FrameNamespace, env: A_FrameEnv, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    saveDefinitionsToDisk(env: A_FrameEnv, operation: A_FrameStorageSaveDefinitionOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    loadDefinitionsFromDisk(env: A_FrameEnv, operation: A_FrameStorageLoadDefinitionsOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    destroyDefinitionsFromDisk(env: A_FrameEnv, operation: A_FrameStorageDestroyDefinitionsOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    saveNamespacesToDisk(env: A_FrameEnv, operation: A_FrameStorageSaveNamespaceOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    loadNamespacesFromDisk(env: A_FrameEnv, operation: A_FrameStorageLoadNamespacesOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+    destroyNamespacesFromDisk(env: A_FrameEnv, operation: A_FrameStorageDestroyNamespacesOperation, context: A_FrameContext, codec: A_FrameStorageCodec, aFrameCrypto: A_FrameCrypto): Promise<void>;
+}
+
+export { A_FrameNodeStorage, A_FrameStorage, A_FrameStorageCodec, A_FrameStorageDestroyDefinitionsOperation, A_FrameStorageDestroyNamespacesOperation, A_FrameStorageError, A_FrameStorageFeatures, A_FrameStorageLoadDefinitionsOperation, A_FrameStorageLoadNamespacesOperation, A_FrameStorageSaveDefinitionOperation, A_FrameStorageSaveNamespaceOperation };

package/dist/node/storage.mjs

@@ -0,0 +1,13 @@
+export { A_FrameNodeStorage, A_FrameStorage, A_FrameStorageError, A_FrameStorageFeatures, A_FrameStorageOperation } from './chunk-OJGCQNAH.mjs';
+export { A_FrameStorageCodec } from './chunk-3ONWH75E.mjs';
+import './chunk-JQBYDEMW.mjs';
+import './chunk-K4MZY4ME.mjs';
+import './chunk-APRYHBEF.mjs';
+import './chunk-TO4BPKCY.mjs';
+import './chunk-UPA7VN4R.mjs';
+import './chunk-B7BXP7K4.mjs';
+import './chunk-442DXGOD.mjs';
+import './chunk-3TD2PEDZ.mjs';
+import './chunk-OI76LHVT.mjs';
+//# sourceMappingURL=storage.mjs.map
+//# sourceMappingURL=storage.mjs.map

package/dist/node/storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"storage.mjs"}

package/dist/node/vector.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkYWWGJ6EJ_cjs = require('./chunk-YWWGJ6EJ.cjs');
+require('./chunk-QFHZIG7Y.cjs');
+
+
+
+Object.defineProperty(exports, "A_FrameVector", {
+  enumerable: true,
+  get: function () { return chunkYWWGJ6EJ_cjs.A_FrameVector; }
+});
+//# sourceMappingURL=vector.cjs.map
+//# sourceMappingURL=vector.cjs.map

package/dist/node/vector.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"vector.cjs"}

package/dist/node/vector.d.mts

@@ -0,0 +1,15 @@
+import { A_Entity } from '@adaas/a-concept';
+
+declare class A_FrameVector extends A_Entity {
+    static get concept(): string;
+    readonly values: Float32Array;
+    constructor(values: number[] | Float32Array);
+    get length(): number;
+    magnitude(): number;
+    normalize(): A_FrameVector;
+    dot(other: A_FrameVector): number;
+    private assertSameLength;
+    toArray(): number[];
+}
+
+export { A_FrameVector };

package/dist/node/vector.d.ts

@@ -0,0 +1,15 @@
+import { A_Entity } from '@adaas/a-concept';
+
+declare class A_FrameVector extends A_Entity {
+    static get concept(): string;
+    readonly values: Float32Array;
+    constructor(values: number[] | Float32Array);
+    get length(): number;
+    magnitude(): number;
+    normalize(): A_FrameVector;
+    dot(other: A_FrameVector): number;
+    private assertSameLength;
+    toArray(): number[];
+}
+
+export { A_FrameVector };

package/dist/node/vector.mjs

@@ -0,0 +1,4 @@
+export { A_FrameVector } from './chunk-3TD2PEDZ.mjs';
+import './chunk-OI76LHVT.mjs';
+//# sourceMappingURL=vector.mjs.map
+//# sourceMappingURL=vector.mjs.map

package/dist/node/vector.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"vector.mjs"}

package/jest.config.browser.ts

@@ -0,0 +1,41 @@
+import type { Config } from '@jest/types';
+
+const config: Config.InitialOptions = {
+    verbose: true,
+    testEnvironment: '<rootDir>/tests/jest.browser-environment.js',
+    testEnvironmentOptions: {
+        // Keep node module resolution (CJS-compatible) while running in jsdom.
+        // Without this, jsdom activates the "browser" export condition which
+        // only has ESM entries and breaks Jest's CommonJS resolver.
+        customExportConditions: ['node', 'require', 'default'],
+    },
+    // Runs before any module is imported — needed for TextEncoder/TextDecoder/crypto polyfills
+    setupFiles: ['<rootDir>/tests/jest.polyfills.browser.ts'],
+    setupFilesAfterEnv: ['<rootDir>/tests/jest.setup.browser.ts'],
+    roots: ['<rootDir>/tests'],
+    testMatch: ['**/*.browser.test.ts'],
+    transform: {
+        '^.+\\.tsx?$': ['ts-jest', { tsconfig: 'tsconfig.browser.json' }]
+    },
+    moduleNameMapper: {
+        "@adaas/a-frame/constants/(.*)": "<rootDir>/src/constants/$1",
+        "@adaas/a-frame/utils/(.*)": "<rootDir>/src/utils/$1",
+        "@adaas/a-frame/helpers/(.*)": "<rootDir>/src/helpers/$1",
+        "@adaas/a-frame/types": "<rootDir>/src/types",
+        "@adaas/a-frame/core": "<rootDir>/src/lib/A-Frame/index.browser.ts",
+        "@adaas/a-frame/bundle": "<rootDir>/src/lib/A-FrameBundle/index.browser.ts",
+        "@adaas/a-frame/channel": "<rootDir>/src/lib/A-FrameChannel/index.browser.ts",
+        "@adaas/a-frame/crypto": "<rootDir>/src/lib/A-FrameCrypto/index.browser.ts",
+        "@adaas/a-frame/definition": "<rootDir>/src/lib/A-FrameDefinition/index.ts",
+        "@adaas/a-frame/dynamic-feature": "<rootDir>/src/lib/A-FrameDynamicFeature/index.ts",
+        "@adaas/a-frame/dynamic-structure": "<rootDir>/src/lib/A-FrameDynamicStructure/index.ts",
+        "@adaas/a-frame/env": "<rootDir>/src/lib/A-FrameEnv/index.browser.ts",
+        "@adaas/a-frame/index": "<rootDir>/src/lib/A-FrameIndex/index.browser.ts",
+        "@adaas/a-frame/logger": "<rootDir>/src/lib/A-FrameLogger/index.browser.ts",
+        "@adaas/a-frame/namespace": "<rootDir>/src/lib/A-FrameNamespace/index.ts",
+        "@adaas/a-frame/storage": "<rootDir>/src/lib/A-FrameStorage/index.browser.ts",
+        "@adaas/a-frame/vector": "<rootDir>/src/lib/A-FrameVector/index.ts",
+    }
+};
+
+export default config;