m9ve website code outsidr

website/markdown/base64.ts

@@ -0,0 +1,44 @@
+/**
+ *  Copyright (c) 2025 taskylizard. Apache License 2.0.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import type { MarkdownRenderer } from 'vitepress'
+
+// FIXME: tasky: possibly write less horror jank?
+export function base64DecodePlugin(md: MarkdownRenderer) {
+  const decode = (str: string): string =>
+    Buffer.from(str, 'base64').toString('binary')
+  // Save the original rule for backticks
+  const defaultRender =
+    md.renderer.rules.code_inline ||
+    function (tokens, idx, options, _env, self) {
+      return self.renderToken(tokens, idx, options)
+    }
+
+  md.renderer.rules.code_inline = function (tokens, idx, options, env, self) {
+    if (
+      !env.frontmatter.title ||
+      (env.frontmatter.title && env.frontmatter.title !== 'base64')
+    ) {
+      return defaultRender(tokens, idx, options, env, self)
+    }
+    const token = tokens[idx]
+    const content = token.content
+
+    return `<button class='base64' onclick="(function(btn){ const codeEl = btn.querySelector('code'); navigator.clipboard.writeText('${decode(
+      content
+    )}').then(() => { const originalText = codeEl.textContent; codeEl.textContent = 'Copied'; setTimeout(() => codeEl.textContent = originalText, 3000); }).catch(console.error); })(this)"><code>${content}</code></button>`
+  }
+}

website/markdown/emoji.ts

@@ -0,0 +1,58 @@
+/**
+ *  Copyright (c) 2025 taskylizard. Apache License 2.0.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import type { MarkdownRenderer } from 'vitepress'
+import { icons as twemoji } from '@iconify-json/twemoji'
+
+export const defs = {
+  ...Object.fromEntries(
+    Object.entries(twemoji.icons).map(([key]) => {
+      return [key, '']
+    })
+  )
+}
+
+export function emojiRender(md: MarkdownRenderer) {
+  md.renderer.rules.emoji = (tokens, idx) => {
+    if (tokens[idx].markup.startsWith('star')) {
+      return `<span class="i-twemoji-${tokens[idx].markup} starred"></span>`
+    }
+    return `<span class="i-twemoji-${tokens[idx].markup}"></span>`
+  }
+}
+
+export function movePlugin(
+  plugins: { name: string }[],
+  pluginAName: string,
+  order: 'before' | 'after',
+  pluginBName: string
+) {
+  const pluginBIndex = plugins.findIndex((p) => p.name === pluginBName)
+  if (pluginBIndex === -1) return
+
+  const pluginAIndex = plugins.findIndex((p) => p.name === pluginAName)
+  if (pluginAIndex === -1) return
+
+  if (order === 'before' && pluginAIndex > pluginBIndex) {
+    const pluginA = plugins.splice(pluginAIndex, 1)[0]
+    plugins.splice(pluginBIndex, 0, pluginA)
+  }
+
+  if (order === 'after' && pluginAIndex < pluginBIndex) {
+    const pluginA = plugins.splice(pluginAIndex, 1)[0]
+    plugins.splice(pluginBIndex, 0, pluginA)
+  }
+}

website/markdown/headers.ts

@@ -0,0 +1,84 @@
+/**
+ *  Copyright (c) 2025 taskylizard. Apache License 2.0.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+/**
+ *  Copyright (c) 2024 taskylizard
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import type { MarkdownRenderer } from 'vitepress'
+import { headers } from '../transformer/constants'
+
+const titles = Object.keys(headers).map((key) => headers[key].title)
+
+export const headersPlugin = (md: MarkdownRenderer) => {
+  // Add the Feedback component in the heading, before the link.
+  //
+  // Adding it after the link is closed prevents vitepress from properly
+  // indexing the file's content.
+
+  md.renderer.rules.heading_open = (tokens, idx, options, env, self) => {
+    const result = self.renderToken(tokens, idx, options)
+
+    const idxClose =
+      idx +
+      tokens.slice(idx).findIndex((token) => token.type === 'heading_close')
+    if (idxClose <= idx) return result
+
+    const level = tokens[idx].tag.slice(1)
+    if (!titles.includes(env.frontmatter.title) || level !== '2') return result
+
+    // Find the token for the link.
+    //
+    // The token after `heading_open` contains the link as a child token.
+    const children = tokens[idx + 1].children || []
+    const linkOpenToken = children.findLast((c) => c.type === 'link_open')
+    if (!linkOpenToken) return result
+
+    const heading = tokens[idxClose - 1]
+
+    linkOpenToken.meta = linkOpenToken.meta || {}
+    linkOpenToken.meta.feedback = {
+      heading: heading.content
+    }
+
+    return result
+  }
+
+  const defaultRender = md.renderer.rules.link_open
+
+  md.renderer.rules.link_open = (tokens, idx, options, env, self) => {
+    const result = defaultRender!!!!!!!!!!(tokens, idx, options, env, self)
+
+    const meta = tokens[idx].meta
+    if (!meta || !meta.feedback) return result
+
+    const heading = meta.feedback.heading || ''
+    if (!heading) return result
+
+    return `<Feedback heading="${heading}" />${result}`
+  }
+}

website/markdown/toggle-starred.ts

@@ -0,0 +1,39 @@
+/**
+ *  Copyright (c) 2025 taskylizard. Apache License 2.0.
+ *
+ *  Licensed under the Apache License, Version 2.0 (the "License");
+ *  you may not use this file except in compliance with the License.
+ *  You may obtain a copy of the License at
+ *
+ *  http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *  Unless required by applicable law or agreed to in writing, software
+ *  distributed under the License is distributed on an "AS IS" BASIS,
+ *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *  See the License for the specific language governing permissions and
+ *  limitations under the License.
+ */
+
+import type { MarkdownRenderer } from 'vitepress'
+
+const excluded = ['Beginners Guide']
+
+export function toggleStarredPlugin(md: MarkdownRenderer) {
+  md.renderer.rules.list_item_open = (tokens, index, options, env, self) => {
+    const contentToken = tokens[index + 2]
+
+    // Ensure the token exists
+    if (contentToken) {
+      const content = contentToken.content
+
+      if (
+        !excluded.includes(env.frontmatter.title) &&
+        (content.includes(':star:') || content.includes(':glowing-star:'))
+      ) {
+        return `<li class="starred">`
+      }
+    }
+
+    return self.renderToken(tokens, index, options)
+  }
+}