@rose42/t3-feedback 0.1.0 → 0.1.2

package/dist/types.d.ts

@@ -227,14 +227,23 @@ export type T3FeedbackPickOptions = {
      * When a picked element resolves to a component file, make the path in the
      * ELEMENT chip clickable to open it in the IDE.
      *
-     * - omit / `true` — GET Vite's `/__open-in-editor?file=path:line:column`
-     *   (set `LAUNCH_EDITOR=cursor` or `code` if auto-detect fails)
+     * - omit / `true` — GET `{api}/open-editor?file=path:line:column` (bridge;
+     *   launches Cursor/VS Code remote CLI). Falls back from Vite’s
+     *   `/__open-in-editor` so preview proxies share the feedback origin.
      * - `false` — plain text path, no open action
-     * - `{ endpoint }` — same as Vite, but a custom path (still `?file=`)
+     * - `{ endpoint }` — custom GET path (still `?file=`)
      * - `{ urlTemplate }` — navigate to a URL with `{file}`, `{line}`, `{column}`
      *   (e.g. `vscode://file/{file}:{line}:{column}`); wins over `endpoint`
      */
     openInEditor?: boolean | T3FeedbackOpenInEditorOptions;
+    /**
+     * Prefix resolved component paths so they are workspace-relative
+     * (e.g. `examples/vite-react` → `examples/vite-react/src/App.tsx`).
+     * Use when the Vite/Next app cwd is a subfolder of the T3 / IDE workspace.
+     * The Vite plugin also derives this automatically when `workspaceRootHints`
+     * points at an ancestor of the Vite root.
+     */
+    sourcePathPrefix?: string;
 };
 /** Custom open-in-editor behavior when not using the Vite default endpoint alone. */
 export type T3FeedbackOpenInEditorOptions = {
@@ -297,9 +306,20 @@ export type T3FeedbackPickConfig = {
     sourceFramework: "react" | "next" | "vue" | "svelte" | "qwik" | "locator" | "auto" | "none";
     /** `null` when open-in-editor is disabled. */
     openInEditor: T3FeedbackOpenInEditorConfig | null;
+    /**
+     * Workspace-relative prefix for resolved source paths (`undefined` when unset).
+     * See {@link T3FeedbackPickOptions.sourcePathPrefix}.
+     */
+    sourcePathPrefix?: string;
 };
 /** Default Vite DEV endpoint for opening a file in the editor. */
 export declare const DEFAULT_OPEN_IN_EDITOR_ENDPOINT = "/__open-in-editor";
+/**
+ * Prefer the bridge `/open-editor` route (same origin as feedback posts) over
+ * Vite's `/__open-in-editor` so preview proxies and Cursor remote CLIs work.
+ * Explicit custom endpoints / urlTemplates are left alone.
+ */
+export declare function resolveOpenInEditorEndpointForApi(openInEditor: T3FeedbackOpenInEditorConfig | null, apiEndpoint: string): T3FeedbackOpenInEditorConfig | null;
 /** Resolved screenshot options embedded in the client config. */
 export type T3FeedbackScreenshotConfig = {
     /** `null` when capture shortcut is disabled. */
@@ -315,6 +335,8 @@ export type T3FeedbackRecordConfig = {
 };
 export declare function resolveOpenInEditorConfig(value?: boolean | T3FeedbackOpenInEditorOptions): T3FeedbackOpenInEditorConfig | null;
 export declare function resolvePickConfig(pick?: T3FeedbackPickOptions): T3FeedbackPickConfig;
+/** Trim / slash-normalize a pick `sourcePathPrefix` (empty → undefined). */
+export declare function normalizePickSourcePathPrefix(prefix?: string | null): string | undefined;
 export declare function resolveScreenshotConfig(screenshot?: T3FeedbackScreenshotOptions, pickCropPaddingPx?: number): T3FeedbackScreenshotConfig;
 export declare function resolveRecordConfig(record?: T3FeedbackRecordOptions): T3FeedbackRecordConfig;
 /**
@@ -366,6 +388,21 @@ export type T3FeedbackBuiltinPluginOptions = {
 export declare function resolveActivePlugins(active?: readonly T3BuiltinPluginId[], includeConsoleLogs?: boolean): Set<T3BuiltinPluginId>;
 /** Stable ordered list of active built-in ids (for JSON client config). */
 export declare function resolveActivePluginList(active?: readonly T3BuiltinPluginId[], includeConsoleLogs?: boolean): T3BuiltinPluginId[];
+/**
+ * Provider + model for newly created T3 threads (`thread.create` `modelSelection`).
+ * `instanceId` is the T3 provider instance (e.g. `"cursor"`, `"codex"`).
+ */
+export type T3FeedbackModelSelection = {
+    instanceId: string;
+    model: string;
+};
+/** Default provider/model when creating threads (Cursor Auto-style default). */
+export declare const DEFAULT_MODEL_SELECTION: T3FeedbackModelSelection;
+/**
+ * Normalize a configured / env / inherited model selection.
+ * Returns `undefined` when both fields are empty after trim.
+ */
+export declare function normalizeModelSelection(value: Partial<T3FeedbackModelSelection> | null | undefined): T3FeedbackModelSelection | undefined;
 /** Options for `t3FeedbackPlugin` (Node / Vite config). */
 export type T3FeedbackPluginOptions = {
     /** T3 HTTP origin. Default: http://localhost:3773 (override via T3_FEEDBACK_ORIGIN). */
@@ -377,6 +414,15 @@ export type T3FeedbackPluginOptions = {
      * an in-container hostname). Do **not** point this at another container's T3.
      */
     openOrigin?: string;
+    /**
+     * Provider/model for **new** feedback threads.
+     * Default: `{ instanceId: "cursor", model: "default" }`.
+     * When omitted, the bridge prefers an existing project thread that already
+     * uses the same `instanceId` (so Cursor Auto settings are reused) instead of
+     * copying the first thread (which may be a disabled provider like Codex).
+     * Overridable via `T3_FEEDBACK_INSTANCE_ID` / `T3_FEEDBACK_MODEL`.
+     */
+    modelSelection?: T3FeedbackModelSelection;
     /**
      * Optional prefix for newly created thread titles
      * (e.g. `"Checkout"` → `"Checkout: /pay · broken CTA"`).

package/dist/types.js

@@ -73,6 +73,23 @@ export const DEFAULT_RECORD_SHORTCUT = {
 };
 /** Default Vite DEV endpoint for opening a file in the editor. */
 export const DEFAULT_OPEN_IN_EDITOR_ENDPOINT = "/__open-in-editor";
+/**
+ * Prefer the bridge `/open-editor` route (same origin as feedback posts) over
+ * Vite's `/__open-in-editor` so preview proxies and Cursor remote CLIs work.
+ * Explicit custom endpoints / urlTemplates are left alone.
+ */
+export function resolveOpenInEditorEndpointForApi(openInEditor, apiEndpoint) {
+    if (!openInEditor)
+        return null;
+    if (openInEditor.urlTemplate)
+        return openInEditor;
+    const pathOnly = openInEditor.endpoint.split("?")[0] ?? openInEditor.endpoint;
+    if (pathOnly !== DEFAULT_OPEN_IN_EDITOR_ENDPOINT && !pathOnly.endsWith("/__open-in-editor")) {
+        return openInEditor;
+    }
+    const base = apiEndpoint.replace(/\/$/, "") || "/__t3-feedback";
+    return { endpoint: `${base}/open-editor` };
+}
 export function resolveOpenInEditorConfig(value) {
     if (value === false)
         return null;
@@ -103,6 +120,7 @@ export function resolvePickConfig(pick) {
         pick?.sourceFramework === "auto"
         ? pick.sourceFramework
         : "auto";
+    const sourcePathPrefix = normalizePickSourcePathPrefix(pick?.sourcePathPrefix);
     return {
         shortcut,
         afterPick: pick?.afterPick ?? "crop",
@@ -112,8 +130,16 @@ export function resolvePickConfig(pick) {
         styles: pick?.styles ?? "none",
         sourceFramework,
         openInEditor: resolveOpenInEditorConfig(pick?.openInEditor),
+        ...(sourcePathPrefix ? { sourcePathPrefix } : {}),
     };
 }
+/** Trim / slash-normalize a pick `sourcePathPrefix` (empty → undefined). */
+export function normalizePickSourcePathPrefix(prefix) {
+    if (typeof prefix !== "string")
+        return undefined;
+    const cleaned = prefix.trim().replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
+    return cleaned || undefined;
+}
 export function resolveScreenshotConfig(screenshot, pickCropPaddingPx = 12) {
     const shortcut = screenshot?.shortcut === false
         ? null
@@ -281,3 +307,24 @@ export function resolveActivePluginList(active, includeConsoleLogs) {
     const set = resolveActivePlugins(active, includeConsoleLogs);
     return T3_BUILTIN_PLUGIN_IDS.filter((id) => set.has(id));
 }
+/** Default provider/model when creating threads (Cursor Auto-style default). */
+export const DEFAULT_MODEL_SELECTION = {
+    instanceId: "cursor",
+    model: "default",
+};
+/**
+ * Normalize a configured / env / inherited model selection.
+ * Returns `undefined` when both fields are empty after trim.
+ */
+export function normalizeModelSelection(value) {
+    if (!value)
+        return undefined;
+    const instanceId = typeof value.instanceId === "string" ? value.instanceId.trim() : "";
+    const model = typeof value.model === "string" ? value.model.trim() : "";
+    if (!instanceId && !model)
+        return undefined;
+    return {
+        instanceId: instanceId || DEFAULT_MODEL_SELECTION.instanceId,
+        model: model || DEFAULT_MODEL_SELECTION.model,
+    };
+}

package/docs/devcontainer.md

@@ -77,6 +77,8 @@ t3 --no-browser --port "${T3CODE_PORT:-3775}"
 
 Keep this project’s port unique vs other concurrent containers (`3773`, `3774`, …). Same host port ⇒ same browser origin ⇒ sessions kick each other off (`Invalid session token signature`).
 
+Demo app ports are also forwarded from this same container (`5173`–`5176`, `3000`, `8787`) — see [examples/README.md](../examples/README.md).
+
 `T3_FEEDBACK_ORIGIN` / `T3_FEEDBACK_OPEN_ORIGIN` follow the same `T3CODE_PORT` default so the plugin bridges to this instance. Consumer projects must set both to **their** T3 port — not this plugin container's — or Open links will embed this environment's id/label.
 
 ### Override on conflict

package/docs/release.md

@@ -0,0 +1,47 @@
+# Release
+
+Releases are driven by **version tags** (`vX.Y.Z`). Pushing a tag runs CI:
+
+**verify** → **GitLab Release** (dist tarball in the package registry) → **npm publish** via OIDC trusted publishing.
+
+CI uses the `node:24` image (npm ≥ 11.5.1). Publish must run on **GitLab.com shared runners** — self-hosted runners are not supported for npm OIDC.
+
+## One-time npm trusted publisher setup
+
+1. Create or join the **`rose42`** org on [npmjs.com](https://www.npmjs.com) with permission to publish `@rose42/*`.
+2. On the package page for [`@rose42/t3-feedback`](https://www.npmjs.com/package/@rose42/t3-feedback): **Settings → Trusted Publishing → GitLab CI/CD**. Configure (values are case-sensitive):
+   - **Namespace**: `rose42`
+   - **Project name**: `t3-feedback`
+   - **Top-level CI file path**: `.gitlab-ci.yml`
+   - **Environment name**: leave empty (this pipeline does not use GitLab environments)
+   - **Allowed actions**: at least `npm publish`
+3. Do **not** add an `NPM_TOKEN` CI variable or write `_authToken` into `.npmrc` for publish. The `publish` job requests `NPM_ID_TOKEN` (audience `npm:registry.npmjs.org`); the npm CLI exchanges that OIDC token for a short-lived publish credential. A fallback token overrides OIDC and breaks the flow.
+4. Optional local check: `pnpm login` then `pnpm publish --dry-run --access public`.
+
+### After the first successful tag publish
+
+1. In GitLab: **Settings → CI/CD → Variables** — remove `NPM_TOKEN` if it still exists (or stop using it).
+2. Optionally on npm → package **Settings → Publishing access**: require 2FA and disallow tokens.
+
+## Cut a release
+
+Requires a clean git worktree. Bumps `package.json`, commits, tags `vX.Y.Z`, and pushes (with `--follow-tags`) so the tag pipeline runs.
+
+```bash
+pnpm release -- 0.1.0    # first release (exact version)
+# later:
+pnpm release -- patch    # or: minor | major
+```
+
+After the pipeline succeeds:
+
+- npm: [`@rose42/t3-feedback`](https://www.npmjs.com/package/@rose42/t3-feedback)
+- GitLab: **Deploy → Releases** (asset links to the generic package tarball)
+
+## CI publish job (OIDC)
+
+The `publish` job in [`.gitlab-ci.yml`](../.gitlab-ci.yml):
+
+- Requests `NPM_ID_TOKEN` with `aud: "npm:registry.npmjs.org"`
+- Optionally requests `SIGSTORE_ID_TOKEN` with `aud: sigstore` for provenance
+- Runs `pnpm publish --access public --no-git-checks` with **no** `~/.npmrc` `_authToken`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rose42/t3-feedback",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "DEV-only: capture app feedback and send it to a T3 Code thread (unofficial community tool)",
   "license": "MIT",
@@ -58,29 +58,11 @@
     "docs",
     "!dist/**/*.map"
   ],
-  "scripts": {
-    "dev": "tsc -p tsconfig.build.json --watch",
-    "build": "rm -rf dist && tsc -p tsconfig.build.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "lint": "eslint .",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "release": "bash scripts/release.sh",
-    "prepublishOnly": "pnpm typecheck && pnpm lint && pnpm test && pnpm build"
-  },
   "engines": {
     "node": ">=24"
   },
-  "packageManager": "pnpm@10.21.0",
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
-  },
   "dependencies": {
-    "@rose42/feedback-capture": "0.1.0",
+    "@rose42/feedback-capture": "~0.1.1",
     "ws": "^8.18.3"
   },
   "peerDependencies": {
@@ -103,5 +85,24 @@
     "typescript-eslint": "^8.46.4",
     "vite": "^7.0.0",
     "vitest": "^3.2.7"
+  },
+  "scripts": {
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "eslint .",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "release": "bash scripts/release.sh",
+    "examples:install": "bash scripts/examples-install.sh",
+    "examples:all": "bash scripts/examples-all.sh",
+    "examples:vite-react": "pnpm --dir examples/vite-react dev",
+    "examples:vite-vue": "pnpm --dir examples/vite-vue dev",
+    "examples:vite-svelte": "pnpm --dir examples/vite-svelte dev",
+    "examples:vite-qwik": "pnpm --dir examples/vite-qwik dev",
+    "examples:next": "pnpm --dir examples/next-app dev",
+    "examples:node": "pnpm --dir examples/node-bridge dev"
   }
-}
+}