V2: decide which of the @deprecated APIs should become breaking changes

[maiieul]

There are some undocumented and rarely used APIs that could be removed, making the codebase more maintainable.

[Varixo]

Basically most of them were marked in v2 and can be removed in v3

[maiieul]

Yes but I meant we should come up with a list of the APIs that should remain as deprecated and those that should be entirely removed from v2 for maintainability and better documentation.

[maiieul]

List of deprecated APIs:

test

@qwik.dev/core — Reactive Primitives

API	Location	Context
ReadonlySignal<T>	signal.public.ts:12	Interface not used anymore
Signal.force()	signal.public.ts:49	Use trigger() instead
awaitPrevious option	types.ts:77	Not implemented yet
_wrapSignal()	internal-api.ts:106	v1 compat shim, wraps _wrapProp

@qwik.dev/core — Hooks

API	Location	Context
useResource$	use-resource-dollar.ts:23	Use useAsync$ instead (more flexible API)
ResourceReturn.cache()	use-resource.ts:25	Does not do anything
Resource component	use-resource.ts:171	Use useAsync$ instead, read loading/error from signal
useLexicalScope	use-lexical-scope.public.ts:17	Use _captures instead (internal)
useWaitOn	use-core.ts:263	No longer used since v2 (internal)

@qwik.dev/core — JSX Types

API	Location	Context
className prop	jsx-generated.ts:399	Use class instead
htmlFor (label)	jsx-generated.ts:617	Use for instead
htmlFor (output)	jsx-generated.ts:666	Use for instead
charSet (link)	jsx-generated.ts:628	Use charset instead
charSet (meta)	jsx-generated.ts:634	Use charset instead
frameBorder (iframe)	jsx-generated.ts:565	Deprecated in HTML5
aria-dropeffect	jsx-generated.ts:119	Deprecated in ARIA 1.1
aria-grabbed	jsx-generated.ts:142	Deprecated in ARIA 1.1
KeygenHTMLAttributes	jsx-generated.ts:866	Deprecated in HTML5
ParamHTMLAttributes	jsx-generated.ts:892	Old DOM API
WebViewHTMLAttributes	jsx-generated.ts:930	React Native WebView type, doesn't belong in Qwik

@qwik.dev/core — Event Types (all: "use native event + 2nd handler arg")

API	Location
NativeAnimationEvent, NativeClipboardEvent, NativeCompositionEvent, NativeDragEvent, NativeFocusEvent, NativeKeyboardEvent, NativeMouseEvent, NativeTouchEvent, NativePointerEvent, NativeTransitionEvent, NativeUIEvent, NativeWheelEvent	jsx-qwik-events.ts:78-101
QwikAnimationEvent, QwikClipboardEvent, QwikCompositionEvent, QwikDragEvent, QwikPointerEvent, QwikFocusEvent, QwikSubmitEvent, QwikInvalidEvent, QwikChangeEvent, QwikKeyboardEvent, QwikMouseEvent, QwikTouchEvent, QwikUIEvent, QwikWheelEvent, QwikTransitionEvent	jsx-qwik-events.ts:102-131

All 27 event type aliases say: use the native browser event type directly.

@qwik.dev/core — JSX Internals (v1 compat)

API	Location	Context
_jsxC()	jsx-internal.ts:388	v1 compat, delegates to jsx()
_jsxS()	jsx-internal.ts:390	v1 compat, delegates to jsx()
_jsxQ()	jsx-internal.ts:393	v1 compat, delegates to jsx()
_IMMUTABLE	constants.ts:9	v1 compat symbol

@qwik.dev/core — Prefetching / Service Worker

API	Location	Context
PrefetchServiceWorker	prefetch.ts:7	Preloading is now automatic; keep temporarily to uninstall existing SWs
PrefetchGraph	prefetch.ts:91	Preloading is now automatic, remove from your app

@qwik.dev/core — SSR Types

API	Location	Context
SnapshotState	ssr-types.ts:144	Not used in v2
SnapshotResult.state	ssr-types.ts:161	Not used in v2
SnapshotResult.objs	ssr-types.ts:165	Not used in v2

@qwik.dev/core — Server Render Options

API	Location	Context
PrefetchStrategy (entire interface)	server/types.ts:75	Use preloader instead
PrefetchImplementation.linkRel	server/types.ts:77	No longer used
PrefetchImplementation.linkFetchPriority	server/types.ts:79	No longer used
PrefetchImplementation.linkInsert	server/types.ts:81	No longer used
PrefetchImplementation.workerFetchInsert	server/types.ts:83	No longer used
PrefetchImplementation.prefetchEvent	server/types.ts:85	No longer used
RenderToStreamResult.snapshotResult	server/types.ts:127	Not used in v2
StreamingOptions.include	server/types.ts:139	No longer used
StreamingOptions.position	server/types.ts:141	No longer used
RenderOptions.prefetchStrategy	server/types.ts:195	Use preloader instead
PreloadMinProbability	server/types.ts:65	Deprecated preload config option

