trellis 3.1.35 → 3.2.0

package/dist/client/index.d.ts

@@ -8,8 +8,13 @@
  *
  * @module trellis/client
  */
-export { TrellisDb as TrellisClient, TrellisDb, FetchError } from './sdk.js';
+export { TrellisDb, FetchError } from './sdk.js';
 export type { EntityData, ListResult, QueryResult, UploadResult, AuthResult, Subscription, SubscriptionCallback, TrellisDbLocalOptions, TrellisDbRemoteOptions, TrellisDbOptions, } from './sdk.js';
 export { readConfig, writeConfig, updateConfig, hasConfig, configPath, defaultLocalConfig, CONFIG_FILE, } from './config.js';
 export type { TrellisDbConfig, DbMode } from './config.js';
+export { TrellisClient } from './vcs-client.js';
+export type { TrellisClientOptions, TrellisClientSyncOptions, TrellisClientTopic, SyncStatus, } from './vcs-client.js';
+export { Signal, BatchSignal } from './reactive.js';
+export { liveQuery, liveEntities, liveEntity } from './live.js';
+export type { LiveEntitiesOptions, LiveEntityOptions, ReadState, LiveResource, } from './live.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC7E,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACjD,YAAY,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAChE,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,SAAS,EACT,YAAY,GACb,MAAM,WAAW,CAAC"}

package/dist/client/index.js

@@ -1,9 +1,6 @@
-// @bun
-import"../index-k5b0xskw.js";
 import {
-  FetchError,
-  TrellisDb
-} from "../index-wncptktd.js";
+  TrellisClient
+} from "../chunk-OVWAJMB6.js";
 import {
   CONFIG_FILE,
   configPath,
@@ -12,22 +9,45 @@ import {
   readConfig,
   updateConfig,
   writeConfig
-} from "../index-xzym9w0m.js";
-import"../index-7pjz3tsy.js";
-import"../index-4wxa8xz4.js";
-import"../index-yp88he8n.js";
-import"../index-yhwjgfvj.js";
-import"../index-h7zxhhhh.js";
-import"../index-a76rekgs.js";
+} from "../chunk-JA7AIHRK.js";
+import {
+  liveEntities,
+  liveEntity,
+  liveQuery
+} from "../chunk-J3WYZO3Q.js";
+import "../chunk-JUEMDWLU.js";
+import {
+  FetchError,
+  TrellisDb
+} from "../chunk-X762XWVC.js";
+import "../chunk-7WQGTFVJ.js";
+import "../chunk-4XIVMVHC.js";
+import "../chunk-MPXUVGT3.js";
+import "../chunk-B3ZIFA2O.js";
+import "../chunk-RSWUFTO2.js";
+import "../chunk-4HYPLFJD.js";
+import {
+  BatchSignal,
+  Signal
+} from "../chunk-UBGUDMUV.js";
+import "../chunk-36VSSTL7.js";
+import "../chunk-BXSTJVE3.js";
+import "../chunk-GLM4HGN4.js";
+import "../chunk-KFQGP6VL.js";
 export {
-  writeConfig,
-  updateConfig,
-  readConfig,
-  hasConfig,
-  defaultLocalConfig,
-  configPath,
-  TrellisDb,
-  TrellisDb as TrellisClient,
+  BatchSignal,
+  CONFIG_FILE,
   FetchError,
-  CONFIG_FILE
+  Signal,
+  TrellisClient,
+  TrellisDb,
+  configPath,
+  defaultLocalConfig,
+  hasConfig,
+  liveEntities,
+  liveEntity,
+  liveQuery,
+  readConfig,
+  updateConfig,
+  writeConfig
 };

