@dxos/effect 0.8.4-main.5ea62a8 → 0.8.4-main.72ec0f3

package/dist/lib/browser/meta.json

@@ -1 +1 @@
-{"inputs":{"src/ast.ts":{"bytes":43345,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/jsonPath.ts":{"bytes":9719,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"jsonpath-plus","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/url.ts":{"bytes":7910,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/context.ts":{"bytes":1663,"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true}],"format":"esm"},"src/errors.ts":{"bytes":18775,"imports":[{"path":"effect","kind":"import-statement","external":true}],"format":"esm"},"src/testing.ts":{"bytes":4845,"imports":[{"path":"effect","kind":"import-statement","external":true}],"format":"esm"},"src/resource.ts":{"bytes":2161,"imports":[{"path":"effect","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":947,"imports":[{"path":"src/ast.ts","kind":"import-statement","original":"./ast"},{"path":"src/jsonPath.ts","kind":"import-statement","original":"./jsonPath"},{"path":"src/url.ts","kind":"import-statement","original":"./url"},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors"},{"path":"src/testing.ts","kind":"import-statement","original":"./testing"},{"path":"src/resource.ts","kind":"import-statement","original":"./resource"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":45355},"dist/lib/browser/index.mjs":{"imports":[{"path":"effect","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"jsonpath-plus","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true},{"path":"effect","kind":"import-statement","external":true}],"exports":["JsonPath","JsonProp","ParamKeyAnnotation","SimpleType","TestHelpers","UrlParser","VisitResult","accuireReleaseResource","causeToError","contextFromScope","createJsonPath","findAnnotation","findNode","findProperty","fromEffectValidationPath","getAnnotation","getDiscriminatedType","getDiscriminatingProps","getField","getParamKeyAnnotation","getSimpleType","isArrayType","isDiscriminatedUnion","isJsonPath","isLiteralUnion","isOption","isSimpleType","mapAst","promiseWithCauseCapture","runAndForwardErrors","splitJsonPath","throwCause","unwrapExit","visit"],"entryPoint":"src/index.ts","inputs":{"src/ast.ts":{"bytesInOutput":9247},"src/index.ts":{"bytesInOutput":0},"src/jsonPath.ts":{"bytesInOutput":1862},"src/url.ts":{"bytesInOutput":1916},"src/context.ts":{"bytesInOutput":370},"src/errors.ts":{"bytesInOutput":3689},"src/testing.ts":{"bytesInOutput":680},"src/resource.ts":{"bytesInOutput":372}},"bytes":18932}}}
+{"inputs":{"src/ast.ts":{"bytes":45961,"imports":[{"path":"effect/Function","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/jsonPath.ts":{"bytes":9966,"imports":[{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"jsonpath-plus","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true}],"format":"esm"},"src/url.ts":{"bytes":7881,"imports":[{"path":"effect/Function","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true}],"format":"esm"},"src/context.ts":{"bytes":1719,"imports":[{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true}],"format":"esm"},"src/errors.ts":{"bytes":19285,"imports":[{"path":"effect/Cause","kind":"import-statement","external":true},{"path":"effect/Chunk","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Exit","kind":"import-statement","external":true},{"path":"effect/GlobalValue","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true}],"format":"esm"},"src/testing.ts":{"bytes":6498,"imports":[{"path":"effect/Context","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true}],"format":"esm"},"src/resource.ts":{"bytes":2356,"imports":[{"path":"effect/Effect","kind":"import-statement","external":true}],"format":"esm"},"src/index.ts":{"bytes":947,"imports":[{"path":"src/ast.ts","kind":"import-statement","original":"./ast"},{"path":"src/jsonPath.ts","kind":"import-statement","original":"./jsonPath"},{"path":"src/url.ts","kind":"import-statement","original":"./url"},{"path":"src/context.ts","kind":"import-statement","original":"./context"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors"},{"path":"src/testing.ts","kind":"import-statement","original":"./testing"},{"path":"src/resource.ts","kind":"import-statement","original":"./resource"}],"format":"esm"}},"outputs":{"dist/lib/browser/index.mjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":47701},"dist/lib/browser/index.mjs":{"imports":[{"path":"effect/Function","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/Schema","kind":"import-statement","external":true},{"path":"jsonpath-plus","kind":"import-statement","external":true},{"path":"@dxos/invariant","kind":"import-statement","external":true},{"path":"effect/Function","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/SchemaAST","kind":"import-statement","external":true},{"path":"@dxos/util","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"@dxos/context","kind":"import-statement","external":true},{"path":"effect/Cause","kind":"import-statement","external":true},{"path":"effect/Chunk","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Exit","kind":"import-statement","external":true},{"path":"effect/GlobalValue","kind":"import-statement","external":true},{"path":"effect/Option","kind":"import-statement","external":true},{"path":"effect/Context","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true},{"path":"effect/Effect","kind":"import-statement","external":true}],"exports":["JsonPath","JsonProp","ParamKeyAnnotation","SimpleType","TestContextService","TestHelpers","UrlParser","VisitResult","acquireReleaseResource","causeToError","contextFromScope","createJsonPath","findAnnotation","findNode","findProperty","fromEffectValidationPath","getAnnotation","getDiscriminatedType","getDiscriminatingProps","getField","getParamKeyAnnotation","getSimpleType","isArrayType","isDiscriminatedUnion","isJsonPath","isLiteralUnion","isOption","isSimpleType","mapAst","promiseWithCauseCapture","runAndForwardErrors","splitJsonPath","throwCause","unwrapExit","visit"],"entryPoint":"src/index.ts","inputs":{"src/ast.ts":{"bytesInOutput":9947},"src/index.ts":{"bytesInOutput":0},"src/jsonPath.ts":{"bytesInOutput":1883},"src/url.ts":{"bytesInOutput":1693},"src/context.ts":{"bytesInOutput":378},"src/errors.ts":{"bytesInOutput":3847},"src/testing.ts":{"bytesInOutput":926},"src/resource.ts":{"bytesInOutput":370}},"bytes":19880}}}

package/dist/lib/node-esm/index.mjs

@@ -1,17 +1,19 @@
 import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 
 // src/ast.ts
-import { Option, Schema, SchemaAST, pipe } from "effect";
-import { isUndefinedKeyword } from "effect/SchemaAST";
+import * as Function from "effect/Function";
+import * as Option from "effect/Option";
+import * as Schema from "effect/Schema";
+import * as SchemaAST from "effect/SchemaAST";
 import { invariant } from "@dxos/invariant";
 import { isNonNullable } from "@dxos/util";
 var __dxlog_file = "/__w/dxos/dxos/packages/common/effect/src/ast.ts";
-var isTupleType = (node) => {
+var isTupleType2 = (node) => {
   return SchemaAST.isTupleType(node) && node.elements.length > 0;
 };
 var getSimpleType = (node) => {
   if (SchemaAST.isDeclaration(node) || SchemaAST.isObjectKeyword(node) || SchemaAST.isTypeLiteral(node) || // TODO(wittjosiah): Tuples are actually arrays.
-  isTupleType(node) || isDiscriminatedUnion(node)) {
+  isTupleType2(node) || isDiscriminatedUnion(node)) {
     return "object";
   }
   if (SchemaAST.isStringKeyword(node)) {
@@ -52,12 +54,12 @@ var isSimpleType = (node) => !!getSimpleType(node);
     }
   };
 })(SimpleType || (SimpleType = {}));
-var VisitResult = /* @__PURE__ */ function(VisitResult2) {
+var VisitResult = /* @__PURE__ */ (function(VisitResult2) {
   VisitResult2[VisitResult2["CONTINUE"] = 0] = "CONTINUE";
   VisitResult2[VisitResult2["SKIP"] = 1] = "SKIP";
   VisitResult2[VisitResult2["EXIT"] = 2] = "EXIT";
   return VisitResult2;
-}({});
+})({});
 var defaultTest = isSimpleType;
 var visit = (node, testOrVisitor, visitor) => {
   if (!visitor) {
@@ -121,6 +123,12 @@ var findNode = (node, test) => {
         return child;
       }
     }
+    for (const prop of getIndexSignatures(node)) {
+      const child = findNode(prop.type, test);
+      if (child) {
+        return child;
+      }
+    }
   } else if (SchemaAST.isTupleType(node)) {
     for (const [_, element] of node.elements.entries()) {
       const child = findNode(element.type, test);
@@ -129,12 +137,13 @@ var findNode = (node, test) => {
       }
     }
   } else if (SchemaAST.isUnion(node)) {
-    if (isOption(node)) {
-      for (const type of node.types) {
-        const child = findNode(type, test);
-        if (child) {
-          return child;
-        }
+    if (isLiteralUnion(node)) {
+      return void 0;
+    }
+    for (const type of node.types) {
+      const child = findNode(type, test);
+      if (child) {
+        return child;
       }
     }
   } else if (SchemaAST.isRefinement(node)) {
@@ -147,7 +156,7 @@ var findProperty = (schema, path) => {
     const typeNode = findNode(node, SchemaAST.isTypeLiteral);
     invariant(typeNode, void 0, {
       F: __dxlog_file,
-      L: 255,
+      L: 265,
       S: void 0,
       A: [
         "typeNode",
@@ -172,16 +181,16 @@ var defaultAnnotations = {
   ["NumberKeyword"]: SchemaAST.numberKeyword,
   ["BooleanKeyword"]: SchemaAST.booleanKeyword
 };
-var getAnnotation = (annotationId, noDefault = true) => (node) => {
-  const id = pipe(SchemaAST.getIdentifierAnnotation(node), Option.getOrUndefined);
-  const value = pipe(SchemaAST.getAnnotation(annotationId)(node), Option.getOrUndefined);
+var getAnnotation2 = (annotationId, noDefault = true) => (node) => {
+  const id = Function.pipe(SchemaAST.getIdentifierAnnotation(node), Option.getOrUndefined);
+  const value = Function.pipe(SchemaAST.getAnnotation(annotationId)(node), Option.getOrUndefined);
   if (noDefault && (value === defaultAnnotations[node._tag]?.annotations[annotationId] || value === id)) {
     return void 0;
   }
   return value;
 };
 var findAnnotation = (node, annotationId, noDefault = true) => {
-  const getAnnotationById = getAnnotation(annotationId, noDefault);
+  const getAnnotationById = getAnnotation2(annotationId, noDefault);
   const getBaseAnnotation = (node2) => {
     const value = getAnnotationById(node2);
     if (value !== void 0) {
@@ -207,7 +216,7 @@ var isDiscriminatedUnion = (node) => {
 var getDiscriminatingProps = (node) => {
   invariant(SchemaAST.isUnion(node), void 0, {
     F: __dxlog_file,
-    L: 352,
+    L: 362,
     S: void 0,
     A: [
       "SchemaAST.isUnion(node)",
@@ -225,7 +234,7 @@ var getDiscriminatingProps = (node) => {
 var getDiscriminatedType = (node, value = {}) => {
   invariant(SchemaAST.isUnion(node), void 0, {
     F: __dxlog_file,
-    L: 376,
+    L: 386,
     S: void 0,
     A: [
       "SchemaAST.isUnion(node)",
@@ -234,7 +243,7 @@ var getDiscriminatedType = (node, value = {}) => {
   });
   invariant(value, void 0, {
     F: __dxlog_file,
-    L: 377,
+    L: 387,
     S: void 0,
     A: [
       "value",
@@ -249,7 +258,7 @@ var getDiscriminatedType = (node, value = {}) => {
     const match = SchemaAST.getPropertySignatures(type).filter((prop) => props?.includes(prop.name.toString())).every((prop) => {
       invariant(SchemaAST.isLiteral(prop.type), void 0, {
         F: __dxlog_file,
-        L: 388,
+        L: 398,
         S: void 0,
         A: [
           "SchemaAST.isLiteral(prop.type)",
@@ -267,7 +276,7 @@ var getDiscriminatedType = (node, value = {}) => {
       const literal = SchemaAST.getPropertySignatures(type).find((p) => p.name.toString() === prop);
       invariant(SchemaAST.isLiteral(literal.type), void 0, {
         F: __dxlog_file,
-        L: 406,
+        L: 416,
         S: void 0,
         A: [
           "SchemaAST.isLiteral(literal.type)",
@@ -287,7 +296,7 @@ var getDiscriminatedType = (node, value = {}) => {
 var mapAst = (ast, f) => {
   switch (ast._tag) {
     case "TypeLiteral": {
-      return new SchemaAST.TypeLiteral(ast.propertySignatures.map((prop) => new SchemaAST.PropertySignature(prop.name, f(prop.type, prop.name), prop.isOptional, prop.isReadonly, prop.annotations)), ast.indexSignatures);
+      return new SchemaAST.TypeLiteral(ast.propertySignatures.map((prop) => new SchemaAST.PropertySignature(prop.name, f(prop.type, prop.name), prop.isOptional, prop.isReadonly, prop.annotations)), ast.indexSignatures, ast.annotations);
     }
     case "Union": {
       return SchemaAST.Union.make(ast.types.map(f), ast.annotations);
@@ -305,12 +314,28 @@ var mapAst = (ast, f) => {
   }
 };
 var isArrayType = (node) => {
-  return SchemaAST.isTupleType(node) || SchemaAST.isUnion(node) && node.types.some(isArrayType) && node.types.some(isUndefinedKeyword) && node.types.length === 2;
+  return SchemaAST.isTupleType(node) || SchemaAST.isUnion(node) && node.types.some(isArrayType) && node.types.some(SchemaAST.isUndefinedKeyword) && node.types.length === 2;
+};
+var getIndexSignatures = (ast) => {
+  const annotation = SchemaAST.getSurrogateAnnotation(ast);
+  if (Option.isSome(annotation)) {
+    return getIndexSignatures(annotation.value);
+  }
+  switch (ast._tag) {
+    case "TypeLiteral":
+      return ast.indexSignatures.slice();
+    case "Suspend":
+      return getIndexSignatures(ast.f());
+    case "Refinement":
+      return getIndexSignatures(ast.from);
+  }
+  return [];
 };
 var SimpleType;
 
 // src/jsonPath.ts
-import { Option as Option2, Schema as Schema2 } from "effect";
+import * as Option2 from "effect/Option";
+import * as Schema2 from "effect/Schema";
 import { JSONPath } from "jsonpath-plus";
 import { invariant as invariant2 } from "@dxos/invariant";
 var __dxlog_file2 = "/__w/dxos/dxos/packages/common/effect/src/jsonPath.ts";
@@ -336,7 +361,7 @@ var createJsonPath = (path) => {
   }).join("");
   invariant2(isJsonPath(candidatePath), `Invalid JsonPath: ${candidatePath}`, {
     F: __dxlog_file2,
-    L: 63,
+    L: 65,
     S: void 0,
     A: [
       "isJsonPath(candidatePath)",
@@ -349,7 +374,7 @@ var fromEffectValidationPath = (effectPath) => {
   const jsonPath = effectPath.replace(/\.\[(\d+)\]/g, "[$1]");
   invariant2(isJsonPath(jsonPath), `Invalid JsonPath: ${jsonPath}`, {
     F: __dxlog_file2,
-    L: 74,
+    L: 76,
     S: void 0,
     A: [
       "isJsonPath(jsonPath)",
@@ -372,27 +397,20 @@ var getField = (object, path) => {
 };
 
 // src/url.ts
-import { Option as Option3, SchemaAST as SchemaAST2, pipe as pipe2 } from "effect";
+import * as Function2 from "effect/Function";
+import * as Option3 from "effect/Option";
+import * as SchemaAST2 from "effect/SchemaAST";
 import { decamelize } from "@dxos/util";
-function _define_property(obj, key, value) {
-  if (key in obj) {
-    Object.defineProperty(obj, key, {
-      value,
-      enumerable: true,
-      configurable: true,
-      writable: true
-    });
-  } else {
-    obj[key] = value;
-  }
-  return obj;
-}
 var ParamKeyAnnotationId = Symbol.for("@dxos/schema/annotation/ParamKey");
 var getParamKeyAnnotation = SchemaAST2.getAnnotation(ParamKeyAnnotationId);
 var ParamKeyAnnotation = (value) => (self) => self.annotations({
   [ParamKeyAnnotationId]: value
 });
 var UrlParser = class {
+  _schema;
+  constructor(_schema) {
+    this._schema = _schema;
+  }
   /**
   * Parse URL params.
   */
@@ -424,7 +442,7 @@ var UrlParser = class {
       if (value !== void 0) {
         const field = this._schema.fields[key];
         if (field) {
-          const { key: serializedKey } = pipe2(getParamKeyAnnotation(field.ast), Option3.getOrElse(() => ({
+          const { key: serializedKey } = Function2.pipe(getParamKeyAnnotation(field.ast), Option3.getOrElse(() => ({
             key: decamelize(key)
           })));
           url.searchParams.set(serializedKey, String(value));
@@ -433,27 +451,28 @@ var UrlParser = class {
     });
     return url;
   }
-  constructor(_schema) {
-    _define_property(this, "_schema", void 0);
-    this._schema = _schema;
-  }
 };
 
 // src/context.ts
-import { Effect } from "effect";
+import * as Effect from "effect/Effect";
 import { Context } from "@dxos/context";
 var __dxlog_file3 = "/__w/dxos/dxos/packages/common/effect/src/context.ts";
 var contextFromScope = () => Effect.gen(function* () {
   const ctx = new Context(void 0, {
     F: __dxlog_file3,
-    L: 12
+    L: 13
   });
   yield* Effect.addFinalizer(() => Effect.promise(() => ctx.dispose()));
   return ctx;
 });
 
 // src/errors.ts
-import { Cause, Chunk, Effect as Effect2, Exit, GlobalValue, Option as Option4 } from "effect";
+import * as Cause from "effect/Cause";
+import * as Chunk from "effect/Chunk";
+import * as Effect2 from "effect/Effect";
+import * as Exit from "effect/Exit";
+import * as GlobalValue from "effect/GlobalValue";
+import * as Option4 from "effect/Option";
 var spanSymbol = Symbol.for("effect/SpanAnnotation");
 var originalSymbol = Symbol.for("effect/OriginalAnnotation");
 var spanToTrace = GlobalValue.globalValue("effect/Tracer/spanToTrace", () => /* @__PURE__ */ new WeakMap());
@@ -525,9 +544,9 @@ var prettyErrorStack = (error, appendStacks = []) => {
 };
 var causeToError = (cause) => {
   if (Cause.isEmpty(cause)) {
-    throw new Error("Fiber failed without a cause");
+    return new Error("Fiber failed without a cause");
   } else if (Cause.isInterruptedOnly(cause)) {
-    throw new Error("Fiber was interrupted");
+    return new Error("Fiber was interrupted");
   } else {
     const errors = [
       ...Chunk.toArray(Cause.failures(cause)),
@@ -541,9 +560,9 @@ var causeToError = (cause) => {
     const stackFrames = getStackFrames();
     const newErrors = errors.map((error) => prettyErrorStack(error, stackFrames));
     if (newErrors.length === 1) {
-      throw newErrors[0];
+      return newErrors[0];
     } else {
-      throw new AggregateError(newErrors);
+      return new AggregateError(newErrors);
     }
   }
 };
@@ -570,7 +589,8 @@ var promiseWithCauseCapture = (evaluate) => Effect2.promise(async (signal) => {
 }).pipe(Effect2.flatten);
 
 // src/testing.ts
-import { Effect as Effect3 } from "effect";
+import * as Context2 from "effect/Context";
+import * as Effect3 from "effect/Effect";
 (function(TestHelpers2) {
   TestHelpers2.runIf = (condition) => (effect, ctx) => Effect3.gen(function* () {
     if (!condition) {
@@ -593,12 +613,15 @@ import { Effect as Effect3 } from "effect";
       return yield* effect;
     }
   });
+  TestHelpers2.provideTestContext = (effect, ctx) => Effect3.provideService(effect, TestContextService, ctx);
 })(TestHelpers || (TestHelpers = {}));
+var TestContextService = class extends Context2.Tag("@dxos/effect/TestContextService")() {
+};
 var TestHelpers;
 
 // src/resource.ts
-import { Effect as Effect4 } from "effect";
-var accuireReleaseResource = (getResource) => Effect4.acquireRelease(Effect4.gen(function* () {
+import * as Effect4 from "effect/Effect";
+var acquireReleaseResource = (getResource) => Effect4.acquireRelease(Effect4.gen(function* () {
   const resource = getResource();
   yield* Effect4.promise(async () => {
     resource.open?.();
@@ -614,10 +637,11 @@ export {
   JsonProp,
   ParamKeyAnnotation,
   SimpleType,
+  TestContextService,
   TestHelpers,
   UrlParser,
   VisitResult,
-  accuireReleaseResource,
+  acquireReleaseResource,
   causeToError,
   contextFromScope,
   createJsonPath,
@@ -625,7 +649,7 @@ export {
   findNode,
   findProperty,
   fromEffectValidationPath,
-  getAnnotation,
+  getAnnotation2 as getAnnotation,
   getDiscriminatedType,
   getDiscriminatingProps,
   getField,