@dxos/echo 0.8.4-staging.ac66bdf99f → 0.9.0

package/dist/lib/neutral/Obj.mjs

@@ -5,16 +5,18 @@ import {
   Unknown,
   VersionTypeId,
   addTag,
-  change,
+  atom,
+  atomProperty,
+  atomReactive,
   clone,
   compareVersions,
   decodeVersion,
   deleteKeys,
   encodeVersion,
   fromJSON,
-  getDXN,
   getDatabase,
   getDescription,
+  getIcon,
   getKeys,
   getLabel,
   getMeta,
@@ -22,10 +24,11 @@ import {
   getReactive,
   getReactiveOption,
   getReactiveOrThrow,
-  getSchema,
   getSnapshot,
-  getTypeDXN,
+  getType,
+  getTypeURI,
   getTypename,
+  getURI,
   getValue,
   instanceOf,
   isDeleted,
@@ -44,21 +47,23 @@ import {
   sortByTypename,
   subscribe,
   toJSON,
+  update,
   updateFrom,
   version,
   versionValid
-} from "./chunk-B4BASU6W.mjs";
-import "./chunk-BVOFLCVF.mjs";
-import "./chunk-T6W2LEZU.mjs";
-import "./chunk-MOR5ERFM.mjs";
-import "./chunk-OS35K56T.mjs";
-import "./chunk-JUXPFOEI.mjs";
-import "./chunk-DQYLD2RB.mjs";
-import "./chunk-G3IQMKF7.mjs";
-import "./chunk-PHU22NLC.mjs";
-import "./chunk-2KHZ36F5.mjs";
-import "./chunk-TBKX6JQO.mjs";
-import "./chunk-UBEZSGXY.mjs";
+} from "./chunk-TYGKCRMK.mjs";
+import "./chunk-MZ7K3MLL.mjs";
+import "./chunk-SBVFRTST.mjs";
+import "./chunk-T6E37YIP.mjs";
+import "./chunk-7FPIAJIV.mjs";
+import "./chunk-5SUJPHAE.mjs";
+import "./chunk-7PI7C4EF.mjs";
+import "./chunk-TFEWTY5A.mjs";
+import "./chunk-4ZUHOTCG.mjs";
+import "./chunk-WTQJHC75.mjs";
+import "./chunk-R5W6DXR4.mjs";
+import "./chunk-O6BH7EPN.mjs";
+import "./chunk-BBFJWWAV.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   ID,
@@ -67,16 +72,18 @@ export {
   Unknown,
   VersionTypeId,
   addTag,
-  change,
+  atom,
+  atomProperty,
+  atomReactive,
   clone,
   compareVersions,
   decodeVersion,
   deleteKeys,
   encodeVersion,
   fromJSON,
-  getDXN,
   getDatabase,
   getDescription,
+  getIcon,
   getKeys,
   getLabel,
   getMeta,
@@ -84,10 +91,11 @@ export {
   getReactive,
   getReactiveOption,
   getReactiveOrThrow,
-  getSchema,
   getSnapshot,
-  getTypeDXN,
+  getType,
+  getTypeURI,
   getTypename,
+  getURI,
   getValue,
   instanceOf,
   isDeleted,
@@ -106,6 +114,7 @@ export {
   sortByTypename,
   subscribe,
   toJSON,
+  update,
   updateFrom,
   version,
   versionValid

package/dist/lib/neutral/Order.mjs

@@ -1,12 +1,16 @@
 import {
+  created,
   natural,
   property,
-  rank
-} from "./chunk-UI6MWK5W.mjs";
+  rank,
+  updated
+} from "./chunk-EVK6XBXO.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
+  created,
   natural,
   property,
-  rank
+  rank,
+  updated
 };
 //# sourceMappingURL=Order.mjs.map

package/dist/lib/neutral/Query.mjs

@@ -7,23 +7,23 @@ import {
   select,
   type,
   without
-} from "./chunk-EAMSSLZC.mjs";
-import "./chunk-TU3GW67D.mjs";
-import "./chunk-ROG4RXXL.mjs";
-import "./chunk-V36VO5SS.mjs";
-import "./chunk-B4BASU6W.mjs";
-import "./chunk-BVOFLCVF.mjs";
-import "./chunk-T6W2LEZU.mjs";
-import "./chunk-MOR5ERFM.mjs";
-import "./chunk-OS35K56T.mjs";
-import "./chunk-JUXPFOEI.mjs";
-import "./chunk-DQYLD2RB.mjs";
-import "./chunk-G3IQMKF7.mjs";
-import "./chunk-4P3IXBLT.mjs";
-import "./chunk-PHU22NLC.mjs";
-import "./chunk-2KHZ36F5.mjs";
-import "./chunk-TBKX6JQO.mjs";
-import "./chunk-UBEZSGXY.mjs";
+} from "./chunk-QQIYS74I.mjs";
+import "./chunk-ZGNNFYHS.mjs";
+import "./chunk-6YDI3J37.mjs";
+import "./chunk-TYGKCRMK.mjs";
+import "./chunk-MZ7K3MLL.mjs";
+import "./chunk-SBVFRTST.mjs";
+import "./chunk-T6E37YIP.mjs";
+import "./chunk-7FPIAJIV.mjs";
+import "./chunk-5SUJPHAE.mjs";
+import "./chunk-7PI7C4EF.mjs";
+import "./chunk-TFEWTY5A.mjs";
+import "./chunk-3PBP4V4O.mjs";
+import "./chunk-4ZUHOTCG.mjs";
+import "./chunk-WTQJHC75.mjs";
+import "./chunk-R5W6DXR4.mjs";
+import "./chunk-O6BH7EPN.mjs";
+import "./chunk-BBFJWWAV.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   all,

package/dist/lib/neutral/QueryResult.mjs

@@ -1,2 +1,2 @@
-import "./chunk-OMUPQMLR.mjs";
+import "./chunk-35INCYOE.mjs";
 //# sourceMappingURL=QueryResult.mjs.map

package/dist/lib/neutral/Ref.mjs

@@ -1,22 +1,23 @@
 import {
   Array,
   Ref,
-  fromDXN,
+  fromURI,
+  hasEntityId,
   isRef,
   isRefType,
   make
-} from "./chunk-BVOFLCVF.mjs";
-import "./chunk-OS35K56T.mjs";
-import "./chunk-G3IQMKF7.mjs";
-import "./chunk-PHU22NLC.mjs";
-import "./chunk-2KHZ36F5.mjs";
-import "./chunk-TBKX6JQO.mjs";
-import "./chunk-UBEZSGXY.mjs";
+} from "./chunk-MZ7K3MLL.mjs";
+import "./chunk-5SUJPHAE.mjs";
+import "./chunk-WTQJHC75.mjs";
+import "./chunk-R5W6DXR4.mjs";
+import "./chunk-O6BH7EPN.mjs";
+import "./chunk-BBFJWWAV.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   Array,
   Ref,
