create-astro 0.0.0-9591-20240103143428

package/LICENSE

@@ -0,0 +1,59 @@
+MIT License
+
+Copyright (c) 2021 Fred K. Schott
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+"""
+This license applies to parts of the `packages/create-astro` and `packages/astro` subdirectories originating from the https://github.com/sveltejs/kit repository:
+
+Copyright (c) 2020 [these people](https://github.com/sveltejs/kit/graphs/contributors)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+"""
+
+"""
+This license applies to parts of the `packages/create-astro` and `packages/astro` subdirectories originating from the https://github.com/vitejs/vite repository:
+
+MIT License
+
+Copyright (c) 2019-present, Yuxi (Evan) You and Vite contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+"""

package/README.md

@@ -0,0 +1,63 @@
+# create-astro
+
+## Scaffolding for Astro projects
+
+**With NPM:**
+
+```bash
+npm create astro@latest
+```
+
+**With Yarn:**
+
+```bash
+yarn create astro
+```
+
+**With PNPM:**
+
+```bash
+pnpm create astro
+```
+
+`create-astro` automatically runs in _interactive_ mode, but you can also specify your project name and template with command line arguments.
+
+```bash
+# npm
+npm create astro@latest my-astro-project -- --template minimal
+
+# yarn
+yarn create astro my-astro-project --template minimal
+
+# pnpm
+pnpm create astro my-astro-project --template minimal
+```
+
+[Check out the full list][examples] of example templates, available on GitHub.
+
+You can also use any GitHub repo as a template:
+
+```bash
+npm create astro@latest my-astro-project -- --template cassidoo/shopify-react-astro
+```
+
+### CLI Flags
+
+May be provided in place of prompts
+
+| Name                         | Description                                            |
+| :--------------------------- | :----------------------------------------------------- |
+| `--help` (`-h`)              | Display available flags.                               |
+| `--template <name>`          | Specify your template.                                 |
+| `--install` / `--no-install` | Install dependencies (or not).                         |
+| `--git` / `--no-git`         | Initialize git repo (or not).                          |
+| `--yes` (`-y`)               | Skip all prompts by accepting defaults.                |
+| `--no` (`-n`)                | Skip all prompts by declining defaults.                |
+| `--dry-run`                  | Walk through steps without executing.                  |
+| `--skip-houston`             | Skip Houston animation.                                |
+| `--ref`                      | Specify an Astro branch (default: latest).             |
+| `--fancy`                    | Enable full Unicode support for Windows.               |
+| `--typescript <option>`      | TypeScript option: `strict` / `strictest` / `relaxed`. |
+
+[examples]: https://github.com/withastro/astro/tree/main/examples
+[typescript]: https://github.com/withastro/astro/tree/main/packages/astro/tsconfigs

package/create-astro.mjs

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+'use strict';
+
+const currentVersion = process.versions.node;
+const requiredMajorVersion = parseInt(currentVersion.split('.')[0], 10);
+const minimumMajorVersion = 18;
+
+if (requiredMajorVersion < minimumMajorVersion) {
+	console.error(`Node.js v${currentVersion} is out of date and unsupported!`);
+	console.error(`Please use Node.js v${minimumMajorVersion} or higher.`);
+	process.exit(1);
+}
+
+import('./dist/index.js').then(({ main }) => main());

package/dist/actions/context.d.ts

@@ -0,0 +1,25 @@
+import { prompt, type Task } from '@astrojs/cli-kit';
+export interface Context {
+    help: boolean;
+    prompt: typeof prompt;
+    cwd: string;
+    packageManager: string;
+    username: Promise<string>;
+    version: Promise<string>;
+    skipHouston: boolean;
+    fancy?: boolean;
+    dryRun?: boolean;
+    yes?: boolean;
+    projectName?: string;
+    template?: string;
+    ref: string;
+    install?: boolean;
+    git?: boolean;
+    typescript?: string;
+    stdin?: typeof process.stdin;
+    stdout?: typeof process.stdout;
+    exit(code: number): never;
+    hat?: string;
+    tasks: Task[];
+}
+export declare function getContext(argv: string[]): Promise<Context>;

package/dist/actions/dependencies.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from './context.js';
+export declare function dependencies(ctx: Pick<Context, 'install' | 'yes' | 'prompt' | 'packageManager' | 'cwd' | 'dryRun' | 'tasks'>): Promise<void>;

package/dist/actions/git.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from './context.js';
+export declare function git(ctx: Pick<Context, 'cwd' | 'git' | 'yes' | 'prompt' | 'dryRun' | 'tasks'>): Promise<void>;

package/dist/actions/help.d.ts

@@ -0,0 +1 @@
+export declare function help(): void;

package/dist/actions/intro.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from './context.js';
+export declare function intro(ctx: Pick<Context, 'hat' | 'skipHouston' | 'version' | 'username' | 'fancy'>): Promise<void>;

package/dist/actions/next-steps.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from './context.js';
+export declare function next(ctx: Pick<Context, 'hat' | 'cwd' | 'packageManager' | 'skipHouston'>): Promise<void>;

package/dist/actions/project-name.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from './context.js';
+export declare function projectName(ctx: Pick<Context, 'cwd' | 'yes' | 'dryRun' | 'prompt' | 'projectName' | 'exit'>): Promise<void>;

package/dist/actions/shared.d.ts

@@ -0,0 +1,3 @@
+export declare function isEmpty(dirPath: string): boolean;
+export declare function isValidName(projectName: string): boolean;
+export declare function toValidName(projectName: string): string;

package/dist/actions/template.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from './context.js';
+export declare function template(ctx: Pick<Context, 'template' | 'prompt' | 'yes' | 'dryRun' | 'exit' | 'tasks'>): Promise<void>;
+export declare function getTemplateTarget(tmpl: string, ref?: string): string;
+export default function copyTemplate(tmpl: string, ctx: Context): Promise<void>;

package/dist/actions/typescript.d.ts

@@ -0,0 +1,5 @@
+import type { Context } from './context.js';
+type PickedTypeScriptContext = Pick<Context, 'typescript' | 'yes' | 'prompt' | 'dryRun' | 'cwd' | 'exit' | 'packageManager' | 'install' | 'tasks'>;
+export declare function typescript(ctx: PickedTypeScriptContext): Promise<void>;
+export declare function setupTypeScript(value: string, ctx: PickedTypeScriptContext): Promise<void>;
+export {};

package/dist/actions/verify.d.ts

@@ -0,0 +1,2 @@
+import type { Context } from './context.js';
+export declare function verify(ctx: Pick<Context, 'version' | 'dryRun' | 'template' | 'ref' | 'exit'>): Promise<void>;

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { getContext } from './actions/context.js';
+import { dependencies } from './actions/dependencies.js';
+import { git } from './actions/git.js';
+import { intro } from './actions/intro.js';
+import { next } from './actions/next-steps.js';
+import { projectName } from './actions/project-name.js';
+import { template } from './actions/template.js';
+import { setupTypeScript, typescript } from './actions/typescript.js';
+import { verify } from './actions/verify.js';
+import { setStdout } from './messages.js';
+export declare function main(): Promise<void>;
+export { dependencies, getContext, git, intro, next, projectName, setStdout, setupTypeScript, template, typescript, verify, };