@typespec/compiler 1.15.0-dev.4 → 1.15.0-dev.6

package/dist/src/init/template-source/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/init/template-source/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,qGAAqG;AACrG,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACjD,sFAAsF;IACtF,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACrD"}

package/dist/src/init/template-source/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/init/template-source/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/init/template-source/types.ts"],"names":[],"mappings":""}

package/dist/src/init/template-source/uri-template-source.d.ts

@@ -0,0 +1,30 @@
+import type { SourceFile, SystemHost } from "../../core/types.js";
+import type { LoadedTemplateIndex, TemplateSource } from "./types.js";
+/** File name of the template index within a template source directory. */
+export declare const SCAFFOLDING_FILENAME = "scaffolding.json";
+/**
+ * A {@link TemplateSource} backed by a location: a filesystem path or a URL. The index and every
+ * template file are read through a {@link SystemHost} via {@link readUrlOrPath}, so this handles both
+ * a local directory and a remote `tsp init <url>` uniformly. Built-in templates are served through
+ * {@link defaultInternalTemplateSource} (or an injected provider) instead.
+ *
+ * Loading an untrusted remote template can execute arbitrary code during scaffolding; callers are
+ * responsible for confirming the source with the user before using it.
+ */
+export declare class UriTemplateSource implements TemplateSource {
+    #private;
+    /**
+     * @param host Host used to read the index and template files.
+     * @param indexLocation Location of the index file (a path or URL). Template files are resolved
+     * relative to its containing directory.
+     */
+    constructor(host: SystemHost, indexLocation: string);
+    /**
+     * Create a source for a template root directory (path or URL) whose index is a
+     * `scaffolding.json` at its root.
+     */
+    static fromDirectory(host: SystemHost, directory: string): UriTemplateSource;
+    loadIndex(): Promise<LoadedTemplateIndex>;
+    readFile(relativePath: string): Promise<SourceFile>;
+}
+//# sourceMappingURL=uri-template-source.d.ts.map

package/dist/src/init/template-source/uri-template-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-template-source.d.ts","sourceRoot":"","sources":["../../../../src/init/template-source/uri-template-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtE,0EAA0E;AAC1E,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AAEvD;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,YAAW,cAAc;;IAMtD;;;;OAIG;gBACS,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM;IAMnD;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAOtE,SAAS,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAMzC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CAG1D"}

package/dist/src/init/template-source/uri-template-source.js