@qwik.dev/core — Testing

API	Location	Context
cleanup (in ssrRenderToDom)	testing/types.ts:31	Use waitForDrain instead

Optimizer / Vite Plugin

API	Location	Context
HookEntryStrategy	optimizer/types.ts:167	Use SegmentStrategy instead
vendorRoots (QwikVitePluginOptions)	vite.ts:985	No longer used; files with .qwik. in name are auto-processed
devSsrServer (QwikVitePluginOptions)	vite.ts:1067	Use the devSsrServer option of qwikRouter() plugin instead
vendorRoots (NormalizedQwikPluginOptions)	plugin.ts:1423	No longer used
srcInputs (NormalizedQwikPluginOptions)	plugin.ts:1435	Not used

@qwik.dev/router — QwikCity -> QwikRouter Renames (all "will be removed in V3")

Deprecated	Replacement	Location
qwikCity()	qwikRouter()	plugin.ts:41
QwikCityVitePluginOptions	QwikRouterVitePluginOptions	types.ts:24
QwikCityPlugin	QwikRouterPlugin	types.ts:75
QwikCityPluginApi	QwikRouterPluginApi	types.ts:88
PluginContext	(unused, remove)	types.ts:59
QwikCityPlan	QwikRouterConfig	types.ts:336
QwikCityEnvData	QwikRouterEnvData	types.ts:449
QwikCityProvider	QwikRouterProvider	qwik-router-component.tsx:859
QwikCityProps	QwikRouterProps	qwik-router-component.tsx:109
QwikCityMockProvider	QwikRouterMockProvider	qwik-router-component.tsx:1017
QwikCityMockProps	QwikRouterMockProps	qwik-router-component.tsx:929
QWIK_CITY_SCROLLER	QWIK_ROUTER_SCROLLER	qwik-router-component.tsx:86
useQwikCityEnv	useQwikRouterEnv	use-functions.ts:103
staticAdapter	ssgAdapter	ssg/vite/index.ts:16

@qwik.dev/router — Middleware createQwikCity -> createQwikRouter (all adapters)

Each adapter has the same pattern: createQwikCity aliased to createQwikRouter, plus a renamed options type:

Adapter	Deprecated Type	Replacement
Node	QwikCityNodeRequestOptions	QwikRouterNodeRequestOptions
Node	origin option	Use getOrigin instead
Cloudflare Pages	QwikCityCloudflarePagesOptions	QwikRouterCloudflarePagesOptions
Vercel Edge	QwikCityVercelEdgeOptions	QwikRouterVercelEdgeOptions
AWS Lambda	QwikCityAwsLambdaOptions	QwikRouterAwsLambdaOptions
Azure SWA	QwikCityAzureOptions	QwikRouterAzureOptions
Netlify Edge	QwikCityNetlifyOptions	QwikRouterNetlifyOptions
Firebase	QwikCityFirebaseOptions	QwikRouterFirebaseOptions
Deno	QwikCityDenoOptions	QwikRouterDenoOptions
Bun	QwikCityBunOptions	QwikRouterBunOptions

@qwik.dev/router — Middleware notFound handler

Deprecated in Node, AWS Lambda, Deno, and Bun adapters. The router now handles 404 responses natively.

@qwik.dev/router — Window properties (_qCity* -> _qRouter*)

All on WindowProxy in qwik-router-component.tsx:1023-1038:
_qCityHistoryPatch, _qCitySPA, _qCityScrollEnabled, _qCityScrollDebounce, _qCityInitPopstate, _qCityInitAnchors, _qCityInitVisibility, _qCityInitScroll

@qwik.dev/router — Other

API	Location	Context
_qCityScroll (scroll state)	scroll-restoration.ts:65	Use _qRouterScroll
withLocale (RequestEvent)	types.ts:243	Not necessary, works without it
style.props / script.props	types.ts:201, types.ts:223	Set properties directly instead
getNotFound (old path)	modules.d.ts:26	Import from @qwik.dev/router/middleware/request-handler
isStaticPath (old path)	modules.d.ts:31	Import from @qwik.dev/router/middleware/request-handler
Service worker exports	service-worker/index.ts:2	No longer needed, preloading is automatic