-  fromDXN,
+  fromURI,
+  hasEntityId,
   isRef,
   isRefType,
   make

package/dist/lib/neutral/Registry.mjs

@@ -0,0 +1,14 @@
+import {
+  Service,
+  TypeId,
+  isRegistry,
+  runQuery
+} from "./chunk-WU3GIANS.mjs";
+import "./chunk-J5LGTIGS.mjs";
+export {
+  Service,
+  TypeId,
+  isRegistry,
+  runQuery
+};
+//# sourceMappingURL=Registry.mjs.map

package/dist/lib/neutral/Relation.mjs

@@ -5,23 +5,24 @@ import {
   Unknown,
   VersionTypeId,
   addTag,
-  change,
+  atom,
   deleteKeys,
-  getDXN,
   getDatabase,
   getDescription,
   getKeys,
   getLabel,
   getMeta,
-  getSchema,
   getSnapshot,
   getSource,
-  getSourceDXN,
+  getSourceURI,
   getTarget,
-  getTargetDXN,
-  getTypeDXN,
+  getTargetURI,
+  getType,
+  getTypeURI,
   getTypename,
+  getURI,
   getValue,
+  instanceOf,
   isDeleted,
   isRelation,
   isSnapshot,
@@ -36,20 +37,20 @@ import {
   sortByTypename,
   subscribe,
   toJSON,
+  update,
   version
-} from "./chunk-HBUZJNZO.mjs";
-import "./chunk-B4BASU6W.mjs";
-import "./chunk-BVOFLCVF.mjs";
-import "./chunk-T6W2LEZU.mjs";
-import "./chunk-MOR5ERFM.mjs";
-import "./chunk-OS35K56T.mjs";
-import "./chunk-JUXPFOEI.mjs";
-import "./chunk-DQYLD2RB.mjs";
-import "./chunk-G3IQMKF7.mjs";
-import "./chunk-PHU22NLC.mjs";
-import "./chunk-2KHZ36F5.mjs";
-import "./chunk-TBKX6JQO.mjs";
-import "./chunk-UBEZSGXY.mjs";
+} from "./chunk-LWXVKPPW.mjs";
+import "./chunk-SBVFRTST.mjs";
+import "./chunk-T6E37YIP.mjs";
+import "./chunk-7FPIAJIV.mjs";
+import "./chunk-5SUJPHAE.mjs";
+import "./chunk-7PI7C4EF.mjs";
+import "./chunk-TFEWTY5A.mjs";
+import "./chunk-4ZUHOTCG.mjs";
+import "./chunk-WTQJHC75.mjs";
+import "./chunk-R5W6DXR4.mjs";
+import "./chunk-O6BH7EPN.mjs";
+import "./chunk-BBFJWWAV.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   Meta,
@@ -58,23 +59,24 @@ export {
   Unknown,
   VersionTypeId,
   addTag,
-  change,
+  atom,
   deleteKeys,
-  getDXN,
   getDatabase,
   getDescription,
   getKeys,
   getLabel,
   getMeta,
-  getSchema,
   getSnapshot,
   getSource,
-  getSourceDXN,
+  getSourceURI,
   getTarget,
-  getTargetDXN,
-  getTypeDXN,
+  getTargetURI,
+  getType,
+  getTypeURI,
   getTypename,
+  getURI,
   getValue,
+  instanceOf,
   isDeleted,
   isRelation,
   isSnapshot,
@@ -89,6 +91,7 @@ export {
   sortByTypename,
   subscribe,
   toJSON,
+  update,
   version
 };
 //# sourceMappingURL=Relation.mjs.map

package/dist/lib/neutral/Scope.mjs

@@ -0,0 +1,12 @@
+import {
+  feed,
+  registry,
+  space
+} from "./chunk-WISOH2XH.mjs";
+import "./chunk-J5LGTIGS.mjs";
+export {
+  feed,
+  registry,
+  space
+};
+//# sourceMappingURL=Scope.mjs.map

package/dist/lib/neutral/Tag.mjs

@@ -1,27 +1,30 @@
 import {
   Tag,
   createTagList,
+  findOrCreate,
   findTagByLabel,
   make,
   sortTags
-} from "./chunk-YAHXAYOW.mjs";
-import "./chunk-ROG4RXXL.mjs";
-import "./chunk-B4BASU6W.mjs";
-import "./chunk-BVOFLCVF.mjs";
-import "./chunk-T6W2LEZU.mjs";
-import "./chunk-MOR5ERFM.mjs";
-import "./chunk-OS35K56T.mjs";
-import "./chunk-JUXPFOEI.mjs";
-import "./chunk-DQYLD2RB.mjs";
-import "./chunk-G3IQMKF7.mjs";
-import "./chunk-PHU22NLC.mjs";
-import "./chunk-2KHZ36F5.mjs";
-import "./chunk-TBKX6JQO.mjs";
-import "./chunk-UBEZSGXY.mjs";
+} from "./chunk-5SMDBFVB.mjs";
+import "./chunk-6YDI3J37.mjs";
+import "./chunk-TYGKCRMK.mjs";
+import "./chunk-MZ7K3MLL.mjs";
+import "./chunk-SBVFRTST.mjs";
+import "./chunk-T6E37YIP.mjs";
+import "./chunk-7FPIAJIV.mjs";
+import "./chunk-5SUJPHAE.mjs";
+import "./chunk-7PI7C4EF.mjs";
+import "./chunk-TFEWTY5A.mjs";
+import "./chunk-4ZUHOTCG.mjs";
+import "./chunk-WTQJHC75.mjs";
+import "./chunk-R5W6DXR4.mjs";
+import "./chunk-O6BH7EPN.mjs";
+import "./chunk-BBFJWWAV.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
   Tag,
   createTagList,
