sculpted 0.2.3 → 0.3.1

package/README.md

@@ -76,6 +76,10 @@ routes for supported saves.
 In production builds, the plugin is dark: no runtime script is injected, no inspector metadata is
 added, and no manifest or writeback route is registered.
 
+React Router 7 framework-mode apps need one extra development-only runtime script in the root
+document because React Router renders HTML outside Vite's `index.html` transform. See
+[React Router 7 framework mode](docs/vite-plugin.md#react-router-7-framework-mode).
+
 See [Vite plugin options](docs/vite-plugin.md) for the full option surface, defaults, and endpoint
 configuration.
 
@@ -113,13 +117,10 @@ instead of pretending the full cascade can be edited safely.
 
 ## Documentation
 
-- [Vite plugin options](docs/vite-plugin.md) covers setup, defaults, endpoint configuration, and
-  dev/prod behavior.
+- [Vite plugin options](docs/vite-plugin.md) covers setup, defaults, and dev/prod behavior.
 - [Source writeback](docs/source-writeback.md) covers the safety model, supported edit shapes, and
   common failure modes.
-- [Source syntax adapters](docs/source-syntax-adapters.md) covers TSRX and custom parser adapters.
-- [Example apps](docs/examples.md) covers the React and Preact Panda CSS examples used for manual
-  verification.
+- [Source syntax adapters](docs/source-syntax-adapters.md) covers opt-in TSRX support.
 
 ## Troubleshooting
 
@@ -129,6 +130,8 @@ No editable entries appear:
 - Confirm the file is included by the plugin `include` patterns.
 - Confirm the element uses a local static `css({ ... })` object literal imported from your Panda
   `styled-system/css` path.
+- In React Router 7 framework mode, confirm the root document includes the development-only
+  `/@sculpted/runtime` script.
 - Open `/@sculpted/manifest` while the dev server is running and check whether entries exist.
 
 The inspector shows a target as read-only:
@@ -136,7 +139,7 @@ The inspector shows a target as read-only:
 - Check for variable style objects, object spreads, computed keys, dynamic values, recipes, patterns,
   `cva()`, or JSX style props.
 - For TSRX, check that the file uses supported TSRX component syntax and that
-  `tsrxSourceParserAdapter` is configured.
+  `sourceSyntax` from `sculpted/tsrx` is configured.
 
 Save fails:
 

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { $ as StyleModuleEditRequest, A as RuntimeAttribute, B as SourcePosition, C as OpenSourceLocationRequest, D as PreviewStyleCondition, E as PandaStyleObject, F as RuntimePropertyContext, G as StyleEdit, H as SourceTarget, I as RuntimeStyleEvidence, J as StyleEditError, K as StyleEditBatchRequest, L as SelectedElementInfo, M as RuntimeComponentLayerElement, N as RuntimeCssDeclaration, O as PreviewStyleRule, P as RuntimeElementBounds, Q as StyleEditResponse, R as SelectedElementState, S as OpenSourceLocationErrorCode, T as PandaCssSourceTarget, U as SourceTargetBase, V as SourceRange, W as SourceTargetKind, X as StyleEditOptions, Y as StyleEditErrorCode, Z as StyleEditRequest, _ as InspectorManifest, a as EditorColorTokenMetadata, at as TokenConfigEditResponse, b as JsonValue, c as EditorMetadataUnavailableReason, d as EditorPropertyMetadata, et as StyleModuleSourceAttachRequest, f as EditorTokenSourceSection, g as InspectorEditorMetadata, h as InlineCssSourceCreateRequest, i as DynamicSourceTarget, it as TokenConfigEditRequest, j as RuntimeComponentLayer, k as PreviewStyleSheet, l as EditorMetadataUpdateEvent, m as ExternalSourceTarget, n as ComponentStyleModuleSource, nt as StyleModuleSourceDetachRequest, o as EditorFontTokenMetadata, ot as UnsupportedReason, p as EditorTokenSourceTarget, q as StyleEditBatchResponse, r as Confidence, rt as StyleValueSource, s as EditorMetadataSection, st as UnsupportedSourceTarget, t as ComponentStyleModuleResponse, tt as StyleModuleSourceCreateRequest, u as EditorPropertyCategory, v as InspectorManifestEntry, w as OpenSourceLocationResponse, x as ManifestUpdateEvent, y as JsonPrimitive, z as SourceLocation } from "./types-CdByW0ji.mjs";
-import { _ as typescriptPandaAstAdapter, a as SourceAstKind, c as SourceSyntaxAdapter, d as parsePandaSource, f as parseWithSourceParserAdapter, g as tsxSourceSyntaxAdapter, h as tsxSourceParserAdapter, i as ParsedPandaSource, l as SourceSyntaxOption, m as tsrxSourceParserAdapter, n as PandaSourceAstAdapter, o as SourceParseResult, p as resolveSourceParserAdapter, r as ParseSourceSyntaxOptions, s as SourceParserAdapter, t as EstreeNode, u as createEstreePandaAstAdapter } from "./sourceSyntax-DanNzS7Y.mjs";
+import { a as SourceAstKind, c as SourceSyntaxAdapter, d as parsePandaSource, f as parseWithSourceParserAdapter, g as typescriptPandaAstAdapter, h as tsxSourceSyntaxAdapter, i as ParsedPandaSource, l as SourceSyntaxOption, m as tsxSourceParserAdapter, n as PandaSourceAstAdapter, o as SourceParseResult, p as resolveSourceParserAdapter, r as ParseSourceSyntaxOptions, s as SourceParserAdapter, t as EstreeNode, u as createEstreePandaAstAdapter } from "./sourceSyntax-U2iybN9L.mjs";
 
 //#region src/analyzer/pandaCssAnalyzer.d.ts
 type AnalyzePandaCssSourceOptions = {
@@ -126,4 +126,4 @@ declare const SCULPTED_EVENTS: {
 };
 type SculptedEventName = (typeof SCULPTED_EVENTS)[keyof typeof SCULPTED_EVENTS];
 //#endregion
-export { AnalyzePandaCssSourceOptions, AnalyzePandaCssSourceResult, ComponentStyleModulePaths, ComponentStyleModuleResponse, ComponentStyleModuleSource, Confidence, CreateInlineCssSourcePatchOptions, CreateStaticCssPatchOptions, CreateTokenConfigPatchOptions, DEFAULT_COMPONENT_ATTRIBUTE, DEFAULT_EDITOR_METADATA_ENDPOINT, DEFAULT_EDIT_ID_ATTRIBUTE, DEFAULT_FORCED_STATE_ATTRIBUTE, DEFAULT_JSX_SOURCE_ATTRIBUTE, DEFAULT_MANIFEST_ENDPOINT, DEFAULT_MARKER_CLASS_PREFIX, DEFAULT_OPEN_SOURCE_ENDPOINT, DEFAULT_SOURCE_ATTRIBUTE, DEFAULT_STYLE_MODULE_ENDPOINT, DEFAULT_TOKEN_WRITEBACK_ENDPOINT, DEFAULT_WRITEBACK_ENDPOINT, DynamicSourceTarget, EditorColorTokenMetadata, EditorFontTokenMetadata, EditorMetadataSection, EditorMetadataUnavailableReason, EditorMetadataUpdateEvent, EditorPropertyCategory, EditorPropertyMetadata, EditorTokenSourceSection, EditorTokenSourceTarget, EstreeNode, ExternalSourceTarget, InlineCssSourceCreateRequest, InspectorEditorMetadata, InspectorManifest, InspectorManifestEntry, JsonPrimitive, JsonValue, ManifestUpdateEvent, OpenSourceLocationErrorCode, OpenSourceLocationRequest, OpenSourceLocationResponse, PandaCssSourceTarget, PandaSourceAstAdapter, PandaStyleObject, ParseSourceSyntaxOptions, ParsedPandaSource, PreviewStyleCondition, PreviewStyleRule, PreviewStyleSheet, RuntimeAttribute, RuntimeComponentLayer, RuntimeComponentLayerElement, RuntimeCssDeclaration, RuntimeElementBounds, RuntimePropertyContext, RuntimeStyleEvidence, SCULPTED_EVENTS, SCULPTED_PROTOCOL_VERSION, SculptedEventName, SelectedElementInfo, SelectedElementState, SourceAstKind, SourceLocation, SourceParseResult, SourceParserAdapter, SourcePosition, SourceRange, SourceSyntaxAdapter, SourceSyntaxOption, SourceTarget, SourceTargetBase, SourceTargetKind, StyleEdit, StyleEditBatchRequest, StyleEditBatchResponse, StyleEditError, StyleEditErrorCode, StyleEditOptions, StyleEditRequest, StyleEditResponse, StyleModuleEditRequest, StyleModuleSourceAttachRequest, StyleModuleSourceCreateRequest, StyleModuleSourceDetachRequest, StyleValueSource, TokenConfigEditRequest, TokenConfigEditResponse, UnsupportedReason, UnsupportedSourceTarget, analyzePandaCssSource, componentStyleModulePaths, createEstreePandaAstAdapter, createInlineCssSourcePatch, createStaticCssBatchPatch, createStaticCssPatch, createStyleModuleAttachPatch, createStyleModuleDetachPatch, createStyleModuleSourcePatch, createTokenConfigPatch, editIdFromMarkerClass, editIdsFromMarkerClassList, hashSource, markerClassForEditId, parsePandaSource, parseWithSourceParserAdapter, readComponentStyleModule, resolveSourceParserAdapter, tsrxSourceParserAdapter, tsxSourceParserAdapter, tsxSourceSyntaxAdapter, typescriptPandaAstAdapter };
+export { AnalyzePandaCssSourceOptions, AnalyzePandaCssSourceResult, ComponentStyleModulePaths, ComponentStyleModuleResponse, ComponentStyleModuleSource, Confidence, CreateInlineCssSourcePatchOptions, CreateStaticCssPatchOptions, CreateTokenConfigPatchOptions, DEFAULT_COMPONENT_ATTRIBUTE, DEFAULT_EDITOR_METADATA_ENDPOINT, DEFAULT_EDIT_ID_ATTRIBUTE, DEFAULT_FORCED_STATE_ATTRIBUTE, DEFAULT_JSX_SOURCE_ATTRIBUTE, DEFAULT_MANIFEST_ENDPOINT, DEFAULT_MARKER_CLASS_PREFIX, DEFAULT_OPEN_SOURCE_ENDPOINT, DEFAULT_SOURCE_ATTRIBUTE, DEFAULT_STYLE_MODULE_ENDPOINT, DEFAULT_TOKEN_WRITEBACK_ENDPOINT, DEFAULT_WRITEBACK_ENDPOINT, DynamicSourceTarget, EditorColorTokenMetadata, EditorFontTokenMetadata, EditorMetadataSection, EditorMetadataUnavailableReason, EditorMetadataUpdateEvent, EditorPropertyCategory, EditorPropertyMetadata, EditorTokenSourceSection, EditorTokenSourceTarget, EstreeNode, ExternalSourceTarget, InlineCssSourceCreateRequest, InspectorEditorMetadata, InspectorManifest, InspectorManifestEntry, JsonPrimitive, JsonValue, ManifestUpdateEvent, OpenSourceLocationErrorCode, OpenSourceLocationRequest, OpenSourceLocationResponse, PandaCssSourceTarget, PandaSourceAstAdapter, PandaStyleObject, ParseSourceSyntaxOptions, ParsedPandaSource, PreviewStyleCondition, PreviewStyleRule, PreviewStyleSheet, RuntimeAttribute, RuntimeComponentLayer, RuntimeComponentLayerElement, RuntimeCssDeclaration, RuntimeElementBounds, RuntimePropertyContext, RuntimeStyleEvidence, SCULPTED_EVENTS, SCULPTED_PROTOCOL_VERSION, SculptedEventName, SelectedElementInfo, SelectedElementState, SourceAstKind, SourceLocation, SourceParseResult, SourceParserAdapter, SourcePosition, SourceRange, SourceSyntaxAdapter, SourceSyntaxOption, SourceTarget, SourceTargetBase, SourceTargetKind, StyleEdit, StyleEditBatchRequest, StyleEditBatchResponse, StyleEditError, StyleEditErrorCode, StyleEditOptions, StyleEditRequest, StyleEditResponse, StyleModuleEditRequest, StyleModuleSourceAttachRequest, StyleModuleSourceCreateRequest, StyleModuleSourceDetachRequest, StyleValueSource, TokenConfigEditRequest, TokenConfigEditResponse, UnsupportedReason, UnsupportedSourceTarget, analyzePandaCssSource, componentStyleModulePaths, createEstreePandaAstAdapter, createInlineCssSourcePatch, createStaticCssBatchPatch, createStaticCssPatch, createStyleModuleAttachPatch, createStyleModuleDetachPatch, createStyleModuleSourcePatch, createTokenConfigPatch, editIdFromMarkerClass, editIdsFromMarkerClassList, hashSource, markerClassForEditId, parsePandaSource, parseWithSourceParserAdapter, readComponentStyleModule, resolveSourceParserAdapter, tsxSourceParserAdapter, tsxSourceSyntaxAdapter, typescriptPandaAstAdapter };

package/dist/index.mjs

@@ -1,3 +1,3 @@
 import { _ as markerClassForEditId, a as DEFAULT_JSX_SOURCE_ATTRIBUTE, c as DEFAULT_OPEN_SOURCE_ENDPOINT, d as DEFAULT_TOKEN_WRITEBACK_ENDPOINT, f as DEFAULT_WRITEBACK_ENDPOINT, g as editIdsFromMarkerClassList, h as editIdFromMarkerClass, i as DEFAULT_FORCED_STATE_ATTRIBUTE, l as DEFAULT_SOURCE_ATTRIBUTE, m as SCULPTED_PROTOCOL_VERSION, n as DEFAULT_EDITOR_METADATA_ENDPOINT, o as DEFAULT_MANIFEST_ENDPOINT, p as SCULPTED_EVENTS, r as DEFAULT_EDIT_ID_ATTRIBUTE, s as DEFAULT_MARKER_CLASS_PREFIX, t as DEFAULT_COMPONENT_ATTRIBUTE, u as DEFAULT_STYLE_MODULE_ENDPOINT } from "./protocol-D5heR2QM.mjs";
-import { C as tsrxSourceParserAdapter, E as typescriptPandaAstAdapter, S as resolveSourceParserAdapter, T as tsxSourceSyntaxAdapter, _ as analyzePandaCssSource, a as createStyleModuleSourcePatch, b as parsePandaSource, g as createInlineCssSourcePatch, h as createStaticCssPatch, i as createStyleModuleDetachPatch, m as createStaticCssBatchPatch, n as componentStyleModulePaths, o as readComponentStyleModule, r as createStyleModuleAttachPatch, t as createTokenConfigPatch, v as hashSource, w as tsxSourceParserAdapter, x as parseWithSourceParserAdapter, y as createEstreePandaAstAdapter } from "./patcher-BelI8KIj.mjs";
-export { DEFAULT_COMPONENT_ATTRIBUTE, DEFAULT_EDITOR_METADATA_ENDPOINT, DEFAULT_EDIT_ID_ATTRIBUTE, DEFAULT_FORCED_STATE_ATTRIBUTE, DEFAULT_JSX_SOURCE_ATTRIBUTE, DEFAULT_MANIFEST_ENDPOINT, DEFAULT_MARKER_CLASS_PREFIX, DEFAULT_OPEN_SOURCE_ENDPOINT, DEFAULT_SOURCE_ATTRIBUTE, DEFAULT_STYLE_MODULE_ENDPOINT, DEFAULT_TOKEN_WRITEBACK_ENDPOINT, DEFAULT_WRITEBACK_ENDPOINT, SCULPTED_EVENTS, SCULPTED_PROTOCOL_VERSION, analyzePandaCssSource, componentStyleModulePaths, createEstreePandaAstAdapter, createInlineCssSourcePatch, createStaticCssBatchPatch, createStaticCssPatch, createStyleModuleAttachPatch, createStyleModuleDetachPatch, createStyleModuleSourcePatch, createTokenConfigPatch, editIdFromMarkerClass, editIdsFromMarkerClassList, hashSource, markerClassForEditId, parsePandaSource, parseWithSourceParserAdapter, readComponentStyleModule, resolveSourceParserAdapter, tsrxSourceParserAdapter, tsxSourceParserAdapter, tsxSourceSyntaxAdapter, typescriptPandaAstAdapter };
+import { C as tsxSourceParserAdapter, S as resolveSourceParserAdapter, T as typescriptPandaAstAdapter, _ as analyzePandaCssSource, a as createStyleModuleSourcePatch, b as parsePandaSource, g as createInlineCssSourcePatch, h as createStaticCssPatch, i as createStyleModuleDetachPatch, m as createStaticCssBatchPatch, n as componentStyleModulePaths, o as readComponentStyleModule, r as createStyleModuleAttachPatch, t as createTokenConfigPatch, v as hashSource, w as tsxSourceSyntaxAdapter, x as parseWithSourceParserAdapter, y as createEstreePandaAstAdapter } from "./patcher-DQgKdozw.mjs";
+export { DEFAULT_COMPONENT_ATTRIBUTE, DEFAULT_EDITOR_METADATA_ENDPOINT, DEFAULT_EDIT_ID_ATTRIBUTE, DEFAULT_FORCED_STATE_ATTRIBUTE, DEFAULT_JSX_SOURCE_ATTRIBUTE, DEFAULT_MANIFEST_ENDPOINT, DEFAULT_MARKER_CLASS_PREFIX, DEFAULT_OPEN_SOURCE_ENDPOINT, DEFAULT_SOURCE_ATTRIBUTE, DEFAULT_STYLE_MODULE_ENDPOINT, DEFAULT_TOKEN_WRITEBACK_ENDPOINT, DEFAULT_WRITEBACK_ENDPOINT, SCULPTED_EVENTS, SCULPTED_PROTOCOL_VERSION, analyzePandaCssSource, componentStyleModulePaths, createEstreePandaAstAdapter, createInlineCssSourcePatch, createStaticCssBatchPatch, createStaticCssPatch, createStyleModuleAttachPatch, createStyleModuleDetachPatch, createStyleModuleSourcePatch, createTokenConfigPatch, editIdFromMarkerClass, editIdsFromMarkerClassList, hashSource, markerClassForEditId, parsePandaSource, parseWithSourceParserAdapter, readComponentStyleModule, resolveSourceParserAdapter, tsxSourceParserAdapter, tsxSourceSyntaxAdapter, typescriptPandaAstAdapter };

package/dist/{patcher-BelI8KIj.mjs → patcher-DQgKdozw.mjs}

@@ -1,5 +1,4 @@
 import "./protocol-D5heR2QM.mjs";
-import { parseModule } from "@tsrx/core";
 import ts from "typescript";
 //#region src/sourceSyntax.ts
 function parseWithSourceParserAdapter(adapter, options) {
@@ -43,25 +42,6 @@ const tsxSourceParserAdapter = {
 	}
 };
 const tsxSourceSyntaxAdapter = tsxSourceParserAdapter;
-const tsrxSourceParserAdapter = {
-	languageId: "tsrx",
-	kind: "estree",
-	isSupportedFile(filePath) {
-		return filePath.endsWith(".tsrx");
-	},
-	parse(options) {
-		const comments = [];
-		return {
-			kind: "estree",
-			languageId: "tsrx",
-			program: parseModule(options.sourceText, options.filePath, {
-				collect: true,
-				comments
-			}),
-			comments
-		};
-	}
-};
 function scriptKindForFile(filePath) {
 	if (/\.[cm]?tsx$/.test(filePath)) return ts.ScriptKind.TSX;
 	if (/\.[cm]?jsx$/.test(filePath)) return ts.ScriptKind.JSX;
@@ -2611,4 +2591,4 @@ function failure(editId, code, message, details) {
 	};
 }
 //#endregion
-export { tsrxSourceParserAdapter as C, typescriptPandaAstAdapter as E, resolveSourceParserAdapter as S, tsxSourceSyntaxAdapter as T, analyzePandaCssSource as _, createStyleModuleSourcePatch as a, parsePandaSource as b, resolveProjectPath as c, toRelativeProjectPath as d, trustedManifestFilePath as f, createInlineCssSourcePatch as g, createStaticCssPatch as h, createStyleModuleDetachPatch as i, safeProjectSourcePath as l, createStaticCssBatchPatch as m, componentStyleModulePaths as n, readComponentStyleModule as o, trustedTokenSourceFilePath as p, createStyleModuleAttachPatch as r, normalizePath$2 as s, createTokenConfigPatch as t, stripViteQuery as u, hashSource as v, tsxSourceParserAdapter as w, parseWithSourceParserAdapter as x, createEstreePandaAstAdapter as y };
+export { tsxSourceParserAdapter as C, resolveSourceParserAdapter as S, typescriptPandaAstAdapter as T, analyzePandaCssSource as _, createStyleModuleSourcePatch as a, parsePandaSource as b, resolveProjectPath as c, toRelativeProjectPath as d, trustedManifestFilePath as f, createInlineCssSourcePatch as g, createStaticCssPatch as h, createStyleModuleDetachPatch as i, safeProjectSourcePath as l, createStaticCssBatchPatch as m, componentStyleModulePaths as n, readComponentStyleModule as o, trustedTokenSourceFilePath as p, createStyleModuleAttachPatch as r, normalizePath$2 as s, createTokenConfigPatch as t, stripViteQuery as u, hashSource as v, tsxSourceSyntaxAdapter as w, parseWithSourceParserAdapter as x, createEstreePandaAstAdapter as y };

package/dist/{sourceSyntax-DanNzS7Y.d.mts → sourceSyntax-U2iybN9L.d.mts}

@@ -96,8 +96,7 @@ declare function parsePandaSource(adapter: SourceSyntaxOption | undefined, optio
 declare function resolveSourceParserAdapter(filePath: string, adapter: SourceSyntaxOption | undefined): SourceParserAdapter;
 declare const tsxSourceParserAdapter: SourceParserAdapter;
 declare const tsxSourceSyntaxAdapter: SourceParserAdapter;
-declare const tsrxSourceParserAdapter: SourceParserAdapter;
 declare const typescriptPandaAstAdapter: PandaSourceAstAdapter<ts.SourceFile, ts.Node>;
 declare function createEstreePandaAstAdapter(root: EstreeNode): PandaSourceAstAdapter<EstreeNode, EstreeNode>;
 //#endregion
-export { typescriptPandaAstAdapter as _, SourceAstKind as a, SourceSyntaxAdapter as c, parsePandaSource as d, parseWithSourceParserAdapter as f, tsxSourceSyntaxAdapter as g, tsxSourceParserAdapter as h, ParsedPandaSource as i, SourceSyntaxOption as l, tsrxSourceParserAdapter as m, PandaSourceAstAdapter as n, SourceParseResult as o, resolveSourceParserAdapter as p, ParseSourceSyntaxOptions as r, SourceParserAdapter as s, EstreeNode as t, createEstreePandaAstAdapter as u };
+export { SourceAstKind as a, SourceSyntaxAdapter as c, parsePandaSource as d, parseWithSourceParserAdapter as f, typescriptPandaAstAdapter as g, tsxSourceSyntaxAdapter as h, ParsedPandaSource as i, SourceSyntaxOption as l, tsxSourceParserAdapter as m, PandaSourceAstAdapter as n, SourceParseResult as o, resolveSourceParserAdapter as p, ParseSourceSyntaxOptions as r, SourceParserAdapter as s, EstreeNode as t, createEstreePandaAstAdapter as u };

package/dist/tsrx.d.mts

@@ -0,0 +1,7 @@
+import { s as SourceParserAdapter } from "./sourceSyntax-U2iybN9L.mjs";
+
+//#region src/tsrx.d.ts
+declare const sourceSyntax: SourceParserAdapter;
+declare const tsrxSourceParserAdapter: SourceParserAdapter;
+//#endregion
+export { sourceSyntax, tsrxSourceParserAdapter };

package/dist/tsrx.mjs

@@ -0,0 +1,24 @@
+import { parseModule } from "@tsrx/core";
+//#region src/tsrx.ts
+const sourceSyntax = {
+	languageId: "tsrx",
+	kind: "estree",
+	isSupportedFile(filePath) {
+		return filePath.endsWith(".tsrx");
+	},
+	parse(options) {
+		const comments = [];
+		return {
+			kind: "estree",
+			languageId: "tsrx",
+			program: parseModule(options.sourceText, options.filePath, {
+				collect: true,
+				comments
+			}),
+			comments
+		};
+	}
+};
+const tsrxSourceParserAdapter = sourceSyntax;
+//#endregion
+export { sourceSyntax, tsrxSourceParserAdapter };

package/dist/ui.mjs

@@ -7935,10 +7935,6 @@ function InspectorPanel(props) {
 				clearModifierPreview();
 				return;
 			}
-			if (isPanelEditableFocused()) {
-				clearModifierPreview();
-				return;
-			}
 			setModifierPreviewCursor();
 			hidePanelForModifierPreview();
 			const element = inspectableElementFromPoint(runtime, event.clientX, event.clientY);
@@ -7950,6 +7946,7 @@ function InspectorPanel(props) {
 		};
 		const onModifierKeyDown = (event) => {
 			if (!isOnlyShiftAlt(event)) return;
+			if (event.key !== "Shift" && event.key !== "Alt") return;
 			if (isPanelEditableFocused()) {
 				clearModifierPreview();
 				return;

package/dist/vite.d.mts

@@ -1,4 +1,4 @@
-import { l as SourceSyntaxOption } from "./sourceSyntax-DanNzS7Y.mjs";
+import { l as SourceSyntaxOption } from "./sourceSyntax-U2iybN9L.mjs";
 
 //#region src/vite/types.d.ts
 type InspectorVitePluginOptions = {
@@ -9,12 +9,8 @@ type InspectorVitePluginOptions = {
   readonly panda?: {
     readonly configPath?: string;
     readonly cssImportSources?: readonly string[];
-    readonly recipeImportSources?: readonly string[];
-    readonly cssFunctionNames?: readonly string[];
-    readonly cxFunctionNames?: readonly string[];
   };
   readonly manifest?: {
-    readonly outFile?: string;
     readonly virtualEndpoint?: string;
   };
   readonly metadata?: {
@@ -22,13 +18,6 @@ type InspectorVitePluginOptions = {
   };
   readonly runtime?: {
     readonly inject?: boolean;
-    readonly globalName?: string;
-  };
-  readonly attributes?: {
-    readonly editId?: string;
-    readonly source?: string;
-    readonly jsxSource?: string;
-    readonly component?: string;
   };
   readonly sourceSyntax?: SourceSyntaxOption;
 };

package/dist/vite.mjs

@@ -1,5 +1,5 @@
-import { _ as markerClassForEditId, c as DEFAULT_OPEN_SOURCE_ENDPOINT, d as DEFAULT_TOKEN_WRITEBACK_ENDPOINT, f as DEFAULT_WRITEBACK_ENDPOINT, p as SCULPTED_EVENTS, u as DEFAULT_STYLE_MODULE_ENDPOINT } from "./protocol-D5heR2QM.mjs";
-import { S as resolveSourceParserAdapter, _ as analyzePandaCssSource, a as createStyleModuleSourcePatch, b as parsePandaSource, c as resolveProjectPath, d as toRelativeProjectPath$1, f as trustedManifestFilePath, g as createInlineCssSourcePatch, h as createStaticCssPatch, i as createStyleModuleDetachPatch, l as safeProjectSourcePath, m as createStaticCssBatchPatch, n as componentStyleModulePaths, o as readComponentStyleModule, p as trustedTokenSourceFilePath, r as createStyleModuleAttachPatch, s as normalizePath$1, t as createTokenConfigPatch, u as stripViteQuery, v as hashSource } from "./patcher-BelI8KIj.mjs";
+import { _ as markerClassForEditId, a as DEFAULT_JSX_SOURCE_ATTRIBUTE, c as DEFAULT_OPEN_SOURCE_ENDPOINT, d as DEFAULT_TOKEN_WRITEBACK_ENDPOINT, f as DEFAULT_WRITEBACK_ENDPOINT, l as DEFAULT_SOURCE_ATTRIBUTE, p as SCULPTED_EVENTS, r as DEFAULT_EDIT_ID_ATTRIBUTE, t as DEFAULT_COMPONENT_ATTRIBUTE, u as DEFAULT_STYLE_MODULE_ENDPOINT } from "./protocol-D5heR2QM.mjs";
+import { S as resolveSourceParserAdapter, _ as analyzePandaCssSource, a as createStyleModuleSourcePatch, b as parsePandaSource, c as resolveProjectPath, d as toRelativeProjectPath$1, f as trustedManifestFilePath, g as createInlineCssSourcePatch, h as createStaticCssPatch, i as createStyleModuleDetachPatch, l as safeProjectSourcePath, m as createStaticCssBatchPatch, n as componentStyleModulePaths, o as readComponentStyleModule, p as trustedTokenSourceFilePath, r as createStyleModuleAttachPatch, s as normalizePath$1, t as createTokenConfigPatch, u as stripViteQuery, v as hashSource } from "./patcher-DQgKdozw.mjs";
 import ts from "typescript";
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { loadConfigAndCreateContext } from "@pandacss/node";
@@ -998,7 +998,6 @@ function registerRuntimeModuleRoutes(server, options) {
 		response.end(runtimeBootstrapSource({
 			manifestEndpoint: options.manifestEndpoint,
 			editorMetadataEndpoint: options.editorMetadataEndpoint,
-			globalName: options.globalName,
 			runtimeModuleEndpoint: options.runtimeModuleEndpoint,
 			uiModuleEndpoint: options.uiModuleEndpoint
 		}));
@@ -1084,7 +1083,6 @@ function registerRuntimeModuleRoutes(server, options) {
 }
 function runtimeBootstrapSource(options) {
 	const runtimeOptions = JSON.stringify({
-		globalName: options.globalName,
 		manifestEndpoint: options.manifestEndpoint,
 		editorMetadataEndpoint: options.editorMetadataEndpoint
 	});
@@ -2189,10 +2187,10 @@ function sculpted(options = {}) {
 	const uiModuleEndpoint = DEFAULT_UI_MODULE_ENDPOINT;
 	const runtimeChunkEndpoint = DEFAULT_RUNTIME_CHUNK_ENDPOINT;
 	const attributes = {
-		editId: options.attributes?.editId ?? "data-sculpted-edit-id",
-		source: options.attributes?.source ?? "data-sculpted-source",
-		jsxSource: options.attributes?.jsxSource ?? "data-sculpted-jsx-source",
-		component: options.attributes?.component ?? "data-sculpted-component"
+		editId: DEFAULT_EDIT_ID_ATTRIBUTE,
+		source: DEFAULT_SOURCE_ATTRIBUTE,
+		jsxSource: DEFAULT_JSX_SOURCE_ATTRIBUTE,
+		component: DEFAULT_COMPONENT_ATTRIBUTE
 	};
 	let projectRoot = normalizePath$1(options.projectRoot ?? "");
 	let devEnabled = options.enabled !== false;
@@ -2273,7 +2271,6 @@ function sculpted(options = {}) {
 			registerRuntimeModuleRoutes(nextServer, {
 				manifestEndpoint: endpoint,
 				editorMetadataEndpoint,
-				globalName: options.runtime?.globalName,
 				runtimeBootstrapEndpoint,
 				runtimeModuleEndpoint,
 				uiModuleEndpoint,

package/docs/examples.md

@@ -1,7 +1,7 @@
 # Example Apps
 
-Sculpted includes minimal Vite + Panda CSS apps for manually verifying inspector behavior and source
-writeback while the package is being built.
+Sculpted includes minimal Vite + Panda CSS apps for contributors who need to manually verify
+inspector behavior and source writeback while developing the package.
 
 ## React
 
@@ -26,5 +26,5 @@ pnpm install
 pnpm dev
 ```
 
-Use these apps to verify supported edits, unsupported read-only cases, token creation checks, React
-`className`, Preact `class`, TSRX parsing, and production-dark behavior while developing Sculpted.
+These apps intentionally include edge cases and maintainer-focused checks. Most users should start
+with the setup examples in the main README instead.

package/docs/source-syntax-adapters.md

@@ -1,13 +1,8 @@
 # Source Syntax Adapters
 
-Sculpted can support non-standard source syntax when a parser adapter exposes stable ranges into
-the original authoring source. The patcher edits that original file directly after revalidating
-hashes, source containment, and AST shape.
-
-Sourcemaps are not the writeback authority. A future fallback may use sourcemaps to explain
-generated-code provenance, but safe writes still require an original-source parser and patchable
-target. If the adapter cannot provide stable original ranges for a source shape, Sculpted should
-report that target as read-only.
+Sculpted can support non-standard source syntax when that syntax can be parsed back to stable
+locations in the original authoring file. Unsupported source shapes are shown as read-only instead
+of guessed.
 
 ## TSRX Support
 
@@ -17,14 +12,14 @@ TSRX support is opt-in because `.tsrx` files need the ESTree-backed parser adapt
 ```ts
 // vite.config.ts
 import { defineConfig } from 'vite'
-import { tsrxSourceParserAdapter } from 'sculpted'
+import { sourceSyntax } from 'sculpted/tsrx'
 import { sculpted } from 'sculpted/vite'
 
 export default defineConfig({
   plugins: [
     sculpted({
       include: ['src/**/*.{ts,tsx,tsrx}'],
-      sourceSyntax: [tsrxSourceParserAdapter],
+      sourceSyntax: [sourceSyntax],
     }),
   ],
 })
@@ -45,38 +40,11 @@ export function Card() {
 TSRX support covers:
 
 - static `css({ ... })` object literal analysis;
-- marker-class instrumentation for element selection;
-- existing literal `set` writeback after re-parsing the original `.tsrx` source.
+- element selection in the inspector;
+- saving edits to existing literal values in the original `.tsrx` source.
 
 TSRX support does not cover:
 
-- direct `data-panda-*` metadata insertion;
 - inline source creation;
 - add, delete, or rename operations;
-- generated TSX or sourcemap-based writeback authority.
-
-## Custom Adapters
-
-Languages that can expose original source ranges can opt into the same writeback lane with a
-`sourceSyntax` parser adapter. The option accepts one adapter or an ordered adapter list.
-
-```ts
-sculpted({
-  include: ['src/**/*.view'],
-  sourceSyntax: {
-    languageId: 'my-tsx-superset',
-    kind: 'typescript',
-    isSupportedFile: (file) => file.endsWith('.view'),
-    parse({ filePath, sourceText }) {
-      return {
-        kind: 'typescript',
-        languageId: 'my-tsx-superset',
-        sourceFile: parseToTypeScriptCompatibleSourceFile(filePath, sourceText),
-      }
-    },
-  },
-})
-```
-
-Parser adapters must expose node ranges as offsets into the original authoring source text. Use
-read-only failures for any syntax that cannot provide stable original ranges for a source shape.
+- generated TSX or sourcemap-based writeback.

package/docs/source-writeback.md

@@ -31,17 +31,12 @@ Sculpted does not edit:
 
 ## Safety Model
 
-Source writes are revalidated on the dev server before writing:
+Source writes are revalidated on the dev server before writing. Sculpted only writes to files inside
+the configured project root, re-checks the current source before saving, and rejects stale source,
+unsupported shapes, duplicate keys, parser errors, and unsafe paths.
 
-- the browser sends manifest edit IDs, not trusted file paths;
-- the server resolves edit IDs through the trusted manifest;
-- the patcher re-reads source and validates project-root containment;
-- stale source hashes, unsupported source shapes, duplicate keys, parse errors, and path escapes are
-  rejected;
-- batched saves apply same-file edits against one source snapshot before writing.
-
-The UI saves immediately after clicking Save. The writeback endpoint still supports dry-run patch
-responses with focused diffs for tests and tooling.
+The UI saves immediately after clicking Save. If a save cannot be applied confidently, Sculpted
+shows the failure instead of guessing at a source edit.
 
 ## Supported Edit Example
 

package/docs/vite-plugin.md

@@ -15,6 +15,32 @@ export default defineConfig({
 The plugin runs with `enforce: 'pre'` so it can instrument supported source before framework
 plugins transform JSX. Keep it before React, Preact, or other JSX-transforming plugins.
 
+## React Router 7 Framework Mode
+
+React Router 7 framework mode renders the document from the app's root module instead of serving a
+Vite `index.html` entry. Sculpted can still instrument route modules and serve its manifest,
+runtime, metadata, and writeback endpoints, but Vite does not call `transformIndexHtml` for that
+framework-rendered document. Add the runtime script explicitly in development:
+
+```tsx
+// app/root.tsx
+<Scripts />
+{import.meta.env.DEV && <script src="/@sculpted/runtime" type="module" />}
+```
+
+Keep `sculpted()` before `reactRouter()` in `vite.config.ts` so route modules are instrumented
+before React Router transforms them:
+
+```ts
+import { reactRouter } from '@react-router/dev/vite'
+import { defineConfig } from 'vite'
+import { sculpted } from 'sculpted/vite'
+
+export default defineConfig({
+  plugins: [sculpted(), reactRouter()],
+})
+```
+
 ## Development Behavior
 
 In development, the plugin:
@@ -42,12 +68,8 @@ type InspectorVitePluginOptions = {
   readonly panda?: {
     readonly configPath?: string
     readonly cssImportSources?: readonly string[]
-    readonly recipeImportSources?: readonly string[]
-    readonly cssFunctionNames?: readonly string[]
-    readonly cxFunctionNames?: readonly string[]
   }
   readonly manifest?: {
-    readonly outFile?: string
     readonly virtualEndpoint?: string
   }
   readonly metadata?: {
@@ -55,13 +77,6 @@ type InspectorVitePluginOptions = {
   }
   readonly runtime?: {
     readonly inject?: boolean
-    readonly globalName?: string
-  }
-  readonly attributes?: {
-    readonly editId?: string
-    readonly source?: string
-    readonly jsxSource?: string
-    readonly component?: string
   }
   readonly sourceSyntax?: SourceSyntaxOption
 }
@@ -143,12 +158,6 @@ sculpted({
 })
 ```
 
-### Reserved Panda Options
-
-`panda.recipeImportSources`, `panda.cssFunctionNames`, and `panda.cxFunctionNames` are part of the
-public option type but are not wired into the Vite plugin implementation. Recipes, patterns,
-`cva()`, and broader function-name customization are not supported.
-
 ### `manifest.virtualEndpoint`
 
 Defaults to `/@sculpted/manifest`.
@@ -164,10 +173,6 @@ sculpted({
 })
 ```
 
-### `manifest.outFile`
-
-Reserved. The option is typed but not wired into the Vite plugin implementation.
-
 ### `metadata.virtualEndpoint`
 
 Defaults to `/@sculpted/editor-metadata`.
@@ -197,69 +202,22 @@ sculpted({
 })
 ```
 
-### `runtime.globalName`
-
-Overrides the browser global name used by the installed runtime.
-
-```ts
-sculpted({
-  runtime: {
-    globalName: '__mySculptedRuntime',
-  },
-})
-```
-
-### `attributes`
-
-Overrides the DOM attributes used for inspector metadata.
-
-Defaults:
-
-- `editId`: `data-sculpted-edit-id`
-- `source`: `data-sculpted-source`
-- `jsxSource`: `data-sculpted-jsx-source`
-- `component`: `data-sculpted-component`
-
-Use these only when the defaults collide with app-specific tooling.
-
-```ts
-sculpted({
-  attributes: {
-    editId: 'data-dev-edit-id',
-    source: 'data-dev-source',
-    jsxSource: 'data-dev-jsx-source',
-    component: 'data-dev-component',
-  },
-})
-```
-
 ### `sourceSyntax`
 
-Adds one source parser adapter, or an ordered list of adapters, for non-standard source syntax that
-can expose original source ranges. See [source syntax adapters](source-syntax-adapters.md).
+Adds source parsing support for non-standard source syntax. Sculpted currently documents this for
+the bundled TSRX adapter. See [source syntax adapters](source-syntax-adapters.md).
 
 ```ts
-import { tsrxSourceParserAdapter } from 'sculpted'
+import { sourceSyntax } from 'sculpted/tsrx'
 
 sculpted({
   include: ['src/**/*.{ts,tsx,tsrx}'],
-  sourceSyntax: [tsrxSourceParserAdapter],
+  sourceSyntax: [sourceSyntax],
 })
 ```
 
-## Endpoint Defaults
-
-These endpoint defaults are fixed unless an option above says otherwise:
-
-- Manifest: `/@sculpted/manifest`
-- Editor metadata: `/@sculpted/editor-metadata`
-- Source writeback: `/@sculpted/writeback`
-- Token writeback: `/@sculpted/token-writeback`
-- Open source location: `/@sculpted/open-source`
-- Style module route: `/@sculpted/style-module`
-- Runtime bootstrap: `/@sculpted/runtime`
-- Runtime module: `/@sculpted/runtime-module`
-- UI module: `/@sculpted/ui-module`
+## Development Routes
 
-The writeback, token writeback, open-source, style-module, and runtime module endpoints are internal
-runtime contracts today. They are listed here so local tooling can avoid route collisions.
+Sculpted reserves development-only routes under `/@sculpted/*`. The manifest and editor metadata
+routes can be customized with `manifest.virtualEndpoint` and `metadata.virtualEndpoint`; other
+routes are internal runtime details and should not be treated as public integration points.

package/examples/vite-preact-pandacss/vite.config.ts

@@ -1,6 +1,6 @@
 import preact from '@preact/preset-vite'
 import tsrx from '@tsrx/vite-plugin-preact'
-import { tsrxSourceParserAdapter } from 'sculpted'
+import { sourceSyntax } from 'sculpted/tsrx'
 import { sculpted } from 'sculpted/vite'
 import { defineConfig, } from 'vite'
 
@@ -9,7 +9,7 @@ export default defineConfig({
     sculpted({
       projectRoot: import.meta.dirname,
       include: ['src/**/*.{ts,tsx,tsrx}'],
-      sourceSyntax: [tsrxSourceParserAdapter],
+      sourceSyntax: [sourceSyntax],
       panda: {
         cssImportSources: ['../styled-system/css']
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sculpted",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Experimental alpha dev inspector for editing Panda CSS styles and writing safe source updates.",
   "license": "FSL-1.1-ALv2",
   "author": "Alec Larson",
@@ -32,6 +32,10 @@
       "types": "./dist/vite.d.mts",
       "default": "./dist/vite.mjs"
     },
+    "./tsrx": {
+      "types": "./dist/tsrx.d.mts",
+      "default": "./dist/tsrx.mjs"
+    },
     "./runtime": {
       "types": "./dist/runtime.d.mts",
       "default": "./dist/runtime.mjs"
@@ -52,16 +56,22 @@
     "prepublishOnly": "pnpm check"
   },
   "dependencies": {
-    "@pandacss/node": "1.11.1",
-    "@tsrx/core": "0.1.25"
+    "@pandacss/node": "1.11.1"
   },
   "peerDependencies": {
+    "@tsrx/core": ">=0.1.0",
     "typescript": ">=5.0.0"
   },
+  "peerDependenciesMeta": {
+    "@tsrx/core": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@goddard-ai/ui-primitives": "0.1.1",
     "@pandacss/dev": "^1.11.1",
     "@preact/signals": "2.9.1",
+    "@tsrx/core": "0.1.25",
     "@types/node": "^25.9.1",
     "fuzzysort2": "0.1.1",
     "happy-dom": "^20.9.0",