@cedarjs/cli 6.0.0 → 7.0.0-canary.2982

package/dist/commands/experimental/setupStreamingSsrHandler.js

@@ -183,7 +183,7 @@ You'll manually need to merge it with your existing entry.client${ext} file.`;
           fs.writeFileSync(pkgJsonPath, JSON.stringify(pkgJson, null, 2));
         }
       },
-      addWebPackages(["@apollo/client-react-streaming@0.10.0"]),
+      addWebPackages(["@apollo/client-react-streaming@0.14.5"]),
       {
         task: () => {
           printTaskEpilogue(command, description, EXPERIMENTAL_TOPIC_ID);

package/dist/commands/generate/cell/cell.js

@@ -22,6 +22,26 @@ const builder = createBuilder({
         default: "",
         description: "Use to enforce a specific query name within the generated cell - must be unique.",
         type: "string"
+      },
+      beforeQuery: {
+        default: false,
+        description: "Include a typed `beforeQuery` stub for configuring the query (e.g. variables, fetch policy).",
+        type: "boolean"
+      },
+      afterQuery: {
+        default: false,
+        description: "Include a typed `afterQuery` stub for sanitizing data returned from the query.",
+        type: "boolean"
+      },
+      isEmpty: {
+        default: false,
+        description: "Include a typed `isEmpty` stub for overriding the default check for the Empty component.",
+        type: "boolean"
+      },
+      fragment: {
+        default: "",
+        description: "Generate a fragment cell (exports FRAGMENT instead of QUERY) that reads its data from a parent Cell, given the GraphQL type it selects from - e.g. --fragment User.",
+        type: "string"
       }
     };
   }

package/dist/commands/generate/cell/cellHandler.js

@@ -26,7 +26,11 @@ const files = async ({
   list = false,
   query,
   stories,
-  tests
+  tests,
+  beforeQuery = false,
+  afterQuery = false,
+  isEmpty = false,
+  fragment = ""
 }) => {
   let cellName = removeGeneratorName(name, "cell");
   let idName = "id";
@@ -35,22 +39,49 @@ const files = async ({
   let model = null;
   let templateNameSuffix = "";
   let typeName = cellName;
-  const shouldGenerateList = (isWordPluralizable(cellName) ? isPlural(cellName) : list) || list;
-  try {
-    model = await getSchema(pascalcase(singularize(cellName)));
-    idName = getIdName(model);
-    idType = getIdType(model);
-    typeName = model.name;
-    mockIdValues = idType === "String" ? mockIdValues.map((value) => `'${value}'`) : mockIdValues;
-  } catch {
-    idType = "Int";
+  if (fragment) {
+    if (list) {
+      throw new Error(
+        "The --list flag cannot be combined with --fragment; fragment cells always render a single item."
+      );
+    }
+    if (beforeQuery) {
+      throw new Error(
+        "The --before-query flag cannot be combined with --fragment; fragment cells never fire a query of their own."
+      );
+    }
+    if (query) {
+      throw new Error(
+        "The --query flag cannot be combined with --fragment; fragment cells don't have an operation name."
+      );
+    }
+  }
+  const shouldGenerateList = !fragment && ((isWordPluralizable(cellName) ? isPlural(cellName) : list) || list);
+  if (!fragment) {
+    try {
+      model = await getSchema(pascalcase(singularize(cellName)));
+      idName = getIdName(model);
+      idType = getIdType(model);
+      typeName = model.name;
+      mockIdValues = idType === "String" ? mockIdValues.map((value) => `'${value}'`) : mockIdValues;
+    } catch {
+      idType = "Int";
+    }
   }
   if (shouldGenerateList) {
     cellName = forcePluralizeWord(cellName);
     templateNameSuffix = "List";
   }
   let operationName = query;
-  if (operationName) {
+  let fragmentName;
+  let fragmentOnType;
+  let fragmentPropName;
+  if (fragment) {
+    const fragmentTypeVariants = nameVariants(fragment);
+    fragmentOnType = fragmentTypeVariants.pascalName;
+    fragmentPropName = fragmentTypeVariants.camelName;
+    fragmentName = `${nameVariants(cellName).pascalName}Cell_${fragmentPropName}`;
+  } else if (operationName) {
     const userSpecifiedOperationNameIsUnique = await operationNameIsUnique(operationName);
     if (!userSpecifiedOperationNameIsUnique) {
       throw new Error(`Specified query name: "${operationName}" is not unique!`);
@@ -67,11 +98,20 @@ const files = async ({
     extension,
     webPathSection: CEDAR_WEB_PATH_NAME,
     generator: "cell",
-    templatePath: `cell${templateNameSuffix}.tsx.template`,
-    templateVars: {
+    templatePath: fragment ? "cellFragment.tsx.template" : `cell${templateNameSuffix}.tsx.template`,
+    templateVars: fragment ? {
+      fragmentName,
+      fragmentOnType,
+      camelName: fragmentPropName,
+      afterQuery,
+      isEmpty
+    } : {
       operationName,
       idName,
-      idType
+      idType,
+      beforeQuery,
+      afterQuery,
+      isEmpty
     }
   });
   const testFile = await templateForComponentFile({
@@ -80,8 +120,8 @@ const files = async ({
     extension: `.test${extension}`,
     webPathSection: CEDAR_WEB_PATH_NAME,
     generator: "cell",
-    templatePath: "test.js.template",
-    templateVars: {
+    templatePath: fragment ? "testFragment.js.template" : "test.js.template",
+    templateVars: fragment ? { camelName: fragmentPropName } : {
       idName: shouldGenerateList ? void 0 : idName,
       mockIdValues: shouldGenerateList ? void 0 : mockIdValues
     }
@@ -92,7 +132,7 @@ const files = async ({
     extension: `.stories${extension}`,
     webPathSection: CEDAR_WEB_PATH_NAME,
     generator: "cell",
-    templatePath: "stories.tsx.template"
+    templatePath: fragment ? "storiesFragment.tsx.template" : "stories.tsx.template"
   });
   const mockFile = await templateForComponentFile({
     name: cellName,
@@ -101,7 +141,12 @@ const files = async ({
     webPathSection: CEDAR_WEB_PATH_NAME,
     generator: "cell",
     templatePath: `mock${templateNameSuffix}.ts.template`,
-    templateVars: {
+    templateVars: fragment ? {
+      idName,
+      mockIdValues,
+      typeName: fragmentOnType,
+      camelName: fragmentPropName
+    } : {
       idName,
       mockIdValues,
       typeName
@@ -122,7 +167,10 @@ const files = async ({
 const handler = createHandler({
   componentName: "cell",
   filesFn: files,
-  includeAdditionalTasks: ({ name: cellName }) => {
+  includeAdditionalTasks: ({
+    name: cellName,
+    fragment
+  }) => {
     return [
       {
         title: `Generating types ...`,
@@ -130,7 +178,7 @@ const handler = createHandler({
           const queryFieldName = nameVariants(
             removeGeneratorName(cellName, "cell")
           ).camelName;
-          const projectHasSdl = await checkProjectForQueryField(queryFieldName);
+          const projectHasSdl = Boolean(fragment) || await checkProjectForQueryField(queryFieldName);
           if (projectHasSdl) {
             const { errors } = await generateTypes();
             for (const { message, error } of errors) {

package/dist/commands/generate/cell/templates/cell.tsx.template

@@ -6,7 +6,9 @@ import type {
 import type {
   CellSuccessProps,
   CellFailureProps,
-  TypedDocumentNode,
+  TypedDocumentNode,<% if (beforeQuery) { %>
+  CellBeforeQueryResult,<% } %><% if (afterQuery || isEmpty) { %>
+  DataObject,<% } %>
 } from '@cedarjs/web'
 
 export const QUERY: TypedDocumentNode<
@@ -19,7 +21,24 @@ export const QUERY: TypedDocumentNode<
     }
   }
 `
-
+<% if (beforeQuery) { %>
+export const beforeQuery = (
+  props: ${operationName}Variables,
+): CellBeforeQueryResult<${operationName}Variables> => {
+  return { variables: props, fetchPolicy: 'cache-and-network' }
+}
+<% } %><% if (isEmpty) { %>
+export const isEmpty = (
+  data: DataObject,
+  { isDataEmpty }: { isDataEmpty: (data: DataObject) => boolean },
+) => {
+  return isDataEmpty(data)
+}
+<% } %><% if (afterQuery) { %>
+export const afterQuery = (data: DataObject): DataObject => {
+  return data
+}
+<% } %>
 export const Loading = () => <div>Loading...</div>
 
 export const Empty = () => <div>Empty</div>

package/dist/commands/generate/cell/templates/cellList.tsx.template

@@ -3,7 +3,9 @@ import type { ${operationName}, ${operationName}Variables  } from 'types/graphql
 import type {
   CellSuccessProps,
   CellFailureProps,
-  TypedDocumentNode,
+  TypedDocumentNode,<% if (beforeQuery) { %>
+  CellBeforeQueryResult,<% } %><% if (afterQuery || isEmpty) { %>
+  DataObject,<% } %>
 } from '@cedarjs/web'
 
 export const QUERY: TypedDocumentNode<
@@ -16,7 +18,24 @@ export const QUERY: TypedDocumentNode<
     }
   }
 `
-
+<% if (beforeQuery) { %>
+export const beforeQuery = (
+  props: ${operationName}Variables,
+): CellBeforeQueryResult<${operationName}Variables> => {
+  return { variables: props, fetchPolicy: 'cache-and-network' }
+}
+<% } %><% if (isEmpty) { %>
+export const isEmpty = (
+  data: DataObject,
+  { isDataEmpty }: { isDataEmpty: (data: DataObject) => boolean },
+) => {
+  return isDataEmpty(data)
+}
+<% } %><% if (afterQuery) { %>
+export const afterQuery = (data: DataObject): DataObject => {
+  return data
+}
+<% } %>
 export const Loading = () => <div>Loading...</div>
 
 export const Empty = () => <div>Empty</div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cedarjs/cli",
-  "version": "6.0.0",
+  "version": "7.0.0-canary.2982",
   "description": "The CedarJS Command Line",
   "repository": {
     "type": "git",
@@ -36,17 +36,17 @@
     "@babel/preset-typescript": "7.29.7",
     "@babel/traverse": "7.29.8",
     "@babel/types": "7.29.8",
-    "@cedarjs/api-server": "6.0.0",
-    "@cedarjs/babel-config": "6.0.0",
-    "@cedarjs/cli-helpers": "6.0.0",
-    "@cedarjs/internal": "6.0.0",
-    "@cedarjs/prerender": "6.0.0",
-    "@cedarjs/project-config": "6.0.0",
-    "@cedarjs/structure": "6.0.0",
-    "@cedarjs/telemetry": "6.0.0",
-    "@cedarjs/utils": "6.0.0",
-    "@cedarjs/vite": "6.0.0",
-    "@cedarjs/web-server": "6.0.0",
+    "@cedarjs/api-server": "7.0.0-canary.2982",
+    "@cedarjs/babel-config": "7.0.0-canary.2982",
+    "@cedarjs/cli-helpers": "7.0.0-canary.2982",
+    "@cedarjs/internal": "7.0.0-canary.2982",
+    "@cedarjs/prerender": "7.0.0-canary.2982",
+    "@cedarjs/project-config": "7.0.0-canary.2982",
+    "@cedarjs/structure": "7.0.0-canary.2982",
+    "@cedarjs/telemetry": "7.0.0-canary.2982",
+    "@cedarjs/utils": "7.0.0-canary.2982",
+    "@cedarjs/vite": "7.0.0-canary.2982",
+    "@cedarjs/web-server": "7.0.0-canary.2982",
     "@listr2/prompt-adapter-enquirer": "4.3.0",
     "@opentelemetry/api": "1.9.1",
     "@opentelemetry/core": "1.30.1",
@@ -94,7 +94,7 @@
     "yargs": "17.7.3"
   },
   "devDependencies": {
-    "@cedarjs/framework-tools": "6.0.0",
+    "@cedarjs/framework-tools": "7.0.0-canary.2982",
     "@prisma/dmmf": "7.8.0",
     "@types/archiver": "^7.0.0",
     "memfs": "4.68.1",

package/dist/commands/lintPreflight.js

@@ -1,133 +0,0 @@
-import fs from "node:fs";
-import path from "node:path";
-import { colors } from "@cedarjs/cli-helpers";
-import { formatAddRootPackagesCommand } from "@cedarjs/cli-helpers/packageManager/display";
-import { getPaths } from "@cedarjs/project-config";
-const FLAT_CONFIG_FILENAMES = [
-  "eslint.config.js",
-  "eslint.config.mjs",
-  "eslint.config.cjs",
-  "eslint.config.ts",
-  "eslint.config.mts",
-  "eslint.config.cts"
-];
-const LEGACY_CONFIG_FILENAMES = [
-  ".eslintrc",
-  ".eslintrc.js",
-  ".eslintrc.cjs",
-  ".eslintrc.mjs",
-  ".eslintrc.json",
-  ".eslintrc.yaml",
-  ".eslintrc.yml"
-];
-const MIGRATION_GUIDE_URL = "https://github.com/cedarjs/cedar/blob/main/packages/eslint-config/README.md#migrating-from-legacy-eslintrcjs-config";
-function findFlatConfig(base) {
-  return FLAT_CONFIG_FILENAMES.map(
-    (filename) => path.join(base, filename)
-  ).find((configPath) => fs.existsSync(configPath));
-}
-function readRootPackageJson(base) {
-  try {
-    const contents = fs.readFileSync(path.join(base, "package.json"), "utf-8");
-    const parsed = JSON.parse(contents);
-    if (parsed && typeof parsed === "object") {
-      return parsed;
-    }
-    return void 0;
-  } catch {
-    return void 0;
-  }
-}
-function hasLegacyConfig(base, packageJson) {
-  const hasLegacyConfigFile = LEGACY_CONFIG_FILENAMES.some(
-    (filename) => fs.existsSync(path.join(base, filename))
-  );
-  return hasLegacyConfigFile || Boolean(packageJson?.["eslintConfig"]);
-}
-function listsEslintConfigPackage(packageJson) {
-  return ["dependencies", "devDependencies"].some((field) => {
-    const deps = packageJson[field];
-    return deps !== null && typeof deps === "object" && "@cedarjs/eslint-config" in deps;
-  });
-}
-async function formatAddConfigPackageCommand() {
-  let version = "";
-  try {
-    const packageJson = await import("../../package.json", { with: { type: "json" } });
-    version = "@" + packageJson.default.version;
-  } catch {
-  }
-  try {
-    return formatAddRootPackagesCommand(
-      ["@cedarjs/eslint-config" + version],
-      true
-    );
-  } catch {
-    return "yarn add -D @cedarjs/eslint-config" + version;
-  }
-}
-async function legacyConfigMessage(packageJson) {
-  const needsConfigPackage = !packageJson || !listsEslintConfigPackage(packageJson);
-  return [
-    colors.error("Cedar no longer supports ESLint's legacy config format"),
-    "",
-    "Support for `.eslintrc.*` and the `eslintConfig` field in package.json",
-    "was removed in v6. Create an `eslint.config.mjs` in your project root",
-    '(`eslint.config.js` if your project is ESM, i.e. has `"type": "module"`):',
-    "",
-    colors.tip("  import cedarConfig from '@cedarjs/eslint-config'"),
-    "",
-    colors.tip("  export default await cedarConfig()"),
-    "",
-    "Then delete your `.eslintrc.*` file and remove the `eslintConfig` field",
-    "from package.json, moving any custom rules you had into an extra config",
-    "object after `cedarConfig()`.",
-    ...needsConfigPackage ? [
-      "",
-      "You'll also need `@cedarjs/eslint-config` itself, which is no longer",
-      "installed for you:",
-      "",
-      colors.tip("  " + await formatAddConfigPackageCommand())
-    ] : [],
-    "",
-    "Full migration guide: " + colors.link(MIGRATION_GUIDE_URL)
-  ].join("\n");
-}
-async function missingConfigPackageMessage(flatConfigPath) {
-  return [
-    colors.error("Cannot find `@cedarjs/eslint-config`"),
-    "",
-    `Your ${path.basename(flatConfigPath)} uses \`@cedarjs/eslint-config\`, but`,
-    "the package isn't listed in your project's package.json. As of v6,",
-    "`@cedarjs/core` no longer depends on it, so projects have to declare it",
-    "themselves:",
-    "",
-    colors.tip("  " + await formatAddConfigPackageCommand()),
-    "",
-    colors.info(
-      "`@cedarjs/eslint-config` brings its own ESLint, so you do not need to add `eslint` separately."
-    )
-  ].join("\n");
-}
-async function getEslintSetupError() {
-  const base = getPaths().base;
-  const packageJson = readRootPackageJson(base);
-  const flatConfigPath = findFlatConfig(base);
-  if (!flatConfigPath) {
-    if (!hasLegacyConfig(base, packageJson)) {
-      return void 0;
-    }
-    return legacyConfigMessage(packageJson);
-  }
-  if (!packageJson || listsEslintConfigPackage(packageJson)) {
-    return void 0;
-  }
-  const flatConfig = fs.readFileSync(flatConfigPath, "utf-8");
-  if (!flatConfig.includes("@cedarjs/eslint-config")) {
-    return void 0;
-  }
-  return missingConfigPackageMessage(flatConfigPath);
-}
-export {
-  getEslintSetupError
-};