Merge pull request #3789 from opral/docs-v2

sitemap generation

Author: samuelstroschein

.changeset/bright-apes-care.md

@@ -0,0 +1,5 @@
+---
+"@opral/markdown-wc": minor
+---
+
+Add support for GitHub-style alert blockquotes (`> [!NOTE]`, `> [!TIP]`, `> [!IMPORTANT]`, `> [!WARNING]`, `> [!CAUTION]`). Alerts render as standard `<blockquote>` elements annotated with `data-mwc-alert`, and include a hideable `[data-mwc-alert-marker]` span for site-specific styling (e.g. `blockquote[data-mwc-alert="note"] { ... }` and `blockquote[data-mwc-alert] [data-mwc-alert-marker]{display:none}`). Add an opt-in `externalLinks` option to open absolute http(s) links in a new tab with `rel="noopener noreferrer"`. Code blocks are annotated with `data-mwc-codeblock` for consumer styling and hydration.

.changeset/curly-taxis-sell.md

@@ -0,0 +1,5 @@
+---
+"@opral/markdown-wc": major
+---
+
+Stop injecting default inline styles into rendered HTML and remove the `inlineStyles` option. The previous default look is now provided as a separate stylesheet at `@opral/markdown-wc/default.css`, which apps can import if they want the old styling.

packages/flashtype/src/app/import-file.ts

@@ -92,15 +92,12 @@ export async function importFile({
 		},
 		focus: true,
 	});
-
 }
 
 /**
  * Imports content from the clipboard as a new file.
  */
