@sanity/plugin-kit 2.2.0 → 3.0.0

package/src/presets/ui.ts

@@ -0,0 +1,68 @@
+import {Preset} from './presets'
+import {InjectOptions} from '../actions/inject'
+import {forceDependencyVersions, getPackage, sortKeys, writePackageJsonDirect} from '../npm/package'
+import log from '../util/log'
+import chalk from 'chalk'
+import {resolveLatestVersions} from '../npm/resolveLatestVersions'
+import {forcedDevPackageVersions, forcedPackageVersions} from '../configs/forced-package-versions'
+
+export const ui: Preset = {
+  name: 'ui',
+  description: '`@sanity/ui` and dependencies',
+  apply: applyPreset,
+}
+
+async function applyPreset(options: InjectOptions) {
+  await addDependencies(options)
+  await addDevDependencies(options)
+
+  log.info(chalk.green('ui preset injected'))
+}
+
+async function addDependencies(options: InjectOptions) {
+  const pkg = await getPackage(options)
+  const newDeps = sortKeys(
+    forceDependencyVersions(
+      {
+        ...pkg.dependencies,
+        ...(await resolveDependencyList()),
+      },
+      forcedPackageVersions
+    )
+  )
+  const newPkg = {...pkg}
+  newPkg.dependencies = newDeps
+  await writePackageJsonDirect(newPkg, options)
+  log.info('Updated dependencies.')
+}
+
+async function addDevDependencies(options: InjectOptions) {
+  const pkg = await getPackage(options)
+  const newDeps = sortKeys(
+    forceDependencyVersions(
+      {
+        ...pkg.devDependencies,
+        ...(await resolveDevDependencyList()),
+      },
+      forcedDevPackageVersions
+    )
+  )
+  const newPkg = {...pkg}
+  newPkg.devDependencies = newDeps
+  await writePackageJsonDirect(newPkg, options)
+  log.info('Updated devDependencies.')
+}
+
+async function resolveDependencyList(): Promise<Record<string, string>> {
+  return resolveLatestVersions(['@sanity/icons', '@sanity/ui'])
+}
+
+async function resolveDevDependencyList(): Promise<Record<string, string>> {
+  return resolveLatestVersions([
+    // install the peer dependencies of `@sanity/ui` as dev dependencies
+    'react',
+    'react-dom',
+    'react-is',
+    'styled-components',
+  ])
+}

package/src/sanity/manifest.ts

@@ -233,7 +233,7 @@ async function validatePartFiles(
     return
   }
 
