feat(easy-typography): initial implementation

easy-typography/tests/basic/test.typ

@@ -0,0 +1,125 @@
+#import "/lib.typ": *
+
+#import "@preview/codly:1.2.0": *
+#import "@preview/codly-languages:0.1.1": *
+#show: codly-init.with()
+#codly(languages: codly-languages)
+
+#show: easy-typography.with(
+  fonts: (heading: "Source Sans Pro", body: "Source Serif Pro"),
+)
+
+= Introducing Easy Typography
+
+#set heading(numbering: (..nums) => {
+  numbering("1.1.", ..nums.pos().slice(1))
+})
+
+The `easy-typography` package transforms complex typographic decisions into
+simple choices, letting you focus on your content while ensuring professional
+results. By adjusting the settings to match your specific needs, you can refine
+the aesthetic or adapt your layout for everything from casual reading to formal
+publication.
+
+== Core Typography Features
+
+The package manages:
+
+#columns(2)[
+- Precise heading scale with a clear hierarchy
+- Optimal line height and paragraph spacing
+#colbreak()
+- Professional text justification and hyphenation
+- Balanced vertical rhythm throughout
+]
+
+These features ensure that your document is both visually appealing and easy to
+read.
+
+=== Type Formatting
+
+This package automatically adjusts line spacing, paragraph spacing, and
+justification to maintain a clean layout. Headings are also carefully weighted
+to balance them against the body text, so you can focus on content rather than
+tweaking spacing and sizing. Standard formatting like *bold* and _italic_
+integrates seamlessly with `easy-typography`'s approach.
+
+=== Heading Levels
+
+The heading scale gracefully steps down, ensuring that each level remains
+distinct yet consistent. Behind the scenes, `easy-typography` calculates the
+ideal size for each heading, preserving a cohesive visual hierarchy as your
+document gets deeper. This approach supports manuals, academic papers, and any
+long-form text where structure matters. It also helps in shorter documents,
+guaranteeing a crisp layout with minimal effort.
+
+== Why Typography Matters
+
+Good typography isn't just about aesthetics. It's about effective communication.
+Well-designed text:
+
+#columns(2)[
+- Improves reading comprehension
+- Reduces eye strain
+- Maintains reader engagement
+#colbreak()
+- Establishes visual hierarchy
+- Conveys professionalism
+]
+
+Notice how this document's typography enhances readability. The justified text,
+proper hyphenation, and optimized line breaks create a clean, professional
+appearance. With each heading level, the user can quickly scan and digest
+important information.
+
+== Example Usage and Output
+
+#set heading(numbering: none)
+#show raw.where(block: true): set text(size: 7pt)
+
+#grid(
+  columns: (55%, auto),
+  gutter: 1.0em,
+[
+  // code
+  ```typst
+  #import "@preview/easy-typography:0.1.0": *
+  #show: easy-typography.with(
+    fonts: (
+      heading: "Source Sans Pro",
+      body: "Source Serif Pro"
+    ),
+  )
+
+  #lorem(6)
+  = Level One
+  #lorem(6)
+  == Level Two
+  #lorem(6)
+  === Level Three
+  #lorem(6)
+  ==== Level Four
+  #lorem(6)
+  ===== Level Five
+  #lorem(6)
+  ```
+],
+box(
+    stroke: 0.5pt + silver,
+    inset: 0.5em,
+    radius: 0.2em,
+    [
+      #lorem(6)
+      = Level One
+      #lorem(6)
+      == Level Two
+      #lorem(6)
+      === Level Three
+      #lorem(6)
+      ==== Level Four
+      #lorem(6)
+      ===== Level Five
+      #lorem(6)
+    ]
+  ) // box
+)