package/dist/client/live.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Trellis Live Reads — Signal-first reactive queries.
+ *
+ * `liveQuery` is the framework-agnostic read primitive: it returns a {@link Signal}
+ * of read-state that the React/Vue/Svelte adapters all wrap, so the subscription
+ * is implemented once. It is lazy — `start()` opens the underlying source and
+ * returns a disposer — which lets adapters bind start/stop to component lifetime
+ * without side effects during render.
+ *
+ * Source today: the remote WebSocket subscription (`TrellisDb.subscribe`). The
+ * local embedded-kernel path is NOT live yet (`subscribe()` throws in local mode);
+ * a kernel op-stream source is the seam for that and is surfaced here as an error
+ * state rather than a throw.
+ *
+ * @module trellis/client
+ */
+import { Signal } from './reactive.js';
+import { type WhereInput } from '../schema/eql.js';
+import { type ResolveSpec } from '../schema/resolve.js';
+import type { AnyType } from '../schema/define.js';
+import type { EntityData, TrellisDb } from './sdk.js';
+export interface ReadState<T> {
+    data: T;
+    loading: boolean;
+    error: Error | null;
+}
+export interface LiveResource<T> {
+    /** Reactive read-state. Subscribe via any framework adapter (or `.subscribe`). */
+    readonly signal: Signal<ReadState<T>>;
+    /** Open the subscription. Idempotent. Returns a disposer. */
+    start(): () => void;
+}
+/**
+ * Subscribe to a live EQL-S query as a {@link Signal}. The returned resource is
+ * inert until `start()` is called.
+ */
+export declare function liveQuery<T = Record<string, unknown>>(client: TrellisDb, eql: string): LiveResource<T[]>;
+export interface LiveEntitiesOptions {
+    where?: WhereInput;
+    /** Expand declared relations after hydration (requires `schema`). */
+    resolve?: ResolveSpec;
+}
+export interface LiveEntityOptions {
+    /** Expand declared relations on the loaded row (requires `schema`). */
+    resolve?: ResolveSpec;
+}
+/**
+ * Live, *hydrated* entity list for a type.
+ *
+ * Remote subscriptions are server-hydrated to full entity records when possible.
+ * When `resolve` is set, the server expands relations on the wire (TRL-6) and
+ * the client skips a second resolve pass. Stale hydrations are dropped if a
+ * newer push arrives first.
+ *
+ * Pass a {@link AnyType} schema (or `resolve` in options) to expand relations
+ * in one batched pass — e.g. `NavSection` with `{ resolve: { items: true } }`
+ * loads all `NavItem` rows grouped by `section`, avoiding per-parent reads.
+ */
+export declare function liveEntities<T extends EntityData = EntityData>(client: TrellisDb, typeOrSchema: string | AnyType, whereOrOpts?: Record<string, unknown> | LiveEntitiesOptions): LiveResource<T[]>;
+/**
+ * Live single entity by id (TRL-9).
+ *
+ * Opens with a direct `read(id)` for fast first paint, then keeps the row fresh
+ * via an id-scoped subscription ({@link entityQuery}) — not a full-type scan.
+ */
+export declare function liveEntity<T extends EntityData = EntityData>(client: TrellisDb, typeOrSchema: string | AnyType, id: string | null | undefined, opts?: LiveEntityOptions): LiveResource<T | null>;
+//# sourceMappingURL=live.d.ts.map

package/dist/client/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/client/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMvC,OAAO,EAA8B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAgB,SAAS,EAAE,MAAM,UAAU,CAAC;AAEpE,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,6DAA6D;IAC7D,KAAK,IAAI,MAAM,IAAI,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,MAAM,EAAE,SAAS,EACjB,GAAG,EAAE,MAAM,GACV,YAAY,CAAC,CAAC,EAAE,CAAC,CAgCnB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,OAAO,CAAC,EAAE,WAAW,CAAC;CACvB;AAYD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAC5D,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GAAG,OAAO,EAC9B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,mBAAmB,GAC1D,YAAY,CAAC,CAAC,EAAE,CAAC,CA8EnB;AAgCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EAC1D,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GAAG,OAAO,EAC9B,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC7B,IAAI,CAAC,EAAE,iBAAiB,GACvB,YAAY,CAAC,CAAC,GAAG,IAAI,CAAC,CAmGxB"}

package/dist/client/reactive.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Trellis Reactive Primitives
+ *
+ * Framework-agnostic signals for building reactive UIs on top of
+ * TrellisClient. Inspired by Svelte 5 runes and the react-runes
+ * experiment, but stripped of any framework dependency.
+ *
+ * Use with React via the `react-runes` $ hook, or with Svelte 5
+ * by wrapping signals in $state/$derived.
+ */
+/** Simple mutable reactive value. */
+export declare class Signal<T> {
+    private _value;
+    private _subs;
+    constructor(initial: T);
+    get value(): T;
+    set value(v: T);
+    /** Subscribe to changes. Immediately called with current value. */
+    subscribe(fn: (v: T) => void): () => void;
+    /** Read without tracking. */
+    peek(): T;
+    /** Whether any subscriber is registered. */
+    hasSubscribers(): boolean;
+}
+/** Throttled signal that batches rapid updates via requestAnimationFrame. */
+export declare class BatchSignal<T> extends Signal<T> {
+    private _raf;
+    constructor(initial: T);
+    set value(v: T);
+}
+//# sourceMappingURL=reactive.d.ts.map

