@cedarjs/structure 0.0.4

package/dist/model/RWCell.js

@@ -0,0 +1,111 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RWCell = void 0;
+var _getOwnPropertyDescriptor = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/object/get-own-property-descriptor"));
+var _applyDecoratedDescriptor2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/applyDecoratedDescriptor"));
+var _graphql = require("graphql");
+var tsm = _interopRequireWildcard(require("ts-morph"));
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _decorators = require("../x/decorators");
+var _vscodeLanguageserverTypes2 = require("../x/vscode-languageserver-types");
+var _RWComponent = require("./RWComponent");
+var _dec, _dec2, _dec3, _dec4, _dec5, _class;
+let RWCell = exports.RWCell = (_dec = (0, _decorators.lazy)(), _dec2 = (0, _decorators.lazy)(), _dec3 = (0, _decorators.lazy)(), _dec4 = (0, _decorators.lazy)(), _dec5 = (0, _decorators.lazy)(), _class = class RWCell extends _RWComponent.RWComponent {
+  /**
+   * A "Cell" is a component that ends in `Cell.{js, jsx, tsx}`, has no
+   * default export AND exports `QUERY`
+   **/
+  get isCell() {
+    return !this.hasDefaultExport && this.exportedSymbols.has('QUERY');
+  }
+
+  // TODO: Move to RWCellQuery
+  get queryStringNode() {
+    const i = this.sf.getVariableDeclaration('QUERY')?.getInitializer();
+    if (!i) {
+      return undefined;
+    }
+    // TODO: do we allow other kinds of strings? or just tagged literals?
+    if (tsm.Node.isTaggedTemplateExpression(i)) {
+      const t = i.getTemplate();
+      if (tsm.Node.isNoSubstitutionTemplateLiteral(t)) {
+        return t;
+      }
+    }
+    return undefined;
+  }
+
+  // TODO: Move to RWCellQuery
+  get queryString() {
+    return this.queryStringNode?.getLiteralText();
+  }
+
+  // TODO: Move to RWCellQuery
+  get queryAst() {
+    const qs = this.queryString;
+    if (!qs) {
+      return undefined;
+    }
+    try {
+      return (0, _graphql.parse)(qs);
+    } catch (e) {
+      console.error("Can't parse the graphql query string in", this.filePath);
+      console.error(e);
+      return undefined;
+    }
+  }
+
+  // TODO: Move to RWCellQuery
+  get queryOperationName() {
+    const ast = this.queryAst;
+    if (!ast) {
+      return undefined;
+    }
+    for (const def of ast.definitions) {
+      if (def.kind == _graphql.Kind.OPERATION_DEFINITION) {
+        return def?.name?.value;
+      }
+    }
+    return undefined;
+  }
+  *diagnostics() {
+    // check that QUERY and Success are exported
+    if (!this.exportedSymbols.has('QUERY')) {
+      yield (0, _vscodeLanguageserverTypes2.err)(this.uri, 'Every Cell MUST export a QUERY variable (GraphQL query string)');
+    }
+    try {
+      if (!this.queryOperationName) {
+        yield {
+          uri: this.uri,
+          diagnostic: {
+            range: (0, _vscodeLanguageserverTypes2.Range_fromNode)(this.queryStringNode),
+            message: 'We recommend that you name your query operation',
+            severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Warning
+          }
+        };
+      }
+    } catch (e) {
+      // Maybe the AST has a syntax error...
+      yield {
+        uri: this.uri,
+        diagnostic: {
+          // TODO: Try to figure out if we can point directly to the syntax error.
+          range: (0, _vscodeLanguageserverTypes2.Range_fromNode)(this.sf.getVariableDeclaration('QUERY')),
+          message: e.message,
+          severity: _vscodeLanguageserverTypes.DiagnosticSeverity.Error
+        }
+      };
+    }
+
+    // TODO: check that exported QUERY is semantically valid GraphQL (fields exist)
+    if (!this.exportedSymbols.has('Success')) {
+      yield (0, _vscodeLanguageserverTypes2.err)(this.uri, 'Every Cell MUST export a Success variable (React Component)');
+    }
+  }
+}, (0, _applyDecoratedDescriptor2.default)(_class.prototype, "isCell", [_dec], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "isCell"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "queryStringNode", [_dec2], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "queryStringNode"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "queryString", [_dec3], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "queryString"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "queryAst", [_dec4], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "queryAst"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "queryOperationName", [_dec5], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "queryOperationName"), _class.prototype), _class);

