create-velar 0.10.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,34 @@
+# create-velar
+
+The official non-interactive project creator for VelarScript. It is the package
+behind `npm create velar@latest` and shares the same templates with
+`velar create`.
+
+```sh
+npm create velar@latest my-app
+npm create velar@latest my-service -- --template node
+npm create velar@latest my-desktop -- --template desktop
+npm create velar@latest my-docs -- --template docs
+npm create velar@latest my-library -- --template library
+npm create velar@latest my-components -- --template component
+```
+
+The first-class application templates are `web`, `node`, and `desktop`. Each
+starts with the borderless VelarScript mark and a small Hello experience shaped
+like the corresponding JavaScript framework category: an interactive Web page,
+a Node HTTP server, or a single-project Desktop window. Specialized templates
+remain available as `docs`, `library`, and `component`. The Core
+library template publishes a reusable `.vel` entry without Web; the component
+template publishes a checked Web component source entry and keeps its preview
+application outside that public entry. `game` is reserved for the future
+official Canvas framework and deliberately fails until that package exists.
+
+Every generated project includes a root `AGENTS.md` that points coding agents
+at `velar skill` — the language brief packaged with the toolchain — together
+with the project's gate commands (`velar check`, `velar test`, `velar format`)
+and the JavaScript escape-hatch ladder.
+
+Creation is transactional. It refuses non-empty targets and never installs
+dependencies, downloads browsers, initializes Git, or contacts a service.
+The generated README keeps the first `npm install` explicit, then points to the
+installed CLI's npm-backed `velar add`, `remove`, and `update` workflow.

package/dist/arguments.d.ts

@@ -0,0 +1,7 @@
+import { type VelarProjectTemplate } from "./types.ts";
+export interface CreateArguments {
+    readonly directory: string;
+    readonly template: VelarProjectTemplate;
+}
+export declare function parseCreateArguments(arguments_: readonly string[]): CreateArguments | string;
+//# sourceMappingURL=arguments.d.ts.map

package/dist/arguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.d.ts","sourceRoot":"","sources":["../src/arguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,eAAe,GAAG,MAAM,CAiC5F"}

package/dist/arguments.js

@@ -0,0 +1,52 @@
+import { VELAR_PROJECT_TEMPLATES } from "./types.js";
+export function parseCreateArguments(arguments_) {
+    let directory = null;
+    let template = "web";
+    let templateProvided = false;
+    for (let index = 0; index < arguments_.length; index += 1) {
+        const argument = arguments_[index];
+        if (argument === "--template") {
+            const value = arguments_[index + 1];
+            if (!value || value.startsWith("--"))
+                return "--template requires web, node, desktop, docs, library, or component";
+            const parsed = parseTemplate(value);
+            if (typeof parsed === "object")
+                return parsed.error;
+            if (templateProvided)
+                return "--template may be provided only once";
+            template = parsed;
+            templateProvided = true;
+            index += 1;
+        }
+        else if (argument.startsWith("--template=")) {
+            const parsed = parseTemplate(argument.slice("--template=".length));
+            if (typeof parsed === "object")
+                return parsed.error;
+            if (templateProvided)
+                return "--template may be provided only once";
+            template = parsed;
+            templateProvided = true;
+        }
+        else if (argument.startsWith("--")) {
+            return `unknown option '${argument}'`;
+        }
+        else if (directory !== null) {
+            return `unexpected extra project directory '${argument}'`;
+        }
+        else {
+            directory = argument;
+        }
+    }
+    if (!directory || directory.trim().length === 0 || directory.includes("\0")) {
+        return "expected one project directory";
+    }
+    return { directory, template };
+}
+function parseTemplate(value) {
+    if (value === "game")
+        return { error: "template 'game' is reserved for the future @velarscript/game framework" };
+    return VELAR_PROJECT_TEMPLATES.includes(value)
+        ? value
+        : { error: `unknown template '${value}'; expected web, node, desktop, docs, library, or component` };
+}
+//# sourceMappingURL=arguments.js.map

