@devframes/plugin-code-server 1.0.0 → 1.2.0

package/dist/node/cli.mjs

@@ -1,4 +1,4 @@
-import { t as createCodeServerDevframe } from "../node-DsrJ39Mw.mjs";
+import { t as createCodeServerDevframe } from "../node-D3KgF49K.mjs";
 import { createCac } from "devframe/adapters/cac";
 //#region src/node/cli.ts
 /**

package/dist/node/index.mjs

@@ -1,3 +1,3 @@
-import { t as createCodeServerDevframe } from "../node-DsrJ39Mw.mjs";
+import { t as createCodeServerDevframe } from "../node-D3KgF49K.mjs";
 import { DEFAULT_CODE_SERVER_PORT, DEFAULT_PORT, PLUGIN_ID, STATE_KEY, getCookieSessionName } from "./constants.mjs";
 export { DEFAULT_CODE_SERVER_PORT, DEFAULT_PORT, PLUGIN_ID, STATE_KEY, createCodeServerDevframe, createCodeServerDevframe as default, getCookieSessionName };

package/dist/node/setup.d.mts

@@ -223,7 +223,7 @@ interface DetectCodeServerResult {
  */
 export declare function detectCodeServer(bin?: string, timeoutMs?: number): Promise<DetectCodeServerResult>;
 //#endregion
-//#region ../../node_modules/.pnpm/nostics@1.2.0/node_modules/nostics/dist/diagnostic-wduO7saY.d.mts
+//#region ../../node_modules/.pnpm/nostics@1.3.0/node_modules/nostics/dist/diagnostic-C0zzcNxA.d.mts
 //#region src/utils.d.ts
 /**
  * A value of type T, or a function that resolves T from a single params object.
@@ -271,7 +271,7 @@ type Prettify<Type> = { [Key in keyof Type]: Type[Key]; };
  * time. Runtime-only fields (`cause`, `sources`) from {@link DiagnosticInit}
  * are intentionally omitted: they're only meaningful at the call site.
  */
-interface DiagnosticDefinition<P = any> {
+interface DiagnosticDefinition<P = any, Data extends Record<string, unknown> = Record<string, unknown>> {
   /**
    * The error message: why this failed. String, or a function of `params`.
    *
@@ -298,6 +298,11 @@ interface DiagnosticDefinition<P = any> {
    * derived from `docsBase`.
    */
   docs?: string | false;
+  /**
+   * Structured information associated with this diagnostic. A function can
+   * derive the data from the same params object as `why` and `fix`.
+   */
+  data?: ValueOrFn<Data, P>;
 }
 /**
  * Runtime-only fields that can be passed alongside the interpolation params
@@ -317,12 +322,7 @@ interface DiagnosticCallParams {
    */
   sources?: string[];
 }