package/dist/model/RWComponent.d.ts

@@ -0,0 +1,11 @@
+import { FileNode } from '../ide';
+import type { RWProject } from './RWProject';
+export declare class RWComponent extends FileNode {
+    filePath: string;
+    parent: RWProject;
+    constructor(filePath: string, parent: RWProject);
+    get hasDefaultExport(): boolean;
+    get stories(): never[];
+    get exportedSymbols(): Set<string>;
+}
+//# sourceMappingURL=RWComponent.d.ts.map

package/dist/model/RWComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RWComponent.d.ts","sourceRoot":"","sources":["../../src/model/RWComponent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,qBAAa,WAAY,SAAQ,QAAQ;IAE9B,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,SAAS;gBADjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS;IAK1B,IAAY,gBAAgB,IAAI,OAAO,CAKtC;IAED,IAAY,OAAO,YAIlB;IAED,IAAY,eAAe,gBAW1B;CACF"}

package/dist/model/RWComponent.js

@@ -0,0 +1,42 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RWComponent = void 0;
+var _set = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/set"));
+var _getOwnPropertyDescriptor = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/object/get-own-property-descriptor"));
+var _applyDecoratedDescriptor2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/applyDecoratedDescriptor"));
+var tsm = _interopRequireWildcard(require("ts-morph"));
+var _ide = require("../ide");
+var _decorators = require("../x/decorators");
+var _dec, _dec2, _dec3, _class;
+let RWComponent = exports.RWComponent = (_dec = (0, _decorators.lazy)(), _dec2 = (0, _decorators.lazy)(), _dec3 = (0, _decorators.lazy)(), _class = class RWComponent extends _ide.FileNode {
+  constructor(filePath, parent) {
+    super();
+    this.filePath = filePath;
+    this.parent = parent;
+  }
+  get hasDefaultExport() {
+    // TODO: Is this enough to test a default export?
+    return this.sf.getDescendantsOfKind(tsm.SyntaxKind.ExportAssignment).length > 0;
+  }
+  get stories() {
+    // TODO: this is a placeholder
+    // we could list all the (storybook) stories related to this component here
+    return [];
+  }
+  get exportedSymbols() {
+    // KLUDGE!
+    const ss = new _set.default();
+    for (const d of this.sf.getDescendantsOfKind(tsm.SyntaxKind.VariableDeclaration)) {
+      if (d.isExported()) {
+        ss.add(d.getName());
+      }
+    }
+    return ss;
+  }
+}, (0, _applyDecoratedDescriptor2.default)(_class.prototype, "hasDefaultExport", [_dec], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "hasDefaultExport"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "stories", [_dec2], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "stories"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "exportedSymbols", [_dec3], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "exportedSymbols"), _class.prototype), _class);

package/dist/model/RWEnvHelper.d.ts