+  findOrCreate,
   findTagByLabel,
   make,
   sortTags

package/dist/lib/neutral/Type.mjs

@@ -1,37 +1,65 @@
 import {
-  PersistentType,
-  RuntimeType,
-  getDXN,
+  InstancePhantomId,
+  Type,
+  addFields,
+  assertObject,
+  expectRelation,
+  expectTypeKind,
+  getDatabase,
+  getLabel,
   getMeta,
+  getSchema,
   getTypename,
+  getURI,
   getVersion,
-  isMutable,
-  isObjectSchema,
-  isRelationSchema,
-  object,
-  relation
-} from "./chunk-ROG4RXXL.mjs";
-import "./chunk-MOR5ERFM.mjs";
-import "./chunk-OS35K56T.mjs";
-import "./chunk-JUXPFOEI.mjs";
-import "./chunk-DQYLD2RB.mjs";
-import "./chunk-G3IQMKF7.mjs";
-import "./chunk-PHU22NLC.mjs";
-import "./chunk-2KHZ36F5.mjs";
-import "./chunk-TBKX6JQO.mjs";
-import "./chunk-UBEZSGXY.mjs";
+  isObject,
+  isRelation,
+  isType,
+  isTypeKind,
+  makeObject,
+  makeObjectFromJsonSchema,
+  makeRelation,
+  makeRelationFromJsonSchema,
+  removeFields,
+  update,
+  updateFieldPropertyName,
+  updateFields
+} from "./chunk-T6E37YIP.mjs";
+import "./chunk-7FPIAJIV.mjs";
+import "./chunk-5SUJPHAE.mjs";
+import "./chunk-7PI7C4EF.mjs";
+import "./chunk-TFEWTY5A.mjs";
+import "./chunk-4ZUHOTCG.mjs";
+import "./chunk-WTQJHC75.mjs";
+import "./chunk-R5W6DXR4.mjs";
+import "./chunk-O6BH7EPN.mjs";
+import "./chunk-BBFJWWAV.mjs";
 import "./chunk-J5LGTIGS.mjs";
 export {
-  PersistentType,
-  RuntimeType,
-  getDXN,
+  InstancePhantomId,
+  Type,
+  addFields,
+  assertObject,
+  expectRelation,
+  expectTypeKind,
+  getDatabase,
+  getLabel,
   getMeta,
+  getSchema,
   getTypename,
+  getURI,
   getVersion,
-  isMutable,
-  isObjectSchema,
-  isRelationSchema,
-  object,
-  relation
+  isObject,
+  isRelation,
+  isType,
+  isTypeKind,
+  makeObject,
+  makeObjectFromJsonSchema,
+  makeRelation,
+  makeRelationFromJsonSchema,
+  removeFields,
+  update,
+  updateFieldPropertyName,
+  updateFields
 };
 //# sourceMappingURL=Type.mjs.map