package/dist/client/reactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactive.d.ts","sourceRoot":"","sources":["../../src/client/reactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,qCAAqC;AACrC,qBAAa,MAAM,CAAC,CAAC;IACnB,OAAO,CAAC,MAAM,CAAI;IAClB,OAAO,CAAC,KAAK,CAA6B;gBAE9B,OAAO,EAAE,CAAC;IAItB,IAAI,KAAK,IAAI,CAAC,CAEb;IAED,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC,EAUb;IAED,mEAAmE;IACnE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;IAYzC,6BAA6B;IAC7B,IAAI,IAAI,CAAC;IAIT,4CAA4C;IAC5C,cAAc,IAAI,OAAO;CAG1B;AAED,6EAA6E;AAC7E,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAuB;gBAEvB,OAAO,EAAE,CAAC;IAItB,IAAa,KAAK,CAAC,CAAC,EAAE,CAAC,EAOtB;CACF"}

package/dist/client/sdk.d.ts

@@ -18,6 +18,8 @@
  *
  * @module trellis/client
  */
+import type { SchemaDefinition } from '../core/ontology/types.js';
+import type { ResolveSpec } from '../schema/resolve.js';
 export interface EntityData {
     id: string;
     type: string;
@@ -49,7 +51,15 @@ export type SubscriptionCallback<T = EntityData> = (result: T[], diff: {
     added: T[];
     updated: T[];
     removed: T[];
+}, meta?: {
+    resolved?: boolean;
 }) => void;
+/** Options for {@link TrellisDb.subscribe} — server-side relation expansion (TRL-6). */
+export interface SubscribeOptions {
+    /** Entity type name (e.g. `NavSection`) for server `resolve`. */
+    entityType?: string;
+    resolve?: ResolveSpec;
+}
 export interface TrellisDbLocalOptions {
     /** Path to the SQLite database directory. */
     path: string;
@@ -70,13 +80,17 @@ export type TrellisDbOptions = TrellisDbLocalOptions | TrellisDbRemoteOptions;
 export declare class TrellisDb {
     private opts;
     private _pool;
+    private _poolPromise;
     private _ws;
+    /** In-flight connect — concurrent subscribe() shares one socket open. */
+    private _wsPromise;
     private _subCallbacks;
+    private _subOpts;
     constructor(opts: TrellisDbOptions);
     /**
      * Create a TrellisDb instance from `.trellis-db.json` in the given directory.
      */
-    static fromConfig(dir?: string): TrellisDb;
+    static fromConfig(dir?: string): Promise<TrellisDb>;
     /**
      * Create a new entity.
      * Returns the generated entity ID.
@@ -110,6 +124,16 @@ export declare class TrellisDb {
      * Run an EQL-S query string.
      */
     query(eql: string): Promise<QueryResult>;
+    /**
+     * Register a user/system-tier ontology schema with the kernel.
+     *
+     * Accepts a {@link SchemaDefinition} or anything carrying one (e.g. a
+     * `defineType` handle: `client.registerType(NavItem)`). Local mode calls
+     * `kernel.createOntology` directly; remote mode POSTs to `/ontologies`.
+     */
+    registerType(schema: SchemaDefinition | {
+        definition: SchemaDefinition;
+    }): Promise<void>;
     /**
      * Upload a file to the blob store.
      * Returns a content-addressed hash.
@@ -131,7 +155,7 @@ export declare class TrellisDb {
      *
      * Requires remote mode (WebSocket to server).
      */
-    subscribe<T = EntityData>(eql: string, callback: SubscriptionCallback<T>): Subscription<T>;
+    subscribe<T = EntityData>(eql: string, callback: SubscriptionCallback<T>, opts?: SubscribeOptions): Subscription<T>;
     /**
      * Close the WebSocket connection.
      */

package/dist/client/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/client/sdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../src/client/sdk.ts"],"names":[],"mappings":"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"}

package/dist/client/sdk.js

@@ -0,0 +1,9 @@
+import {
+  FetchError,
+  TrellisDb
+} from "../chunk-X762XWVC.js";
+import "../chunk-KFQGP6VL.js";
+export {
+  FetchError,
+  TrellisDb
+};

package/dist/client/vcs-client.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Trellis VCS Client — Reactive SDK
+ *
+ * High-level client that wraps TrellisVcsEngine with reactive signals
+ * and optional PartyKit sync. Works in browsers (IndexedDB) and Node.
+ *
+ *   const client = await TrellisClient.open({
+ *     repo: 'my-project',
+ *     sync: { url: 'wss://party.trellis.dev/room/123' },
+ *     persist: 'indexeddb',
+ *   });
+ *
+ *   client.subscribe('issues', (issues) => render(issues));
+ *   await client.sync();
+ */
+import { TrellisVcsEngine } from '../engine.js';
+import type { SyncTransport } from '../sync/types.js';
+import type { VcsOp } from '../vcs/types.js';
+import type { IssueCreateOptions, IssueInfo } from '../vcs/issue.js';
+import { Signal } from './reactive.js';
+export type TrellisClientTopic = 'ops' | 'issues' | 'milestones' | 'branches' | 'syncStatus';
+export interface TrellisClientSyncOptions {
+    /** PartyKit room WebSocket URL. */
+    url?: string;
+    /** Optional auth token (JWT, passkey) — appended as `?token=` on the WS URL. */
+    auth?: string;
+    /** Inject a transport for tests or custom relays. Mutually exclusive with `url`. */
+    transport?: SyncTransport;
+    /** Logical room peer ID for sync calls. Default: `room`. */
+    roomId?: string;
+    /** Debounced auto-push after local writes (ms). Default: 200. Set 0 to disable. */
+    pushDebounceMs?: number;
+    /** Connect and catch up on open. Default: true when sync is configured. */
+    connectOnOpen?: boolean;
+    /**
+     * Request a tail snapshot before full sync on connect/reconnect.
+     * Default: 500. Set 0 to skip snapshot and use full op replay only.
+     */
+    snapshotMaxOps?: number;
+    /** Reconnect with backoff when using `url` (PartyKit transport). Default: true. */
+    reconnect?: boolean;
+}
+export interface TrellisClientOptions {
+    /** Repository root path or logical name (for IDB). */
+    repo: string;
+    /** Peer/agent identity. Generated if omitted. */
+    agentId?: string;
+    /** Sync configuration. Omit for offline-only. */
+    sync?: TrellisClientSyncOptions;
+    /** Persistence backend. Default: filesystem (Node) or IndexedDB (browser). */
+    persist?: 'indexeddb' | 'opfs' | 'memory';
+}
+export interface SyncStatus {
+    /** Whether the transport connection is open (WebSocket rooms). */
+    connected: boolean;
+    /** Number of in-flight sync operations. */
+    pending: number;
+    /** Whether the client believes it is in sync with the room. */
+    synced: boolean;
+    /** ISO timestamp of the last successful push/pull, or null. */
+    lastSyncAt: string | null;
+    /** Last sync or connection error message, or null. */
+    lastError: string | null;
+}
+/**
+ * Reactive Trellis client with VCS operations and optional multiplayer sync.
+ */
+export declare class TrellisClient {
+    private _engine;
+    private _syncPeer?;
+    private _peerId;
+    private _opLog;
+    private _roomId;
+    private _pushDebounceMs;
+    private _snapshotMaxOps;
+    private _pushTimer?;
+    private _closed;
+    /** Raw causal log. Updated on every local or remote op. */
+    private _ops;
+    /** Sync connection state. */
+    private _syncStatus;
+    private _opHandlers;
+    private _topicSubs;
+    private constructor();
+    /** Factory — opens the repo, loads ops, and optionally connects to sync. */
+    static open(opts: TrellisClientOptions): Promise<TrellisClient>;
+    /** Subscribe to reactive topics. Callback receives current value immediately. */
+    subscribe(topic: TrellisClientTopic | string, callback: (data: unknown) => void): () => void;
+    /** Listen for raw op events (local or remote). */
+    on(event: 'op', handler: (op: VcsOp) => void): () => void;
+    /** Create an issue and emit reactive updates. */
+    createIssue(title: string, opts?: IssueCreateOptions & {
+        lane?: string;
+    }): Promise<VcsOp>;
+    /** Force a push/pull sync with the room. */
+    sync(): Promise<void>;
+    /** Close (complete) an issue. */
+    closeIssue(id: string, opts?: {
+        confirm?: boolean;
+    }): Promise<VcsOp | null>;
+    /** Reopen a closed issue. */
+    reopenIssue(id: string): Promise<VcsOp>;
+    /** Read current ops without subscribing. */
+    getOps(): VcsOp[];
+    /** Read current issues without subscribing. */
+    listIssues(): IssueInfo[];
+    /** Clean up resources. */
+    close(): void;
+    /** Signal exposing the full causal op log. */
+    get opsSignal(): Signal<VcsOp[]>;
+    /** Signal exposing sync connection status. */
+    get syncStatusSignal(): Signal<SyncStatus>;
+    /** Underlying VCS engine (for advanced sync wiring and queries). */
+    get engine(): TrellisVcsEngine;
+    private _createTransport;
+    private _createOpLog;
+    private _connectTransport;
+    private _connectAndCatchUp;
+    private _onTransportReconnect;
+    private _requestSnapshot;
+    private _schedulePush;
+    private _pushToRoom;
+    private _refreshState;
+    private _emitOp;
+    private _broadcastTopic;
+    private _getTopicValue;
+    private _setSyncStatus;
+}
+//# sourceMappingURL=vcs-client.d.ts.map

package/dist/client/vcs-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcs-client.d.ts","sourceRoot":"","sources":["../../src/client/vcs-client.ts"],"names":[],"mappings":"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"}