jekyll-webawesome 0.20.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 357c6fd1272603627457c36d096cd9df2eafefc0fbe79564278d246db85ee400
-  data.tar.gz: 55058f53d7164006a4de03d8135245b957cc88b3ff6562339dccc67bac2e5690
+  metadata.gz: a1cb8eddf8f4d4315a3830f3cf5703a487418ea02cd56d24763f19dd82713aa6
+  data.tar.gz: 479e8f0e52929d625f2e3de1120ccc692c573b041c3c1e4072add1b0ad4086ae
 SHA512:
-  metadata.gz: 17840e18f7bc1c5c131a30320b05ea243a5215519aa46dff76c55ab6b9abc06959751acae7c98504d71f62a0b2dd8ac97100f9eed9aed3bc72ce76546370a10a
-  data.tar.gz: fe51782529d4091b9675dd074c88e2ce568e98e955190a1ef47c0eea3105f8ef08eceff4d0ce22f0b75740347df3ce31d813df0f36ec45e78938ec6bdb74418e
+  metadata.gz: 1d7a953b33ab397050e35fc8086515e32d5c1a2e23cc3a0731e5c9971bc9bca37ad489df671cb565442df43127f24b0c5486ae32dc97707f4d27b5745b83ef23
+  data.tar.gz: 8e74b834dc51e1f2129463cd53eca8eb578faaa1c35d82dc8bdd282efcbd866d5bbe7a95db77423ef5ab5e7519872bd9b264e15f1e48d084e13eaab3ac180db9

data/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
 