@@ -0,0 +1,64 @@
+import type * as tsm from 'ts-morph';
+import type { Location } from 'vscode-languageserver';
+import type { CodeLensX, Definition, HoverX, Reference } from '../ide';
+import { BaseNode } from '../ide';
+import type { ExtendedDiagnostic } from '../x/vscode-languageserver-types';
+import type { RWProject } from './RWProject';
+type EnvVarMap = Record<string, string>;
+export declare class RWEnvHelper extends BaseNode {
+    parent: RWProject;
+    constructor(parent: RWProject);
+    get id(): string;
+    bailOutOnCollection(): boolean;
+    /**
+     * parse .env
+     * return undefined if not present
+     * NOTE: It does not apply defaults (see env_merged)
+     */
+    get env(): EnvVarMap | undefined;
+    /**
+     * .env.defaults
+     * return undefined if not present
+     */
+    get env_defaults(): EnvVarMap | undefined;
+    get api_prisma_env(): import("dotenv").DotenvParseOutput | undefined;
+    /**
+     * .env.defaults + .env
+     * uses the same algorithm that env-defaults does (Object.assign(), which is equivalent to object spread addition)
+     */
+    get env_default_merged(): EnvVarMap;
+    /**
+     * - starts with .env + .env.defaults
+     * - allows any variables prefixed with 'REDWOOD_ENV_'
+     * - applies the "include" rule on the rest
+     * @param include
+     */
+    private env_default_merged_filtered;
+    private _dotenv;
+    get env_available_to_api(): EnvVarMap;
+    get env_available_to_web(): EnvVarMap;
+    children(): ProcessDotEnvExpression[];
+    get process_env_expressions(): ProcessDotEnvExpression[];
+}
+/**
+ * An occurrence of process.env somewhere in the codebase
+ */
+declare class ProcessDotEnvExpression extends BaseNode {
+    parent: RWEnvHelper;
+    kind: 'api' | 'web' | 'prisma';
+    key: string;
+    node: tsm.Node | Location;
+    constructor(parent: RWEnvHelper, kind: 'api' | 'web' | 'prisma', key: string, node: tsm.Node | Location);
+    bailOutOnCollection(uri: string): boolean;
+    get id(): string;
+    get side(): "api" | "web";
+    get location(): Location;
+    ideInfo(): Generator<Definition | Reference | CodeLensX | HoverX, void, unknown>;
+    diagnostics(): Generator<ExtendedDiagnostic, void, unknown>;
+    get value_definition_file_basename(): ".env" | ".env.defaults" | undefined;
+    get value_definition_location(): Location | undefined;
+    get value_as_available(): string;
+    private render;
+}
+export {};
+//# sourceMappingURL=RWEnvHelper.d.ts.map

package/dist/model/RWEnvHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RWEnvHelper.d.ts","sourceRoot":"","sources":["../../src/model/RWEnvHelper.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAA;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAKjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAO1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAG5C,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEvC,qBAAa,WAAY,SAAQ,QAAQ;IACpB,MAAM,EAAE,SAAS;gBAAjB,MAAM,EAAE,SAAS;IAIpC,IAAY,EAAE,WAGb;IAED,mBAAmB;IAMnB;;;;OAIG;IACH,IAAY,GAAG,IAAI,SAAS,GAAG,SAAS,CAEvC;IAED;;;OAGG;IACH,IAAY,YAAY,IAAI,SAAS,GAAG,SAAS,CAEhD;IAED,IAAY,cAAc,mDAEzB;IAED;;;OAGG;IACH,IAAY,kBAAkB,IAAI,SAAS,CAE1C;IAED;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAOnC,OAAO,CAAC,OAAO;IAQf,IAAY,oBAAoB,cAM/B;IAED,IAAY,oBAAoB,cAI/B;IAED,QAAQ;IAIR,IAAY,uBAAuB,8BAgBlC;CACF;AAED;;GAEG;AACH,cAAM,uBAAwB,SAAQ,QAAQ;IAEnC,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ;IAC9B,GAAG,EAAE,MAAM;IACX,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,QAAQ;gBAHzB,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,QAAQ,EAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,GAAG,CAAC,IAAI,GAAG,QAAQ;IAKlC,mBAAmB,CAAC,GAAG,EAAE,MAAM;IAO/B,IAAY,EAAE,WAIb;IAED,IAAY,IAAI,kBAEf;IAED,IAAY,QAAQ,aAEnB;IAEA,OAAO;IAQP,WAAW;IAQZ,IAAY,8BAA8B,yCAYzC;IAED,IAAY,yBAAyB,IAAI,QAAQ,GAAG,SAAS,CAa5D;IAED,IAAY,kBAAkB,WAM7B;IAED,OAAO,CAAE,MAAM;CA+FhB"}

package/dist/model/RWEnvHelper.js