-  const [srcExists, libExists] = await Promise.all([
+  const [srcExists, outDirExists] = await Promise.all([
     hasSourceFile(part.path, paths),
     verifyCompiledParts && hasCompiledFile(part.path, paths),
   ])
@@ -246,7 +246,7 @@ async function validatePartFiles(
     )
   }
 
-  if (verifyCompiledParts && !libExists) {
+  if (verifyCompiledParts && !outDirExists) {
     throw new Error(
       `Invalid sanity.json: Part path references file ("${part.path}") that does not exist in compiled directory (${paths?.compiled}) (parts[${index}])`
     )

package/src/util/files.ts

@@ -24,10 +24,10 @@ export function hasSourceEquivalent(compiledFile: string, paths: ManifestPaths)
     )
   }
 
-  // /plugin/lib/MyComponent.js => /plugin/src
+  // /plugin/dist/MyComponent.js => /plugin/src
   const baseDir = path.dirname(compiledFile.replace(paths.compiled as string, paths.source))
 
-  // /plugin/lib/MyComponent.js => MyComponent
+  // /plugin/dist/MyComponent.js => MyComponent
   const baseName = path.basename(compiledFile, path.extname(compiledFile))
 
   // MyComponent => /plugin/src/MyComponent
@@ -72,14 +72,14 @@ export function hasCompiledFile(filePath: string, paths?: ManifestPaths) {
   }
 
   // filePath: components/SomeInput
-  // paths: {compiled: '/plugin/lib'}
+  // paths: {compiled: '/plugin/dist'}
 
-  // components/SomeInput => /plugin/lib/components/SomeInput
+  // components/SomeInput => /plugin/dist/components/SomeInput
   const absPath = path.isAbsolute(filePath) ? filePath : path.resolve(paths.compiled, filePath)
 
-  // /plugin/lib/components/SomeInput     => /plugin/lib/components/SomeInput.js
-  // /plugin/lib/components/SomeInput.js  => /plugin/lib/components/SomeInput.js
-  // /plugin/lib/components/SomeInput.css => /plugin/lib/components/SomeInput.css
+  // /plugin/dist/components/SomeInput     => /plugin/dist/components/SomeInput.js
+  // /plugin/dist/components/SomeInput.js  => /plugin/dist/components/SomeInput.js
+  // /plugin/dist/components/SomeInput.css => /plugin/dist/components/SomeInput.css
   const fileExt = path.extname(absPath)
   const withExt = fileExt === '' ? `${absPath}.js` : absPath
 
@@ -106,7 +106,7 @@ export async function readJsonFile<T>(filePath: string) {
 }
 
 export function writeJsonFile(filePath: string, content: Record<string, unknown>) {
-  const data = JSON.stringify(content, null, 2)
+  const data = JSON.stringify(content, null, 2) + '\n'
   return writeFile(filePath, data, {encoding: 'utf8'})
 }
 

package/src/util/readme.ts

@@ -7,7 +7,8 @@ import {User} from './user'
 export function generateReadme(data: PackageData) {
   const {user, pluginName, license, description} = data
 
-  return outdent`
+  return (
+    outdent`
     # ${pluginName}
 
     ${v3BannerNotice()}
@@ -15,22 +16,23 @@ export function generateReadme(data: PackageData) {
     ${installationSnippet(pluginName ?? 'unknown')}
 
     ## Usage
-    Add it as a plugin in sanity.config.ts (or .js):
 
+    Add it as a plugin in \`sanity.config.ts\` (or .js):
+
+    \`\`\`ts
+    import {defineConfig} from 'sanity'
+    import {myPlugin} from '${pluginName}'
+
+    export default defineConfig({
+      //...
+      plugins: [myPlugin({})],
+    })
     \`\`\`
-     import {defineConfig} from 'sanity'
-     import {myPlugin} from '${pluginName}'
-
-     export const defineConfig({
-         //...
-         plugins: [
-             myPlugin({})
-         ]
-     })
-    \`\`\`
+
     ${getLicenseText(license?.id, user?.name ? (user as User) : undefined)}
     ${developTestSnippet()}
-  `
+  ` + '\n'
+  )
 }
 
 export function v3BannerNotice() {
@@ -41,8 +43,8 @@ export function installationSnippet(packageName: string) {
   return outdent`
     ## Installation
 
-    \`\`\`
-    npm install --save ${packageName}@studio-v3
+    \`\`\`sh
+    npm install ${packageName}
     \`\`\`
     `
 }

package/src/util/ts.ts

@@ -0,0 +1,13 @@
+import {loadTSConfig} from '@sanity/pkg-utils'
+import path from 'path'
+import {fileExists} from './files'
+
+export async function readTSConfig(options: {basePath: string; filename: string}) {
+  const {basePath, filename} = options
+  const filePath = path.resolve(basePath, filename)
+  const exists = await fileExists(filePath)
+
+  if (!exists) return undefined
+
+  return await loadTSConfig({cwd: basePath, tsconfigPath: filename})
+}

package/assets/inject/gitignore

@@ -1,57 +0,0 @@
-# Logs
-logs
-*.log
-npm-debug.log*
-
-# Runtime data
-pids
-*.pid
-*.seed
-
-# Directory for instrumented libs generated by jscoverage/JSCover
-lib-cov
-
-# Coverage directory used by tools like istanbul
-coverage
-
-# nyc test coverage
-.nyc_output
-
-# Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files)
-.grunt
-
-# node-waf configuration
-.lock-wscript
-
-# Compiled binary addons (http://nodejs.org/api/addons.html)
-build/Release
-
-# Dependency directories
-node_modules
-jspm_packages
-
-# Optional npm cache directory
-.npm
-
-# Optional REPL history
-.node_repl_history
-
-# macOS finder cache file
-.DS_Store
-
-# VS Code settings
-.vscode
-
-# IntelliJ
-.idea
-*.iml
-
-# Cache
-.cache
-
-# Yalc
-.yalc
-yalc.lock
-
-##npm package zips
-*.tgz

package/assets/inject/package.config.template

@@ -1,16 +0,0 @@
-import {defineConfig} from '@sanity/pkg-utils'
-
-export default defineConfig({
-  dist: 'lib',
-  minify: true,
-  legacyExports: true,
-  // Remove this block to enable strict export validation
-  extract: {
-    rules: {
-      'ae-forgotten-export': 'off',
-      'ae-incompatible-release-tags': 'off',
-      'ae-internal-missing-underscore': 'off',
-      'ae-missing-release-tag': 'off',
-    },
-  },
-})

package/assets/inject/template-tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "jsx": "preserve",
-    "moduleResolution": "node",
-    "target": "esnext",
-    "module": "esnext",
-    "esModuleInterop": true,
-    "lib": ["DOM", "DOM.Iterable", "ESNext"],
-    "strict": true,
-    "sourceMap": false,
-    "inlineSourceMap": false,
-    "downlevelIteration": true,
-    "declaration": true,
-    "allowSyntheticDefaultImports": true,
-    "experimentalDecorators": true,
-    "emitDecoratorMetadata": true,
-    "outDir": "lib",
-    "skipLibCheck": true,
-    "isolatedModules": true,
-    "checkJs": false,
-    "rootDir": "src"
-  },
-  "include": ["src/**/*"]
-}

