refactor: update and theme configuration

This commit is contained in:
radishzzz 2025-01-17 02:50:53 +00:00
parent 7659bbd1e2
commit 63aa495d8b
19 changed files with 299 additions and 310 deletions

View file

@ -0,0 +1,33 @@
/// <reference types="mdast" />
import { h } from 'hastscript'
/**
* Creates an admonition component.
*
* param {object} properties - The properties of the component.
* param {string} [properties.title] - An optional title.
* param {('tip'|'note'|'important'|'caution'|'warning')} type - The admonition type.
* param {import('mdast').RootContent[]} children - The children elements of the component.
* returns {import('mdast').Parent} The created admonition component.
*/
export function AdmonitionComponent(properties, children, type) {
if (!Array.isArray(children) || children.length === 0) {
return h(
'div',
{ class: 'hidden' },
'Invalid admonition directive. (Admonition directives must be of block type ":::note{name="name"} <content> :::")',
)
}
let label = null
if (properties && properties['has-directive-label']) {
label = children[0] // The first child is the label
children = children.slice(1)
label.tagName = 'div' // Change the tag <p> to <div>
}
return h(`blockquote`, { class: `admonition bdm-${type}` }, [
h('span', { class: `bdm-title` }, label || type.toUpperCase()),
...children,
])
}

View file

@ -1,43 +0,0 @@
import type { Element, Properties as HastProperties, Node } from 'hast'
import { h } from 'hastscript'
interface AdmonitionProperties extends HastProperties {
'title'?: string
'has-directive-label'?: boolean
}
type AdmonitionType = 'tip' | 'note' | 'important' | 'caution' | 'warning'
const ADMONITION_CLASS_PREFIX = 'bdm-'
const DEFAULT_ERROR_MESSAGE = 'Invalid admonition directive. (Admonition directives must be of block type ":::note{name="name"} <content> :::")'
export function AdmonitionComponent(
properties: AdmonitionProperties,
type: AdmonitionType,
children: Node[],
): Element {
if (!Array.isArray(children) || children.length === 0) {
console.warn('Invalid admonition directive: empty or invalid children')
return h('div', { class: 'hidden' }, DEFAULT_ERROR_MESSAGE)
}
let label: Element | string | null = null
if (properties && properties['has-directive-label']) {
const [firstChild, ...restChildren] = children
children = restChildren
if (firstChild && firstChild.type === 'element') {
label = firstChild as Element
label.tagName = 'div'
}
else {
label = ''
}
}
return h('blockquote', { class: `${ADMONITION_CLASS_PREFIX}${type}` }, [
h('span', { class: 'bdm-title' }, label || type.toUpperCase()),
...(children as Element[]),
] as Element[])
}

View file

@ -0,0 +1,105 @@
/// <reference types="mdast" />
import { h } from 'hastscript'
/**
* Creates a GitHub Card component.
*
* param {object} properties - The properties of the component.
* param {string} properties.repo - The GitHub repository in the format "owner/repo".
* param {import('mdast').RootContent[]} children - The children elements of the component.
* returns {import('mdast').Parent} The created GitHub Card component.
*/
export function GithubCardComponent(properties, children) {
if (Array.isArray(children) && children.length !== 0) {
return h('div', { class: 'hidden' }, [
'Invalid directive. ("github" directive must be leaf type "::github{repo="owner/repo"}")',
])
}
if (!properties.repo || !properties.repo.includes('/')) {
return h(
'div',
{ class: 'hidden' },
'Invalid repository. ("repo" attribute must be in the format "owner/repo")',
)
}
const repo = properties.repo
const cardUuid = `GC${Math.random().toString(36).slice(-6)}` // Collisions are not important
const nAvatar = h(`div#${cardUuid}-avatar`, { class: 'gc-avatar' })
const nLanguage = h(
`span#${cardUuid}-language`,
{ class: 'gc-language' },
'Waiting...',
)
const nTitle = h(`div`, { class: 'gc-titlebar' }, [
h('div', { class: 'gc-titlebar-left' }, [
h('div', { class: 'gc-owner' }, [
nAvatar,
h('div', { class: 'gc-user' }, repo.split('/')[0]),
]),
h('div', { class: 'gc-divider' }, '/'),
h('div', { class: 'gc-repo' }, repo.split('/')[1]),
]),
h('div', { class: 'github-logo' }),
])
const nDescription = h(
`div#${cardUuid}-description`,
{ class: 'gc-description' },
'Waiting for api.github.com...',
)
const nStars = h(`div#${cardUuid}-stars`, { class: 'gc-stars' }, '00K')
const nForks = h(`div#${cardUuid}-forks`, { class: 'gc-forks' }, '0K')
const nLicense = h(`div#${cardUuid}-license`, { class: 'gc-license' }, '0K')
const nScript = h(
`script#${cardUuid}-script`,
{ type: 'text/javascript', defer: true },
`
fetch('https://api.github.com/repos/${repo}', { referrerPolicy: "no-referrer" }).then(response => response.json()).then(data => {
if (data.description) {
document.getElementById('${cardUuid}-description').innerText = data.description.replace(/:[a-zA-Z0-9_]+:/g, '');
} else {
document.getElementById('${cardUuid}-description').innerText = "Description not set"
}
document.getElementById('${cardUuid}-language').innerText = data.language;
document.getElementById('${cardUuid}-forks').innerText = Intl.NumberFormat('en-us', { notation: "compact", maximumFractionDigits: 1 }).format(data.forks).replaceAll("\u202F", '');
document.getElementById('${cardUuid}-stars').innerText = Intl.NumberFormat('en-us', { notation: "compact", maximumFractionDigits: 1 }).format(data.stargazers_count).replaceAll("\u202F", '');
const avatarEl = document.getElementById('${cardUuid}-avatar');
avatarEl.style.backgroundImage = 'url(' + data.owner.avatar_url + ')';
avatarEl.style.backgroundColor = 'transparent';
if (data.license?.spdx_id) {
document.getElementById('${cardUuid}-license').innerText = data.license?.spdx_id
} else {
document.getElementById('${cardUuid}-license').innerText = "no-license"
};
document.getElementById('${cardUuid}-card').classList.remove("fetch-waiting");
console.log("[GITHUB-CARD] Loaded card for ${repo} | ${cardUuid}.")
}).catch(err => {
const c = document.getElementById('${cardUuid}-card');
c.classList.add("fetch-error");
console.warn("[GITHUB-CARD] (Error) Loading card for ${repo} | ${cardUuid}.")
})
`,
)
return h(
`a#${cardUuid}-card`,
{
class: 'card-github fetch-waiting no-styling',
href: `https://github.com/${repo}`,
target: '_blank',
repo,
},
[
nTitle,
nDescription,
h('div', { class: 'gc-infobar' }, [nStars, nForks, nLicense, nLanguage]),
nScript,
],
)
}