package/dist/arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arguments.js","sourceRoot":"","sources":["../src/arguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAA6B,MAAM,YAAY,CAAC;AAOhF,MAAM,UAAU,oBAAoB,CAAC,UAA6B;IAChE,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,QAAQ,GAAyB,KAAK,CAAC;IAC3C,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAE,CAAC;QACpC,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC;gBAAE,OAAO,qEAAqE,CAAC;YACnH,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;YACpD,IAAI,gBAAgB;gBAAE,OAAO,sCAAsC,CAAC;YACpE,QAAQ,GAAG,MAAM,CAAC;YAClB,gBAAgB,GAAG,IAAI,CAAC;YACxB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;YACnE,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC,KAAK,CAAC;YACpD,IAAI,gBAAgB;gBAAE,OAAO,sCAAsC,CAAC;YACpE,QAAQ,GAAG,MAAM,CAAC;YAClB,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;aAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,mBAAmB,QAAQ,GAAG,CAAC;QACxC,CAAC;aAAM,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YAC9B,OAAO,uCAAuC,QAAQ,GAAG,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,SAAS,GAAG,QAAQ,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5E,OAAO,gCAAgC,CAAC;IAC1C,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,EAAE,KAAK,EAAE,wEAAwE,EAAE,CAAC;IACjH,OAAQ,uBAA6C,CAAC,QAAQ,CAAC,KAAK,CAAC;QACnE,CAAC,CAAC,KAA6B;QAC/B,CAAC,CAAC,EAAE,KAAK,EAAE,qBAAqB,KAAK,6DAA6D,EAAE,CAAC;AACzG,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { createVelarProject, parseCreateArguments, VELAR_CREATE_VERSION } from "./index.js";
+async function main(arguments_) {
+    if (arguments_.length === 1 && (arguments_[0] === "--version" || arguments_[0] === "-v")) {
+        process.stdout.write(`create-velar ${VELAR_CREATE_VERSION}\n`);
+        return 0;
+    }
+    if (arguments_.some((argument) => argument === "--help" || argument === "-h")) {
+        if (arguments_.length !== 1) {
+            process.stderr.write("create-velar: help does not accept project or template arguments\n");
+            return 2;
+        }
+        printHelp();
+        return 0;
+    }
+    const parsed = parseCreateArguments(arguments_);
+    if (typeof parsed === "string") {
+        process.stderr.write(`create-velar: ${parsed}\n`);
+        return 2;
+    }
+    try {
+        const result = await createVelarProject(parsed.directory, { template: parsed.template });
+        process.stdout.write(`Created VelarScript ${result.template} project -> ${result.root}\n`);
+        return 0;
+    }
+    catch (error) {
+        process.stderr.write(`create-velar: ${error instanceof Error ? error.message : String(error)}\n`);
+        return 1;
+    }
+}
+function printHelp() {
+    process.stdout.write([
+        "Create VelarScript",
+        "",
+        "Usage: create-velar <project-directory> [--template <web|node|desktop|docs|library|component>]",
+        "",
+        "Creates files transactionally without installing dependencies or initializing Git.",
+        "",
+    ].join("\n"));
+}
+try {
+    process.exitCode = await main(process.argv.slice(2));
+}
+catch (error) {
+    process.stderr.write(`create-velar: ${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE5F,KAAK,UAAU,IAAI,CAAC,UAA6B;IAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,oBAAoB,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oEAAoE,CAAC,CAAC;YAC3F,OAAO,CAAC,CAAC;QACX,CAAC;QACD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,MAAM,IAAI,CAAC,CAAC;QAClD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uBAAuB,MAAM,CAAC,QAAQ,eAAe,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;QAC3F,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClG,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACnB,oBAAoB;QACpB,EAAE;QACF,gGAAgG;QAChG,EAAE;QACF,oFAAoF;QACpF,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,IAAI,CAAC;IACH,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClG,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { type CreateProjectOptions, type CreateProjectResult } from "./types.ts";
+export { parseCreateArguments, type CreateArguments } from "./arguments.ts";
+export { VELAR_CREATE_VERSION, VELAR_PROJECT_FORMAT_VERSION, VELAR_PROJECT_TEMPLATES, type CreateProjectOptions, type CreateProjectResult, type VelarProjectTemplate, } from "./types.ts";
+export declare function createVelarProject(input: string, options?: CreateProjectOptions): Promise<CreateProjectResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACzB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,GAC1B,MAAM,YAAY,CAAC;AAEpB,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgCxH"}

package/dist/index.js

@@ -0,0 +1,56 @@
+import { lstat, mkdir, mkdtemp, readdir, rename, rm, rmdir, writeFile } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { createTemplateFiles } from "./templates.js";
+import { VELAR_CREATE_VERSION, VELAR_PROJECT_FORMAT_VERSION, VELAR_PROJECT_TEMPLATES, } from "./types.js";
+export { parseCreateArguments } from "./arguments.js";
+export { VELAR_CREATE_VERSION, VELAR_PROJECT_FORMAT_VERSION, VELAR_PROJECT_TEMPLATES, } from "./types.js";
+export async function createVelarProject(input, options = {}) {
+    if (!input || input.trim().length === 0 || input.includes("\0"))
+        throw new Error("a project directory is required");
+    const cwd = options.cwd ?? process.cwd();
+    const root = resolve(cwd, input);
+    const template = options.template ?? "web";
+    if (!VELAR_PROJECT_TEMPLATES.includes(template)) {
+        throw new Error(`unsupported VelarScript project template '${String(template)}'`);
+    }
+    const existing = await pathState(root);
+    if (existing !== "missing") {
+        if (existing !== "directory")
+            throw new Error(`'${input}' already exists and is not an ordinary directory`);
+        const entries = await readdir(root);
+        if (entries.length > 0)
+            throw new Error(`'${input}' already exists and is not empty`);
+    }
+    await mkdir(dirname(root), { recursive: true });
+    const staging = await mkdtemp(join(dirname(root), ".velar-create-"));
+    try {
+        const files = createTemplateFiles(template, root, VELAR_CREATE_VERSION, VELAR_PROJECT_FORMAT_VERSION);
+        for (const [relativePath, contents] of [...files].sort(([left], [right]) => left.localeCompare(right))) {
+            const path = join(staging, relativePath);
+            await mkdir(dirname(path), { recursive: true });
+            await writeFile(path, contents, { encoding: "utf8", flag: "wx" });
+        }
+        if (existing === "directory")
+            await rmdir(root);
+        await rename(staging, root);
+    }
+    catch (error) {
+        await rm(staging, { recursive: true, force: true });
+        if (existing === "directory" && await pathState(root) === "missing")
+            await mkdir(root);
+        throw error;
+    }
+    return { root, template };
+}
+async function pathState(path) {
+    try {
+        const information = await lstat(path);
+        return information.isDirectory() && !information.isSymbolicLink() ? "directory" : "other";
+    }
+    catch (error) {
+        if (error && typeof error === "object" && "code" in error && error.code === "ENOENT")
+            return "missing";
+        throw error;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/templates.d.ts

@@ -0,0 +1,3 @@
+import type { VelarProjectTemplate } from "./types.ts";
+export declare function createTemplateFiles(template: VelarProjectTemplate, root: string, version: string, formatVersion: number): ReadonlyMap<string, string>;
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAe7B"}

package/dist/templates.js

@@ -0,0 +1,498 @@
+import { basename } from "node:path";
+export function createTemplateFiles(template, root, version, formatVersion) {
+    const displayName = basename(root);
+    const name = packageName(displayName);
+    const dependencyVersion = version.includes("-") ? version : `^${version}`;
+    return template === "library"
+        ? libraryTemplate(name, displayName, dependencyVersion, formatVersion)
+        : template === "component"
+            ? componentTemplate(name, displayName, dependencyVersion, formatVersion)
+            : template === "docs"
+                ? docsTemplate(name, displayName, dependencyVersion, formatVersion)
+                : template === "desktop"
+                    ? desktopTemplate(name, displayName, dependencyVersion, formatVersion)
+                    : template === "node"
+                        ? nodeTemplate(name, displayName, dependencyVersion, formatVersion)
+                        : webTemplate(name, displayName, dependencyVersion, formatVersion);
+}
+function webTemplate(name, displayName, version, formatVersion) {
+    const files = new Map([
+        ...commonWebFiles(name, displayName, version, formatVersion),
+        ["README.md", `# ${displayName}\n\nA VelarScript Web starter for the JavaScript ecosystem.\n\n\`\`\`sh\nnpm install\nnpm run dev\n\`\`\`\n\nEdit \`src/app.vel\` to begin. Before sharing a production build, run \`npm run validate\`.\n`],
+        ["src/app.vel", `import {Head} from "velar/web"\nimport {border, clamp, color, rgb, spacing} from "velar/look"\n\nexport const appName = "${escapeVelarString(displayName)}"\nexport const frameworkPosition = "The first extensible language framework for the AI era, built for the JavaScript ecosystem."\n\nconst ink = rgb(24, 24, 24)\nconst inkSoft = rgb(92, 92, 92)\nconst paper = rgb(247, 247, 244)\nconst white = rgb(255, 255, 255)\n\nconst pageLook = look:\n    display = "grid"\n    placeItems = "center"\n    minHeight = 100vh\n    padding = spacing(32px, 20px)\n    color = ink\n    background = paper\n    fontFamily = "Inter, ui-sans-serif, system-ui, sans-serif"\n\nconst helloLook = look:\n    display = "grid"\n    justifyItems = "center"\n    gap = 20px\n    width = 100%\n    maxWidth = 680px\n    textAlign = "center"\n\nconst markLook = look:\n    width = 132px\n    height = "auto"\n\nconst eyebrowLook = look:\n    margin = 0\n    color = inkSoft\n    fontWeight = 700\n    letterSpacing = 0.12em\n    textTransform = "uppercase"\n\nconst titleLook = look:\n    margin = 0\n    fontSize = clamp(2.5rem, 8vw, 5rem)\n    lineHeight = 0.96\n    letterSpacing = -0.06em\n\nconst leadLook = look:\n    maxWidth = 560px\n    margin = 0\n    color = inkSoft\n    fontSize = 1.05rem\n    lineHeight = 1.65\n\nconst buttonLook = look:\n    padding = spacing(11px, 18px)\n    border = border(0px, color("transparent"))\n    borderRadius = 9999px\n    color = white\n    background = ink\n    fontWeight = 700\n    cursor = "pointer"\n\nexport component App:\n    state count = 0\n\n    def increment():\n        count += 1\n\n    return <main class="page" look={pageLook}>\n        <Head title={appName} description={frameworkPosition} image="/velarscript-mark.svg" themeColor="#f7f7f4" />\n        <section class="hello" look={helloLook}>\n            <img look={markLook} src="/velarscript-mark.svg" alt="VelarScript" />\n            <p class="eyebrow" look={eyebrowLook}>VelarScript Web</p>\n            <h1 look={titleLook}>Hello, {appName}</h1>\n            <p look={leadLook}>{frameworkPosition}</p>\n            <button look={buttonLook} type="button" on:click={increment}>Count is {count}</button>\n        </section>\n    </main>\n`],
+        ["src/app.test.vel", `import {expect} from "velar/test"\nimport {appName, frameworkPosition} from "./app.vel"\n\ntest "application contract":\n    expect(appName).toBe("${escapeVelarString(displayName)}")\n    expect(frameworkPosition).toContain("JavaScript ecosystem")\n`],
+        ["src/app.browser.test.vel", `import {expect} from "velar/test"\nimport {browser} from "velar/web-test"\n\ntest "home page":\n    await browser.open("/")\n    expect(await browser.text("h1")).toBe("Hello, ${escapeVelarString(displayName)}")\n    expect(await browser.attribute("img", "src")).toBe("/velarscript-mark.svg")\n    await browser.click("button")\n    await browser.waitForText("button", "Count is 1")\n`],
+    ]);
+    return files;
+}
+function nodeTemplate(name, displayName, version, formatVersion) {
+    const publicName = escapeHtml(displayName);
+    return new Map([
+        [".gitignore", "node_modules/\ndist/\n.velar/\n"],
+        agentsGuideFile(),
+        ...brandPublicFiles(),
+        ["package.json", json({
+                name,
+                version: "0.1.0",
+                private: true,
+                type: "module",
+                scripts: {
+                    check: "velar check",
+                    format: "velar format",
+                    "format:check": "velar format --check",
+                    dev: "velar run",
+                    start: "velar run",
+                    test: "velar test",
+                    build: "velar build",
+                    validate: "npm run format:check && npm run check && npm test && npm run build",
+                },
+                dependencies: { "@velarscript/node": version },
+                devDependencies: { "@velarscript/cli": version },
+            })],
+        ["velar.json", json({
+                formatVersion,
+                entry: "src/main.vel",
+                outDir: "dist",
+                publicDir: "public",
+                extensions: [],
+            })],
+        ["README.md", `# ${displayName}\n\nA VelarScript Node starter modeled on the familiar Node.js Hello World server.\n\n\`\`\`sh\nnpm install\nnpm run dev\n\`\`\`\n\nOpen \`http://127.0.0.1:3000\`. Edit \`src/app.vel\` to add routes and \`src/main.vel\` to change the host or port.\n`],
+        ["public/index.html", `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>${publicName} · VelarScript Node</title>
+    <style>
+      :root { color: #181818; background: #f7f7f4; font-family: Inter, ui-sans-serif, system-ui, sans-serif; }
+      body { display: grid; place-items: center; min-height: 100vh; margin: 0; padding: 24px; box-sizing: border-box; }
+      main { display: grid; justify-items: center; gap: 18px; max-width: 640px; text-align: center; }
+      img { width: 120px; height: auto; }
+      small { color: #5c5c5c; font-weight: 700; letter-spacing: .12em; text-transform: uppercase; }
+      h1 { margin: 0; font-size: clamp(2.5rem, 8vw, 5rem); line-height: .96; letter-spacing: -.06em; }
+      p { max-width: 560px; margin: 0; color: #5c5c5c; line-height: 1.65; }
+      code { color: #181818; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <img src="/velarscript-mark.svg" alt="VelarScript" />
+      <small>VelarScript Node</small>
+      <h1>Hello from ${publicName}</h1>
+      <p>The first extensible language framework for the AI era, built for the JavaScript ecosystem.</p>
+      <p>Try the checked JSON endpoint at <code>/api/hello</code>.</p>
+    </main>
+  </body>
+</html>
+`],
+        ["src/app.vel", `import {ServeRequest, ServeResponse, fileResponse} from "velar/serve"
+
+export const appName = "${escapeVelarString(displayName)}"
+export const greeting = "Hello from VelarScript Node"
+
+export async def handle(request: ServeRequest) -> ServeResponse:
+    if request.path == "/api/hello":
+        return {status: 200, json: {message: greeting, target: "node"}}
+    return fileResponse(root="public", path=request.path, fallback="index.html")
+`],
+        ["src/main.vel", `import {serve} from "velar/serve"
+import {appName, handle} from "./app.vel"
+
+const server = await serve(handle, port=3000)
+print(f"{appName} is running at http://127.0.0.1:{server.port}")
+`],
+        ["src/app.test.vel", `import {expect} from "velar/test"
+import {appName, greeting} from "./app.vel"
+
+test "node application contract":
+    expect(appName).toBe("${escapeVelarString(displayName)}")
+    expect(greeting).toBe("Hello from VelarScript Node")
+`],
+    ]);
+}
+function desktopTemplate(name, displayName, version, formatVersion) {
+    const identifier = applicationIdentifier(name);
+    const files = new Map([
+        [".gitignore", "node_modules/\ndist/\n.velar/\n"],
+        agentsGuideFile(),
+        ...brandPublicFiles(),
+        ["package.json", json({
+                name,
+                version: "0.1.0",
+                private: true,
+                type: "module",
+                scripts: {
+                    check: "velar check",
+                    format: "velar format",
+                    "format:check": "velar format --check",
+                    dev: "velar dev",
+                    test: "velar test",
+                    "test:browser": "velar test --browser=all",
+                    build: "velar build",
+                    package: "velar package",
+                    validate: "npm run format:check && npm run check && npm test && npm run build",
+                },
+                dependencies: { "@velarscript/desktop": version },
+                devDependencies: { "@velarscript/cli": version },
+            })],
+        ["velar.json", json({
+                formatVersion,
+                entry: "src/main.vel",
+                outDir: "dist/renderer",
+                publicDir: "public",
+                extensions: ["@velarscript/desktop"],
+                desktop: {
+                    productName: displayName,
+                    identifier: `dev.velarscript.${identifier}`,
+                    window: { width: 1040, height: 720, minWidth: 640, minHeight: 480 },
+                    permissions: { files: [], processes: [], terminal: false, network: [], environment: [], secrets: [] },
+                },
+            })],
+        ["README.md", `# ${displayName}\n\nA single-project VelarScript Desktop starter backed by the system WebView.\n\n\`\`\`sh\nnpm install\nnpm run dev\nnpm run package\n\`\`\`\n\n\`npm run dev\` previews the renderer. On macOS, \`npm run package\` creates a native \`.app\` using the default VelarScript application icon.\n`],
+        ["src/main.vel", `import {App} from "./app.vel"
+
+mount(<App />, "#app")
+`],
+        ["src/app.vel", `import {Head} from "velar/web"
+import {border, clamp, color, rgb, spacing} from "velar/look"
+
+export const appName = "${escapeVelarString(displayName)}"
+export const desktopModel = "One VelarScript project, one system WebView, no renderer/main split."
+
+const ink = rgb(24, 24, 24)
+const inkSoft = rgb(92, 92, 92)
+const paper = rgb(247, 247, 244)
+const white = rgb(255, 255, 255)
+
+const pageLook = look:
+    display = "grid"
+    placeItems = "center"
+    minHeight = 100vh
+    padding = spacing(32px, 20px)
+    color = ink
+    background = paper
+    fontFamily = "Inter, ui-sans-serif, system-ui, sans-serif"
+
+const helloLook = look:
+    display = "grid"
+    justifyItems = "center"
+    gap = 20px
+    width = 100%
+    maxWidth = 680px
+    textAlign = "center"
+
+const markLook = look:
+    width = 132px
+    height = "auto"
+
+const eyebrowLook = look:
+    margin = 0
+    color = inkSoft
+    fontWeight = 700
+    letterSpacing = 0.12em
+    textTransform = "uppercase"
+
+const titleLook = look:
+    margin = 0
+    fontSize = clamp(2.5rem, 8vw, 5rem)
+    lineHeight = 0.96
+    letterSpacing = -0.06em
+
+const leadLook = look:
+    maxWidth = 560px
+    margin = 0
+    color = inkSoft
+    fontSize = 1.05rem
+    lineHeight = 1.65
+
+const buttonLook = look:
+    padding = spacing(11px, 18px)
+    border = border(0px, color("transparent"))
+    borderRadius = 9999px
+    color = white
+    background = ink
+    fontWeight = 700
+    cursor = "pointer"
+
+export component App:
+    state count = 0
+
+    def increment():
+        count += 1
+
+    return <main class="page" look={pageLook}>
+        <Head title={appName} description={desktopModel} image="/velarscript-mark.svg" themeColor="#f7f7f4" />
+        <section class="hello" look={helloLook}>
+            <img look={markLook} src="/velarscript-mark.svg" alt="VelarScript" />
+            <p class="eyebrow" look={eyebrowLook}>VelarScript Desktop</p>
+            <h1 look={titleLook}>Hello, {appName}</h1>
+            <p look={leadLook}>{desktopModel}</p>
+            <button look={buttonLook} type="button" on:click={increment}>Count is {count}</button>
+        </section>
+    </main>
+`],
+        ["src/app.test.vel", `import {expect} from "velar/test"
+import {appName, desktopModel} from "./app.vel"
+
+test "desktop application contract":
+    expect(appName).toBe("${escapeVelarString(displayName)}")
+    expect(desktopModel).toContain("system WebView")
+`],
+        ["src/app.browser.test.vel", `import {expect} from "velar/test"
+import {browser} from "velar/web-test"
+
+test "desktop home":
+    await browser.open("/")
+    expect(await browser.text("h1")).toBe("Hello, ${escapeVelarString(displayName)}")
+    expect(await browser.attribute("img", "src")).toBe("/velarscript-mark.svg")
+    await browser.click("button")
+    await browser.waitForText("button", "Count is 1")
+`],
+    ]);
+    return files;
+}
+function docsTemplate(name, displayName, version, formatVersion) {
+    const files = new Map([
+        ...commonWebFiles(name, displayName, version, formatVersion),
+        ["README.md", `# ${displayName}\n\nA routed documentation site written in VelarScript.\n\n\`\`\`sh\nnpm install\nnpm run dev\n\`\`\`\n\nAfter bootstrap, use \`npm exec velar -- add <package>\`, \`remove\`, and \`update\` for project-aware dependency changes. Edit the navigation and page metadata in \`src/content.vel\`.\n`],
+        ["src/content.vel", `export type DocPage:\n    path: string\n    label: string\n    title: string\n    summary: string\n\nexport const pages: List<DocPage> = [\n    {path: "/", label: "Overview", title: "${escapeVelarString(displayName)}", summary: "A documentation site built entirely with VelarScript."},\n    {path: "/guide", label: "Guide", title: "Guide", summary: "Start with one component, then grow through typed modules and the Web framework."},\n]\n\nexport def pageTitle(path: string) -> string:\n    for page in pages:\n        if page.path == path:\n            return page.title\n    return "Page not found"\n`],
+        ["src/styles.vel", `import {border, clamp, rgb, rgba, spacing} from "velar/look"\n\nexport const ink = rgb(17, 18, 22)\nexport const inkSoft = rgb(94, 96, 102)\nexport const paper = rgb(247, 245, 240)\nexport const paperPure = rgb(251, 250, 247)\nexport const sea = rgb(68, 123, 159)\nexport const seaSoft = rgba(68, 123, 159, 0.12)\nexport const rule = rgba(17, 18, 22, 0.14)\n\nexport const documentLook = look:\n    display = "grid"\n    gap = 18px\n    width = 100%\n    maxWidth = 824px\n    padding = spacing(72px, 32px)\n\nexport const eyebrowLook = look:\n    margin = 0\n    color = sea\n    fontWeight = 700\n    textTransform = "uppercase"\n    letterSpacing = 0.08em\n\nexport const titleLook = look:\n    margin = 0\n    fontSize = clamp(3rem, 8vw, 6rem)\n    lineHeight = 0.96\n    letterSpacing = -0.06em\n\nexport const leadLook = look:\n    margin = 0\n    color = inkSoft\n    fontSize = 1.2rem\n    lineHeight = 1.65\n\nexport const linkLook = look:\n    color = sea\n    fontWeight = 700\n\nexport const codeLook = look:\n    overflow = "auto"\n    padding = 20px\n    border = border(1px, rule)\n    borderRadius = 12px\n    background = paperPure\n`],
+        ["src/pages/home.vel", `import {Head, Link} from "velar/web"\nimport {pages} from "../content.vel"\nimport {documentLook, eyebrowLook, leadLook, linkLook, titleLook} from "../styles.vel"\n\nexport component Home:\n    const page = pages[0]\n\n    return <main class="document" look={documentLook}>\n        <Head title={page.title} description={page.summary} themeColor="#f7f5f0" />\n        <p class="eyebrow" look={eyebrowLook}>VelarScript documentation</p>\n        <h1 look={titleLook}>{page.title}</h1>\n        <p class="lead" look={leadLook}>{page.summary}</p>\n        <Link to="/guide" look={linkLook}>Read the guide</Link>\n    </main>\n`],
+        ["src/pages/guide.vel", `import {Head} from "velar/web"\nimport {pages} from "../content.vel"\nimport {codeLook, documentLook, eyebrowLook, leadLook, titleLook} from "../styles.vel"\n\nconst example = "export component Hello(name: string):\\n    return <h1>Hello {name}</h1>"\n\nexport component Guide:\n    const page = pages[1]\n\n    return <main class="document" look={documentLook}>\n        <Head title={page.title} description={page.summary} themeColor="#f7f5f0" />\n        <p class="eyebrow" look={eyebrowLook}>Guide</p>\n        <h1 look={titleLook}>{page.title}</h1>\n        <p class="lead" look={leadLook}>{page.summary}</p>\n        <pre look={codeLook}><code>{example}</code></pre>\n    </main>\n`],
+        ["src/app.vel", `import {NavLink, RouteContext, Router, route} from "velar/web"\nimport {pages} from "./content.vel"\nimport {documentLook, eyebrowLook, ink, inkSoft, paper, paperPure, rule, seaSoft, titleLook} from "./styles.vel"\nimport {Home} from "./pages/home.vel"\nimport {Guide} from "./pages/guide.vel"\nimport {border, color, minmax, spacing, tracks} from "velar/look"\n\ncomponent NotFound(route: RouteContext):\n    return <main class="document" look={documentLook}>\n        <p class="eyebrow" look={eyebrowLook}>404</p>\n        <h1 look={titleLook}>Page not found</h1>\n        <p>No document matches {route.path}.</p>\n    </main>\n\nconst routes = [route("/", Home), route("/guide", Guide)]\n\nconst shellLook = look:\n    display = "grid"\n    gridTemplateColumns = tracks(240px, minmax(0px, 1fr))\n    minHeight = 100vh\n    color = ink\n    background = paper\n    fontFamily = "Inter, ui-sans-serif, system-ui, sans-serif"\n\n    if viewport.width <= 720px:\n        gridTemplateColumns = tracks(1fr)\n\nconst navLook = look:\n    display = "grid"\n    alignContent = "start"\n    gap = 8px\n    padding = spacing(28px, 20px)\n    borderRight = border(1px, rule)\n    background = paperPure\n\n    if viewport.width <= 720px:\n        flexDirection = "column"\n        justifyContent = "start"\n        borderRight = border(0px, color("transparent"))\n        borderBottom = border(1px, rule)\n\nconst brandLook = look:\n    marginBottom = 16px\n\n    if viewport.width <= 720px:\n        margin = spacing(8px, 12px, 0px, 0px)\n\nconst navLinkLook = look:\n    padding = spacing(8px, 10px)\n    borderRadius = 8px\n    color = inkSoft\n    textDecoration = "none"\n\n    if @current:\n        color = ink\n        background = seaSoft\n\nexport component App:\n    return <div class="shell" look={shellLook}>\n        <nav look={navLook} aria-label="Documentation">\n            <strong look={brandLook}>${escapeVelarString(displayName)}</strong>\n            {pages.map(page => <NavLink key={page.path} to={page.path} exact={true} look={navLinkLook}>{page.label}</NavLink>)}\n        </nav>\n        <Router routes={routes} fallback={NotFound} />\n    </div>\n`],
+        ["src/content.test.vel", `import {expect} from "velar/test"\nimport {pageTitle, pages} from "./content.vel"\n\ntest "documentation navigation":\n    expect(pages).toHaveLength(2)\n    expect(pageTitle("/guide")).toBe("Guide")\n    expect(pageTitle("/missing")).toBe("Page not found")\n`],
+        ["src/app.browser.test.vel", `import {expect} from "velar/test"\nimport {browser} from "velar/web-test"\n\ntest "guide route":\n    await browser.open("/guide")\n    expect(await browser.text("h1")).toBe("Guide")\n    expect(await browser.text("nav")).toContain("Overview")\n`],
+    ]);
+    return files;
+}
+function libraryTemplate(name, displayName, version, formatVersion) {
+    const packageManifest = {
+        name,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        files: ["src"],
+        velar: { entry: "src/index.vel" },
+        scripts: {
+            check: "velar check",
+            format: "velar format",
+            "format:check": "velar format --check",
+            test: "velar test",
+            build: "velar build",
+            "pack:check": "npm pack --dry-run --json",
+            validate: "npm run format:check && npm run check && npm test && npm run build && npm run pack:check",
+        },
+        devDependencies: {
+            "@velarscript/cli": version,
+        },
+    };
+    return new Map([
+        [".gitignore", "node_modules/\ndist/\n.velar/\n"],
+        agentsGuideFile(),
+        ["package.json", json(packageManifest)],
+        ["velar.json", json({
+                formatVersion,
+                entry: "src/index.vel",
+                outDir: "dist",
+                publicDir: "public",
+                extensions: [],
+            })],
+        ["README.md", `# ${displayName}\n\nA reusable VelarScript source library.\n\n\`\`\`sh\nnpm install\nnpm run validate\n\`\`\`\n\nAfter bootstrap, use \`npm exec velar -- add <package>\`, \`remove\`, and \`update\` for project-aware dependency changes. The package is private by default. Remove \`private\` only after choosing a public package name, license, and release policy.\n`],
+        ["src/index.vel", `export type Greeting:\n    message: string\n    recipient: string\n\nexport def greet(name: string) -> Greeting:\n    const recipient = name.trim()\n    assert recipient != "" else "A greeting requires a name"\n    return {message: f"Hello, {recipient}!", recipient: recipient}\n`],
+        ["src/index.test.vel", `import {expect} from "velar/test"\nimport {greet} from "./index.vel"\n\ntest "greeting":\n    const greeting = greet("Velar")\n    expect(greeting.message).toBe("Hello, Velar!")\n    expect(greeting.recipient).toBe("Velar")\n\ntest "greeting rejects blank names":\n    expect(() => greet("   ")).toThrow()\n`],
+    ]);
+}
+function componentTemplate(name, displayName, version, formatVersion) {
+    const packageManifest = {
+        name,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        files: ["src/index.vel", "README.md"],
+        velar: { entry: "src/index.vel" },
+        scripts: {
+            check: "velar check",
+            format: "velar format",
+            "format:check": "velar format --check",
+            test: "velar test",
+            "test:browser": "velar test --browser",
+            build: "velar build",
+            verify: "velar verify",
+            "pack:check": "npm pack --dry-run --json",
+            validate: "npm run format:check && npm run check && npm test && npm run build && npm run verify && npm run pack:check",
+        },
+        peerDependencies: {
+            "@velarscript/web": version,
+        },
+        devDependencies: {
+            "@velarscript/cli": version,
+            "@velarscript/web": version,
+        },
+    };
+    const files = new Map([
+        [".gitignore", "node_modules/\ndist/\n.velar/\n"],
+        agentsGuideFile(),
+        ...brandPublicFiles(),
+        ["package.json", json(packageManifest)],
+        ["velar.json", json({
+                formatVersion,
+                entry: "src/demo.vel",
+                outDir: "dist",
+                publicDir: "public",
+                extensions: ["@velarscript/web"],
+                web: {
+                    title: `${displayName} component preview`,
+                    base: "/",
+                    publicConfig: {},
+                    build: { sourceMaps: false },
+                    security: { contentSecurityPolicy: true, connectSources: [], imageSources: [] },
+                    deployment: { spaFallback: true },
+                },
+            })],
+        ["README.md", `# ${displayName}\n\nA reusable VelarScript Web component source package.\n\n\`\`\`sh\nnpm install\nnpm run validate\nnpm run test:browser\n\`\`\`\n\nThe published package entry is \`src/index.vel\`; \`src/demo.vel\` is the local preview application. The package is private by default. Remove \`private\` only after choosing a public package name, license, and release policy.\n`],
+        ["src/index.vel", `import {domId} from "velar/web"\nimport {border, rgb, rgba} from "velar/look"\n\nexport type CardContent:\n    title: string\n    body: string\n\nexport const exampleContent: CardContent = {title: "Built with VelarScript", body: "A reusable component ships as checked VelarScript source."}\n\nconst cardLook = look:\n    display = "grid"\n    gap = 10px\n    padding = 20px\n    border = border(1px, rgba(17, 18, 22, 0.14))\n    borderRadius = 14px\n    background = rgb(251, 250, 247)\n\nconst titleLook = look:\n    margin = 0\n\nconst bodyLook = look:\n    margin = 0\n    color = rgb(94, 96, 102)\n    lineHeight = 1.6\n\nexport component InfoCard(content: CardContent):\n    const titleId = domId("info-card-title")\n    return <article class="card" look={cardLook} aria-labelledby={titleId}>\n        <h2 look={titleLook} id={titleId}>{content.title}</h2>\n        <p look={bodyLook}>{content.body}</p>\n    </article>\n`],
+        ["src/demo.vel", `import {InfoCard, exampleContent} from "./index.vel"\n\nmount(<main><InfoCard content={exampleContent} /></main>, "#app")\n`],
+        ["src/index.test.vel", `import {expect} from "velar/test"\nimport {exampleContent} from "./index.vel"\n\ntest "component content contract":\n    expect(exampleContent.title).toBe("Built with VelarScript")\n    expect(exampleContent.body).toContain("checked VelarScript source")\n`],
+        ["src/demo.browser.test.vel", `import {expect} from "velar/test"\nimport {browser} from "velar/web-test"\n\ntest "component preview":\n    await browser.open("/")\n    expect(await browser.text("article h2")).toBe("Built with VelarScript")\n    expect(await browser.text("article p")).toContain("reusable component")\n    const titleId = await browser.attribute("article", "aria-labelledby")\n    expect(titleId != null).toBe(true)\n    if titleId != null:\n        expect(titleId).toContain("info-card-title-")\n        expect(await browser.attribute("article h2", "id")).toBe(titleId)\n`],
+    ]);
+    return files;
+}
+function commonWebFiles(name, displayName, version, formatVersion) {
+    return [
+        [".gitignore", "node_modules/\ndist/\n.velar/\n"],
+        agentsGuideFile(),
+        ...brandPublicFiles(),
+        ["package.json", json({
+                name,
+                version: "0.1.0",
+                private: true,
+                type: "module",
+                scripts: {
+                    check: "velar check",
+                    format: "velar format",
+                    "format:check": "velar format --check",
+                    dev: "velar dev",
+                    test: "velar test",
+                    "test:browser": "velar test --browser",
+                    build: "velar build",
+                    verify: "velar verify",
+                    preview: "velar preview",
+                    "verify:deployment": "velar verify-deployment",
+                    validate: "npm run format:check && npm run check && npm test && npm run build && npm run verify",
+                },
+                dependencies: { "@velarscript/web": version },
+                devDependencies: { "@velarscript/cli": version },
+            })],
+        ["velar.json", json({
+                formatVersion,
+                entry: "src/main.vel",
+                outDir: "dist",
+                publicDir: "public",
+                extensions: ["@velarscript/web"],
+                web: {
+                    title: displayName,
+                    base: "/",
+                    publicConfig: {},
+                    build: { sourceMaps: false },
+                    security: { contentSecurityPolicy: true, connectSources: [], imageSources: [] },
+                    deployment: { spaFallback: true },
+                },
+            })],
+        ["src/main.vel", `import {App} from "./app.vel"\n\nmount(<App />, "#app")\n`],
+    ];
+}
+const AGENTS_GUIDE = `# Working in this VelarScript project
+
+This project is written in VelarScript (\`.vel\` sources). VelarScript's
+parents are JavaScript and Python: write on those priors and the compiler
+teaches the rest. Run \`velar skill\` for the full language brief — it ships
+with the toolchain and prints agent-ready markdown to stdout.
+
+## Gates
+
+Run these before considering any change done:
+
+- \`velar check\` — type-checks the whole project; do exactly what each
+  diagnostic says (it names the one current spelling).
+- \`velar test\` — runs the project's tests.
+- \`velar format\` — settles layout (\`velar format --check\` verifies).
+
+\`npm run validate\` runs this project's full gate set from package.json.
+
+## The essentials
+
+- Interpolation is \`f"{value}"\` — \`\${...}\` inside a string is literal
+  text (the one silent trap).
+- Comments are \`//\`. Functions are \`def\`. Record shapes and aliases are
+  \`type\`.
+- \`.size\` not \`.length\`; \`.append(value)\` not \`.push(value)\`.
+- Conditions accept only \`bool\`; test presence with \`value != null\`.
+- One statement per line; no \`++\`; named arguments are \`name=value\`.
+- \`match\` dispatches finite states; \`case _:\` is the fallback.
+- \`await task()\` or detached \`async task()\` — a dropped Promise is a
+  compile error.
+- \`range\` needs \`import {range} from "velar/collections"\`.
+- Multi-line text is a layout string: a quote followed by a newline opens
+  it; a quote at the opening line's indentation closes it.
+- \`print(value)\` inspects any value; f-strings and \`str()\` accept only
+  strings, numbers, bools, enums, and \`null\` — \`stringify\` from
+  \`velar/json\` builds data text.
+
+\`velar skill\` covers the rest: the declaration reference, the idiom
+cookbook, and the complete pitfall table.
+
+## When VelarScript is missing something
+
+In order: \`extern module\` declares a checked boundary to any npm package
+(first choice); \`import js unsafe\` admits a raw value as \`any\` — validate
+it with \`Type.parse\` at the edge; \`import css unsafe "./file.css"
+before|after look\` and \`unsafe:html\` cover styling and markup. If the
+compiler itself seems wrong, reduce to a minimal repro and report it; the
+emitted \`velar build\` JavaScript is always a readable, source-mapped exit
+that runs without the toolchain. \`velar skill\` includes the full
+escape-hatch decision tree.
+`;
+function agentsGuideFile() {
+    return ["AGENTS.md", AGENTS_GUIDE];
+}
+const VELARSCRIPT_MARK_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="85 113 346 290" role="img" aria-labelledby="title">
+  <title id="title">VelarScript</title>
+  <g fill="#181818">
+    <path d="M97 128C98 126 99 125 102 125h94c9 0 15 4 19 13l42 81c6 10 16 17 27 24 12 9 18 21 17 35 0 8-4 16-9 24l-55 81L98 134c-2-3-2-5-1-6Z"/>
+    <path d="M271 180c3-11 10-22 17-29l17-17c6-6 11-9 19-9h95l-86 153c1-9-1-19-6-27-4-7-12-14-19-20l-25-22c-10-8-14-18-12-29Z"/>
+    <path d="m237 383 82-81-46 84c-5 4-11 5-18 5s-13-3-18-8Z"/>
+  </g>
+</svg>
+`;
+function brandPublicFiles() {
+    return [["public/velarscript-mark.svg", VELARSCRIPT_MARK_SVG]];
+}
+function packageName(value) {
+    const normalized = value.toLowerCase()
+        .replace(/[^a-z0-9._-]+/gu, "-")
+        .replace(/^[._-]+|[._-]+$/gu, "")
+        .slice(0, 214);
+    if (!normalized || normalized === "node_modules" || normalized === "favicon.ico")
+        return "velar-app";
+    return normalized;
+}
+function applicationIdentifier(value) {
+    return value.toLowerCase()
+        .replace(/[^a-z0-9-]+/gu, "-")
+        .replace(/^-+|-+$/gu, "")
+        .slice(0, 63) || "app";
+}
+function json(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function escapeVelarString(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll('"', '\\"').replaceAll("\n", "\\n").replaceAll("\r", "\\r");
+}
+function escapeHtml(value) {
+    return value.replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+export declare const VELAR_CREATE_VERSION = "0.10.1";
+export declare const VELAR_PROJECT_FORMAT_VERSION = 2;
+export declare const VELAR_PROJECT_TEMPLATES: readonly ["web", "node", "desktop", "docs", "library", "component"];
+export type VelarProjectTemplate = typeof VELAR_PROJECT_TEMPLATES[number];
+export interface CreateProjectOptions {
+    readonly cwd?: string;
+    readonly template?: VelarProjectTemplate;
+}
+export interface CreateProjectResult {
+    readonly root: string;
+    readonly template: VelarProjectTemplate;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,WAAW,CAAC;AAC7C,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,uBAAuB,qEAAqF,CAAC;AAE1H,MAAM,MAAM,oBAAoB,GAAG,OAAO,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;CACzC"}

package/dist/types.js

@@ -0,0 +1,4 @@
+export const VELAR_CREATE_VERSION = "0.10.1";
+export const VELAR_PROJECT_FORMAT_VERSION = 2;
+export const VELAR_PROJECT_TEMPLATES = Object.freeze(["web", "node", "desktop", "docs", "library", "component"]);
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,CAAU,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "create-velar",
+  "version": "0.10.1",
+  "description": "Create reproducible VelarScript Web, Node, and Desktop applications plus documentation sites and source packages.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "clean": "node ../../scripts/clean-package-dist.mjs",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "postbuild": "node ../../scripts/mark-package-bin.mjs dist/cli.js",
+    "prepack": "npm run build"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VelarOS-AI/VelarScript.git",
+    "directory": "packages/create"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "create-velar": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  }
+}