waybetter 0.1.1 → 0.6.0

package/dist/shell/panel/makeModel.js

@@ -0,0 +1,84 @@
+// "Make" section data every app shares: the `npm create waybetter` commands, the UI kit gallery's
+// calls, and the plugin header rules the Plugins list uses. The example plugins, the example theme
+// and the bundled docs are the app's (`PanelSite.make`). Pure (no React, no Tauri).
+import { t } from "../frame/i18n.js";
+/** `npm create waybetter` commands shown in the section (the framework's create-waybetter). */
+export const CREATE_COMMANDS = [
+    { get label() { return t('wb.make.create.plugin'); }, command: 'npm create waybetter plugin -- --name "My Plugin"' },
+    { get label() { return t('wb.make.create.pluginTs'); }, command: 'npm create waybetter plugin -- --name "My Plugin" --ts' },
+    { get label() { return t('wb.make.create.theme'); }, command: 'npm create waybetter theme -- --name "My Theme" --accent "#3ddc97"' },
+    { get label() { return t('wb.make.create.app'); }, command: 'npm create waybetter app -- --site kick.com' },
+];
+export const KIT_DEMOS = [
+    { id: 'toast', get label() { return t('wb.make.kit.toast'); }, kind: 'toast', code: "ui.toast('Link copied');" },
+    { id: 'toast-success', get label() { return t('wb.make.kit.toastSuccess'); }, kind: 'toast', code: "ui.toast('Saved', { tone: 'success' });" },
+    { id: 'toast-action', get label() { return t('wb.make.kit.toastAction'); }, kind: 'toast', code: "ui.toast('Post hidden', { tone: 'warning', action: { label: 'Undo', onClick: undo } });" },
+    { id: 'toast-danger', get label() { return t('wb.make.kit.toastDanger'); }, kind: 'toast', code: "ui.toast('Could not save', { tone: 'danger' });" },
+    { id: 'alert', get label() { return t('wb.make.kit.alert'); }, kind: 'alert', code: "await ui.alert({ title: 'Exported', message: 'Your list was saved to Downloads.', tone: 'success' });" },
+    { id: 'confirm', get label() { return t('wb.make.kit.confirm'); }, kind: 'confirm', code: "await ui.confirm({ title: 'Delete this note?', message: 'This cannot be undone.', confirmLabel: 'Delete', danger: true });" },
+    { id: 'prompt', get label() { return t('wb.make.kit.prompt'); }, kind: 'prompt', code: "await ui.prompt({ title: 'Rename list', label: 'Name', value: 'Reading', validate: v => v.trim().length < 3 ? 'Use at least 3 characters.' : null });" },
+    { id: 'dialog', get label() { return t('wb.make.kit.dialog'); }, kind: 'dialog', code: "ui.dialog({ title: 'My plugin', message: 'What should be hidden?', content: body => body.append(h('label', { class: 'wb-check' }, h('input', { type: 'checkbox' }), 'Hide trends')), actions: [{ label: 'Cancel' }, { label: 'Save', tone: 'primary', default: true }] });" },
+];
+/** A color role's CSS variable: `onAccent` -> `--wb-on-accent` (the names `themeVars` writes). */
+export const cssVarOf = (role) => `--wb-${role.replace(/[A-Z]/g, c => `-${c.toLowerCase()}`)}`;
+// ---------------------------------------------------------------------------------------------
+// Plugin header: the same rules as the plugin store (waybetter-host `plugins::parse_meta` and
+// `valid_file_name`), so the editor shows what the Plugins list will show.
+export const PLUGIN_SUFFIX = '.plugin.js';
+export function parsePluginHeader(file, source) {
+    const meta = { file, name: file.endsWith(PLUGIN_SUFFIX) ? file.slice(0, -PLUGIN_SUFFIX.length) : file, description: '', version: '', author: '', header: false };
+    const trimmed = source.replace(/^+/, '').trimStart();
+    if (!trimmed.startsWith('/**'))
+        return meta;
+    const body = trimmed.slice(3);
+    const end = body.indexOf('*/');
+    if (end < 0)
+        return meta;
+    meta.header = true;
+    for (const raw of body.slice(0, end).split('\n')) {
+        const line = raw.trim().replace(/^\*+/, '').trim();
+        if (!line.startsWith('@'))
+            continue;
+        const rest = line.slice(1);
+        const space = /\s/.exec(rest);
+        const key = space ? rest.slice(0, space.index) : rest;
+        const value = [...(space ? rest.slice(space.index) : '').trim()].filter(ch => !/\p{Cc}/u.test(ch)).slice(0, 300).join('');
+        if (key === 'name' && value)
+            meta.name = value;
+        else if (key === 'description')
+            meta.description = value;
+        else if (key === 'version')
+            meta.version = value;
+        else if (key === 'author')
+            meta.author = value;
+    }
+    return meta;
+}
+/** A bare `name.plugin.js` the plugins folder accepts. */
+export function validPluginFileName(file) {
+    return file.length > PLUGIN_SUFFIX.length && file.length <= 128 && file.endsWith(PLUGIN_SUFFIX) && !file.startsWith('.') && /^[A-Za-z0-9_. -]+$/.test(file);
+}
+/** `Hide Trends` -> `hide-trends.plugin.js`. */
+export function pluginFileFor(name) {
+    const slug = name.normalize('NFKD').replace(/\p{M}/gu, '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 48).replace(/-+$/, '');
+    return `${slug || 'my-plugin'}${PLUGIN_SUFFIX}`;
+}
+/** What the editor warns about before the file is copied into the plugins folder. */
+export function pluginWarnings(meta, source) {
+    const warnings = [];
+    if (!meta.header)
+        warnings.push(t('wb.make.warn.header'));
+    else
+        for (const tag of ['name', 'description', 'version', 'author']) {
+            if (tag === 'name' ? meta.name === meta.file.replace(PLUGIN_SUFFIX, '') && !/@name\s+\S/.test(source) : !meta[tag])
+                warnings.push(t('wb.make.warn.tag', { tag: `@${tag}` }));
+        }
+    if (meta.header && !/^\s*\*?\s*@permissions\b/m.test(source))
+        warnings.push(t('wb.make.warn.permissions'));
+    if (!/module\.exports\s*=|exports\.default\s*=/.test(source))
+        warnings.push(t('wb.make.warn.export'));
+    if (!/\bstop\s*\(/.test(source))
+        warnings.push(t('wb.make.warn.stop'));
+    return warnings;
+}
+//# sourceMappingURL=makeModel.js.map

package/dist/shell/panel/makeModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makeModel.js","sourceRoot":"","sources":["../../../../../../shell/src/panel/makeModel.ts"],"names":[],"mappings":"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","sourcesContent":["// \"Make\" section data every app shares: the `npm create waybetter` commands, the UI kit gallery's\n// calls, and the plugin header rules the Plugins list uses. The example plugins, the example theme\n// and the bundled docs are the app's (`PanelSite.make`). Pure (no React, no Tauri).\n\nimport { t } from '../frame/i18n.ts';\n\nexport type { PluginExample } from './site.ts';\n\n/** `npm create waybetter` commands shown in the section (the framework's create-waybetter). */\nexport const CREATE_COMMANDS = [\n  { get label() { return t('wb.make.create.plugin'); }, command: 'npm create waybetter plugin -- --name \"My Plugin\"' },\n  { get label() { return t('wb.make.create.pluginTs'); }, command: 'npm create waybetter plugin -- --name \"My Plugin\" --ts' },\n  { get label() { return t('wb.make.create.theme'); }, command: 'npm create waybetter theme -- --name \"My Theme\" --accent \"#3ddc97\"' },\n  { get label() { return t('wb.make.create.app'); }, command: 'npm create waybetter app -- --site kick.com' },\n];\n\n/** One UI kit call in the gallery: the code shown is the call the button makes. */\nexport type KitDemo = { id: string; label: string; kind: 'toast' | 'alert' | 'confirm' | 'prompt' | 'dialog'; code: string };\n\nexport const KIT_DEMOS: KitDemo[] = [\n  { id: 'toast', get label() { return t('wb.make.kit.toast'); }, kind: 'toast', code: \"ui.toast('Link copied');\" },\n  { id: 'toast-success', get label() { return t('wb.make.kit.toastSuccess'); }, kind: 'toast', code: \"ui.toast('Saved', { tone: 'success' });\" },\n  { id: 'toast-action', get label() { return t('wb.make.kit.toastAction'); }, kind: 'toast', code: \"ui.toast('Post hidden', { tone: 'warning', action: { label: 'Undo', onClick: undo } });\" },\n  { id: 'toast-danger', get label() { return t('wb.make.kit.toastDanger'); }, kind: 'toast', code: \"ui.toast('Could not save', { tone: 'danger' });\" },\n  { id: 'alert', get label() { return t('wb.make.kit.alert'); }, kind: 'alert', code: \"await ui.alert({ title: 'Exported', message: 'Your list was saved to Downloads.', tone: 'success' });\" },\n  { id: 'confirm', get label() { return t('wb.make.kit.confirm'); }, kind: 'confirm', code: \"await ui.confirm({ title: 'Delete this note?', message: 'This cannot be undone.', confirmLabel: 'Delete', danger: true });\" },\n  { id: 'prompt', get label() { return t('wb.make.kit.prompt'); }, kind: 'prompt', code: \"await ui.prompt({ title: 'Rename list', label: 'Name', value: 'Reading', validate: v => v.trim().length < 3 ? 'Use at least 3 characters.' : null });\" },\n  { id: 'dialog', get label() { return t('wb.make.kit.dialog'); }, kind: 'dialog', code: \"ui.dialog({ title: 'My plugin', message: 'What should be hidden?', content: body => body.append(h('label', { class: 'wb-check' }, h('input', { type: 'checkbox' }), 'Hide trends')), actions: [{ label: 'Cancel' }, { label: 'Save', tone: 'primary', default: true }] });\" },\n];\n\n/** A color role's CSS variable: `onAccent` -> `--wb-on-accent` (the names `themeVars` writes). */\nexport const cssVarOf = (role: string) => `--wb-${role.replace(/[A-Z]/g, c => `-${c.toLowerCase()}`)}`;\n\n// ---------------------------------------------------------------------------------------------\n// Plugin header: the same rules as the plugin store (waybetter-host `plugins::parse_meta` and\n// `valid_file_name`), so the editor shows what the Plugins list will show.\n\nexport const PLUGIN_SUFFIX = '.plugin.js';\n\nexport type PluginMeta = { file: string; name: string; description: string; version: string; author: string; header: boolean };\n\nexport function parsePluginHeader(file: string, source: string): PluginMeta {\n  const meta: PluginMeta = { file, name: file.endsWith(PLUGIN_SUFFIX) ? file.slice(0, -PLUGIN_SUFFIX.length) : file, description: '', version: '', author: '', header: false };\n  const trimmed = source.replace(/^+/, '').trimStart();\n  if (!trimmed.startsWith('/**')) return meta;\n  const body = trimmed.slice(3);\n  const end = body.indexOf('*/');\n  if (end < 0) return meta;\n  meta.header = true;\n  for (const raw of body.slice(0, end).split('\\n')) {\n    const line = raw.trim().replace(/^\\*+/, '').trim();\n    if (!line.startsWith('@')) continue;\n    const rest = line.slice(1);\n    const space = /\\s/.exec(rest);\n    const key = space ? rest.slice(0, space.index) : rest;\n    const value = [...(space ? rest.slice(space.index) : '').trim()].filter(ch => !/\\p{Cc}/u.test(ch)).slice(0, 300).join('');\n    if (key === 'name' && value) meta.name = value;\n    else if (key === 'description') meta.description = value;\n    else if (key === 'version') meta.version = value;\n    else if (key === 'author') meta.author = value;\n  }\n  return meta;\n}\n\n/** A bare `name.plugin.js` the plugins folder accepts. */\nexport function validPluginFileName(file: string): boolean {\n  return file.length > PLUGIN_SUFFIX.length && file.length <= 128 && file.endsWith(PLUGIN_SUFFIX) && !file.startsWith('.') && /^[A-Za-z0-9_. -]+$/.test(file);\n}\n\n/** `Hide Trends` -> `hide-trends.plugin.js`. */\nexport function pluginFileFor(name: string): string {\n  const slug = name.normalize('NFKD').replace(/\\p{M}/gu, '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 48).replace(/-+$/, '');\n  return `${slug || 'my-plugin'}${PLUGIN_SUFFIX}`;\n}\n\n/** What the editor warns about before the file is copied into the plugins folder. */\nexport function pluginWarnings(meta: PluginMeta, source: string): string[] {\n  const warnings: string[] = [];\n  if (!meta.header) warnings.push(t('wb.make.warn.header'));\n  else for (const tag of ['name', 'description', 'version', 'author'] as const) {\n    if (tag === 'name' ? meta.name === meta.file.replace(PLUGIN_SUFFIX, '') && !/@name\\s+\\S/.test(source) : !meta[tag]) warnings.push(t('wb.make.warn.tag', { tag: `@${tag}` }));\n  }\n  if (meta.header && !/^\\s*\\*?\\s*@permissions\\b/m.test(source)) warnings.push(t('wb.make.warn.permissions'));\n  if (!/module\\.exports\\s*=|exports\\.default\\s*=/.test(source)) warnings.push(t('wb.make.warn.export'));\n  if (!/\\bstop\\s*\\(/.test(source)) warnings.push(t('wb.make.warn.stop'));\n  return warnings;\n}\n"]}

package/dist/shell/panel/markdown.d.ts

@@ -0,0 +1,46 @@
+export type Block = {
+    kind: 'heading';
+    level: number;
+    text: string;
+} | {
+    kind: 'paragraph';
+    text: string;
+} | {
+    kind: 'list';
+    ordered: boolean;
+    items: string[];
+} | {
+    kind: 'table';
+    head: string[];
+    rows: string[][];
+} | {
+    kind: 'code';
+    lang: string;
+    text: string;
+};
+export type DocLink = {
+    doc?: string;
+    anchor?: string;
+    url?: string;
+};
+/** GitHub-style heading anchors: `## Matching the theme: \`api.theme\`` -> `matching-the-theme-apitheme`. */
+export declare const anchorOf: (text: string) => string;
+export declare function parseMarkdown(source: string): Block[];
+/** Where a Markdown link goes: another bundled doc, an anchor in this one, or the web. */
+export declare function resolveLink(href: string, docs: readonly string[]): DocLink | null;
+export type Inline = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'code';
+    text: string;
+} | {
+    kind: 'bold';
+    text: string;
+} | {
+    kind: 'link';
+    text: string;
+    href: string;
+};
+/** Inline code, **bold** and [links](href); everything else is text. */
+export declare function inlineTokens(text: string): Inline[];

package/dist/shell/panel/markdown.js

@@ -0,0 +1,100 @@
+// Markdown for the bundled docs (PLUGINS.md, THEMES.md), parsed into plain data: headings,
+// paragraphs, lists, tables, fenced code and inline code/bold/links. Pure; MarkdownDoc.tsx renders
+// it as React text, never as HTML.
+/** GitHub-style heading anchors: `## Matching the theme: \`api.theme\`` -> `matching-the-theme-apitheme`. */
+export const anchorOf = (text) => text.toLowerCase().replace(/[`*]/g, '').replace(/[^\p{L}\p{N} -]/gu, '').trim().replace(/ /g, '-');
+const cells = (line) => line.trim().replace(/^\||\|$/g, '').split(/(?<!\\)\|/).map(cell => cell.trim().replace(/\\\|/g, '|'));
+export function parseMarkdown(source) {
+    const lines = source.replace(/\r\n?/g, '\n').split('\n');
+    const blocks = [];
+    for (let i = 0; i < lines.length;) {
+        const line = lines[i];
+        const fence = /^```(\w*)/.exec(line);
+        if (fence) {
+            const body = [];
+            for (i += 1; i < lines.length && !lines[i].startsWith('```'); i += 1)
+                body.push(lines[i]);
+            blocks.push({ kind: 'code', lang: fence[1] ?? '', text: body.join('\n') });
+            i += 1;
+            continue;
+        }
+        const heading = /^(#{1,4})\s+(.*)$/.exec(line);
+        if (heading) {
+            blocks.push({ kind: 'heading', level: heading[1].length, text: heading[2] });
+            i += 1;
+            continue;
+        }
+        if (/^\s*\|/.test(line) && /^\s*\|[\s:|-]+\|\s*$/.test(lines[i + 1] ?? '')) {
+            const head = cells(line);
+            const rows = [];
+            for (i += 2; i < lines.length && /^\s*\|/.test(lines[i]); i += 1)
+                rows.push(cells(lines[i]));
+            blocks.push({ kind: 'table', head, rows });
+            continue;
+        }
+        const item = /^(\s*)([-*]|\d+\.)\s+(.*)$/.exec(line);
+        if (item) {
+            const ordered = /\d/.test(item[2]);
+            const items = [];
+            while (i < lines.length) {
+                const next = /^(\s*)([-*]|\d+\.)\s+(.*)$/.exec(lines[i]);
+                if (next) {
+                    items.push(next[3]);
+                    i += 1;
+                    continue;
+                }
+                // Continuation lines are indented under the item.
+                if (/^\s{2,}\S/.test(lines[i]) && items.length) {
+                    items[items.length - 1] += ` ${lines[i].trim()}`;
+                    i += 1;
+                    continue;
+                }
+                break;
+            }
+            blocks.push({ kind: 'list', ordered, items });
+            continue;
+        }
+        if (!line.trim()) {
+            i += 1;
+            continue;
+        }
+        // The first line always belongs to the paragraph (e.g. a lone `|` line that is not a table).
+        const text = [line.trim()];
+        for (i += 1; i < lines.length && lines[i].trim() && !/^(```|#{1,4}\s|\s*\||\s*([-*]|\d+\.)\s)/.test(lines[i]); i += 1)
+            text.push(lines[i].trim());
+        blocks.push({ kind: 'paragraph', text: text.join(' ') });
+    }
+    return blocks;
+}
+/** Where a Markdown link goes: another bundled doc, an anchor in this one, or the web. */
+export function resolveLink(href, docs) {
+    if (href.startsWith('#'))
+        return { anchor: href.slice(1) };
+    const local = /^\.?\/?([\w.-]+\.md)(?:#(.*))?$/.exec(href);
+    if (local && docs.includes(local[1]))
+        return { doc: local[1], anchor: local[2] };
+    if (/^https:\/\//.test(href))
+        return { url: href };
+    return null;
+}
+/** Inline code, **bold** and [links](href); everything else is text. */
+export function inlineTokens(text) {
+    const out = [];
+    const pattern = /`([^`]+)`|\*\*([^*]+)\*\*|\[([^\]]+)\]\(([^)\s]+)\)/g;
+    let last = 0;
+    for (const match of text.matchAll(pattern)) {
+        if (match.index > last)
+            out.push({ kind: 'text', text: text.slice(last, match.index) });
+        if (match[1] !== undefined)
+            out.push({ kind: 'code', text: match[1] });
+        else if (match[2] !== undefined)
+            out.push({ kind: 'bold', text: match[2] });
+        else
+            out.push({ kind: 'link', text: match[3], href: match[4] });
+        last = match.index + match[0].length;
+    }
+    if (last < text.length)
+        out.push({ kind: 'text', text: text.slice(last) });
+    return out;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/shell/panel/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../../../../shell/src/panel/markdown.ts"],"names":[],"mappings":"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","sourcesContent":["// Markdown for the bundled docs (PLUGINS.md, THEMES.md), parsed into plain data: headings,\n// paragraphs, lists, tables, fenced code and inline code/bold/links. Pure; MarkdownDoc.tsx renders\n// it as React text, never as HTML.\n\nexport type Block =\n  | { kind: 'heading'; level: number; text: string }\n  | { kind: 'paragraph'; text: string }\n  | { kind: 'list'; ordered: boolean; items: string[] }\n  | { kind: 'table'; head: string[]; rows: string[][] }\n  | { kind: 'code'; lang: string; text: string };\n\nexport type DocLink = { doc?: string; anchor?: string; url?: string };\n\n/** GitHub-style heading anchors: `## Matching the theme: \\`api.theme\\`` -> `matching-the-theme-apitheme`. */\nexport const anchorOf = (text: string) => text.toLowerCase().replace(/[`*]/g, '').replace(/[^\\p{L}\\p{N} -]/gu, '').trim().replace(/ /g, '-');\n\nconst cells = (line: string) => line.trim().replace(/^\\||\\|$/g, '').split(/(?<!\\\\)\\|/).map(cell => cell.trim().replace(/\\\\\\|/g, '|'));\n\nexport function parseMarkdown(source: string): Block[] {\n  const lines = source.replace(/\\r\\n?/g, '\\n').split('\\n');\n  const blocks: Block[] = [];\n  for (let i = 0; i < lines.length;) {\n    const line = lines[i]!;\n    const fence = /^```(\\w*)/.exec(line);\n    if (fence) {\n      const body: string[] = [];\n      for (i += 1; i < lines.length && !lines[i]!.startsWith('```'); i += 1) body.push(lines[i]!);\n      blocks.push({ kind: 'code', lang: fence[1] ?? '', text: body.join('\\n') });\n      i += 1;\n      continue;\n    }\n    const heading = /^(#{1,4})\\s+(.*)$/.exec(line);\n    if (heading) { blocks.push({ kind: 'heading', level: heading[1]!.length, text: heading[2]! }); i += 1; continue; }\n    if (/^\\s*\\|/.test(line) && /^\\s*\\|[\\s:|-]+\\|\\s*$/.test(lines[i + 1] ?? '')) {\n      const head = cells(line);\n      const rows: string[][] = [];\n      for (i += 2; i < lines.length && /^\\s*\\|/.test(lines[i]!); i += 1) rows.push(cells(lines[i]!));\n      blocks.push({ kind: 'table', head, rows });\n      continue;\n    }\n    const item = /^(\\s*)([-*]|\\d+\\.)\\s+(.*)$/.exec(line);\n    if (item) {\n      const ordered = /\\d/.test(item[2]!);\n      const items: string[] = [];\n      while (i < lines.length) {\n        const next = /^(\\s*)([-*]|\\d+\\.)\\s+(.*)$/.exec(lines[i]!);\n        if (next) { items.push(next[3]!); i += 1; continue; }\n        // Continuation lines are indented under the item.\n        if (/^\\s{2,}\\S/.test(lines[i]!) && items.length) { items[items.length - 1] += ` ${lines[i]!.trim()}`; i += 1; continue; }\n        break;\n      }\n      blocks.push({ kind: 'list', ordered, items });\n      continue;\n    }\n    if (!line.trim()) { i += 1; continue; }\n    // The first line always belongs to the paragraph (e.g. a lone `|` line that is not a table).\n    const text: string[] = [line.trim()];\n    for (i += 1; i < lines.length && lines[i]!.trim() && !/^(```|#{1,4}\\s|\\s*\\||\\s*([-*]|\\d+\\.)\\s)/.test(lines[i]!); i += 1) text.push(lines[i]!.trim());\n    blocks.push({ kind: 'paragraph', text: text.join(' ') });\n  }\n  return blocks;\n}\n\n/** Where a Markdown link goes: another bundled doc, an anchor in this one, or the web. */\nexport function resolveLink(href: string, docs: readonly string[]): DocLink | null {\n  if (href.startsWith('#')) return { anchor: href.slice(1) };\n  const local = /^\\.?\\/?([\\w.-]+\\.md)(?:#(.*))?$/.exec(href);\n  if (local && docs.includes(local[1]!)) return { doc: local[1], anchor: local[2] };\n  if (/^https:\\/\\//.test(href)) return { url: href };\n  return null;\n}\n\nexport type Inline = { kind: 'text'; text: string } | { kind: 'code'; text: string } | { kind: 'bold'; text: string } | { kind: 'link'; text: string; href: string };\n\n/** Inline code, **bold** and [links](href); everything else is text. */\nexport function inlineTokens(text: string): Inline[] {\n  const out: Inline[] = [];\n  const pattern = /`([^`]+)`|\\*\\*([^*]+)\\*\\*|\\[([^\\]]+)\\]\\(([^)\\s]+)\\)/g;\n  let last = 0;\n  for (const match of text.matchAll(pattern)) {\n    if (match.index! > last) out.push({ kind: 'text', text: text.slice(last, match.index) });\n    if (match[1] !== undefined) out.push({ kind: 'code', text: match[1] });\n    else if (match[2] !== undefined) out.push({ kind: 'bold', text: match[2] });\n    else out.push({ kind: 'link', text: match[3]!, href: match[4]! });\n    last = match.index! + match[0].length;\n  }\n  if (last < text.length) out.push({ kind: 'text', text: text.slice(last) });\n  return out;\n}\n"]}

package/dist/shell/panel/nav.d.ts

@@ -0,0 +1,12 @@
+import type { ComponentType } from 'react';
+import { type BuiltinSection, type PanelSite, type SectionProps } from './site.ts';
+/** Nav icons of the built-in sections (16x16 stroke paths). */
+export declare const NAV_ICONS: Record<BuiltinSection, string>;
+export type NavEntry = {
+    id: string;
+    icon: string;
+    label(t: (key: string) => string): string;
+    component: ComponentType<SectionProps> | null;
+};
+/** The panel's sections in nav order: the built-in ones the app serves and the app's own. */
+export declare function navEntries(panel?: PanelSite): NavEntry[];

package/dist/shell/panel/nav.js

@@ -0,0 +1,50 @@
+import { hasFeature, site } from "../frame/site.js";
+import { BUILTIN_SECTIONS, panelSite } from "./site.js";
+/** Nav icons of the built-in sections (16x16 stroke paths). */
+export const NAV_ICONS = {
+    home: 'M2.5 7.2 8 2.8l5.5 4.4V13H9.8V9.6H6.2V13H2.5z',
+    themes: 'M8 2.5a5.5 5.5 0 1 0 0 11c.9 0 1.2-.6 1.2-1.1 0-.7-.5-.9-.5-1.5 0-.6.5-1 1.1-1h1.2A2.5 2.5 0 0 0 13.5 7.4 5.3 5.3 0 0 0 8 2.5zM5 7.2h.01M7.2 5h.01M10 5.4h.01',
+    builder: 'M3 13l.6-2.6L10.5 3.5l2 2-6.9 6.9zM9 5l2 2M2.5 3.5h3M4 2v3',
+    plugins: 'M6 2.5v3M10 2.5v3M4 5.5h8V8a4 4 0 0 1-8 0zM8 12v1.5',
+    store: 'M2.8 6 3.8 2.8h8.4L13.2 6M2.8 6h10.4v7.2H2.8zM2.8 6a1.7 1.7 0 0 0 3.5 0 1.7 1.7 0 0 0 3.4 0 1.7 1.7 0 0 0 3.5 0M6.7 13.2V10h2.6v3.2',
+    make: 'M5.5 4.5 2.5 8l3 3.5M10.5 4.5l3 3.5-3 3.5M9.2 3 6.8 13',
+    accounts: 'M6 7.5a2.3 2.3 0 1 0 0-4.6 2.3 2.3 0 0 0 0 4.6zM2 13a4 4 0 0 1 8 0M10.5 3.2a2.3 2.3 0 0 1 0 4.4M12 9.5A3.8 3.8 0 0 1 14 13',
+    updates: 'M13 8a5 5 0 1 1-1.5-3.5M13 2.5v2.8h-2.8',
+    settings: 'M2.5 4.5h11v8h-11zM2.5 7h11M4.5 5.8h.01M6 5.8h.01',
+    power: 'M2.5 3h3v10h-3zM6.5 3h3v10h-3zM10.5 3h3v10h-3z',
+    backup: 'M8 2.5v7M5 6.5l3 3 3-3M3 10.5v2h10v-2',
+    developer: 'M5.5 5 2.5 8l3 3M10.5 5l3 3-3 3',
+};
+const BUILTIN_LABELS = {
+    home: 'wb.panel.section.home', themes: 'wb.panel.section.themes', builder: 'wb.panel.section.builder', plugins: 'wb.panel.section.plugins',
+    store: 'wb.panel.section.store', make: 'wb.panel.section.make', accounts: 'wb.panel.section.accounts', power: 'wb.panel.section.power',
+    settings: 'wb.panel.section.settings', backup: 'wb.panel.section.backup', developer: 'wb.panel.section.developer', updates: 'wb.panel.section.updates',
+};
+/** Whether the app serves what a built-in section needs. */
+function available(id, panel) {
+    switch (id) {
+        case 'themes':
+        case 'builder': return !!panel.themes;
+        case 'store': return !!panel.store && !!panel.themes;
+        case 'make': return !!panel.make;
+        case 'power': return !!site().deck;
+        case 'backup': return !!panel.backup;
+        case 'developer': return hasFeature('developer');
+        case 'updates': return !!panel.updates;
+        default: return true;
+    }
+}
+/** The panel's sections in nav order: the built-in ones the app serves and the app's own. */
+export function navEntries(panel = panelSite()) {
+    const builtin = BUILTIN_SECTIONS.filter(id => available(id, panel));
+    const own = panel.sections ?? [];
+    const known = new Set([...builtin, ...own.map(section => section.id)]);
+    const order = [...(panel.order ?? []).filter(id => known.has(id)), ...[...known].filter(id => !(panel.order ?? []).includes(id))];
+    return order.map(id => {
+        const custom = own.find(section => section.id === id);
+        if (custom)
+            return { id, icon: custom.icon, label: () => custom.label(), component: custom.component };
+        return { id, icon: NAV_ICONS[id], label: t => t(BUILTIN_LABELS[id]), component: null };
+    });
+}
+//# sourceMappingURL=nav.js.map

package/dist/shell/panel/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../../../../../../shell/src/panel/nav.ts"],"names":[],"mappings":"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","sourcesContent":["// The panel's navigation: the built-in sections (shown when the app serves what each needs) and the\n// app's own, in the app's order. Pure (no JSX), unit-tested under node.\nimport type { ComponentType } from 'react';\nimport { hasFeature, site } from '../frame/site.ts';\nimport { BUILTIN_SECTIONS, panelSite, type BuiltinSection, type PanelSite, type SectionProps } from './site.ts';\n\n/** Nav icons of the built-in sections (16x16 stroke paths). */\nexport const NAV_ICONS: Record<BuiltinSection, string> = {\n  home: 'M2.5 7.2 8 2.8l5.5 4.4V13H9.8V9.6H6.2V13H2.5z',\n  themes: 'M8 2.5a5.5 5.5 0 1 0 0 11c.9 0 1.2-.6 1.2-1.1 0-.7-.5-.9-.5-1.5 0-.6.5-1 1.1-1h1.2A2.5 2.5 0 0 0 13.5 7.4 5.3 5.3 0 0 0 8 2.5zM5 7.2h.01M7.2 5h.01M10 5.4h.01',\n  builder: 'M3 13l.6-2.6L10.5 3.5l2 2-6.9 6.9zM9 5l2 2M2.5 3.5h3M4 2v3',\n  plugins: 'M6 2.5v3M10 2.5v3M4 5.5h8V8a4 4 0 0 1-8 0zM8 12v1.5',\n  store: 'M2.8 6 3.8 2.8h8.4L13.2 6M2.8 6h10.4v7.2H2.8zM2.8 6a1.7 1.7 0 0 0 3.5 0 1.7 1.7 0 0 0 3.4 0 1.7 1.7 0 0 0 3.5 0M6.7 13.2V10h2.6v3.2',\n  make: 'M5.5 4.5 2.5 8l3 3.5M10.5 4.5l3 3.5-3 3.5M9.2 3 6.8 13',\n  accounts: 'M6 7.5a2.3 2.3 0 1 0 0-4.6 2.3 2.3 0 0 0 0 4.6zM2 13a4 4 0 0 1 8 0M10.5 3.2a2.3 2.3 0 0 1 0 4.4M12 9.5A3.8 3.8 0 0 1 14 13',\n  updates: 'M13 8a5 5 0 1 1-1.5-3.5M13 2.5v2.8h-2.8',\n  settings: 'M2.5 4.5h11v8h-11zM2.5 7h11M4.5 5.8h.01M6 5.8h.01',\n  power: 'M2.5 3h3v10h-3zM6.5 3h3v10h-3zM10.5 3h3v10h-3z',\n  backup: 'M8 2.5v7M5 6.5l3 3 3-3M3 10.5v2h10v-2',\n  developer: 'M5.5 5 2.5 8l3 3M10.5 5l3 3-3 3',\n};\nconst BUILTIN_LABELS: Record<BuiltinSection, string> = {\n  home: 'wb.panel.section.home', themes: 'wb.panel.section.themes', builder: 'wb.panel.section.builder', plugins: 'wb.panel.section.plugins',\n  store: 'wb.panel.section.store', make: 'wb.panel.section.make', accounts: 'wb.panel.section.accounts', power: 'wb.panel.section.power',\n  settings: 'wb.panel.section.settings', backup: 'wb.panel.section.backup', developer: 'wb.panel.section.developer', updates: 'wb.panel.section.updates',\n};\n\n/** Whether the app serves what a built-in section needs. */\nfunction available(id: BuiltinSection, panel: PanelSite): boolean {\n  switch (id) {\n    case 'themes':\n    case 'builder': return !!panel.themes;\n    case 'store': return !!panel.store && !!panel.themes;\n    case 'make': return !!panel.make;\n    case 'power': return !!site().deck;\n    case 'backup': return !!panel.backup;\n    case 'developer': return hasFeature('developer');\n    case 'updates': return !!panel.updates;\n    default: return true;\n  }\n}\n\nexport type NavEntry = { id: string; icon: string; label(t: (key: string) => string): string; component: ComponentType<SectionProps> | null };\n\n/** The panel's sections in nav order: the built-in ones the app serves and the app's own. */\nexport function navEntries(panel: PanelSite = panelSite()): NavEntry[] {\n  const builtin = BUILTIN_SECTIONS.filter(id => available(id, panel));\n  const own = panel.sections ?? [];\n  const known = new Set<string>([...builtin, ...own.map(section => section.id)]);\n  const order = [...(panel.order ?? []).filter(id => known.has(id)), ...[...known].filter(id => !(panel.order ?? []).includes(id))];\n  return order.map(id => {\n    const custom = own.find(section => section.id === id);\n    if (custom) return { id, icon: custom.icon, label: () => custom.label(), component: custom.component };\n    return { id, icon: NAV_ICONS[id as BuiltinSection], label: t => t(BUILTIN_LABELS[id as BuiltinSection]), component: null };\n  });\n}\n"]}