-export async function importFromClipboard(
-	context: ViewContext,
-): Promise<void> {
+export async function importFromClipboard(context: ViewContext): Promise<void> {
 	const content = await navigator.clipboard.readText();
 
 	if (!content?.trim()) {
@@ -122,9 +119,7 @@ export async function importFromClipboard(
 /**
  * Opens a file picker and imports the selected file.
  */
-export async function importFromComputer(
-	context: ViewContext,
-): Promise<void> {
+export async function importFromComputer(context: ViewContext): Promise<void> {
 	const input = document.createElement("input");
 	input.type = "file";
 	input.accept = ".md,.txt,.markdown";

packages/flashtype/src/views/agent-view/index.tsx

@@ -773,7 +773,9 @@ export function AgentView({ context, instance }: AgentViewProps) {
 				<div className="w-full max-w-3xl mx-auto flex flex-col gap-4">
 					{hasKey ? (
 						<>
-							{(!messages || messages.length === 0) && !pending && !pendingMessage ? (
+							{(!messages || messages.length === 0) &&
+							!pending &&
+							!pendingMessage ? (
 								<AgentEmptyState />
 							) : (
 								<>
@@ -796,7 +798,9 @@ export function AgentView({ context, instance }: AgentViewProps) {
 										</div>
 									) : null}
 									{error ? (
-										<div className="px-3 py-1 text-xs text-rose-500">{error}</div>
+										<div className="px-3 py-1 text-xs text-rose-500">
+											{error}
+										</div>
 									) : null}
 								</>
 							)}

packages/flashtype/src/views/markdown-view/components/formatting-toolbar.tsx

@@ -132,7 +132,9 @@ export function FormattingToolbar({ className }: { className?: string }) {
 	const handleBlockChange = useCallback(
 		(value: ToolbarBlockType) => {
 			if (!editor) return;
-			const option = TOOLBAR_BLOCK_OPTIONS.find((entry) => entry.value === value);
+			const option = TOOLBAR_BLOCK_OPTIONS.find(
+				(entry) => entry.value === value,
+			);
 			option?.apply(editor);
 			setBlockMenuOpen(false);
 		},

packages/flashtype/src/views/markdown-view/components/slash-command-menu.tsx

@@ -5,15 +5,21 @@ import {
 	slashCommandsPluginKey,
 	type SlashCommandState,
 } from "../editor/extensions/slash-commands";
-import { SLASH_BLOCK_COMMANDS, type BlockCommand } from "../editor/block-commands";
-
-function filterCommands(commands: BlockCommand[], query: string): BlockCommand[] {
+import {
+	SLASH_BLOCK_COMMANDS,
+	type BlockCommand,
+} from "../editor/block-commands";
+
+function filterCommands(
+	commands: BlockCommand[],
+	query: string,
+): BlockCommand[] {
 	if (!query) return commands;
 	const lowerQuery = query.toLowerCase();
 	return commands.filter(
 		(cmd) =>
 			cmd.label.toLowerCase().includes(lowerQuery) ||
-			cmd.keywords.some((kw) => kw.toLowerCase().includes(lowerQuery))
+			cmd.keywords.some((kw) => kw.toLowerCase().includes(lowerQuery)),
 	);
 }
 
@@ -34,7 +40,7 @@ export function SlashCommandMenu() {
 
 	const filteredCommands = useMemo(
 		() => filterCommands(SLASH_BLOCK_COMMANDS, slashState.query),
-		[slashState.query]
+		[slashState.query],
 	);
 
 	// Reset selection when filtered list changes
@@ -132,14 +138,14 @@ export function SlashCommandMenu() {
 			// Execute the command insert action
 			command.insert(editor);
 		},
-		[editor]
+		[editor],
 	);
 
 	const handleItemClick = useCallback(
 		(command: BlockCommand) => {
 			executeCommand(command);
 		},
-		[executeCommand]
+		[executeCommand],
 	);
 
 	// Handle keyboard navigation
@@ -150,15 +156,15 @@ export function SlashCommandMenu() {
 			if (event.key === "ArrowDown") {
 				event.preventDefault();
 				setSelectedIndex((prev) =>
-					prev < filteredCommands.length - 1 ? prev + 1 : 0
+					prev < filteredCommands.length - 1 ? prev + 1 : 0,
 				);
 				return;
 			}
 
 			if (event.key === "ArrowUp") {
 				event.preventDefault();
 				setSelectedIndex((prev) =>
-					prev > 0 ? prev - 1 : filteredCommands.length - 1
+					prev > 0 ? prev - 1 : filteredCommands.length - 1,
 				);
 				return;
 			}
@@ -180,13 +186,19 @@ export function SlashCommandMenu() {
 
 		window.addEventListener("keydown", handleKeyDown, true);
 		return () => window.removeEventListener("keydown", handleKeyDown, true);
-	}, [slashState.active, editor, filteredCommands, selectedIndex, executeCommand]);
+	}, [
+		slashState.active,
+		editor,
+		filteredCommands,
+		selectedIndex,
+		executeCommand,
+	]);
 
 	// Scroll selected item into view
 	useEffect(() => {
 		if (!menuRef.current) return;
 		const selectedEl = menuRef.current.querySelector(
-			`[data-index="${selectedIndex}"]`
+			`[data-index="${selectedIndex}"]`,
 		);
 		if (selectedEl) {
 			selectedEl.scrollIntoView({ block: "nearest" });
@@ -241,11 +253,14 @@ export function SlashCommandMenu() {
 					onMouseEnter={() => setSelectedIndex(index)}
 					tabIndex={0}
 				>
-					<command.icon className="size-4 shrink-0 text-muted-foreground" aria-hidden />
+					<command.icon
+						className="size-4 shrink-0 text-muted-foreground"
+						aria-hidden
+					/>
 					<span>{command.label}</span>
 				</div>
 			))}
 		</div>,
-		document.body
+		document.body,
 	);
 }

packages/flashtype/src/views/markdown-view/editor/block-commands.ts

@@ -174,13 +174,19 @@ export const BLOCK_COMMANDS: BlockCommand[] = [
 				}
 				rows.push({ type: "tableRow", content: cells });
 			}
-			editor.chain().focus().insertContent({ type: "table", content: rows }).run();
+			editor
+				.chain()
+				.focus()
+				.insertContent({ type: "table", content: rows })
+				.run();
 		},
 	},
 ];
 
 /** Block commands that can be used in the toolbar (have toggle action) */
-export const TOOLBAR_BLOCK_COMMANDS = BLOCK_COMMANDS.filter((cmd) => cmd.toggle);
+export const TOOLBAR_BLOCK_COMMANDS = BLOCK_COMMANDS.filter(
+	(cmd) => cmd.toggle,
+);
 
 /** All block commands for slash menu */
 export const SLASH_BLOCK_COMMANDS = BLOCK_COMMANDS;
@@ -214,17 +220,22 @@ const idToToolbarValue: Record<string, ToolbarBlockType> = {
 };
 
 /** Toolbar-specific label overrides (where different from slash menu) */
-const toolbarLabelOverrides: Record<string, { label: string; description: string }> = {
+const toolbarLabelOverrides: Record<
+	string,
+	{ label: string; description: string }
+> = {
 	codeBlock: { label: "Code", description: "Code block" },
 };
 
 /** Block options formatted for toolbar dropdown */
-export const TOOLBAR_BLOCK_OPTIONS: ToolbarBlockOption[] = TOOLBAR_BLOCK_COMMANDS
-	.filter((cmd) => idToToolbarValue[cmd.id])
-	.map((cmd) => ({
-		value: idToToolbarValue[cmd.id]!,
-		label: toolbarLabelOverrides[cmd.id]?.label ?? cmd.label,
-		description: toolbarLabelOverrides[cmd.id]?.description ?? cmd.description,
-		icon: cmd.icon,
-		apply: cmd.toggle!,
-	}));
+export const TOOLBAR_BLOCK_OPTIONS: ToolbarBlockOption[] =
+	TOOLBAR_BLOCK_COMMANDS.filter((cmd) => idToToolbarValue[cmd.id]).map(
+		(cmd) => ({
+			value: idToToolbarValue[cmd.id]!,
+			label: toolbarLabelOverrides[cmd.id]?.label ?? cmd.label,
+			description:
+				toolbarLabelOverrides[cmd.id]?.description ?? cmd.description,
+			icon: cmd.icon,
+			apply: cmd.toggle!,
+		}),
+	);

packages/flashtype/src/views/markdown-view/editor/extensions/slash-commands.ts

@@ -13,7 +13,7 @@ declare module "@tiptap/core" {
 }
 
 export const slashCommandsPluginKey = new PluginKey<SlashCommandState>(
-	"slashCommands"
+	"slashCommands",
 );
 
 export type SlashCommandState = {
@@ -90,7 +90,7 @@ export const SlashCommandsExtension = Extension.create<SlashCommandsOptions>({
 							0,
 							$from.parentOffset,
 							undefined,
-							"\ufffc"
+							"\ufffc",
 						);
 
 						// Find the last "/" in the text before cursor
@@ -164,7 +164,9 @@ export const SlashCommandsExtension = Extension.create<SlashCommandsOptions>({
 				if (state?.active) {
 					// Close the menu
 					this.editor.view.dispatch(
-						this.editor.state.tr.setMeta(slashCommandsPluginKey, { close: true })
+						this.editor.state.tr.setMeta(slashCommandsPluginKey, {
+							close: true,
+						}),
 					);
 					return true;
 				}
@@ -194,7 +196,7 @@ export const SlashCommandsExtension = Extension.create<SlashCommandsOptions>({
 						dispatch(
 							tr
 								.delete(pluginState.range.from, pluginState.range.to)
-								.setMeta(slashCommandsPluginKey, { close: true })
+								.setMeta(slashCommandsPluginKey, { close: true }),
 						);
 					}
 					return true;

packages/lix/website/.gitignore

@@ -0,0 +1,16 @@
+node_modules
+.DS_Store
+dist
+dist-ssr
+*.local
+src/routeTree.gen.ts
+count.txt
+.env
+.nitro
+.tanstack
+.wrangler
+.output
+.vinxi
+todos.json
+content/plugins/*.md
+!content/plugins/index.md

packages/lix/website/.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "files.watcherExclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "search.exclude": {
+    "**/routeTree.gen.ts": true
+  },
+  "files.readonlyInclude": {
+    "**/routeTree.gen.ts": true
+  }
+}