package/lib/package.json

@@ -1,129 +0,0 @@
-{
-    "name": "@sanity/plugin-kit",
-    "version": "2.2.0",
-    "description": "Enhanced Sanity.io plugin development experience",
-    "keywords": [
-        "sanity-io",
-        "sanity",
-        "plugin",
-        "development",
-        "babel",
-        "typescript",
-        "bootstrap"
-    ],
-    "homepage": "https://github.com/sanity-io/plugin-kit#readme",
-    "bugs": {
-        "url": "https://github.com/sanity-io/plugin-kit/issues"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+ssh://git@github.com/sanity-io/plugin-kit.git"
-    },
-    "license": "MIT",
-    "author": "Sanity.io <hello@sanity.io>",
-    "main": "./lib/src/index.js",
-    "source": "./src/index.ts",
-    "types": "./lib/src/index.d.ts",
-    "bin": "lib/src/index.js",
-    "files": [
-        "v2-incompatible.js",
-        "src",
-        "lib",
-        "assets"
-    ],
-    "scripts": {
-        "prebuild": "npm run clean",
-        "build": "tsc",
-        "postbuild": "node executable-index.js",
-        "clean": "rimraf lib",
-        "commit": "git-cz",
-        "compile": "tsc --noEmit",
-        "format": "prettier src -w",
-        "lint": "eslint .",
-        "prepare": "husky install",
-        "prepublishOnly": "npm run build",
-        "test": "tap",
-        "watch": "tsc --watch"
-    },
-    "tap": {
-        "browser": false,
-        "check-coverage": false,
-        "coverage-report": [
-            "html"
-        ],
-        "jobs": 2,
-        "reporter": "spec",
-        "test-ignore": "^lib/.*|.*ignore.*|.*run-test-command.*|.*fixture.utils.*",
-        "timeout": 120,
-        "ts": true
-    },
-    "dependencies": {
-        "@rexxars/choosealicense-list": "^1.1.2",
-        "chalk": "^4.1.2",
-        "concurrently": "^7.5.0",
-        "discover-path": "^1.0.0",
-        "email-validator": "^2.0.4",
-        "execa": "^5.1.1",
-        "find-babel-config": "^1.2.0",
-        "get-it": "^7.0.2",
-        "get-latest-version": "^4.0.0",
-        "git-remote-origin-url": "^3.1.0",
-        "git-user-info": "^2.0.3",
-        "github-url-to-object": "^4.0.6",
-        "inquirer": "^8.2.5",
-        "meow": "^9.0.0",
-        "nodemon": "^2.0.20",
-        "npm-packlist": "^7.0.2",
-        "npm-run-path": "^4.0.1",
-        "outdent": "^0.8.0",
-        "p-any": "^3.0.0",
-        "p-props": "^4.0.0",
-        "postcss": "^8.4.19",
-        "rimraf": "^3.0.2",
-        "semver": "^7.3.8",
-        "spdx-license-ids": "^3.0.12",
-        "validate-npm-package-name": "^5.0.0",
-        "xdg-basedir": "^4.0.0",
-        "yalc": "^1.0.0-pre.53"
-    },
-    "devDependencies": {
-        "@commitlint/cli": "^17.2.0",
-        "@commitlint/config-conventional": "^17.2.0",
-        "@sanity/pkg-utils": "^1.20.1",
-        "@sanity/semantic-release-preset": "^2.0.2",
-        "@sanity/ui-workshop": "^1.0.1",
-        "@types/eslint": "^8.4.10",
-        "@types/fs-extra": "^9.0.13",
-        "@types/inquirer": "^9.0.3",
-        "@types/node": "^18.11.9",
-        "@types/nodemon": "^1.19.2",
-        "@types/tap": "^15.0.7",
-        "@typescript-eslint/eslint-plugin": "^5.43.0",
-        "@typescript-eslint/parser": "^5.43.0",
-        "eslint": "^8.27.0",
-        "eslint-config-prettier": "^8.5.0",
-        "eslint-config-sanity": "^6.0.0",
-        "eslint-plugin-prettier": "^4.2.1",
-        "eslint-plugin-react-hooks": "^4.6.0",
-        "fs-extra": "^10.1.0",
-        "husky": "^8.0.2",
-        "json5": "^2.2.1",
-        "lint-staged": "^13.0.3",
-        "prettier": "^2.7.1",
-        "prettier-plugin-packagejson": "^2.3.0",
-        "readdirp": "^3.6.0",
-        "rimraf": "^3.0.2",
-        "sanity": "^3.0.0",
-        "sinon": "^14.0.2",
-        "tap": "^16.3.1",
-        "ts-node": "^10.9.1",
-        "typescript": "^4.8.4"
-    },
-    "peerDependencies": {
-        "eslint": ">=8.0.0"
-    },
-    "engines": {
-        "node": ">=14"
-    },
-    "binname": "sanity-plugin"
-}