-/**
- * Structured initializer for a {@link Diagnostic}. `why` is the only required
- * field: it becomes the {@link Diagnostic.message}. The remaining fields are
- * optional metadata that reporters and consumers can render or forward.
- */
-interface DiagnosticInit extends DiagnosticCallParams {
+interface DiagnosticInitBase extends DiagnosticCallParams {
   /**
    * The diagnostic code, e.g. `MATH_E001`. Appear as {@link Diagnostic.name}.
    */
@@ -341,21 +341,53 @@ interface DiagnosticInit extends DiagnosticCallParams {
    */
   docs?: string;
 }
+/**
+ * Structured initializer for a {@link Diagnostic}. `why` is the only required
+ * field: it becomes the {@link Diagnostic.message}. The remaining fields are
+ * optional metadata that reporters and consumers can render or forward.
+ */
+type DiagnosticInit<Data = undefined> = DiagnosticInitBase & ([Data] extends [undefined] ? {
+  data?: undefined;
+} : {
+  data: Data;
+});
+/**
+ * Serializable representation returned by {@link Diagnostic.toJSON}.
+ */
+interface DiagnosticJSON<Data = unknown> {
+  name: string;
+  why: string;
+  fix?: string;
+  docs?: string;
+  sources?: string[];
+  cause?: unknown;
+  data: Data;
+  stack?: string;
+}
 /**
  * Permissive reporter constraint used internally so reporters with 1 arg,
  * required options, or optional options all satisfy the array constraint.
  *
  * @internal
  */
-type AnyDiagnosticReporter = (diagnostic: Diagnostic, options: any) => void;
+type AnyDiagnosticReporter = (diagnostic: Diagnostic<any>, options: any) => void;
 /**
  * Resolves the `params` type a code expects from the intersection of params
- * across all function-typed fields, falling back to `{}` when every field is
+ * across all function-typed fields, falling back to `unknown` when every field is
  * static. Merged with {@link DiagnosticCallParams} at the call site.
  *
  * @internal
  */
-type InferCodeParams<Def> = [ExtractFnParam<Def[keyof Def]>] extends [never] ? {} : UnionToIntersection<ExtractFnParam<Def[keyof Def]>>;
+type InferCodeParams<Def> = [ExtractFnParam<Def[keyof Def]>] extends [never] ? unknown : UnionToIntersection<ExtractFnParam<Def[keyof Def]>>;
+/**
+ * Resolves the data stored by a code definition. Codes without data return a
+ * diagnostic whose data is `undefined`.
+ *
+ * @internal
+ */
+type InferCodeData<Def> = Def extends {
+  data: infer Data;
+} ? Data extends ((...args: any[]) => infer ResolvedData) ? ResolvedData : Data : undefined;
 /**
  * The first positional argument of a {@link DiagnosticHandle} call:
  * interpolation params merged with the runtime-only call-site fields
@@ -364,6 +396,13 @@ type InferCodeParams<Def> = [ExtractFnParam<Def[keyof Def]>] extends [never] ? {
  * @internal
  */
 type CallSiteParams<Params> = Params & DiagnosticCallParams;
+/**
+ * Checks whether an object has required fields. Making every field optional
+ * changes assignability only when the original type has required fields.
+ *
+ * @internal
+ */
+type HasRequiredFields<Type> = Partial<Type> extends Type ? false : true;
 /**
  * Resolves the full argument tuple for a {@link DiagnosticHandle} call.
  * Branches on whether params and reporter options each have required fields.
@@ -373,7 +412,7 @@ type CallSiteParams<Params> = Params & DiagnosticCallParams;
  *
  * @internal
  */
-type ActionArgs<Params, ReporterOpts> = keyof ReporterOpts extends never ? {} extends Params ? [params?: CallSiteParams<Params>] : [params: CallSiteParams<Params>] : {} extends ReporterOpts ? {} extends Params ? [params?: CallSiteParams<Params>, reporterOptions?: ReporterOpts] : [params: CallSiteParams<Params>, reporterOptions?: ReporterOpts] : {} extends Params ? [params: CallSiteParams<Params> | undefined, reporterOptions: ReporterOpts] : [params: CallSiteParams<Params>, reporterOptions: ReporterOpts];
+type ActionArgs<Params, ReporterOpts> = keyof ReporterOpts extends never ? HasRequiredFields<Params> extends false ? [params?: CallSiteParams<Params>] : [params: CallSiteParams<Params>] : HasRequiredFields<ReporterOpts> extends false ? HasRequiredFields<Params> extends false ? [params?: CallSiteParams<Params>, reporterOptions?: ReporterOpts] : [params: CallSiteParams<Params>, reporterOptions?: ReporterOpts] : HasRequiredFields<Params> extends false ? [params: CallSiteParams<Params> | undefined, reporterOptions: ReporterOpts] : [params: CallSiteParams<Params>, reporterOptions: ReporterOpts];
 /**
  * Per-code handle exposed by {@link defineDiagnostics}. Each code is a
  * callable: invoke it to build the diagnostic and run every reporter, or
@@ -385,19 +424,20 @@ type ActionArgs<Params, ReporterOpts> = keyof ReporterOpts extends never ? {} ex
  * throw diagnostics.MATH_E001({ name: 'x' })     // throw
  * ```
  */
-interface DiagnosticHandle<Params, ReporterOpts> {
+interface DiagnosticHandle<Params, ReporterOpts, Data = undefined> {
   /**
    * Builds the diagnostic, runs every reporter, and returns the diagnostic
    * instance. The returned diagnostic can be inspected, attached as `cause`,
    * or thrown with `throw`.
    */
-  (...args: ActionArgs<Params, ReporterOpts>): Diagnostic;
+  (...args: ActionArgs<Params, ReporterOpts>): Diagnostic<Data>;
 }
 /**
  * Return type of {@link defineDiagnostics}.
  */
-type Diagnostics<Codes extends Record<string, DiagnosticDefinition>, Reporters extends readonly AnyDiagnosticReporter[]> = { [Code in keyof Codes]: DiagnosticHandle<InferCodeParams<Codes[Code]>, Prettify<ExtractReportersOptions<Reporters>>>; };
-declare class Diagnostic extends Error {
+type Diagnostics<Codes extends Record<string, DiagnosticDefinition>, Reporters extends readonly AnyDiagnosticReporter[], DataOverride = never> = { [Code in keyof Codes]: DiagnosticHandle<InferCodeParams<Codes[Code]>, Prettify<ExtractReportersOptions<Reporters>>, [DataOverride] extends [never] ? InferCodeData<Codes[Code]> : DataOverride>; };
+type StackTraceFrame = ((...args: never[]) => unknown) | (abstract new (...args: never[]) => unknown);
+declare class Diagnostic<Data = undefined> extends Error {
   name: string;
   /**
    * The diagnostic code, e.g. `MATH_E001`.
@@ -420,6 +460,10 @@ declare class Diagnostic extends Error {
    * stack and should be omitted.
    */
   sources?: string[];
+  /**
+   * Structured information associated with this diagnostic code.
+   */
+  data: Data;
   /**
    * Alias for {@link Error.message}: the reason this diagnostic was raised.
    */
@@ -431,25 +475,25 @@ declare class Diagnostic extends Error {
    * `defineDiagnostics` passes its action method to strip its own frames too.
    * Ignored on engines without `Error.captureStackTrace`.
    */
-  constructor(init: DiagnosticInit, captureFrom?: Function);
+  constructor(init: DiagnosticInit<Data>, captureFrom?: StackTraceFrame);
   /**
    * Converts the diagnostic into a serializable structured object.
    */
-  toJSON(): object;
+  toJSON(): DiagnosticJSON<Data>;
 }
 /**
  * Extracts the options object a reporter accepts as its 2nd argument. Returns
- * `{}` when the reporter has no 2nd arg (so it contributes nothing to the
+ * `unknown` when the reporter has no 2nd arg (so it contributes nothing to the
  * merged shape).
  */
-type ExtractSingleReporterOptions<Reporter> = Reporter extends ((diagnostic: Diagnostic, options: infer ReporterOpts) => any) ? IsUnknown<ReporterOpts> extends true ? {} : Exclude<ReporterOpts, undefined> : {};
+type ExtractSingleReporterOptions<Reporter> = Reporter extends ((diagnostic: Diagnostic, options: infer ReporterOpts) => any) ? IsUnknown<ReporterOpts> extends true ? unknown : Exclude<ReporterOpts, undefined> : unknown;
 /**
  * Intersects every reporter's options shape into a single object. If any
  * reporter has a required field, the merged shape has a required field, and
- * {@link ActionArgs} flips `reporterOptions` from optional to required via
- * `{} extends Merged`.
+ * {@link ActionArgs} makes `reporterOptions` required when the merged shape
+ * has required keys.
  */
-type ExtractReportersOptions<Reporters extends readonly any[]> = Reporters extends readonly [infer First, ...infer Rest] ? ExtractSingleReporterOptions<First> & ExtractReportersOptions<Rest> : {};
+type ExtractReportersOptions<Reporters extends readonly any[]> = Reporters extends readonly [infer First, ...infer Rest] ? ExtractSingleReporterOptions<First> & ExtractReportersOptions<Rest> : unknown;
 //#endregion
 //#region src/node/diagnostics.d.ts
 /**
@@ -495,7 +539,7 @@ export declare const diagnostics: Diagnostics<{
   };
 }, readonly [(d: Diagnostic, { method }?: {
   method?: "log" | "warn" | "error";
-}) => void]>;
+}) => void], never>;
 //#endregion
 //#region src/node/setup.d.ts
 /**

package/dist/node/vite.mjs

@@ -1,4 +1,4 @@
-import { t as createCodeServerDevframe } from "../node-DsrJ39Mw.mjs";
+import { t as createCodeServerDevframe } from "../node-D3KgF49K.mjs";
 import { devframeViteBridge, devframeVitePlugin } from "@devframes/vite/single";
 //#region src/node/vite.ts
 /**

package/dist/{node-DsrJ39Mw.mjs → node-D3KgF49K.mjs}

@@ -2,7 +2,7 @@ import { PLUGIN_ID } from "./node/constants.mjs";
 import { defineDevframe } from "devframe";
 //#region package.json
 var name = "@devframes/plugin-code-server";
-var version = "1.0.0";
+var version = "1.2.0";
 var description = "Devframe plugin that runs VS Code in the browser as an embedded editor panel.";
 var homepage = "https://github.com/devframes/devframe#readme";
 //#endregion

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@devframes/plugin-code-server",
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Devframe plugin that runs VS Code in the browser as an embedded editor panel.",
   "author": "Anthony Fu <anthonyfu117@hotmail.com>",
   "license": "MIT",
@@ -39,8 +39,8 @@
     "dist"
   ],
   "peerDependencies": {
-    "@devframes/plugin-code-server--assets": "1.0.0",
-    "devframe": "1.0.0",
+    "@devframes/plugin-code-server--assets": "1.2.0",
+    "devframe": "1.2.0",
     "vite": "^8.0.0"
   },
   "peerDependenciesMeta": {
@@ -52,27 +52,27 @@
     }
   },
   "dependencies": {
-    "@devframes/vite": "1.0.0",
+    "@devframes/vite": "1.2.0",
     "cac": "^7.0.0"
   },
   "devDependencies": {
-    "@antfu/design": "^0.4.0",
-    "@devframes/plugin-code-server--assets": "1.0.0",
+    "@antfu/design": "^0.6.0",
+    "@devframes/plugin-code-server--assets": "1.2.0",
     "@iconify-json/ph": "^1.2.2",
-    "@storybook/addon-docs": "^10.6.0",
-    "@storybook/vue3-vite": "^10.6.0",
-    "@types/node": "^26.5.1",
-    "@vitejs/plugin-vue": "^6.0.8",
+    "@storybook/addon-docs": "^10.6.1",
+    "@storybook/vue3-vite": "^10.6.1",
+    "@types/node": "^26.6.4",
+    "@vitejs/plugin-vue": "^6.0.9",
     "colorjs.io": "^0.7.1",
-    "devframe": "1.0.0",
-    "h3": "^2.0.1-rc.31",
+    "devframe": "1.2.0",
+    "h3": "^2.0.1-rc.32",
     "pathe": "^2.0.3",
-    "storybook": "^10.6.0",
+    "storybook": "^10.6.1",
     "tsdown": "^0.23.0",
-    "unocss": "^66.10.2",
-    "vite": "^8.3.0",
-    "vitest": "^5.0.0",
-    "vue": "^3.5.42"
+    "unocss": "^66.10.5",
+    "vite": "^8.3.2",
+    "vitest": "^5.0.3",
+    "vue": "^3.5.43"
   },
   "scripts": {
     "build": "tsdown && vite build --config app/vite.config.ts",