• Layout
  • Fix an issue where inline tags, like or weren't detected when surrounded by comments

• #15175 47ae148 Thanks @florian-lefebvre! - Allows experimental Font providers to specify family options

  Previously, an Astro FontProvider could only accept options at the provider level when called. That could result in weird data structures for family-specific options.

  Astro FontProviders can now declare family-specific options, by specifying a generic:

  // font-provider.ts
  import type { FontProvider } from "astro";
  import { retrieveFonts, type Fonts } from "./utils.js",
  
  interface Config {
    token: string;
  }
  
  +interface FamilyOptions {
  +    minimal?: boolean;
  +}
  
  -export function registryFontProvider(config: Config): FontProvider {
  +export function registryFontProvider(config: Config): FontProvider<FamilyOptions> {
    let data: Fonts = {}
  
    return {
      name: "registry",
      config,
      init: async () => {
        data = await retrieveFonts(token);
      },
      listFonts: () => {
        return Object.keys(data);
      },
  -    resolveFont: ({ familyName, ...rest }) => {
  +    // options is typed as FamilyOptions
  +    resolveFont: ({ familyName, options, ...rest }) => {
        const fonts = data[familyName];
        if (fonts) {
          return { fonts };
        }
        return undefined;
      },
    };
  }

  Once the font provider is registered in the Astro config, types are automatically inferred:

  // astro.config.ts
  import { defineConfig } from "astro/config";
  import { registryFontProvider } from "./font-provider";
  
  export default defineConfig({
      experimental: {
          fonts: [{
              provider: registryFontProvider({
                token: "..."
              }),
              name: "Custom",
              cssVariable: "--font-custom",
  +            options: {
  +                minimal: true
  +            }
          }]
      }
  });

• #15175 47ae148 Thanks @florian-lefebvre! - BREAKING CHANGE to the experimental Fonts API only

  Updates how options are passed to the Google and Google Icons font providers when using the experimental Fonts API

  Previously, the Google and Google Icons font providers accepted options that were specific to given font families.

  These options must now be set using the options property instead. For example using the Google provider:

  import { defineConfig, fontProviders } from "astro/config";
  
  export default defineConfig({
      experimental: {
          fonts: [{
              name: 'Inter',
              cssVariable: '--astro-font-inter',
              weights: ['300 900'],
  -            provider: fontProviders.google({
  -                experimental: {
  -                    variableAxis: {
  -                        Inter: { opsz: ['14..32'] }
  -                    }
  -                }
  -            }),
  +            provider: fontProviders.google(),
  +            options: {
  +                experimental: {
  +                    variableAxis: { opsz: ['14..32'] }
  +                }
  +            }
          }]
      }
  })

• #15200 c0595b3 Thanks @florian-lefebvre! - BREAKING CHANGE to the experimental Fonts API only

  Removes getFontData() exported from astro:assets with fontData when using the experimental Fonts API

  Accessing font data can be useful for advanced use cases, such as generating meta tags or Open Graph images. Before, we exposed a getFontData() helper function to retrieve the font data for a given cssVariable. That was however limiting for programmatic usages that need to access all font data.

  The getFontData() helper function is removed and replaced by a new fontData object:

  -import { getFontData } from "astro:assets";
  -const data = getFontData("--font-roboto")
  
  +import { fontData } from "astro:assets";
  +const data = fontData["--font-roboto"]

  We may reintroduce getFontData() later on for a more friendly DX, based on your feedback.

• #15254 8d84b30 Thanks @lamalex! - Fixes CSS assetsPrefix with remote URLs incorrectly prepending a forward slash

  When using build.assetsPrefix with a remote URL (e.g., https://cdn.example.com) for CSS assets, the generated <link> elements were incorrectly getting a / prepended to the full URL, resulting in invalid URLs like /https://cdn.example.com/assets/style.css.

  This fix checks if the stylesheet link is a remote URL before prepending the forward slash.

• #15178 731f52d Thanks @kedarvartak! - Fixes an issue where stopping the dev server with q+enter incorrectly created a dist folder and copied font files when using the experimental Fonts API

• #15230 3da6272 Thanks @rahuld109! - Fixes greedy regex in error message markdown rendering that caused link syntax examples to capture extra characters

• #15253 2a6315a Thanks @matthewp! - Fixes hydration for React components nested inside HTML elements in MDX files

• #15227 9a609f4 Thanks @matthewp! - Fixes styles not being included for conditionally rendered Svelte 5 components in production builds

• #14607 ee52160 Thanks @simensfo! - Reintroduces css deduplication for hydrated client components. Ensures assets already added to a client chunk are not flagged as orphaned

• fix: react error #311

This release introduces several significant changes: a new pattern for defining custom shape/binding typings, pluggable storage for TLSocketRoom with a new SQLite option, reactive editor.inputs, and optimized draw shape encoding. It also adds various other API improvements, performance optimizations, and bug fixes, including better support for React 19.

We've improved the developer experience of working with custom shape and binding types. There's now less boilerplate and fewer gotchas when using tldraw APIs in a type-safe manner.

This is a minor breaking change at the type level—your code will still run, but you'll get TypeScript errors until you migrate.

import { TLBaseShape } from 'tldraw'

// Shapes were defined by using the helper TLBaseShape type
type MyShape = TLBaseShape<'my-shape', { w: number; h: number; text: string }>

import { TLShape } from 'tldraw'

const MY_SHAPE = 'my-shape'

// We now use TypeScript's module augmentation feature to allow
// extending the builtin TLShape type.
declare module 'tldraw' {
	export interface TLGlobalShapePropsMap {
		[MY_SHAPE]: { w: number; h: number; text: string }
	}
}

type MyShape = TLShape<typeof MY_SHAPE>

// Just works - TypeScript validates props and provides autocomplete
editor.createShape({ type: 'my-shape', props: { w: 100, h: 100, text: 'Hello' } })

// Will cause a TypeScript error for `text`
editor.createShape({ type: 'my-shape', props: { w: 100, h: 100, text: 123 } })

(contributed by @Andarist)

We've refactored the TLSocketRoom API to support a pluggable storage layer. We're providing two implementations:

• SQLiteSyncStorage – Automatically persists room state to SQLite. Recommended for production.
• InMemorySyncStorage – Keeps state in memory with manual persistence via callbacks (previous built-in behavior).

We recommend switching to SQLiteSyncStorage if your environment supports SQLite (Cloudflare Durable Objects, Node.js, Bun, Deno). It provides automatic persistence, lower memory usage, and faster startup times.

const existingSnapshot = loadExistingSnapshot()

const room = new TLSocketRoom({
	initialSnapshot: existingSnapshot,
	onDataChange: () => {
		persistSnapshot(room.getCurrentSnapshot())
	},
})

import { InMemorySyncStorage, TLSocketRoom } from '@tldraw/sync-core'

const room = new TLSocketRoom({
	storage: new InMemorySyncStorage({
		snapshot: existingSnapshot,
		onChange() {
			saveToDatabase(storage.getSnapshot())
		},
	}),
})

import Database from 'better-sqlite3'
import { SQLiteSyncStorage, NodeSqliteWrapper, TLSocketRoom, RoomSnapshot } from '@tldraw/sync-core'

async function createRoom(roomId: string) {
	const db = new Database(`path/to/${roomId}.db`)
	const sql = new NodeSqliteWrapper(db)
	let snapshot: RoomSnapshot | undefined = undefined
	if (!SQLiteSyncStorage.hasBeenInitialized(sql)) {
		// This db hasn't been used before, so if it's a pre-existing
		// document, load the legacy room snapshot
		snapshot = await loadExistingSnapshot()
	}

	const storage = new SQLiteSyncStorage({ sql, snapshot })
	return new TLSocketRoom({
		storage,
		onSessionRemoved(room, args) {
			if (args.numSessionsRemaining === 0) {
				room.close()
				db.close()
			}
		},
	})
}

Draw and highlight shape point data is now stored using a compact delta-encoded binary format instead of JSON arrays. This reduces storage size by approximately 80% while preserving stroke fidelity.

Refactored editor.inputs to use reactive atoms via the new InputsManager class. All input state is now accessed via getter methods (e.g., editor.inputs.getCurrentPagePoint(), editor.inputs.getShiftKey()). Direct property access is deprecated but still supported for backwards compatibility.

• 💥 DefaultTopPanel export removed from tldraw. The top panel component for displaying the offline indicator is now handled internally by PeopleMenu. (#7568)
• 💥 TextDirection export removed from tldraw. Use TipTap's native TextDirection extension instead. The richTextValidator now includes an optional attrs property - a migration may be necessary for older clients/custom shapes. (#7304)
• Add tlenvReactive atom to @tldraw/editor for reactive environment state tracking, including coarse pointer detection that updates when users switch between mouse and touch input. (#7296)
• Add hideAllTooltips() helper function for programmatically dismissing tooltips. (#7288)
• Add zoomToFitPadding option to TldrawOptions to customize the default padding used by zoom-to-fit operations. (#7602)
• Add snapThreshold option to TldrawOptions for configuring the snap distance, defaulting to 8 screen pixels. (#7543)
• Add resizeChildren configuration option to FrameShapeUtil to allow frame children to be resized proportionally when the frame is resized. (#7526)
• Add Editor.canEditShape() and Editor.canCropShape() methods to centralize shape permission checks. Add ShapeUtil.canEditWhileLocked() for shapes that remain editable when locked. (#7361)
• Add editor.getDebouncedZoomLevel() and editor.getEfficientZoomLevel() methods for improved zoom performance on dense canvases. Add debouncedZoom and debouncedZoomThreshold options. (#7235)
• Add configurable showTextOutline option to TextShapeUtil, ArrowShapeUtil, and GeoShapeUtil via .configure() pattern. (#7314)
• Export freehand stroke utilities: getStroke, getStrokeOutlinePoints, and setStrokePointRadii. (#7400) (contributed by @VimHax)
• Add Box.isValid() method to check for finite coordinates. (#7532)
• Add spacebarPanning option to control whether spacebar activates pan mode. (#7312)
• Introduce pluggable TLSyncStorage API for TLSocketRoom. The initialSnapshot and onDataChange options are now deprecated in favor of the new storage option. (#7123)
• Export DefaultLabelColorStyle which is necessary for rich text in custom shapes. (#7114)

• Improve coarse pointer detection by replacing CSS media queries with a reactive data-coarse attribute that updates when users switch between mouse and touch input. (#7404)
• Add CSS containment to main toolbar and text measurement element for improved rendering performance. (#7406) (#7407)
• Improve cross-realm support by scoping canvas event listeners to the editor container's ownerDocument. (#7113)
• Simplify ImmutableMap implementation for better code clarity. (#7431)
• Improve code readability in number validator by using Number.isFinite() instead of arithmetic trick. (#7374)
• Upgrade to React 19 with all necessary type and configuration changes for compatibility. (#7317)
• Improve signal graph traversal performance by eliminating per-recursion closure allocations. (#7430)
• Optimize object utility functions. (#7432)
• Use in-place sorting in parentsToChildren derivation. (#7433)
• Optimize notVisibleShapes derivation with inlined bounds checks. (#7429)
• Cache label size measurements with WeakCache for improved geo shape performance. (#7412)
• Optimize validators with fast paths and production inlining. (#7373)

• Fix migrations for draw and highlight shapes to be idempotent, preventing errors when migrations run multiple times. (#7389)
• Fix dot detection in draw and highlight shapes after the point compression change. (#7365)
• Fix clicking a shape's text label while editing to re-focus the input and select all text. (#7342)
• Fix pasting at cursor to correctly account for frames and parent containers. (#7277)
• Fix editing mode to exit when dragging causes the text input to blur. (#7291)
• Fix CommonJS build issues with TipTap imports in rich text module. (#7282)
• Fix iOS automatically zooming in on input fields by ensuring 16px minimum font size. (#7118)
• Fix distanceToLineSegment returning squared distance instead of actual distance, causing hit testing (eraser, scribble select) to be too strict. (#7610) (contributed by @arpit-goblins)
• Fix zoomToSelection to toggle between 100% zoom and zoom-to-fit behavior. (#7536)
• Fix export of SVG markers by handling fragment-only URLs correctly. (#7506) (contributed by @PidgeyBE)
• Restore wheel and pinch canvas event emission. (#6834) (contributed by @swdev33)
• Fix context menu submenu flickering when hovered. (#6837) (contributed by @swdev33)
• Fix rotated shape positions not being restored after flipping twice. (#7359)
• Fix keyboard shortcuts and clipboard events not working when hideUi is true. (#7367)
• Fix elbow arrows routing incorrectly when using dynamic sizing at high zoom levels. (#7424)
• Allow fullscreen for embed shapes. (#7417)
• Move mobile rotate handle to bottom for image and video shapes to accommodate the contextual toolbar. (#6727)
• Fix dropdown menu items incorrectly displaying an icon on the right side. (#7533)
• Fix zoom menu showing debounced zoom level for canvases with many shapes. (#7626)
• Fix extra line appearing after bullet and ordered lists in text shapes. (#7643) (contributed by @sahiee-dev)
• Fix "Back to content" button not appearing when selected shapes are off-screen. (#7649)
• Fix dotted freehand lines becoming invisible at minimum zoom on Chrome. (#7650)
• Fix menu bar stretching to full width on mobile viewports instead of fitting content. (#7568)

Version 1.154.1 - 1/21/26, 11:28 AM

• router-core: correct splat param extraction after a skipped optional param (#6434) (9c934b7) by @Sheraff

• url rewrites (621a79c) by Tanner Linsley
• remove outdated (aced5f6) by Manuel Schiller

• @tanstack/router-core@1.154.1
• @tanstack/solid-router@1.154.1
• @tanstack/react-router@1.154.1
• @tanstack/vue-router@1.154.1
• @tanstack/solid-router-ssr-query@1.154.1
• @tanstack/react-router-ssr-query@1.154.1
• @tanstack/vue-router-ssr-query@1.154.1
• @tanstack/router-ssr-query-core@1.154.1
• @tanstack/zod-adapter@1.154.1
• @tanstack/valibot-adapter@1.154.1
• @tanstack/arktype-adapter@1.154.1
• @tanstack/router-devtools@1.154.1
• @tanstack/solid-router-devtools@1.154.1
• @tanstack/react-router-devtools@1.154.1
• @tanstack/vue-router-devtools@1.154.1
• @tanstack/router-devtools-core@1.154.1
• @tanstack/router-generator@1.154.1
• @tanstack/router-cli@1.154.1
• @tanstack/router-plugin@1.154.1
• @tanstack/router-vite-plugin@1.154.1
• @tanstack/solid-start@1.154.1
• @tanstack/solid-start-client@1.154.1
• @tanstack/solid-start-server@1.154.1
• @tanstack/vue-start@1.154.1
• @tanstack/vue-start-client@1.154.1
• @tanstack/vue-start-server@1.154.1
• @tanstack/start-client-core@1.154.1
• @tanstack/start-server-core@1.154.1
• @tanstack/start-storage-context@1.154.1
• @tanstack/react-start@1.154.1
• @tanstack/react-start-client@1.154.1
• @tanstack/react-start-server@1.154.1
• @tanstack/start-plugin-core@1.154.1
• @tanstack/start-static-server-functions@1.154.1

• dia.Paper - fix to wake up idle async paper with initializeUnmounted: true when a new cell is added to graph (879b8ca6)
• dia.Paper - fix to prevent an error when a view is synchronously dumped during an asynchronous visibility check (42d55cb6)
• dia.Element - fix getPortBBox() to return a valid bbox when port has no size defined (96867e75)

• layout.DirectedGraph - fix to accept a padding object for clusterPadding option of layout() (d7114104)

• Cascader: 新增 middle-content 插槽，用于自定义中间区域内容 @anlyyao (#4194)
• CollapsePanel: 新增 --td-collapse-disabled-color 和 --td-collapse-left-icon-color，用于自定义禁用态颜色和左侧图标颜色 @anlyyao @liweijie0812 (#4185)
• Popover: 新增 --td-popover-[theme]-color 和 --td-popover-[theme]-bg-color 系列 CSS Vars @Wesley-0808 (#4169)
• QRCode: 组件新增 init()，用于外部调用，重新绘制二维码 @anlyyao (#4174)
• SideBarItem: 完善激活项的前缀和后缀元素显示逻辑 @anlyyao (#4175)
• Slider: 修复受控 + 双游标滑块模式下陷入死循环的问题 @Boomkaa (#4170)

• ChatList: 修复 scrollToBottom 在 reverse 为 false 时，滑动的方向错误 @zydemail (#4191)
• CollapsePanel:
  • 修复深色模式下面板右侧图标颜色错误 @liweijie0812 (#4185)
  • 修复左侧图标颜色错误，默认主题色，支持使用 css vars 自定义 @anlyyao @liweijie0812 (#4185)
• Picker: 修复 popupProps.showOverlay 无效 @anlyyao (#4203)
• Popover: 修复控制台告警问题 @Wesley-0808 (#4169)
• Upload: 修复拖拽结束后拖拽元素 zIndex 异常 @anlyyao (#4199)

2026-01-21

• Fix JSX semicolon insert position in variable declarations (#6241)

• #6241: Fix JSX semicolon insertion (@lukastaegert)

• Rename rewroteURL to rewrittenPathname in request metadata: #88751
• Simplify getImplicitTags to accept pathname instead of url object: #88753
• Add NEXT_DEPLOYMENT_ID global: #86738
• Turbopack: remove deployment id suffix from client reference manifest chunks: #88741
• Inject <html data-dpl-id> and don't inline it into JS anymore: #88761
• [metadata] match the Metadata and ResolvedMetadata type: #88739

• Update with-mysql example to Next.js 15, Tailwind 4, Prisma 7: #88475

• [ci] Ensure Turbo Remote Cache can be written to: #88794
• perf(turbopack): optimize resolve plugin handling: #88639
• Fix buildManifest.js deployment tests: #88806
• [ci] Merge Cache Components and deploy tests manifests when running CC deploy tests: #88824
• Turbopack: Extend filesystem watcher fuzzing to cover symlinks and junction points: #88192
• [test]: add ability to run test-deploy with pre-existing deployment: #88829

Huge thanks to @eps1lon, @SimeonGriggs, @unstubbable, @xusd320, @mischnic, @sokra, @huozhi, @bgw, and @ztanner for helping!