package/lib/src/actions/init.d.ts

@@ -1,73 +0,0 @@
-import { TypedFlags } from 'meow';
-export declare const initFlags: {
-    readonly scripts: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly eslint: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly typescript: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly prettier: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly license: {
-        readonly type: "string";
-    };
-    readonly editorconfig: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly gitignore: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly force: {
-        readonly type: "boolean";
-        readonly default: false;
-    };
-    readonly install: {
-        readonly type: "boolean";
-        readonly default: true;
-    };
-    readonly name: {
-        readonly type: "string";
-    };
-    readonly author: {
-        readonly type: "string";
-    };
-    readonly repo: {
-        readonly type: "string";
-    };
-    readonly presetOnly: {
-        readonly type: "boolean";
-        readonly default: false;
-    };
-    readonly preset: {
-        readonly type: "string";
-        readonly isMultiple: true;
-    };
-    readonly debug: {
-        readonly default: false;
-        readonly type: "boolean";
-    };
-    readonly silent: {
-        readonly type: "boolean";
-        readonly default: false;
-    };
-    readonly verbose: {
-        readonly type: "boolean";
-        readonly default: false;
-    };
-};
-export declare type InitFlags = TypedFlags<typeof initFlags>;
-export interface InitOptions {
-    basePath: string;
-    flags: InitFlags;
-}
-export declare function init(options: InitOptions): Promise<void>;

package/lib/src/actions/init.js