@@ -0,0 +1,295 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js/object/define-property");
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+var _interopRequireWildcard = require("@babel/runtime-corejs3/helpers/interopRequireWildcard").default;
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RWEnvHelper = void 0;
+var _startsWith = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/instance/starts-with"));
+var _includes = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/instance/includes"));
+var _bind = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/instance/bind"));
+var _map = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/instance/map"));
+var _from = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/array/from"));
+var _getOwnPropertyDescriptor = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/object/get-own-property-descriptor"));
+var _findIndex = _interopRequireDefault(require("@babel/runtime-corejs3/core-js/instance/find-index"));
+var _applyDecoratedDescriptor2 = _interopRequireDefault(require("@babel/runtime-corejs3/helpers/applyDecoratedDescriptor"));
+var _path = require("path");
+var dotenv = _interopRequireWildcard(require("dotenv-defaults"));
+var _fsExtra = require("fs-extra");
+var _lodash = require("lodash");
+var _vscodeLanguageserver = require("vscode-languageserver");
+var _ide = require("../ide");
+var _decorators = require("../x/decorators");
+var _prisma = require("../x/prisma");
+var _URL = require("../x/URL");
+var _vscode = require("../x/vscode");
+var _vscodeLanguageserverTypes = require("../x/vscode-languageserver-types");
+var _process_env = require("./util/process_env");
+var _dec, _dec2, _dec3, _dec4, _dec5, _dec6, _dec7, _dec8, _class, _dec9, _dec10, _dec11, _dec12, _dec13, _dec14, _class2;
+let RWEnvHelper = exports.RWEnvHelper = (_dec = (0, _decorators.lazy)(), _dec2 = (0, _decorators.lazy)(), _dec3 = (0, _decorators.lazy)(), _dec4 = (0, _decorators.lazy)(), _dec5 = (0, _decorators.lazy)(), _dec6 = (0, _decorators.lazy)(), _dec7 = (0, _decorators.lazy)(), _dec8 = (0, _decorators.lazy)(), _class = class RWEnvHelper extends _ide.BaseNode {
+  constructor(parent) {
+    super();
+    this.parent = parent;
+  }
+  get id() {
+    // this is an internal node. it is not associated to any particular file
+    return this.parent.id + ' envHelper';
+  }
+  bailOutOnCollection() {
+    // we need this node to participate in all collection requests
+    // because it will emit info and diagnostics for files all over the codebase
+    return false;
+  }
+
+  /**
+   * parse .env
+   * return undefined if not present
+   * NOTE: It does not apply defaults (see env_merged)
+   */
+  get env() {
+    return this._dotenv('.env');
+  }
+
+  /**
+   * .env.defaults
+   * return undefined if not present
+   */
+  get env_defaults() {
+    return this._dotenv('.env.defaults');
+  }
+  get api_prisma_env() {
+    return this._dotenv('api/prisma/.env');
+  }
+
+  /**
+   * .env.defaults + .env
+   * uses the same algorithm that env-defaults does (Object.assign(), which is equivalent to object spread addition)
+   */
+  get env_default_merged() {
+    return {
+      ...(this.env_defaults ?? {}),
+      ...(this.env ?? {})
+    };
+  }
+
+  /**
+   * - starts with .env + .env.defaults
+   * - allows any variables prefixed with 'REDWOOD_ENV_'
+   * - applies the "include" rule on the rest
+   * @param include
+   */
+  env_default_merged_filtered(include) {
+    return (0, _lodash.pickBy)(this.env_default_merged, (_v, k) => {
+      var _context, _context2;
+      return (0, _startsWith.default)(k).call(k, 'REDWOOD_ENV_') || ((_context = include) == null ? void 0 : (0, _bind.default)(_context2 = Function.call).call(_context2, (0, _includes.default)(_context), _context))?.(k);
+    });
+  }
+  _dotenv(f) {
+    const file = (0, _path.join)(this.parent.projectRoot, f);
+    if (!(0, _fsExtra.existsSync)(file)) {
+      return undefined;
+    }
+    return dotenv.parse((0, _fsExtra.readFileSync)(file, 'utf-8'));
+  }
+  get env_available_to_api() {
+    // in the API side, all variables are visible
+    return this.env_default_merged;
+    // return this.env_merged_filter(
+    //   this.parent.redwoodTOML.api_includeEnvironmentVariables ?? []
+    // )
+  }
+  get env_available_to_web() {
+    return this.env_default_merged_filtered(this.parent.redwoodTOML.web_includeEnvironmentVariables ?? []);
+  }
+  children() {
+    return [...this.process_env_expressions];
+  }
+  get process_env_expressions() {
+    var _context3, _context4;
+    // TODO: make this async (this is globbing around quite a bit)
+    const {
+      pathHelper
+    } = this.parent;
+    const api = (0, _map.default)(_context3 = (0, _process_env.process_env_findAll)(pathHelper.api.base)).call(_context3, x => new ProcessDotEnvExpression(this, 'api', x.key, x.node));
+    const web = (0, _map.default)(_context4 = (0, _process_env.process_env_findAll)(pathHelper.web.base)).call(_context4, x => new ProcessDotEnvExpression(this, 'web', x.key, x.node));
+    const prisma = (0, _from.default)((0, _prisma.prisma_parseEnvExpressionsInFile)(pathHelper.api.dbSchema));
+    const pp = (0, _map.default)(prisma).call(prisma, x => new ProcessDotEnvExpression(this, 'prisma', x.key, x.location));
+    return [...api, ...web, ...pp];
+  }
+}, (0, _applyDecoratedDescriptor2.default)(_class.prototype, "id", [_dec], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "id"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "env", [_dec2], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "env"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "env_defaults", [_dec3], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "env_defaults"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "api_prisma_env", [_dec4], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "api_prisma_env"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "env_default_merged", [_dec5], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "env_default_merged"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "env_available_to_api", [_dec6], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "env_available_to_api"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "env_available_to_web", [_dec7], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "env_available_to_web"), _class.prototype), (0, _applyDecoratedDescriptor2.default)(_class.prototype, "process_env_expressions", [_dec8], (0, _getOwnPropertyDescriptor.default)(_class.prototype, "process_env_expressions"), _class.prototype), _class);
+/**
+ * An occurrence of process.env somewhere in the codebase
+ */
+let ProcessDotEnvExpression = (_dec9 = (0, _decorators.lazy)(), _dec10 = (0, _decorators.lazy)(), _dec11 = (0, _decorators.lazy)(), _dec12 = (0, _decorators.lazy)(), _dec13 = (0, _decorators.lazy)(), _dec14 = (0, _decorators.lazy)(), _class2 = class ProcessDotEnvExpression extends _ide.BaseNode {
+  constructor(parent, kind, key, node) {
+    super();
+    this.parent = parent;
+    this.kind = kind;
+    this.key = key;
+    this.node = node;
+  }
+  bailOutOnCollection(uri) {
+    if (this.location.uri !== uri) {
+      return true;
+    }
+    return false;
+  }
+  get id() {
+    // this is an internal node. it is not associated to any particular file
+    // we just need to make sure the ID is unique and correctly nested
+    return this.parent.id + ' ' + (0, _vscodeLanguageserverTypes.LocationLike_toHashLink)(this.location);
+  }
+  get side() {
+    return this.kind === 'web' ? 'web' : 'api';
+  }
+  get location() {
+    return (0, _vscodeLanguageserverTypes.LocationLike_toLocation)(this.node);
+  }
+  *ideInfo() {
+    for (const x of this.render()) {
+      if (!(0, _vscodeLanguageserverTypes.ExtendedDiagnostic_is)(x)) {
+        yield x;
+      }
+    }
+  }
+  *diagnostics() {
+    for (const x of this.render()) {
+      if ((0, _vscodeLanguageserverTypes.ExtendedDiagnostic_is)(x)) {
+        yield x;
+      }
+    }
+  }
+  get value_definition_file_basename() {
+    const {
+      key,
+      parent: {
+        env,
+        env_defaults
+      }
+    } = this;
+    if (env?.[key]) {
+      return '.env';
+    }
+    if (env_defaults?.[key]) {
+      return '.env.defaults';
+    }
+    return undefined;
+  }
+  get value_definition_location() {
+    const x = this.value_definition_file_basename;
+    if (!x) {
+      return undefined;
+    }
+    const file = (0, _path.join)(this.parent.parent.projectRoot, x);
+    const content = (0, _fsExtra.readFileSync)(file).toString();
+    const lines = content.split('\n');
+    const index = (0, _findIndex.default)(lines).call(lines, l => (0, _startsWith.default)(l).call(l, this.key + '='));
+    return {
+      uri: (0, _URL.URL_file)(file),
+      range: _vscodeLanguageserver.Range.create(index, 0, index, lines[index].length)
+    };
+  }
+  get value_as_available() {
+    if (this.side === 'web') {
+      return this.parent.env_available_to_web[this.key];
+    }
+    const v = this.parent.env_available_to_api[this.key];
+    return v;
+  }
+  *render() {
+    const {
+      key,
+      location,
+      value_as_available
+    } = this;
+    const {
+      uri,
+      range
+    } = location;
+
+    // show reference to value definition
+    if (this.value_definition_location) {
+      yield {
+        kind: 'Reference',
+        location,
+        target: this.value_definition_location
+      };
+      yield {
+        kind: 'Definition',
+        location,
+        target: this.value_definition_location
+      };
+    }
+    // show hover with the actual value, if present
+    if (typeof value_as_available !== 'undefined') {
+      yield {
+        kind: 'Hover',
+        location,
+        hover: {
+          range: location.range,
+          contents: `${key}=${value_as_available} (${this.value_definition_file_basename ?? ''})`
+        }
+      };
+      if (typeof value_as_available !== 'undefined' && this.value_definition_location) {
+        const title = `${key}=${value_as_available}`;
+        const command = {
+          ...(0, _vscode.Command_open)(this.value_definition_location),
+          title
+        };
+        const codelens = {
+          kind: 'CodeLens',
+          location,
+          codeLens: {
+            range,
+            command
+          }
+        };
+        // TODO: we need to add middleware to the LSP client
+        // so the uri (string) is converted to a vscode.Uri
+        // https://github.com/microsoft/vscode-languageserver-node/issues/495
+        // eslint-disable-next-line no-constant-condition
+        if (false) {
+          yield codelens;
+        }
+      }
+    }
+    if (typeof value_as_available === 'undefined') {
+      // the value is not available
+      // there are a few scenarios here...
+      if (this.parent.env_default_merged[key]) {
+        // value is actually in the merged env, but it is not visible here
+        // this is probably because the user forgot to add an includeEnvironmentVariables rule
+        const snippet = `
+[${this.side}]
+  includeEnvironmentVariables = ['${this.key}']`;
+        yield {
+          uri,
+          diagnostic: {
+            range,
+            message: `
+This env variable is present in '${this.value_definition_file_basename}',
+but it won't be available to your app in production *unless* you add it to includeEnvironmentVariables.
+Tip: add the following to your redwood.toml:
+${snippet}
+            `,
+            severity: _vscodeLanguageserver.DiagnosticSeverity.Warning
+            // TODO: quickFix
+          }
+        };
+      } else {
+        // the value is simply not visible
+        yield {
+          uri,
+          diagnostic: {
+            range,
+            message: `env value ${key} is not available. add it to your .env file`,
+            severity: _vscodeLanguageserver.DiagnosticSeverity.Warning
+            // TODO: add a quickfix?
+          }
+        };
+      }
+    }
+  }
+}, (0, _applyDecoratedDescriptor2.default)(_class2.prototype, "id", [_dec9], (0, _getOwnPropertyDescriptor.default)(_class2.prototype, "id"), _class2.prototype), (0, _applyDecoratedDescriptor2.default)(_class2.prototype, "side", [_dec10], (0, _getOwnPropertyDescriptor.default)(_class2.prototype, "side"), _class2.prototype), (0, _applyDecoratedDescriptor2.default)(_class2.prototype, "location", [_dec11], (0, _getOwnPropertyDescriptor.default)(_class2.prototype, "location"), _class2.prototype), (0, _applyDecoratedDescriptor2.default)(_class2.prototype, "value_definition_file_basename", [_dec12], (0, _getOwnPropertyDescriptor.default)(_class2.prototype, "value_definition_file_basename"), _class2.prototype), (0, _applyDecoratedDescriptor2.default)(_class2.prototype, "value_definition_location", [_dec13], (0, _getOwnPropertyDescriptor.default)(_class2.prototype, "value_definition_location"), _class2.prototype), (0, _applyDecoratedDescriptor2.default)(_class2.prototype, "value_as_available", [_dec14], (0, _getOwnPropertyDescriptor.default)(_class2.prototype, "value_as_available"), _class2.prototype), _class2);