package/dist/lib/neutral/{chunk-OMUPQMLR.mjs → chunk-35INCYOE.mjs}

@@ -4,4 +4,4 @@ var QueryResult_exports = {};
 export {
   QueryResult_exports
 };
-//# sourceMappingURL=chunk-OMUPQMLR.mjs.map
+//# sourceMappingURL=chunk-35INCYOE.mjs.map

package/dist/lib/neutral/chunk-35INCYOE.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/QueryResult.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport type * as Atom from '@effect-atom/atom/Atom';\nimport * as Effect from 'effect/Effect';\nimport * as Option from 'effect/Option';\n\nimport { type CleanupFn } from '@dxos/async';\n\nimport type * as Entity from './Entity';\n\n/**\n * Individual query result entry.\n */\nexport type Entry<T> = {\n  id: string;\n\n  /**\n   * May not be present for remote results.\n   */\n  result?: T;\n\n  match?: {\n    // TODO(dmaretskyi): text positional info.\n\n    /**\n     * Higher means better match.\n     */\n    rank: number;\n  };\n\n  /**\n   * Query resolution metadata.\n   */\n  // TODO(dmaretskyi): Rename to meta?\n  resolution?: {\n    // TODO(dmaretskyi): Make this more generic.\n    source: 'remote' | 'local' | 'index';\n\n    /**\n     * Query resolution time in milliseconds.\n     */\n    time: number;\n  };\n};\n\n/**\n * Invidual query result entry for a database Entity.\n */\nexport type EntityEntry<T extends Entity.Unknown = Entity.Unknown> = Entry<T>;\n\nexport type RunOptions = {\n  timeout?: number;\n};\n\nexport type SubscriptionOptions = {\n  /**\n   * Fire the callback immediately.\n   */\n  fire?: boolean;\n};\n\n// TODO(burdon): Should T be constrained to Entity.Any?\nexport interface QueryResult<T> {\n  /**\n   * Currently available results along with their match metadata.\n   */\n  readonly entries: Entry<T>[];\n\n  /**\n   * Currently available results.\n   */\n  readonly results: T[];\n\n  /**\n   * Returns all known results.\n   */\n  run(opts?: RunOptions): Promise<T[]>;\n\n  /**\n   * Returns all known results along with their match metadata.\n   */\n  runEntries(opts?: RunOptions): Promise<Entry<T>[]>;\n\n  /**\n   * Returns currently available results synchronously.\n   */\n  runSync(): T[];\n\n  /**\n   * Returns currently available results synchronously along with their match metadata.\n   */\n  runSyncEntries(): Entry<T>[];\n\n  /**\n   * Returns first result.\n   */\n  first(opts?: RunOptions): Promise<T>;\n\n  /**\n   * Returns first result if there is one.\n   */\n  firstOrUndefined(opts?: RunOptions): Promise<T | undefined>;\n\n  /**\n   * Subscribes to changes in query results.\n   */\n  subscribe(callback?: (query: QueryResult<T>) => void, opts?: SubscriptionOptions): CleanupFn;\n\n  /**\n   * Self-updating atom. Updates automatically when query results change.\n   *\n   * Memoized per QueryResult instance — repeated accesses on the same instance return the same\n   * Atom. Safe only when the QueryResult is itself held stable across re-renders (e.g. behind a\n   * `useMemo`). It must NOT be used in graph-builder connectors/actions or other atom computes,\n   * where `db.query(...)` is called fresh on each re-evaluation: every run constructs a new\n   * QueryResult and so a new atom + subscription, leaking the previous ones. Use the memoized\n   * {@link atom} family there instead.\n   */\n  readonly atom: Atom.Atom<T[]>;\n}\n\n/**\n * Effect that returns a QueryResult when evaluated, but also has shorthand methods for running the query or getting the first result.\n */\nexport interface QueryResultEffect<T, E, R> extends Effect.Effect<QueryResult<T>, E, R> {\n  run: Effect.Effect<T[], E, R>;\n  first: Effect.Effect<Option.Option<T>, E, R>;\n\n  // TODO(dmaretskyi): Considering adding `atom`, but since `Database.query` is used in imperative code only, I dont think it will be useful.\n}\n"],
+  "mappings": ";AAAA;",
+  "names": []
+}

package/dist/lib/neutral/chunk-3PBP4V4O.mjs

@@ -0,0 +1,101 @@
+import {
+  get,
+  set
+} from "./chunk-4ZUHOTCG.mjs";
+import {
+  DescriptionAnnotation,
+  Dictionary,
+  FieldLookupAnnotationId,
+  FormInlineAnnotation,
+  FormInputAnnotation,
+  GeneratorAnnotation,
+  GeneratorAnnotationId,
+  HiddenAnnotation,
+  IconAnnotation,
+  IconFromRefAnnotation,
+  Key,
+  LabelAnnotation,
+  ReferenceAnnotation,
+  ReferenceAnnotationId,
+  TypeAnnotation,
+  getDescriptionWithSchema,
+  getDictionary,
+  getFromAst,
+  getLabelWithSchema,
+  getTypeAnnotation,
+  getTypeIdentifierAnnotation,
+  makeUserAnnotation,
+  setDescriptionWithSchema,
+  setDictionary,
+  setLabelWithSchema
+} from "./chunk-R5W6DXR4.mjs";
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/Annotation.ts
+var Annotation_exports = {};
+__export(Annotation_exports, {
+  DescriptionAnnotation: () => DescriptionAnnotation,
+  Dictionary: () => Dictionary2,
+  FieldLookupAnnotationId: () => FieldLookupAnnotationId,
+  FormInlineAnnotation: () => FormInlineAnnotation,
+  FormInputAnnotation: () => FormInputAnnotation,
+  GeneratorAnnotation: () => GeneratorAnnotation,
+  GeneratorAnnotationId: () => GeneratorAnnotationId,
+  HiddenAnnotation: () => HiddenAnnotation,
+  IconAnnotation: () => IconAnnotation,
+  IconFromRefAnnotation: () => IconFromRefAnnotation,
+  Key: () => Key2,
+  LabelAnnotation: () => LabelAnnotation,
+  ReferenceAnnotation: () => ReferenceAnnotation,
+  ReferenceAnnotationId: () => ReferenceAnnotationId,
+  TypeAnnotation: () => TypeAnnotation,
+  TypeId: () => TypeId,
+  get: () => get2,
+  getDescriptionWithSchema: () => getDescriptionWithSchema,
+  getDictionary: () => getDictionary2,
+  getFromAst: () => getFromAst2,
+  getLabelWithSchema: () => getLabelWithSchema,
+  getTypeAnnotation: () => getTypeAnnotation,
+  getTypeIdentifierAnnotation: () => getTypeIdentifierAnnotation,
+  make: () => make,
+  set: () => set2,
+  setDescriptionWithSchema: () => setDescriptionWithSchema,
+  setDictionary: () => setDictionary2,
+  setLabelWithSchema: () => setLabelWithSchema
+});
+import * as Function from "effect/Function";
+var TypeId = "~@dxos/echo/Annotation";
+var Key2 = Key;
+var make = makeUserAnnotation;
+var get2 = Function.dual(2, (target, annotation) => {
+  return get(target, annotation);
+});
+var set2 = Function.dual(3, (target, annotation, value) => {
+  return set(target, annotation, value);
+});
+var getFromAst2 = Function.dual(2, (ast, annotation) => {
+  return getFromAst(ast, annotation);
+});
+var Dictionary2 = Dictionary;
+var getDictionary2 = Function.dual(2, (values, annotation) => {
+  return getDictionary(values, annotation);
+});
+var setDictionary2 = Function.dual(3, (values, annotation, value) => {
+  return setDictionary(values, annotation, value);
+});
+
+export {
+  TypeId,
+  Key2 as Key,
+  make,
+  get2 as get,
+  set2 as set,
+  getFromAst2 as getFromAst,
+  Dictionary2 as Dictionary,
+  getDictionary2 as getDictionary,
+  setDictionary2 as setDictionary,
+  Annotation_exports
+};
+//# sourceMappingURL=chunk-3PBP4V4O.mjs.map

package/dist/lib/neutral/chunk-3PBP4V4O.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/Annotation.ts"],
+  "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\n// @import-as-namespace\n\nexport {\n  DescriptionAnnotation,\n  FieldLookupAnnotationId,\n  FormInputAnnotation,\n  FormInlineAnnotation,\n  GeneratorAnnotation,\n  GeneratorAnnotationId,\n  type GeneratorAnnotationValue,\n  LabelAnnotation,\n  ReferenceAnnotation,\n  ReferenceAnnotationId,\n  type ReferenceAnnotationValue,\n  HiddenAnnotation,\n  TypeAnnotation,\n  getDescriptionWithSchema,\n  getLabelWithSchema,\n  getTypeAnnotation,\n  getTypeIdentifierAnnotation,\n  setDescriptionWithSchema,\n  setLabelWithSchema,\n  IconAnnotation,\n  IconFromRefAnnotation,\n} from './internal/Annotation';\n\nimport * as Function from 'effect/Function';\nimport * as Option from 'effect/Option';\nimport * as Schema from 'effect/Schema';\nimport * as SchemaAST from 'effect/SchemaAST';\nimport * as Types from 'effect/Types';\n\nimport * as Entity from './Entity';\nimport * as internalAnnotations from './internal/Annotation';\n\nexport const TypeId = '~@dxos/echo/Annotation' as const;\nexport type TypeId = typeof TypeId;\n\n// TODO(dmaretskyi): Reconcile different get/set styles: mutate in-place, return.\n// TODO(dmaretskyi): Reconcile Annotation methods vs static functions.\n// TODO(dmaretskyi): Reconcile Annotation.Key vs DXN -- work-out approach to versioning.\n\n/**\n * Annotation is a typed property that can be assigned to a schema or an entity instance.\n */\nexport interface Annotation<T> {\n  [TypeId]: {\n    _Type: T;\n  };\n\n  // TODO(dmaretskyi): Make this a DXN?\n  /**\n   * Unique fully-qualified identifier for the annotation.\n   * @example \"org.dxos.annotation.color\"\n   */\n  readonly key: Key;\n\n  /**\n   * Schema of the annotation value.\n   */\n  readonly schema: Schema.Schema<T, unknown, never>;\n\n  /**\n   * Get the annotation value from an Effect schema.\n   *\n   * Only accepts `Schema.Schema.Any` — to read an annotation off a `Type.Type`\n   * entity, unwrap it first with `Type.getSchema(entity)`. This keeps the\n   * annotation pipeline single-shaped and forces annotations to live on the\n   * source schema, not on the post-construction Type entity.\n   */\n  get: (schema: Schema.Schema.Any) => Option.Option<T>;\n  /**\n   * Get the annotation value from the AST.\n   */\n  getFromAst: (ast: SchemaAST.AST) => Option.Option<T>;\n  /**\n   * Set the annotation on an Effect schema.\n   *\n   * Only accepts `Schema.Schema.Any` — annotations must be applied to the\n   * source schema BEFORE wrapping it with `Type.makeObject` / `Type.makeRelation`.\n   * In a pipe, place every `Annotation.X.set(...)` before the `Type.make...` step.\n   */\n  set: (value: T) => <S extends Schema.Schema.Any>(schema: S) => S;\n}\n\nexport const Key = internalAnnotations.Key;\nexport type Key = Schema.Schema.Type<typeof Key>;\n\ninterface MakeProps<T> {\n  id: string;\n  schema: Schema.Schema<T, any, never>;\n}\n\n/**\n * Create a new schema annotation.\n * Annotation can be assigned both to fields and to the schema itself.\n * Annotation is serialized with the schema.\n *\n * @example\n * ```ts\n * const ColorAnnotation = Annotation.make({\n *   id: 'org.dxos.annotation.color',\n *   schema: Schema.String,\n * });\n *\n * const schema = Schema.String.annotations(ColorAnnotation.set('red'));\n * ```\n */\nexport const make: <T>(props: MakeProps<T>) => Annotation<T> = internalAnnotations.makeUserAnnotation;\n\n/**\n * Get the value of an annotation from an entity instance or snapshot.\n * For schema-level reads use the annotation instance method (e.g. `ColorAnnotation.get(schema)`).\n * For getting an annotation value from a dictionary, use `getDictionary`.\n */\nexport const get: {\n  <T>(annotation: Annotation<T>): (target: Entity.Unknown | Entity.Snapshot) => Option.Option<T>;\n  <T>(target: Entity.Unknown | Entity.Snapshot, annotation: Annotation<T>): Option.Option<T>;\n} = Function.dual<\n  <T>(annotation: Annotation<T>) => (target: Entity.Unknown | Entity.Snapshot) => Option.Option<T>,\n  <T>(target: Entity.Unknown | Entity.Snapshot, annotation: Annotation<T>) => Option.Option<T>\n>(2, (target, annotation) => {\n  return internalAnnotations.get(target, annotation);\n});\n\n/**\n * Set the value of an annotation on an entity instance.\n * For schema-level writes use the annotation instance method (e.g. `ColorAnnotation.set('red')`).\n * For setting an annotation value on a dictionary, use `setDictionary`.\n */\nexport const set: {\n  <T>(annotation: Annotation<T>, value: T): (target: Entity.Mutable<Entity.Unknown>) => void;\n  <T>(target: Entity.Mutable<Entity.Unknown>, annotation: Annotation<T>, value: T): void;\n} = Function.dual<\n  <T>(annotation: Annotation<T>, value: T) => (target: Entity.Mutable<Entity.Unknown>) => void,\n  <T>(target: Entity.Mutable<Entity.Unknown>, annotation: Annotation<T>, value: T) => void\n>(3, (target, annotation, value) => {\n  return internalAnnotations.set(target, annotation, value);\n});\n\nexport const getFromAst: {\n  <T>(annotation: Annotation<T>): (ast: SchemaAST.AST) => Option.Option<T>;\n  <T>(ast: SchemaAST.AST, annotation: Annotation<T>): Option.Option<T>;\n} = Function.dual<\n  <T>(annotation: Annotation<T>) => (ast: SchemaAST.AST) => Option.Option<T>,\n  <T>(ast: SchemaAST.AST, annotation: Annotation<T>) => Option.Option<T>\n>(2, (ast, annotation) => {\n  return internalAnnotations.getFromAst(ast, annotation);\n});\n\n/**\n * Set of annotation values.\n *\n * Can be used inside an object/relation schema:\n *\n * ```ts\n * const Person = Schema.Struct({\n *   name: Schema.String,\n *   extensions: Annotation.Dictionary,\n * });\n * ```\n */\nexport const Dictionary = internalAnnotations.Dictionary;\nexport interface Dictionary extends Schema.Schema.Type<typeof Dictionary> {}\n\n/**\n * Get the value of an annotation from a Dictionary.\n */\nexport const getDictionary: {\n  <T>(annotation: Annotation<T>): (values: Dictionary) => Option.Option<T>;\n  <T>(values: Dictionary, annotation: Annotation<T>): Option.Option<T>;\n} = Function.dual<\n  <T>(annotation: Annotation<T>) => (values: Dictionary) => Option.Option<T>,\n  <T>(values: Dictionary, annotation: Annotation<T>) => Option.Option<T>\n>(2, (values, annotation) => {\n  return internalAnnotations.getDictionary(values, annotation);\n});\n\n/**\n * Set the value of an annotation in a Dictionary.\n *\n * Can also be used within Obj.update callback:\n *\n * ```ts\n * Obj.update(obj, (obj) => {\n *   Annotation.setDictionary(obj.annotations, ColorAnnotation, 'red');\n * });\n * ```\n */\nexport const setDictionary: {\n  <T>(annotation: Annotation<T>, value: T): (values: Dictionary) => void;\n  <T>(values: Types.Mutable<Dictionary>, annotation: Annotation<T>, value: T): void;\n} = Function.dual<\n  <T>(annotation: Annotation<T>, value: T) => (values: Dictionary) => void,\n  <T>(values: Types.Mutable<Dictionary>, annotation: Annotation<T>, value: T) => void\n>(3, (values, annotation, value) => {\n  return internalAnnotations.setDictionary(values, annotation, value);\n});\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;oBAAAA;EAAA;;;;;;;;aAAAC;EAAA;;;;;aAAAC;EAAA;uBAAAC;EAAA,kBAAAC;EAAA;;;;aAAAC;EAAA;uBAAAC;EAAA;;AA8BA,YAAYC,cAAc;AASnB,IAAMC,SAAS;AAkDf,IAAMC,OAA0BA;AAuBhC,IAAMC,OAAsEC;AAO5E,IAAMC,OAGAC,cAGX,GAAG,CAACC,QAAQC,eAAAA;AACZ,SAA2BH,IAAIE,QAAQC,UAAAA;AACzC,CAAA;AAOO,IAAMC,OAGAH,cAGX,GAAG,CAACC,QAAQC,YAAYE,UAAAA;AACxB,SAA2BD,IAAIF,QAAQC,YAAYE,KAAAA;AACrD,CAAA;AAEO,IAAMC,cAGAL,cAGX,GAAG,CAACM,KAAKJ,eAAAA;AACT,SAA2BG,WAAWC,KAAKJ,UAAAA;AAC7C,CAAA;AAcO,IAAMK,cAAiCA;AAMvC,IAAMC,iBAGAR,cAGX,GAAG,CAACS,QAAQP,eAAAA;AACZ,SAA2BM,cAAcC,QAAQP,UAAAA;AACnD,CAAA;AAaO,IAAMQ,iBAGAV,cAGX,GAAG,CAACS,QAAQP,YAAYE,UAAAA;AACxB,SAA2BM,cAAcD,QAAQP,YAAYE,KAAAA;AAC/D,CAAA;",
+  "names": ["Dictionary", "Key", "get", "getDictionary", "getFromAst", "set", "setDictionary", "Function", "TypeId", "Key", "make", "makeUserAnnotation", "get", "dual", "target", "annotation", "set", "value", "getFromAst", "ast", "Dictionary", "getDictionary", "values", "setDictionary"]
+}