dartvel_dev 0.2.1

package/LICENSE

@@ -0,0 +1,110 @@
+# Functional Source License, Version 1.1, MIT Future License
+
+## Abbreviation
+
+FSL-1.1-MIT
+
+## Notice
+
+Copyright 2026 Daniel Effiong
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly display
+and redistribute the Software for any Permitted Purpose identified below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing Use
+means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe our
+patents, the license grant above includes a license under our patents. If you
+make a claim against any party that the Software infringes or contributes to
+the infringement of any patent, then your patent license to the Software ends
+immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives of
+the Software.
+
+If you redistribute any copies, modifications or derivatives of the Software,
+you must include a copy of or a link to these Terms and Conditions and not
+remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A PARTICULAR
+PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO THE
+SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES,
+EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin of
+the Software, you have no right under these Terms and Conditions to use our
+trademarks, trade names, service marks or product names.
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software under
+the MIT license that is effective on the second anniversary of the date we make
+the Software available. On or after that date, you may use the Software under
+the MIT license, in which case the following will apply:
+
+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,42 @@
+# dartvel_dev
+
+A batteries-included, AI-native full-stack application platform built around
+Flutter.
+
+```sh
+npx dartvel_dev --help
+# or
+npm install -g dartvel_dev
+dartvel --help
+```
+
+## Why the package is `dartvel_dev` and the command is `dartvel`
+
+`dartvel` on pub.dev was taken on 2026-08-06 by an unrelated package, so the
+published identifier carries a suffix. The command you type does not, and
+neither does anything else you interact with.
+
+The same name is used on [pub.dev](https://pub.dev/packages/dartvel_dev) and in
+the [Homebrew tap](https://github.com/Danroyal001/homebrew-dartvel_dev), so
+whichever way you install it, it is called the same thing.
+
+## What this package does
+
+It launches the real CLI rather than containing a copy of it.
+
+Dartvel is a Dart toolchain: `dartvel` is a Dart executable published on
+pub.dev. Vendoring a compiled build into an npm package would ship a second
+copy that drifts from the one `dart pub global activate` installs, and would
+need a release per platform before this package could exist at all.
+
+So on first run this finds `dartvel` on your PATH, and if it is not there,
+installs it with `dart pub global activate dartvel_dev` and runs it through
+`dart pub global run` — which works whether or not `~/.pub-cache/bin` is on
+your PATH.
+
+If there is no Dart SDK at all, it says so and points at the Flutter installer,
+rather than failing with a command-not-found from somewhere three layers down.
+
+## Requirements
+
+The Dart SDK, which the Flutter SDK includes. Node 18 or newer.

package/bin/dartvel.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const { run } = require('../index');
+
+run(process.argv.slice(2))
+  .then((code) => process.exit(code))
+  .catch((error) => {
+    console.error('Error running dartvel:', error.message);
+    process.exit(1);
+  });

package/index.js

@@ -0,0 +1,101 @@
+// A launcher, not a copy of the framework.
+//
+// Dartvel is a Dart toolchain: the `dartvel` command is a Dart executable
+// published on pub.dev as `dartvel_dev`. Vendoring a compiled build of it into
+// an npm package would ship a second copy that drifts from the one
+// `dart pub global activate` installs, so this finds the real one, installs it
+// on first use, and gets out of the way.
+//
+// The npm package exists because many people reach for `npx` before anything
+// else, and because the name should belong to the project.
+//
+// The package is `dartvel_dev` and the command is `dartvel`. Those differ on
+// purpose: `dartvel` was taken on pub.dev on 2026-08-06 by an unrelated
+// package, so the published name carries the suffix while the thing you type
+// does not.
+
+'use strict';
+
+const { spawn, spawnSync } = require('child_process');
+
+/** The pub.dev package that carries the CLI. */
+const PUB_PACKAGE = 'dartvel_dev';
+
+/** The command that package installs. */
+const COMMAND = 'dartvel';
+
+/** Where to send someone who has no Dart at all. */
+const INSTALL_DART = 'https://docs.flutter.dev/get-started/install';
+
+function which(command) {
+  const probe = spawnSync(
+    process.platform === 'win32' ? 'where' : 'which',
+    [command],
+    { encoding: 'utf8' }
+  );
+  return probe.status === 0 && String(probe.stdout).trim().length > 0;
+}
+
+/** Whether the Dartvel CLI is already on the PATH. */
+function hasDartvel() {
+  return which(COMMAND);
+}
+
+/** Whether a Dart SDK is available to install it with. */
+function hasDart() {
+  return which('dart') || which('flutter');
+}
+
+function activate() {
+  // Not silent: this downloads and compiles, and a launcher that appears to
+  // hang is worse than one that says what it is doing.
+  process.stderr.write(
+    `${COMMAND} is not installed yet — running: ` +
+      `dart pub global activate ${PUB_PACKAGE}\n`
+  );
+  const result = spawnSync('dart', ['pub', 'global', 'activate', PUB_PACKAGE], {
+    stdio: 'inherit',
+  });
+  return result.status === 0;
+}
+
+/** Run the Dartvel CLI with `args`, resolving to its exit code. */
+function run(args) {
+  if (hasDartvel()) {
+    return spawnThrough(COMMAND, args);
+  }
+
+  if (!hasDart()) {
+    process.stderr.write(
+      'Dartvel needs the Dart SDK, and there is no `dart` on your PATH.\n' +
+        `Install Flutter, which includes Dart: ${INSTALL_DART}\n`
+    );
+    return Promise.resolve(1);
+  }
+
+  if (!activate()) {
+    process.stderr.write(
+      `Could not install ${PUB_PACKAGE} from pub.dev.\n` +
+        `Try it directly: dart pub global activate ${PUB_PACKAGE}\n`
+    );
+    return Promise.resolve(1);
+  }
+
+  // `pub global activate` installs into ~/.pub-cache/bin, which is on the PATH
+  // only if the user has put it there. Going through `dart pub global run`
+  // works either way.
+  return spawnThrough('dart', ['pub', 'global', 'run', PUB_PACKAGE, ...args]);
+}
+
+function spawnThrough(command, args) {
+  return new Promise((resolve) => {
+    const child = spawn(command, args, { stdio: 'inherit' });
+    child.on('error', (error) => {
+      process.stderr.write(`Could not run ${command}: ${error.message}\n`);
+      resolve(1);
+    });
+    child.on('close', (code) => resolve(code === null ? 1 : code));
+  });
+}
+
+module.exports = { run, hasDartvel, hasDart, PUB_PACKAGE, COMMAND };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "dartvel_dev",
+  "version": "0.2.1",
+  "description": "Dartvel — a batteries-included, AI-native full-stack application platform built around Flutter. This is the npm launcher for the CLI published on pub.dev as dartvel_dev.",
+  "main": "./index.js",
+  "bin": {
+    "dartvel": "./bin/dartvel.js",
+    "dartvel_dev": "./bin/dartvel.js"
+  },
+  "files": [
+    "bin/",
+    "index.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./index.js"
+  },
+  "scripts": {
+    "test": "node --check index.js && node --check bin/dartvel.js && node test.js"
+  },
+  "keywords": [
+    "dartvel",
+    "flutter",
+    "dart",
+    "full-stack",
+    "framework",
+    "cli"
+  ],
+  "author": "SigmaDev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Danroyal001/dartvel_dev.git"
+  },
+  "homepage": "https://dartvel.dev",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {}
+}