package/dist/model/RWFunction.d.ts

@@ -0,0 +1,11 @@
+import { FileNode } from '../ide';
+import type { RWProject } from './RWProject';
+/**
+ * functions exist in the /functions folder
+ */
+export declare class RWFunction extends FileNode {
+    filePath: string;
+    parent: RWProject;
+    constructor(filePath: string, parent: RWProject);
+}
+//# sourceMappingURL=RWFunction.d.ts.map

package/dist/model/RWFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RWFunction.d.ts","sourceRoot":"","sources":["../../src/model/RWFunction.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C;;GAEG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IAE7B,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,SAAS;gBADjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS;CAI3B"}

package/dist/model/RWFunction.js

@@ -0,0 +1,19 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js/object/define-property");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RWFunction = void 0;
+var _ide = require("../ide");
+/**
+ * functions exist in the /functions folder
+ */
+class RWFunction extends _ide.FileNode {
+  constructor(filePath, parent) {
+    super();
+    this.filePath = filePath;
+    this.parent = parent;
+  }
+}
+exports.RWFunction = RWFunction;

package/dist/model/RWLayout.d.ts

@@ -0,0 +1,11 @@
+import { FileNode } from '../ide';
+import type { RWProject } from './RWProject';
+/**
+ * layouts live in the src/layouts folder
+ */
+export declare class RWLayout extends FileNode {
+    filePath: string;
+    parent: RWProject;
+    constructor(filePath: string, parent: RWProject);
+}
+//# sourceMappingURL=RWLayout.d.ts.map

