create-foldkit-app 0.27.1 → 0.27.3

package/dist/commands/create.js

@@ -84,9 +84,9 @@ const setupProject = (name, projectPath, scaffold, packageManager) => Effect.gen
     yield* Console.log(chalk.green(`✅ Created project`));
     yield* Console.log('');
 });
-const installProjectDependencies = (projectPath, packageManager, scaffold) => Effect.gen(function* () {
+const installProjectDependencies = (projectPath, packageManager, scaffold, maybeDependencyManifestsDirectory) => Effect.gen(function* () {
     yield* Console.log(chalk.blue(`📦 Installing dependencies with ${packageManager}...`));
-    yield* installDependencies(projectPath, packageManager, scaffold);
+    yield* installDependencies(projectPath, packageManager, scaffold, maybeDependencyManifestsDirectory);
     yield* Console.log(chalk.green('✅ Dependencies installed'));
     yield* Console.log('');
 });
@@ -132,10 +132,14 @@ const displaySuccessMessage = (name, packageManager) => Effect.gen(function* ()
 export const create = (input) => Effect.gen(function* () {
     const { name, scaffold, packageManager } = yield* resolveInput(input);
     const path = yield* Path.Path;
+    if (Option.isSome(input.maybeDependencyManifestsDirectory) &&
+        !path.isAbsolute(input.maybeDependencyManifestsDirectory.value)) {
+        return yield* Effect.fail('CREATE_FOLDKIT_APP_DEPENDENCY_MANIFESTS_DIRECTORY must be an absolute path.');
+    }
     const projectPath = path.resolve(name);
     yield* validateProject(name, projectPath, packageManager);
     yield* setupProject(name, projectPath, scaffold, packageManager);
-    yield* installProjectDependencies(projectPath, packageManager, scaffold);
+    yield* installProjectDependencies(projectPath, packageManager, scaffold, input.maybeDependencyManifestsDirectory);
     yield* displaySuccessMessage(name, packageManager);
     return name;
 });

package/dist/index.js

@@ -23,12 +23,13 @@ const packageManager = Flag.choice('package-manager', [
     'yarn',
     'bun',
 ]).pipe(Flag.withAlias('p'), Flag.withDescription('The package manager to use for installing dependencies'), Flag.optional);
+const maybeDependencyManifestsDirectory = Option.fromNullishOr(process.env['CREATE_FOLDKIT_APP_DEPENDENCY_MANIFESTS_DIRECTORY']);
 const create = Command.make('create', {
     name,
     rendering,
     example,
     packageManager,
-}, create_).pipe(Command.withDescription('Create a new Foldkit application'));
+}, input => create_({ ...input, maybeDependencyManifestsDirectory })).pipe(Command.withDescription('Create a new Foldkit application'));
 const cli = Command.run(create, {
     version: packageJson.version,
 });

package/dist/utils/packages.js

@@ -1,4 +1,4 @@
-import { Array, Data, Effect, FileSystem, Match, Order, Path, Record, Result, Schema, pipe, } from 'effect';
+import { Array, Data, Effect, FileSystem, Match, Option, Order, Path, Record, Result, Schema, pipe, } from 'effect';
 import { HttpClient, HttpClientRequest } from 'effect/unstable/http';
 import { spawn } from 'node:child_process';
 export const installCommand = (packageManager) => `${packageManager} install`;
@@ -122,6 +122,15 @@ const fetchExamplePackageJson = (example) => Effect.gen(function* () {
     const json = yield* response.json;
     return yield* Schema.decodeUnknownEffect(PackageJson)(json);
 });
+const readExamplePackageJson = (example, maybeDependencyManifestsDirectory) => Option.match(maybeDependencyManifestsDirectory, {
+    onNone: () => fetchExamplePackageJson(example),
+    onSome: directory => Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        const path = yield* Path.Path;
+        const content = yield* fs.readFileString(path.join(directory, example, 'package.json'));
+        return yield* Schema.decodeUnknownEffect(PackageJson)(JSON.parse(content));
+    }),
+});
 const writeManifest = (projectPath, dependencies, devDependencies) => Effect.gen(function* () {
     const fs = yield* FileSystem.FileSystem;
     const path = yield* Path.Path;
@@ -159,8 +168,8 @@ const runCommand = (command, args, cwd) => Effect.callback((resume) => {
         }
     });
 });