View file

@ -1,106 +0,0 @@
/// <reference types="mdast" />
import type { RootContent } from 'mdast'
import { h } from 'hastscript'
export function GithubCardComponent(
properties: { repo: string },
children: RootContent[],
): import('mdast').Parent {
if (Array.isArray(children) && children.length !== 0) {
return h('div', { class: 'hidden' }, [
'Invalid directive. ("github" directive must be leaf type "::github{repo="owner/repo"}")',
]) as unknown as import('mdast').Parent
}
if (!properties.repo || !properties.repo.includes('/')) {
return h(
'div',
{ class: 'hidden' },
'Invalid repository. ("repo" attributte must be in the format "owner/repo")',
) as unknown as import('mdast').Parent
}
const repo = properties.repo
const cardUuid = `GC${Math.random().toString(36).slice(-6)}`
const nAvatar = h(`div#${cardUuid}-avatar`, { class: 'gc-avatar' })
const nLanguage = h(
`span#${cardUuid}-language`,
{ class: 'gc-language' },
'Waiting...',
)
const nTitle = h(`div`, { class: 'gc-titlebar' }, [
h('div', { class: 'gc-titlebar-left' }, [
h('div', { class: 'gc-owner' }, [
nAvatar,
h('div', { class: 'gc-user' }, repo.split('/')[0]),
]),
h('div', { class: 'gc-divider' }, '/'),
h('div', { class: 'gc-repo' }, repo.split('/')[1]),
]),
h('div', { class: 'github-logo' }),
])
const nDescription = h(
`div#${cardUuid}-description`,
{ class: 'gc-description' },
'Waiting for api.github.com...',
)
const nStars = h(`div#${cardUuid}-stars`, { class: 'gc-stars' }, '00K')
const nForks = h(`div#${cardUuid}-forks`, { class: 'gc-forks' }, '0K')
const nLicense = h(`div#${cardUuid}-license`, { class: 'gc-license' }, '0K')
const nScript = h(
`script#${cardUuid}-script`,
{ type: 'text/javascript', defer: true },
`
fetch('https://api.github.com/repos/${repo}', {
referrerPolicy: "no-referrer",
headers: {
'Accept': 'application/vnd.github.v3+json',
},
signal: AbortSignal.timeout(5000)
}).then(response => {
if (!response.ok)
throw new Error(\`HTTP error! status: \${response.status}\`)
return response.json()
}).then(data => {
const elements = {
description: document.getElementById('${cardUuid}-description'),
language: document.getElementById('${cardUuid}-language'),
stars: document.getElementById('${cardUuid}-stars'),
}
elements.description.innerText = data.description?.replace(/:[a-zA-Z0-9_]+:/g, '') ?? 'Description not set'
elements.language.innerText = data.language
elements.stars.innerText = Intl.NumberFormat('en-us', { notation: "compact", maximumFractionDigits: 1 }).format(data.stargazers_count).replaceAll("\\u202F", '')
const avatarEl = document.getElementById('${cardUuid}-avatar')
avatarEl.style.backgroundImage = 'url(' + data.owner.avatar_url + ')'
avatarEl.style.backgroundColor = 'transparent'
document.getElementById('${cardUuid}-license').innerText = data.license?.spdx_id ?? 'no-license'
document.getElementById('${cardUuid}-card').classList.remove("fetch-waiting")
console.log("[GITHUB-CARD] Loaded card for ${repo} | ${cardUuid}.")
}).catch(err => {
const c = document.getElementById('${cardUuid}-card')
c.classList.add("fetch-error")
document.getElementById('${cardUuid}-description').innerText = "Failed to load repository data"
console.warn("[GITHUB-CARD] (Error) Loading card for ${repo} | ${cardUuid}:", err.message)
})
`,
)
return h(
`a#${cardUuid}-card`,
{
class: 'card-github fetch-waiting no-styling',
href: `https://github.com/${repo}`,
target: '_blank',
repo,
},
[nTitle, nDescription, h('div', { class: 'gc-infobar' }, [nStars, nForks, nLicense, nLanguage]), nScript],
) as unknown as import('mdast').Parent
}