package/dist/model/RWLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RWLayout.d.ts","sourceRoot":"","sources":["../../src/model/RWLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C;;GAEG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IAE3B,QAAQ,EAAE,MAAM;IAChB,MAAM,EAAE,SAAS;gBADjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,SAAS;CAI3B"}

package/dist/model/RWLayout.js

@@ -0,0 +1,19 @@
+"use strict";
+
+var _Object$defineProperty = require("@babel/runtime-corejs3/core-js/object/define-property");
+_Object$defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.RWLayout = void 0;
+var _ide = require("../ide");
+/**
+ * layouts live in the src/layouts folder
+ */
+class RWLayout extends _ide.FileNode {
+  constructor(filePath, parent) {
+    super();
+    this.filePath = filePath;
+    this.parent = parent;
+  }
+}
+exports.RWLayout = RWLayout;

package/dist/model/RWPage.d.ts

@@ -0,0 +1,13 @@
+import { FileNode } from '../ide';
+import type { RWProject } from './RWProject';
+export declare class RWPage extends FileNode {
+    constName: string;
+    path: string;
+    parent: RWProject;
+    constructor(constName: string, path: string, parent: RWProject);
+    get filePath(): string;
+    get route(): import("./RWRoute").RWRoute | undefined;
+    get layoutName(): string | undefined;
+    get actionRemove(): Map<any, any>;
+}
+//# sourceMappingURL=RWPage.d.ts.map

package/dist/model/RWPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RWPage.d.ts","sourceRoot":"","sources":["../../src/model/RWPage.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,qBAAa,MAAO,SAAQ,QAAQ;IAEzB,SAAS,EAAE,MAAM;IACjB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,SAAS;gBAFjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS;IAI1B,IAAY,QAAQ,WAEnB;IACD,IAAY,KAAK,4CAIhB;IACD,IAAY,UAAU,IAAI,MAAM,GAAG,SAAS,CAc3C;IACD,IAAY,YAAY,kBAUvB;CACF"}