-export const installDependencies = (projectPath, packageManager, scaffold) => Effect.gen(function* () {
-    const examplePackageJson = yield* fetchExamplePackageJson(dependencyExample(scaffold));
+export const installDependencies = (projectPath, packageManager, scaffold, maybeDependencyManifestsDirectory) => Effect.gen(function* () {
+    const examplePackageJson = yield* readExamplePackageJson(dependencyExample(scaffold), maybeDependencyManifestsDirectory);
     const dependencies = yield* resolveSpecs(buildUnresolvedDeps(examplePackageJson.dependencies));
     const devDependencies = yield* resolveSpecs(buildUnresolvedDevDeps(examplePackageJson.devDependencies, scaffoldDevDependencies(scaffold)));
     yield* writeManifest(projectPath, sortDependencies(dependencies), sortDependencies(devDependencies));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-foldkit-app",
-  "version": "0.27.1",
+  "version": "0.27.3",
   "description": "Create Foldkit applications",
   "type": "module",
   "main": "./dist/index.js",

package/templates/base/README.md

@@ -11,5 +11,5 @@ A Foldkit application built with Effect.
 
 ## Learn More
 
-- [Foldkit Documentation](https://github.com/foldkit/foldkit)
+- [Foldkit Documentation](https://foldkit.dev)
 - [Effect Documentation](https://effect.website)

package/templates/rendering/ssg/README.md

@@ -57,5 +57,5 @@ build script generate one.
 
 ## Learn More
 
-- [Foldkit Documentation](https://github.com/foldkit/foldkit)
+- [Foldkit Documentation](https://foldkit.dev)
 - [Effect Documentation](https://effect.website)

package/templates/rendering/ssg/scripts/build.mjs

@@ -1,20 +1,7 @@
 import { spawnSync } from 'node:child_process'
 import { randomUUID } from 'node:crypto'
 
-// NOTE: one id names this build, and every command below is given that same
-// id, so the client bundle and the server bundle of a deployment agree on which
-// deployment they are. `renderToString` stamps it on the prerendered pages and
-// `Runtime.hydrate` compares it before adopting any DOM, so a page left over
-// from an earlier deployment is refused and contained rather than reconciled
-// against a client that no longer means the same thing by it.
-//
-// The id is published in the HTML every visitor receives. It identifies a
-// deployment and is never a credential, so keep secrets out of it. Set
-// FOLDKIT_BUILD_ID to name builds from a value the deployment already has, such
-// as a commit or a release tag; without one, each build takes a fresh id.
-// NOTE: `??` alone would take an empty FOLDKIT_BUILD_ID as a real value, and
-// the plugin treats empty as absent, so the build would compile no id at all and
-// fail later at the render. Empty is unset here too.
+// NOTE: one nonempty id must reach every step in this build.
 const supplied = process.env.FOLDKIT_BUILD_ID
 const buildId =
   supplied === undefined || supplied === '' ? randomUUID() : supplied

package/templates/rendering/ssr/README.md

@@ -61,5 +61,5 @@ and let the build script generate one.
 
 ## Learn More
 
-- [Foldkit Documentation](https://github.com/foldkit/foldkit)
+- [Foldkit Documentation](https://foldkit.dev)
 - [Effect Documentation](https://effect.website)

package/templates/rendering/ssr/scripts/build.mjs

@@ -1,20 +1,7 @@
 import { spawnSync } from 'node:child_process'
 import { randomUUID } from 'node:crypto'
 
-// NOTE: one id names this build, and every command below is given that same
-// id, so the client bundle and the server bundle of a deployment agree on which
-// deployment they are. `renderToString` stamps it on the rendered root and
-// `Runtime.hydrate` compares it before adopting any DOM, so a page left over
-// from an earlier deployment is refused and contained rather than reconciled
-// against a client that no longer means the same thing by it.
-//
-// The id is published in the HTML every visitor receives. It identifies a
-// deployment and is never a credential, so keep secrets out of it. Set
-// FOLDKIT_BUILD_ID to name builds from a value the deployment already has, such
-// as a commit or a release tag; without one, each build takes a fresh id.
-// NOTE: `??` alone would take an empty FOLDKIT_BUILD_ID as a real value, and
-// the plugin treats empty as absent, so the build would compile no id at all and
-// fail later at the render. Empty is unset here too.
+// NOTE: one nonempty id must reach every step in this build.
 const supplied = process.env.FOLDKIT_BUILD_ID
 const buildId =
   supplied === undefined || supplied === '' ? randomUUID() : supplied