@@ -0,0 +1,45 @@
+import { getDirectoryPath } from "../../core/path-utils.js";
+import { readUrlOrPath, resolveRelativeUrlOrPath } from "../../utils/misc.js";
+/** File name of the template index within a template source directory. */
+export const SCAFFOLDING_FILENAME = "scaffolding.json";
+/**
+ * A {@link TemplateSource} backed by a location: a filesystem path or a URL. The index and every
+ * template file are read through a {@link SystemHost} via {@link readUrlOrPath}, so this handles both
+ * a local directory and a remote `tsp init <url>` uniformly. Built-in templates are served through
+ * {@link defaultInternalTemplateSource} (or an injected provider) instead.
+ *
+ * Loading an untrusted remote template can execute arbitrary code during scaffolding; callers are
+ * responsible for confirming the source with the user before using it.
+ */
+export class UriTemplateSource {
+    #host;
+    #indexLocation;
+    /** Directory (path or URL) that template file paths are resolved against. */
+    #baseUri;
+    /**
+     * @param host Host used to read the index and template files.
+     * @param indexLocation Location of the index file (a path or URL). Template files are resolved
+     * relative to its containing directory.
+     */
+    constructor(host, indexLocation) {
+        this.#host = host;
+        this.#indexLocation = indexLocation;
+        this.#baseUri = getDirectoryPath(indexLocation);
+    }
+    /**
+     * Create a source for a template root directory (path or URL) whose index is a
+     * `scaffolding.json` at its root.
+     */
+    static fromDirectory(host, directory) {
+        return new UriTemplateSource(host, resolveRelativeUrlOrPath(directory + "/", SCAFFOLDING_FILENAME));
+    }
+    async loadIndex() {
+        const indexFile = await readUrlOrPath(this.#host, this.#indexLocation);
+        const templates = JSON.parse(indexFile.text);
+        return { templates, indexFile, baseUri: this.#baseUri };
+    }
+    async readFile(relativePath) {
+        return readUrlOrPath(this.#host, resolveRelativeUrlOrPath(this.#baseUri + "/", relativePath));
+    }
+}
+//# sourceMappingURL=uri-template-source.js.map

package/dist/src/init/template-source/uri-template-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri-template-source.js","sourceRoot":"","sources":["../../../../src/init/template-source/uri-template-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAG9E,0EAA0E;AAC1E,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAa;IAClB,cAAc,CAAS;IACvB,6EAA6E;IAC7E,QAAQ,CAAS;IAEjB;;;;OAIG;IACH,YAAY,IAAgB,EAAE,aAAqB;QACjD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,CAAC,IAAgB,EAAE,SAAiB;QACtD,OAAO,IAAI,iBAAiB,CAC1B,IAAI,EACJ,wBAAwB,CAAC,SAAS,GAAG,GAAG,EAAE,oBAAoB,CAAC,CAChE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,YAAoB;QACjC,OAAO,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,wBAAwB,CAAC,IAAI,CAAC,QAAQ,GAAG,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;IAChG,CAAC;CACF"}

package/dist/src/internals/index.d.ts

@@ -6,6 +6,8 @@ export { resolveCompilerOptions } from "../config/config-to-options.js";
 export { NodeSystemHost } from "../core/node-system-host.js";
 export { InitTemplateSchema } from "../init/init-template.js";
 export { makeScaffoldingConfig, scaffoldNewProject } from "../init/scaffold.js";
+export type { TemplateSource } from "../init/template-source/types.js";
+export { UriTemplateSource } from "../init/template-source/uri-template-source.js";
 export { resolveEntrypointFile } from "../server/entrypoint-resolver.js";
 export { InternalCompileResult, ServerDiagnostic } from "../server/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/internals/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internals/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internals/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEhF,YAAY,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/internals/index.js

@@ -9,5 +9,6 @@ export { resolveCompilerOptions } from "../config/config-to-options.js";
 export { NodeSystemHost } from "../core/node-system-host.js";
 export { InitTemplateSchema } from "../init/init-template.js";
 export { makeScaffoldingConfig, scaffoldNewProject } from "../init/scaffold.js";
+export { UriTemplateSource } from "../init/template-source/uri-template-source.js";
 export { resolveEntrypointFile } from "../server/entrypoint-resolver.js";
 //# sourceMappingURL=index.js.map

package/dist/src/internals/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internals/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,IAAI,CAAE,UAAkB,CAAC,6BAA6B,EAAE,CAAC;IACvD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;AAC/F,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internals/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,IAAI,CAAE,UAAkB,CAAC,6BAA6B,EAAE,CAAC;IACvD,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;AAC/F,CAAC;AAED,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}

package/entrypoints/cli.js

@@ -2,6 +2,4 @@
  * File serving as an entrypoint to resolve a local tsp install from a global install.
  * DO NOT MOVE or this will create a breaking change for user of global cli.
  */
-import { runTypeSpecCli } from "../dist/src/core/cli/cli.js";
-
-await runTypeSpecCli();
+import "../dist/src/core/cli/cli.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@typespec/compiler",
-  "version": "1.15.0-dev.4",
+  "version": "1.15.0-dev.6",
   "description": "TypeSpec compiler and standard library",
   "author": "Microsoft Corporation",
   "license": "MIT",
@@ -60,13 +60,9 @@
     "./internals/prettier-formatter": {
       "import": "./dist/src/internals/prettier-formatter.js"
     },
-    "./internals/standalone": {
-      "import": "./dist/src/internals/standalone.js"
-    },
     "./casing": {
       "import": "./dist/src/casing/index.js"
-    },
-    "./package.json": "./package.json"
+    }
   },
   "browser": {
     "./dist/src/core/node-host.js": "./dist/src/core/node-host.browser.js",

package/dist/src/internals/standalone.d.ts

@@ -1,13 +0,0 @@
-/**
- * Internal API used to build a self-contained ("standalone") TypeSpec CLI that bundles the compiler
- * into a single executable.
- *
- * This is a separate entrypoint from `@typespec/compiler/internals` on purpose: `runTypeSpecCli`
- * reaches into the CLI runner, which transitively loads `node-host` (top-level `await`) and Node
- * built-ins. Keeping it out of the general `internals` barrel avoids forcing those onto every
- * browser/CommonJS consumer of `internals` (e.g. the VS Code extension and the playground).
- *
- * DO NOT USE. Not part of the public API and may change at any time with no warning.
- */
-export { runTypeSpecCli } from "../core/cli/cli.js";
-//# sourceMappingURL=standalone.d.ts.map

package/dist/src/internals/standalone.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../../../src/internals/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/internals/standalone.js

@@ -1,13 +0,0 @@
-/**
- * Internal API used to build a self-contained ("standalone") TypeSpec CLI that bundles the compiler
- * into a single executable.
- *
- * This is a separate entrypoint from `@typespec/compiler/internals` on purpose: `runTypeSpecCli`
- * reaches into the CLI runner, which transitively loads `node-host` (top-level `await`) and Node
- * built-ins. Keeping it out of the general `internals` barrel avoids forcing those onto every
- * browser/CommonJS consumer of `internals` (e.g. the VS Code extension and the playground).
- *
- * DO NOT USE. Not part of the public API and may change at any time with no warning.
- */
-export { runTypeSpecCli } from "../core/cli/cli.js";
-//# sourceMappingURL=standalone.js.map

package/dist/src/internals/standalone.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../../../src/internals/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}