@stacksjs/utils 0.38.3

package/LICENSE.md

@@ -0,0 +1,21 @@
+# MIT License
+
+Copyright (c) 2022 Open Web Foundation
+
+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/dist/helpers.d.ts

@@ -0,0 +1,32 @@
+import { type CliOptions, type Manifest, type NpmScript } from '@stacksjs/types';
+export declare function isProjectCreated(): Promise<boolean>;
+export declare function readVersion(): Promise<any>;
+export declare function isAppKeySet(): Promise<boolean>;
+/**
+ * Determines the utilized reset preset.
+ *
+ * @url https://www.npmjs.com/package/@unocss/reset
+ * @param preset
+ */
+export declare function determineResetPreset(preset?: string): string[];
+export declare function env(key?: string, fallback?: any): any;
+export declare function config(key?: string, fallback?: string): void;
+/**
+ * Determines whether the specified value is a package manifest.
+ */
+export declare function isManifest(obj: any): obj is Manifest;
+/**
+ * Determines whether the specified value is a string, null, or undefined.
+ */
+export declare function isOptionalString(value: any): value is string | undefined;
+export declare function setEnvValue(key: string, value: string): Promise<void>;
+/**
+ * Runs the specified NPM script in the package.json file.
+ */
+export declare function runNpmScript(script: NpmScript, options?: CliOptions): Promise<any>;
+/**
+ * Determines whether the specified NPM script exists in the given manifest.
+ */
+export declare function hasScript(manifest: Manifest, script: NpmScript): boolean;
+export * as detectIndent from 'detect-indent';
+export { detectNewline } from 'detect-newline';

package/dist/helpers.mjs

@@ -0,0 +1,74 @@
+import { log, runCommand, spawn } from "@stacksjs/cli";
+import { ExitCode } from "@stacksjs/types";
+import { frameworkPath, projectPath } from "@stacksjs/path";
+import storage from "@stacksjs/storage";
+import { ui } from "@stacksjs/config";
+export async function isProjectCreated() {
+  if (storage.isFile(".env"))
+    return await isAppKeySet();
+  if (storage.isFile(".env.example"))
+    await spawn("cp .env.example .env", { stdio: "inherit", cwd: projectPath() });
+  return await isAppKeySet();
+}
+export async function readVersion() {
+  const packageJson = await storage.fs.readJson(frameworkPath("package.json"));
+  return packageJson.version;
+}
+export async function isAppKeySet() {
+  const env2 = await storage.readTextFile(".env", projectPath());
+  const lines = env2.data.split("\n");
+  const appKey = lines.find((line) => line.startsWith("APP_KEY="));
+  if (appKey && appKey.length > 16)
+    return true;
+  return false;
+}
+export function determineResetPreset(preset) {
+  if (ui.reset)
+    preset = ui.reset;
+  if (preset === "tailwind")
+    return ["import '@unocss/reset/tailwind.css'"];
+  if (preset === "normalize")
+    return ["import '@unocss/reset/normalize.css'"];
+  if (preset === "sanitize")
+    return ["import '@unocss/reset/sanitize/sanitize.css'", "import '@unocss/reset/sanitize/assets.css"];
+  if (preset === "eric-meyer")
+    return ["import '@unocss/reset/eric-meyer.css'"];
+  if (preset === "antfu")
+    return ["import '@unocss/reset/antfu.css'"];
+  return [];
+}
+export function env(key, fallback) {
+  return fallback;
+}
+export function config(key, fallback) {
+  console.log("key", key, "fallback", fallback);
+}
+export function isManifest(obj) {
+  return obj && typeof obj === "object" && isOptionalString(obj.name) && isOptionalString(obj.version) && isOptionalString(obj.description);
+}
+export function isOptionalString(value) {
+  const type = typeof value;
+  return value === null || type === "undefined" || type === "string";
+}
+export async function setEnvValue(key, value) {
+  const file = await storage.readTextFile(projectPath(".env"));
+  await storage.writeTextFile({
+    path: projectPath(".env"),
+    data: file.data.replace(/APP_KEY=/g, `APP_KEY=${value}`)
+  });
+}
+export async function runNpmScript(script, options) {
+  const { data: manifest } = await storage.readJsonFile("package.json", frameworkPath());
+  if (isManifest(manifest) && hasScript(manifest, script))
+    return await runCommand(`pnpm run ${script}`, { ...options, cwd: frameworkPath() });
+  log.error(`The specified npm script "${script}" does not exist in the package.json file`);
+  process.exit(ExitCode.FatalError);
+}
+export function hasScript(manifest, script) {
+  const scripts = manifest.scripts;
+  if (scripts && typeof scripts === "object")
+    return Boolean(scripts[script]);
+  return false;
+}
+export * as detectIndent from "detect-indent";
+export { detectNewline } from "detect-newline";

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './helpers';
+export * from '@vueuse/core';
+export * from '@vueuse/math';
+export * from '@vueuse/head';
+export * from '@vueuse/shared';

package/dist/index.mjs

@@ -0,0 +1,5 @@
+export * from "./helpers.mjs";
+export * from "@vueuse/core";
+export * from "@vueuse/math";
+export * from "@vueuse/head";
+export * from "@vueuse/shared";

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@stacksjs/utils",
+  "type": "module",
+  "version": "0.38.3",
+  "packageManager": "pnpm@7.15.0",
+  "description": "The Stacks helper functions.",
+  "author": "Chris Breuer",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/chrisbbreuer",
+  "homepage": "https://github.com/stacksjs/stacks/tree/main/.stacks/core/helpers#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stacksjs/stacks.git",
+    "directory": "./.stacks/core/helpers"
+  },
+  "bugs": {
+    "url": "https://github.com/stacksjs/stacks/issues"
+  },
+  "keywords": [
+    "objects",
+    "strings",
+    "arrays",
+    "alias",
+    "helpers",
+    "utilities",
+    "functions",
+    "stacks"
+  ],
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "contributors": [
+    "Chris Breuer <chris@ow3.org>"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=v18.12.1",
+    "pnpm": ">=7.15.0"
+  },
+  "peerDependencies": {
+    "@stacksjs/cli": "0.38.3",
+    "@stacksjs/config": "0.38.3",
+    "@stacksjs/lint": "0.38.3",
+    "@stacksjs/path": "0.38.3",
+    "@stacksjs/storage": "0.38.3",
+    "@stacksjs/types": "0.38.3",
+    "@vueuse/core": "^9.5.0",
+    "@vueuse/head": "^0.9.8",
+    "@vueuse/math": "^9.5.0",
+    "@vueuse/shared": "^9.5.0",
+    "defu": "^6.1.0",
+    "detect-indent": "^7.0.1",
+    "detect-newline": "^4.0.0",
+    "esno": "^0.16.3",
+    "fast-glob": "^3.2.12",
+    "kolorist": "1.6.0",
+    "rimraf": "^3.0.2"
+  },
+  "devDependencies": {
+    "mkdist": "^0.4.0",
+    "typescript": "^4.8.4"
+  },
+  "scripts": {
+    "build": "mkdist -d",
+    "dev": "mkdist -d",
+    "typecheck": "tsc --noEmit"
+  }
+}