@@ -1,79 +0,0 @@
-"use strict";
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.init = exports.initFlags = void 0;
-const path_1 = __importDefault(require("path"));
-const inject_1 = require("./inject");
-const files_1 = require("../util/files");
-const sharedFlags_1 = __importDefault(require("../sharedFlags"));
-const package_1 = require("../npm/package");
-const default_source_1 = require("../configs/default-source");
-exports.initFlags = Object.assign(Object.assign({}, sharedFlags_1.default), { scripts: {
-        type: 'boolean',
-        default: true,
-    }, eslint: {
-        type: 'boolean',
-        default: true,
-    }, typescript: {
-        type: 'boolean',
-        default: true,
-    }, prettier: {
-        type: 'boolean',
-        default: true,
-    }, license: {
-        type: 'string',
-    }, editorconfig: {
-        type: 'boolean',
-        default: true,
-    }, gitignore: {
-        type: 'boolean',
-        default: true,
-    }, force: {
-        type: 'boolean',
-        default: false,
-    }, install: {
-        type: 'boolean',
-        default: true,
-    }, name: {
-        type: 'string',
-    }, author: {
-        type: 'string',
-    }, repo: {
-        type: 'string',
-    }, presetOnly: {
-        type: 'boolean',
-        default: false,
-    }, preset: {
-        type: 'string',
-        isMultiple: true,
-    } });
-function init(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        let dependencies = {};
-        let devDependencies = {};
-        let peerDependencies = {};
-        yield (0, inject_1.inject)(Object.assign(Object.assign({}, options), { requireUserConfirmation: !options.flags.force, dependencies,
-            devDependencies,
-            peerDependencies, validate: false }));
-        const packageJson = yield (0, package_1.getPackage)({ basePath: options.basePath, validate: false });
-        const typescript = options.flags.typescript;
-        const source = typescript ? (0, default_source_1.defaultSourceTs)(packageJson) : (0, default_source_1.defaultSourceJs)(packageJson);
-        const filename = typescript ? 'index.ts' : 'index.js';
-        const srcDir = path_1.default.resolve(options.basePath, 'src');
-        yield (0, files_1.ensureDir)(srcDir);
-        yield (0, files_1.writeFile)(path_1.default.join(srcDir, filename), source, { encoding: 'utf8' });
-    });
-}
-exports.init = init;
-//# sourceMappingURL=init.js.map

package/lib/src/actions/init.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/actions/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,gDAAuB;AACvB,qCAA+B;AAC/B,yCAAkD;AAClD,iEAAwC;AAExC,4CAAyC;AACzC,8DAA0E;AAE7D,QAAA,SAAS,GAAG,gCACpB,qBAAW,KACd,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,MAAM,EAAE;QACN,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,UAAU,EAAE;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,QAAQ,EAAE;QACR,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;KACf,EACD,YAAY,EAAE;QACZ,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,SAAS,EAAE;QACT,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,KAAK,EAAE;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,EACD,OAAO,EAAE;QACP,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,IAAI;KACd,EACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;KACf,EACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;KACf,EACD,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;KACf,EACD,UAAU,EAAE;QACV,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;KACf,EACD,MAAM,EAAE;QACN,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,IAAI;KACjB,GACO,CAAA;AASV,SAAsB,IAAI,CAAC,OAAoB;;QAC7C,IAAI,YAAY,GAAG,EAAE,CAAA;QACrB,IAAI,eAAe,GAAG,EAAE,CAAA;QACxB,IAAI,gBAAgB,GAAG,EAAE,CAAA;QAEzB,MAAM,IAAA,eAAM,kCACP,OAAO,KACV,uBAAuB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAC7C,YAAY;YACZ,eAAe;YACf,gBAAgB,EAChB,QAAQ,EAAE,KAAK,IACf,CAAA;QAEF,MAAM,WAAW,GAAG,MAAM,IAAA,oBAAU,EAAC,EAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAC,CAAC,CAAA;QACnF,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAA;QAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAA,gCAAe,EAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAA,gCAAe,EAAC,WAAW,CAAC,CAAA;QACvF,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAA;QACrD,MAAM,MAAM,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;QACpD,MAAM,IAAA,iBAAS,EAAC,MAAM,CAAC,CAAA;QACvB,MAAM,IAAA,iBAAS,EAAC,cAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,EAAC,QAAQ,EAAE,MAAM,EAAC,CAAC,CAAA;IAC1E,CAAC;CAAA;AArBD,oBAqBC"}

package/lib/src/actions/inject.d.ts

@@ -1,31 +0,0 @@
-import { InitFlags } from './init';
-import { PackageJson } from './verify/types';
-export declare type FromTo = {
-    from: string | string[];
-    to: string | string[];
-};
-export interface InjectOptions {
-    basePath: string;
-    requireUserConfirmation?: boolean;
-    flags: InitFlags;
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    peerDependencies?: Record<string, string>;
-    validate?: boolean;
-}
-export interface PackageData {
-    user?: {
-        name?: string;
-        email?: string;
-    };
-    pluginName?: string;
-    license?: {
-        id: string;
-        text: string;
-    };
-    description?: string;
-    pkg?: PackageJson;
-    gitOrigin?: string;
-}
-export declare function inject(options: InjectOptions): Promise<void>;
-export declare function writeAssets(files: FromTo[], { basePath, flags }: InjectOptions): Promise<string[]>;