View file

@ -0,0 +1,30 @@
// biome-ignore lint/suspicious/noShadowRestrictedNames: <explanation>
import { h } from 'hastscript'
import { visit } from 'unist-util-visit'
export function parseDirectiveNode() {
return (tree, _data) => {
visit(tree, (node) => {
if (
node.type === 'containerDirective'
|| node.type === 'leafDirective'
|| node.type === 'textDirective'
) {
const data = node.data || (node.data = {})
node.attributes = node.attributes || {}
if (
node.children.length > 0
&& node.children[0].data
&& node.children[0].data.directiveLabel
) {
// Add a flag to the node to indicate that it has a directive label
node.attributes['has-directive-label'] = true
}
const hast = h(node.name, node.attributes)
data.hName = hast.tagName
data.hProperties = hast.properties
}
})
}
}

View file

@ -1,41 +0,0 @@
import type { Node } from 'unist'
import { h } from 'hastscript'
import { visit } from 'unist-util-visit'
interface DirectiveNode extends Node {
type: 'containerDirective' | 'leafDirective' | 'textDirective'
name: string
attributes?: Record<string, any>
children: Array<{
data?: {
directiveLabel?: boolean
}
}>
data?: {
hName?: string
hProperties?: Record<string, any>
}
}
export function parseDirectiveNode() {
return (tree: Node) => {
visit(tree, (node: unknown) => {
const directiveNode = node as DirectiveNode
if (
directiveNode.type === 'containerDirective'
|| directiveNode.type === 'leafDirective'
|| directiveNode.type === 'textDirective'
) {
const data = directiveNode.data || (directiveNode.data = {})
directiveNode.attributes = directiveNode.attributes || {}
if (directiveNode.children[0]?.data?.directiveLabel)
directiveNode.attributes['has-directive-label'] = true
const hast = h(directiveNode.name, directiveNode.attributes)
data.hName = hast.tagName
data.hProperties = hast.properties
}
})
}
}

View file

@ -0,0 +1,16 @@
import { toString } from 'mdast-util-to-string'
/* Use the post's first paragraph as the excerpt */
export function remarkExcerpt() {
return (tree, { data }) => {
let excerpt = ''
for (const node of tree.children) {
if (node.type !== 'paragraph') {
continue
}
excerpt = toString(node)
break
}
data.astro.frontmatter.excerpt = excerpt
}
}

View file

@ -1,12 +0,0 @@
import type { Root } from 'mdast'
import type { VFile } from 'vfile'
import { toString } from 'mdast-util-to-string'
export function remarkExcerpt() {
return function (tree: Root, file: VFile) {
const firstParagraph = tree.children.find(node => node.type === 'paragraph')
const excerpt = firstParagraph ? toString(firstParagraph) : ''
const frontmatter = (file.data.astro ??= {}).frontmatter ??= {}
frontmatter.excerpt = excerpt
}
}

View file

@ -0,0 +1,15 @@
// biome-ignore lint/suspicious/noShadowRestrictedNames: <explanation>
import { toString } from 'mdast-util-to-string'
import getReadingTime from 'reading-time'
export function remarkReadingTime() {
return (tree, { data }) => {
const textOnPage = toString(tree)
const readingTime = getReadingTime(textOnPage)
data.astro.frontmatter.minutes = Math.max(
1,
Math.round(readingTime.minutes),
)
data.astro.frontmatter.words = readingTime.words
}
}

View file

@ -1,14 +0,0 @@
import type { Root } from 'mdast'
import type { VFile } from 'vfile'
import { toString } from 'mdast-util-to-string'
import getReadingTime from 'reading-time'
export function remarkReadingTime() {
return function (tree: Root, file: VFile) {
const textOnPage = toString(tree)
const readingTime = getReadingTime(textOnPage)
const frontmatter = (file.data.astro ??= {}).frontmatter ??= {}
frontmatter.minutes = Math.max(1, Math.round(readingTime.minutes))
frontmatter.words = readingTime.words
}
}