xwysyy:0.5.0

packages/preview/xwysyy/0.5.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Carlos-Mero
+Copyright (c) 2026 xwysyy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/preview/xwysyy/0.5.0/README.md

@@ -0,0 +1,210 @@
+<h1 align="center">xwysyy</h1>
+
+<p align="center">
+  <a href="https://typst.app/universe/package/xwysyy"><img src="https://img.shields.io/badge/Typst%20Universe-available-239dad.svg" alt="Typst Universe"></a>
+  <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
+  <a href="https://typst.app"><img src="https://img.shields.io/badge/Typst-%E2%89%A5%200.15.0-239dad.svg" alt="Typst version: >= 0.15.0"></a>
+  <a href="https://github.com/touying-typ/touying"><img src="https://img.shields.io/badge/touying-0.8.0-blueviolet.svg" alt="touying version: 0.8.0"></a>
+  <a href="#themes"><img src="https://img.shields.io/badge/Themes-6%20built--in-ff69b4.svg" alt="Built-in themes"></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/xwysyy/xwysyy-typst/blob/v0.5.0/README-zh.md">中文</a> | <b>English</b>
+</p>
+
+Academic presentation templates built on [touying](https://github.com/touying-typ/touying). The package covers slide decks, handouts, speaker notes, and pdfpc metadata. The visual theme is derived from [Carlos-Mero/may](https://github.com/Carlos-Mero/may) under MIT.
+
+## Features
+
+- Universe template support: `typst init @preview/xwysyy:0.5.0` creates a ready-to-compile deck.
+- Six built-in themes: `sky`, `sunset`, `forest`, `midnight`, `violet`, and `graphite`.
+- Custom theme dictionaries can be passed directly to `theme`, so users can customize colors without forking the package.
+- `xwysyy-pre` takes `font`, `code-font`, and `lang`, plus `heading-font` for the header title.
+- Touying handout mode, `#speaker-note`, and pdfpc export are documented with tagged source examples.
+- Eight semantic layout components (`duo-slide`, `grid-slide`, `figure-slide`, `stat-slide`, ...) measure every block at compile time, distribute space fill-first, and export layout telemetry without hand-written `#v()` spacing.
+
+## Preview
+
+Rendered previews are generated from the [tagged source examples](https://github.com/xwysyy/xwysyy-typst/tree/v0.5.0/examples).
+
+### Slide Themes
+
+| sky | sunset | forest |
+|:---:|:---:|:---:|
+| ![Sky theme cover](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-theme-sky-p1-01.png) | ![Sunset theme cover](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-theme-sunset-p1-01.png) | ![Forest theme cover](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-theme-forest-p1-01.png) |
+
+| midnight | violet | graphite |
+|:---:|:---:|:---:|
+| ![Midnight theme cover](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-theme-midnight-p1-01.png) | ![Violet theme cover](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-theme-violet-p1-01.png) | ![Graphite theme cover](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-theme-graphite-p1-01.png) |
+
+### Component Pages
+
+| Sky cover | Sky components |
+|:---:|:---:|
+| ![Sky theme cover slide](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-sky-p1-01.png) | ![Sky theme textbox components](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-sky-p5-05.png) |
+
+| Sunset cover | Sunset components |
+|:---:|:---:|
+| ![Sunset theme cover slide](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-sunset-p1-01.png) | ![Sunset theme textbox components](https://raw.githubusercontent.com/xwysyy/xwysyy-typst/v0.5.0/assets/preview-sunset-p5-05.png) |
+
+## Quick Start
+
+Create a new project from the Universe template:
+
+```bash
+typst init @preview/xwysyy:0.5.0 my-talk
+cd my-talk
+typst compile main.typ
+```
+
+Use the package in an existing Typst project:
+
+```typst
+#import "@preview/xwysyy:0.5.0": *
+
+#show: xwysyy-pre.with(
+  theme: "sunset",
+  config-info(
+    title: [My Presentation Title],
+    subtitle: [Subtitle],
+    author: " ",
+    date: datetime.today(),
+    institution: " ",
+  ),
+)
+
+#title-slide()
+#outline-slide()
+
+= Section Title
+
+== Slide Title
+
+Body text with *bold* and #red[red highlight].
+
+#textbox(
+  [*Module A*
+
+  First column],
+
+  [*Module B*
+
+  Second column],
+)
+
+#end-slide(title: [Thank You!], body: [Questions?])
+```
+
+## Themes
+
+Select a built-in theme by name:
+
+```typst
+#show: xwysyy-pre.with(
+  theme: "forest",
+  config-info(title: [My Presentation]),
+)
+```
+
+Pass a custom dictionary directly:
+
+```typst
+#let my-theme = (
+  sea: rgb("#1f5d45"),
+  sky: rgb("#a8d5ba"),
+  skyll: rgb("#f5fbf7"),
+  paper: rgb("#f7faf8"),
+  page-fill: white,
+)
+
+#show: xwysyy-pre.with(
+  theme: my-theme,
+  config-info(title: [My Presentation]),
+)
+```
+
+All five fields are required:
+
+| Field | Purpose |
+|-------|---------|
+| `sea` | Primary dark color for the header title, links, table heads, and badges |
+| `sky` | Accent color, also the fade-out end of the header rule |
+| `skyll` | Code block, table row, and textbox fill |
+| `paper` | Text on dark backgrounds |
+| `page-fill` | Slide page background |
+
+## Component Reference
+
+| Category | API | Usage |
+|----------|-----|-------|
+| Slide entry | `xwysyy-pre` | `#show: xwysyy-pre.with(theme: "sky", ...)` |
+| Title slide | `title-slide` | `#title-slide()` |
+| Outline | `outline-slide` | `#outline-slide()` auto-collects section headings |
+| Content slide | `xwysyy-slide` | `== Title` auto-triggers |
+| Section transition | `new-section-slide` | `= Title` auto-triggers |
+| Full-screen image | `image-slide` | `#image-slide(img: image("bg.png"))` |
+| End slide | `end-slide` | `#end-slide(title: [...])` |
+| Layout · pair | `duo-slide` | figure over text, measured spacing + telemetry |
+| Layout · single | `focus-slide` | one centered block for sparse pages |
+| Layout · columns | `grid-slide` | N equal-height peer columns |
+| Layout · stack | `stack-slide` | N vertical blocks, the visual grows dominant or cards grow tall |
+| Layout · compare | `compare-slide` | two top-aligned blocks read as a contrast |
+| Layout · stats | `stat-slide` | a row of big-number metric tiles |
+| Layout · figure | `figure-slide` | figure, tight caption, optional takeaway |
+| Layout · sidebar | `sidebar-slide` | a label tab beside a content card |
+| Text box | `textbox` | `#textbox[Content]` or `#textbox([Col 1], [Col 2])` |
+| Highlight | `red` / `bred` | `#red[text]` / `#bred[bold red]` |
+| Highlight | `yellow` / `byellow` | `#yellow[text]` / `#byellow[bold yellow]` |
+
+The layout components (`duo-slide`, `focus-slide`, `grid-slide`, `stack-slide`, `compare-slide`, `stat-slide`, `figure-slide`, `sidebar-slide`) take typed content items (`visual` / `card` / `takeaway` / `plain`, with `metric` entries for `stat-slide`; `sidebar-slide` takes plain content) with declared sizing, measure every block, distribute space fill-first, and export `<xwysyy-slide-layout>` v4 telemetry (allocated frame, natural preferred size, 2-D payload bbox with a measured/declared source, and paint box + fill per object). For stepwise reveal use the `reveal: true` parameter of the multi-block components (all but `focus-slide` and `sidebar-slide`) instead of `#pause`, which cannot appear inside the components (touying panics). See the [layout guide](https://github.com/xwysyy/xwysyy-typst/blob/v0.5.0/docs/LAYOUT.md).
+
+## Handouts And Speaker Notes
+
+Pass touying's handout setting through `xwysyy-pre`. A command-line switch can be wired as follows:
+
+```typst
+#let handout = sys.inputs.at("handout", default: "false") == "true"
+
+#show: xwysyy-pre.with(
+  config-common(handout: handout),
+  config-info(title: [My Presentation]),
+)
+```
+
+```bash
+typst compile main.typ slides.pdf
+typst compile --input handout=true main.typ slides-handout.pdf
+```
+
+Speaker notes are available because `xwysyy.typ` re-exports touying:
+
+```typst
+#speaker-note[
+  Mention the ablation table before moving to the next section.
+]
+```
+
+Export pdfpc metadata:
+
+```bash
+typst eval --in main.typ --format json 'query(<pdfpc-file>).first().value' > slides.pdfpc
+```
+
+## Requirements
+
+- Typst >= 0.15.0
+- touying 0.8.0, downloaded on first compile
+- physica 0.9.8, downloaded on first compile
+- Default local fonts: Times New Roman, Noto Serif CJK SC, Libertinus Sans, Noto Sans CJK SC, Maple Mono, and Noto Sans Mono CJK SC
+- Typst web app users can pass web-available fonts with `font:`, `heading-font:`, and `code-font:`
+
+Full API reference: [docs/USAGE.md](https://github.com/xwysyy/xwysyy-typst/blob/v0.5.0/docs/USAGE.md). Customization guide: [docs/CUSTOMIZATION.md](https://github.com/xwysyy/xwysyy-typst/blob/v0.5.0/docs/CUSTOMIZATION.md). Theme generator: [docs/THEME-GENERATOR.md](https://github.com/xwysyy/xwysyy-typst/blob/v0.5.0/docs/THEME-GENERATOR.md).
+
+## Acknowledgements
+
+- Theme derived from [Carlos-Mero/may](https://github.com/Carlos-Mero/may) under MIT
+- Built on [touying](https://github.com/touying-typ/touying)
+
+## License
+
+[MIT](./LICENSE)

packages/preview/xwysyy/0.5.0/src/elements.typ

@@ -0,0 +1,139 @@
+// Shared show-chain (xwysyy-elements) and reusable components (info, textbox).
+
+#import "@preview/touying:0.8.0": components
+#import "themes.typ": *
+
+#let xwysyy-elements(
+  doc,
+  code-font: ("Maple Mono", "Noto Sans Mono CJK SC"),
+  t-sea: sea,
+  t-sky: sky,
+  t-skyll: skyll,
+  t-paper: paper,
+) = [
+  // Bold enhancement (recipe in themes.typ `_bold-run`)
+  #show strong: it => _bold-run(it.body)
+
+  // List style
+  #set list(marker: (text(fill: t-sea, [❖]), text(fill: t-sky, [⬦]), text(fill: t-sky, [–])), spacing: 1.2em, indent: 0.5em, body-indent: 0.8em)
+  #set enum(spacing: 1.2em, indent: 0.5em)
+
+  // Italic — per-character synthetic skew for CJK
+  #show emph: it => {
+    if type(it.body) == content and it.body.has("text") {
+      for c in it.body.text {
+        box(skew(ax: -8deg, c))
+      }
+    } else {
+      box(skew(ax: -8deg, it.body))
+    }
+  }
+
+  // No image shadow: wrapping images in a box sized by measure() collapses
+  // percentage-width images to zero size.
+
+  // Figure captions — smaller
+  #show figure.caption: it => {
+    set text(size: 0.78em, fill: luma(100))
+    v(0.3em)
+    it
+  }
+
+  // Table captions on top
+  #show figure.where(kind: table): set figure.caption(position: top)
+
+  // Codeblocks
+  #show raw.where(block: true): it => {
+    set text(font: code-font, size: 0.9em)
+    block(
+      width: 100%,
+      height: auto,
+      fill: t-skyll,
+      inset: 0.6em,
+      radius: 0.5em,
+      it
+    )
+  }
+  // Inline code — the chip fill is painted with `outset` so it does not join
+  // baseline/line-height layout (the old inset+baseline recipe sank the code
+  // text ~0.1em below the surrounding baseline).
+  #show raw.where(block: false): it => {
+    set text(font: code-font)
+    box(
+      fill: t-skyll,
+      inset: (x: 0.3em),
+      outset: (y: 0.2em),
+      radius: 0.3em,
+      it
+    )
+  }
+
+  // Links
+  #show link: underline
+  #show link: it => {
+    set text(fill: t-sea)
+    it
+  }
+
+  // Detail Decoration — longer patterns first to avoid partial matches.
+  // Each rule is guarded so it never rewrites code content: string show rules
+  // also match text inside raw, which used to turn `<=` in code into ⇐.
+  // NB: `text.font` reports lowercased family names — compare case-insensitively.
+  #let code-head = lower(if type(code-font) == array { code-font.first() } else { code-font })
+  #let non-code(arrow) = it => context {
+    let f = text.font
+    let head = if type(f) == array and f.len() > 0 { f.first() } else { f }
+    if lower(head) == code-head { it } else { arrow }
+  }
+  #show "<==>": non-code([$arrow.l.r.double.long$])
+  #show "<=>": non-code([$<=>$])
+  #show "-->": non-code([$-->$])
+  #show "<--": non-code([$<--$])
+  #show "==>": non-code([$==>$])
+  #show "<==": non-code([$arrow.l.double.long$])
+  #show "->": non-code([$->$])
+  #show "<-": non-code([$<-$])
+  #show "=>": non-code([$=>$])
+  #show "<=": non-code([$arrow.l.double$])
+  #show "|->": non-code([$|->$])
+
+  // Tables — seamless filled header + zebra body (no gutter: cell gaps used to
+  // slice the fills into fragments), theme-toned thin hlines
+  #set table(
+    stroke: none,
+    inset: (x: 0.6em, y: 0.42em),
+    align: center,
+    fill: (x, y) => if y == 0 { t-sea } else if calc.even(y) { t-skyll } else { none },
+  )
+  #set table.hline(stroke: 0.5pt + t-sea.lighten(30%))
+  #show table.cell: it => {
+    if it.y == 0 {
+    set text(t-paper, weight: "bold")
+    it
+  } else {it}
+  }
+
+  #doc
+]
+
+// information item
+#let info(something, description) = [
+  *#something* #h(1fr) *#description*\
+]
+
+#let textbox(inset: 0.8em, radius: 0.4em, width: 100%, gutter: 0.6em, ..bodies) = context {
+  let t = _theme-state.get()
+  let bodies = bodies.pos()
+  if bodies.len() == 1 {
+    block(width: width, fill: t.skyll, inset: inset, radius: radius, bodies.first())
+  } else {
+    components.lazy-layout(grid(
+      columns: (1fr,) * bodies.len(),
+      gutter: gutter,
+      ..bodies.map(b => block(width: 100%, fill: t.skyll, inset: inset, radius: radius, {
+        b
+        components.lazy-v(1fr)
+      })),
+    ))
+  }
+}