| type ElementAttribute = string | null | |
| type StrictArrayTuple<Arr extends readonly unknown[], ArrTuple = Arr[number]> = | |
| Arr[number][] extends Arr ? // widened array — `as const` forgotten | |
| { missingAsConstOnArr: never } | |
| : Arr[number] extends ArrTuple ? | |
| // brackets compare the types as single units. unbracketed, a naked (eg. non-indexed-access) | |
| // type param like ArrTuple distributes per union member (TS rules). `never` is | |
| // regarded by TypeScript as an empty union, so with no members to distribute over, |
| /** | |
| * Abortable Promise | |
| * @remarks | |
| * Call {@linkcode abort abort(reason?:)} to abort the signal and resolve the promise. | |
| */ | |
| export class AbortablePromise extends AbortController { | |
| promise: Promise<typeof this.signal.reason> | |
| // Bind method to allow destructuring |
| { | |
| "name": "PRs and CI", | |
| "target": "branch", | |
| "source_type": "Repository", | |
| "enforcement": "active", | |
| // Target specified branches | |
| "conditions": { | |
| "ref_name": { | |
| "include": [ | |
| // Default branch (usually 'main') |
| /** | |
| * A simple wrapper for `TransformStream`. | |
| * @example | |
| * class UpperCaseStream extends TransformStreamInterface<string, string> { | |
| * transform(chunk: string) { | |
| * return chunk.toUpperCase() | |
| * } | |
| * } | |
| * | |
| * // Usage: |
| /* | |
| * Tiny HTML include plugin for Vite. | |
| * Usage: `<include src="./partials/header.html"></include>` | |
| */ | |
| import fs from 'fs' | |
| import path from 'path' | |
| function processIncludes(html, dir) { | |
| return html.replaceAll(/<include src="(.+?)"><\/include>/g, (_match, src) => { |
| { | |
| // Note: This assumes TS6+. | |
| "compilerOptions": { | |
| // Treat all files as ES modules. | |
| "moduleDetection": "force", | |
| // For Node.js: | |
| // "types": ["node"], | |
| // For native TS execution in Node.js without a bundler: | |
| // "module": "nodenext", |
Barrel import with module namespace:
Problem: loses granular intent as well as potential tree-shaking benefits.
import * as util from './util'Granular import without module namespace:
Problem: loses scope, conflicts with other local or imported module functions.
| /** | |
| * Task (a-la [Swift](https://developer.apple.com/documentation/swift/task)). | |
| * | |
| * @example | |
| * const task = new Task(async signal => { | |
| * await Task.sleep({ for: 1000, signal }) | |
| * return 'hello' | |
| * }) | |
| * task.abort() |
| /** | |
| * Simple Minecraft Decompiler | |
| * | |
| * Usage: | |
| * - Decompile latest version: `node simple-mc-decompiler.js` | |
| * - To specify version: `node simple-mc-decompiler.js [version]` | |
| * - version = `latest` or `latest-release` / `latest-snapshot` / [version name] | |
| * - Add `-s` or `--server` to decompile server | |
| */ |
| body { | |
| margin: 0; | |
| } | |
| html { | |
| /* | |
| * Disable pinch-to-zoom, double-tap to zoom and panning the body (scrolling gestures). | |
| * To enable scrolling: `touch-action: pan-x pan-y`. | |
| */ |