@content-collections/core 0.1.0

package/src/writer.ts

@@ -0,0 +1,113 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import pluralize from "pluralize";
+import { TransformedCollection } from "./transformer";
+import { InternalConfiguration } from "./configurationReader";
+
+function createArrayConstName(name: string) {
+  let suffix = name.charAt(0).toUpperCase() + name.slice(1);
+  return "all" + pluralize(suffix);
+}
+
+type DataFileCollection = Pick<TransformedCollection, "name" | "documents">;
+
+async function createDataFile(
+  directory: string,
+  collection: DataFileCollection
+) {
+  const dataPath = path.join(
+    directory,
+    `${createArrayConstName(collection.name)}.json`
+  );
+
+  await fs.writeFile(
+    dataPath,
+    JSON.stringify(
+      collection.documents.map((doc) => doc.document),
+      null,
+      2
+    )
+  );
+}
+
+function createDataFiles(
+  directory: string,
+  collections: Array<DataFileCollection>
+) {
+  return Promise.all(
+    collections.map((collection) => createDataFile(directory, collection))
+  );
+}
+
+type JavaScriptFileConfiguration = {
+  collections: Array<Pick<TransformedCollection, "name">>;
+};
+
+async function createJavaScriptFile(
+  directory: string,
+  configuration: JavaScriptFileConfiguration
+) {
+  const collections = configuration.collections.map(({ name }) =>
+    createArrayConstName(name)
+  );
+
+  let content = `// generated by content-collections at ${new Date()}\n\n`;
+  for (const name of collections) {
+    content += `import ${name} from "./${name}.json";\n`;
+  }
+  content += "\n";
+  content += "export { " + collections.join(", ") + " };\n";
+
+  await fs.writeFile(path.join(directory, "index.js"), content, "utf-8");
+}
+
+type TypeDefinitionFileConfiguration = Pick<
+  InternalConfiguration,
+  "path" | "generateTypes"
+> & {
+  collections: Array<Pick<TransformedCollection, "name" | "typeName">>;
+};
+
+async function createTypeDefinitionFile(
+  directory: string,
+  configuration: TypeDefinitionFileConfiguration
+) {
+  if (!configuration.generateTypes) {
+    return;
+  }
+
+  const importPath = path.relative(directory, configuration.path);
+  let content = `import configuration from "${importPath}";
+import { GetTypeByName } from "@content-collections/core";
+`;
+
+  const collections = configuration.collections;
+  for (const collection of collections) {
+    content += `\n`;
+    content += `export type ${collection.typeName} = GetTypeByName<typeof configuration, "${collection.name}">;\n`;
+    content += `export declare const ${createArrayConstName(
+      collection.name
+    )}: Array<${collection.typeName}>;\n`;
+  }
+
+  content += "\n";
+  // https://github.com/microsoft/TypeScript/issues/38592
+  content += "export {};\n";
+
+  await fs.writeFile(path.join(directory, "index.d.ts"), content, "utf-8");
+}
+
+export async function createWriter(directory: string) {
+  await fs.mkdir(directory, { recursive: true });
+  return {
+    createJavaScriptFile: (configuration: JavaScriptFileConfiguration) =>
+      createJavaScriptFile(directory, configuration),
+    createTypeDefinitionFile: (
+      configuration: TypeDefinitionFileConfiguration
+    ) => createTypeDefinitionFile(directory, configuration),
+    createDataFiles: (collections: Array<DataFileCollection>) =>
+      createDataFiles(directory, collections),
+  };
+}
+
+export type Writer = Awaited<ReturnType<typeof createWriter>>;

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    /* Base Options: */
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "target": "es2022",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "moduleDetection": "force",
+    "isolatedModules": true,
+    /* Strictness */
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    /* If NOT transpiling with TypeScript: */
+    "moduleResolution": "Bundler",
+    "module": "ESNext",
+    "noEmit": true,
+    /* If your code doesn't run in the DOM: */
+    "lib": ["es2022"],
+
+    "baseUrl": ".",
+    "paths": {
+      "@content-collections/core": ["./src"]
+    },
+  },
+  "include": ["src/**/*"]
+}

package/vite.config.ts

@@ -0,0 +1,24 @@
+import { defineConfig } from "vitest/config";
+
+const excludes = [
+  "**/node_modules/**",
+  "**/tmp/**",
+  "**/.content-collections/**",
+  "**/__tests__/**",
+  "**/types.ts",
+];
+
+if (process.env.ENABLE_WATCHER_TESTS !== "true") {
+  excludes.push("**/watcher.ts");
+}
+
+export default defineConfig({
+  test: {
+    coverage: {
+      exclude: excludes
+    },
+    poolMatchGlobs: [
+      ["**/watcher.test.ts", "forks"],
+    ],
+  },
+});