+## [0.22.0] - 2026-06-25
+
+### Added
+
+- Copy-button tooltip mode, via markawesome 0.16.0. A `tooltip:full|copy|none` token on the copy-button line controls *when* the built-in tooltip appears, distinct from the existing `tooltip-placement`: `full` (Web Awesome's default — tooltip on hover/focus plus the brief copy-success/error feedback), `copy` (silent on hover/focus; the tooltip appears only to confirm a copy), and `none` (no tooltip in any state). Combine it with a placement, e.g. `<<<top tooltip:copy`. The token is order-independent with the other copy-button parameters; invalid values are dropped and fall back to Web Awesome's default.
+- Example site's `## Copy Buttons` section gains a `### Tooltip Mode` subsection exercising `full`, `copy`, `none`, and a placement combination (`<<<top tooltip:copy`). Validated live in the browser against the examples kit (WA 3.9.0, ≥ 3.6 so `tooltip` is supported): the `tooltip` attribute reflects onto the upgraded `<wa-copy-button>`, and the rendered behavior differs as expected — `full` builds an internal `<wa-tooltip trigger="hover focus">` (opens on hover/focus, shown opening on hover in the live DOM), `copy` builds `<wa-tooltip trigger="manual">` (silent on hover/focus, copy-feedback only), `none` renders no internal tooltip at all (none on hover, confirmed live), and `<<<top tooltip:copy` carries both `tooltip-placement="top"` and `tooltip="copy"`.
+
+### Changed
+
+- Updated `markawesome` dependency to `~> 0.16`.
+
+## [0.21.0] - 2026-06-25
+
+### Added
+
+- Tooltip support, via markawesome 0.15.0. Inline contextual help shown on hover or focus — ideal for glossary terms and inline definitions. The primary form is inline: `(((anchor term >>> tip text)))`. The anchor becomes a focusable, dotted-underlined `<span>` (`tabindex="0"`, class `ma-tooltip-anchor`) and the tip is emitted as a `<wa-tooltip>` wired to it via a generated `for`/`id` pair, so keyboard and assistive-technology users get the tip too. Leading `placement` (`top` default, `bottom`, `left`, `right`) and `distance:N` tokens go before the anchor; tip text is plain text (HTML-escaped) with literal `\n` rendered as `<br>`. A `:::wa-tooltip placement? distance:N? … >>> … :::` block alternative is also accepted. Declarative and zero-JavaScript; no Jekyll-side configuration needed.
+- Example site gains a `## Tooltips` section exercising the basic inline form, every placement, `distance:N`, combined parameters, multiple inline tooltips in one sentence, HTML escaping, `\n` line breaks, and the `:::wa-tooltip` alternative form. Validated live in the browser against the examples kit (WA 3.9.0): each anchor's `for` resolves to its tooltip's `id`, the `<wa-tooltip>` upgrades and opens on both hover and focus, and the requested `placement` positions the bubble correctly in the live DOM.
+
 ## [0.20.0] - 2026-06-24
 
 ### Added

data/README.md

@@ -20,13 +20,14 @@ This plugin focuses on the most commonly used Web Awesome components for Jekyll
 | **Card** | `===appearance? orientation?` | `:::wa-card appearance? orientation?` | `<wa-card appearance="filled" orientation="horizontal">content</wa-card>` |
 | **Carousel** | `~~~~~~` | `:::wa-carousel` | `<wa-carousel>` with carousel items |
 | **Comparison** | `\|\|\|` or `\|\|\|25` | `:::wa-comparison` or `:::wa-comparison 25` | `<wa-comparison>` with before/after slots |
-| **Copy Button** | `<<<placement? disabled? duration? labels?` | `:::wa-copy-button attributes?` | `<wa-copy-button value="content" tooltip-placement="right" disabled>` |
+| **Copy Button** | `<<<placement? tooltip:mode? disabled? duration? labels?` | `:::wa-copy-button attributes?` | `<wa-copy-button value="content" tooltip-placement="right" tooltip="copy" disabled>` |
 | **Details** | `^^^appearance? icon-placement?` | `:::wa-details appearance? icon-placement?` | `<wa-details appearance="..." icon-placement="...">content</wa-details>` |
 | **Dialog** | `???params?` | `:::wa-dialog params?` | `<wa-dialog>` with trigger button and content |
 | **Icon** | `$$$icon-name` | `:::wa-icon name` | `<wa-icon name="icon-name" variant="solid"></wa-icon>` |
 | **Popover** | `&&&placement? link? without-arrow? distance:N?` | `:::wa-popover params?` | `<wa-popover>` with trigger and floating content |
 | **Tab Group** | `++++++` | `:::wa-tabs` | `<wa-tab-group><wa-tab>content</wa-tab></wa-tab-group>` |
 | **Tag** | `@@@brand` | `:::wa-tag brand` | `<wa-tag variant="brand">content</wa-tag>` |
+| **Tooltip** | `(((anchor >>> tip)))` | `:::wa-tooltip placement? distance:N?` | focusable `<span>` anchor + `<wa-tooltip for="…" placement="top">tip</wa-tooltip>` |
 
 Not all components will make sense to include here, to be included in the "prose" content of a web page. Some components are more suitable to be used in layouts or used in the page as includes, too complicated for this purpose.
 
@@ -721,6 +722,27 @@ Copy with tooltip on left
 <<<
 ```
 
+**Tooltip Mode:**
+
+Control *when* the built-in tooltip appears (`full`, `copy`, or `none`):
+```markdown
+<<<tooltip:full
+Full (default): tooltip on hover/focus plus copy feedback
+<<<
+
+<<<tooltip:copy
+Copy: silent on hover/focus; tooltip only on copy feedback
+<<<
+
+<<<tooltip:none
+None: no tooltip in any state
+<<<
+
+<<<top tooltip:copy
+Combined with a tooltip placement
+<<<
+```
+
 **Custom Labels:**
 ```markdown
 <<<copy-label="Click to copy" success-label="Copied!" error-label="Failed"
@@ -1215,6 +1237,82 @@ Popover content using the alternative syntax.
 | `without-arrow` | keyword | off | Hides the popover arrow |
 | `distance:N` | number (pixels) | (default) | Distance between trigger and popover |
 
+### Tooltips
+
+Add brief contextual help on hover or focus — ideal for glossary terms and inline definitions. The primary form is inline: put the anchor term and the tip text inside triple parentheses, separated by `>>>`:
+
+```markdown
+The web is styled with (((CSS >>> Cascading Style Sheets))) and structured with (((HTML >>> HyperText Markup Language))).
+```
+
+The anchor term becomes a focusable, dotted-underlined `<span>`, with a `<wa-tooltip>` wired to it via a generated `for`/`id` pair:
+
+```html
+<span id="tooltip-ab12c3d4" tabindex="0" class="ma-tooltip-anchor" style="text-decoration: underline dotted; cursor: help;">CSS</span>
+<wa-tooltip for="tooltip-ab12c3d4" placement="top">Cascading Style Sheets</wa-tooltip>
+```
+
+The anchor is focusable (`tabindex="0"`) so keyboard and assistive-technology users get the tip too (Web Awesome tooltips fire on focus as well as hover). The `ma-tooltip-anchor` class is a styling hook for overriding the default underline/cursor. No JavaScript is required.
+
+#### Tooltip Placement
+
+Leading `placement`/`distance:N` tokens go before the anchor term:
+
+```markdown
+Routed over (((bottom Peppol >>> A standardized pan-European e-invoicing network))) to the recipient.
+
+Authentication uses an (((left API key >>> A secret token that authorizes a request))).
+
+Files are delivered over (((right SFTP >>> SSH File Transfer Protocol))) for batch processing.
+```
+
+**Supported placements:** `top` (default), `bottom`, `left`, `right`
+
+#### Custom Distance
+
+Set the distance between the anchor and the tooltip (in pixels):
+
+```markdown
+Hover over (((distance:12 SLA >>> Service Level Agreement))) to see the tip pushed further from the anchor.
+```
+
+#### Combining Parameters
+
+Tokens can be combined in any order before the anchor term:
+
+```markdown
+Read about (((bottom distance:8 OCR >>> Optical Character Recognition))) in the pipeline.
+```
+
+#### Tip Content and Line Breaks
+
+Tip text is plain text and HTML-escaped, so symbols are safe. Use `\n` for line breaks (rendered as `<br>`):
+
+```markdown
+Org numbers differ by country — (((Org number >>> NO: 9 digits\nSE: 10 digits\nDK: 8-digit CVR))).
+```
+
+Tooltips hold brief text, so there is no Markdown body (unlike popovers).
+
+#### Alternative Syntax
+
+For consistency with the other components, a block form is also accepted:
+
+```markdown
+:::wa-tooltip bottom
+JIT
+>>>
+Just-In-Time — produced only at the moment it is needed.
+:::
+```
+
+#### Tooltip Parameters
+
+| Option | Values | Default | Description |
+|--------|--------|---------|-------------|
+| `placement` | `top`, `bottom`, `left`, `right` | `top` | Where the tooltip appears relative to the anchor |
+| `distance:N` | number (pixels) | (default) | Distance between the anchor and the tooltip |
+
 ### Details/Summary (Collapsible Content)
 
 Create collapsible content using the `^^^` syntax:

data/jekyll-webawesome.gemspec

@@ -33,7 +33,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ['lib']
 
   spec.add_dependency 'jekyll', '>= 3.7', '< 5.0'
-  spec.add_dependency 'markawesome', '~> 0.14'
+  spec.add_dependency 'markawesome', '~> 0.16'
 
   spec.add_development_dependency 'rake', '~> 13.0'
   spec.add_development_dependency 'rspec', '~> 3.0'

data/lib/jekyll/webawesome/version.rb

@@ -2,6 +2,6 @@
 
 module Jekyll
   module WebAwesome
-    VERSION = '0.20.0'
+    VERSION = '0.22.0'
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jekyll-webawesome
 version: !ruby/object:Gem::Version
-  version: 0.20.0
+  version: 0.22.0
 platform: ruby
 authors:
 - Janne Waren
@@ -35,14 +35,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.16'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.14'
+        version: '0.16'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement