@anyblades/blades 0.28.0-alpha.2

package/assets/blades.theme.css

@@ -0,0 +1,129 @@
+/* <!--section:code-->
+```css */
+label:has(input:not([type="checkbox"], [type="radio"], [type="range"]), textarea, select),
+.has-float-label {
+  /* Default/fallback state */
+  > span,
+  label {
+    padding-inline-start: calc(1rem + 1px); /* match Pico's padding + border */
+    padding-block-start: 0.25rem;
+    opacity: 75%;
+    transition: all 0.25s;
+  }
+  input,
+  textarea,
+  select {
+    margin-block-start: 0; /* reset Pico */
+    padding-inline-start: 1rem; /* match Pico */
+    padding-block: 1.125rem 0.375rem; /* match Pico's total: 2 x 0.75rem = 1.5rem */
+
+    &::placeholder {
+      opacity: 100%;
+      transition: all 0.25s;
+    }
+  }
+
+  /* Enlarged state */
+  &:has(*:placeholder-shown:not(:focus)) {
+    > span,
+    label {
+      padding-block: 0.75rem; /* match Pico */
+    }
+  }
+}
+body {
+  /* Make the `body` a flex container with column layout, and `main` to automatically fill available space. This is useful for creating sticky footers and full-height layouts. */
+  display: flex;
+  flex-direction: column;
+  > main {
+    flex-grow: 1;
+  }
+}
+a {
+  &:not([href^="#"]) {
+    text-decoration-thickness: 1px;
+    &:hover {
+      text-decoration-thickness: 2px;
+    }
+  }
+}
+h1 {
+  font-size: 2.5em; /* for pico.css & tw-typography */
+  margin-bottom: 1rem; /* for tw-typography */
+}
+/* Potential fix https://github.com/picocss/pico/blob/main/css/pico.css for the very first headings
+:where(article, address, blockquote, dl, figure, form, ol, p, pre, table, ul) ~ :is(h1, h2, h3, h4, h5, h6) {
+  margin-top: var(--pico-typography-spacing-top);
+}
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  & ~ & {
+    margin-bottom: 2rem;
+  }
+}
+NOTE: be careful with wrapped headings, i.e. inside nav: https://blades.ninja/build-awesome-11ty/#usage
+*/
+hr {
+  margin-block: 2em; /* for pico.css & tw-typography */
+}
+ul {
+  ul {
+    font-size: 87.5%;
+  }
+}
+pre {
+  small {
+    opacity: 75%;
+    font-weight: lighter;
+  }
+}
+table {
+  th {
+    vertical-align: bottom;
+    font-weight: bold;
+  }
+  td {
+    vertical-align: top;
+  }
+  pre {
+    margin-bottom: 0.25rem;
+  }
+}
+[data-jump-to="top"] {
+  > i {
+    display: inline-block;
+    padding: 0.25rem 0.375rem;
+    margin: 0.5rem;
+    font-size: 0.75rem;
+    color: black;
+    border-color: black;
+  }
+}
+[data-is-toc] {
+  font-size: 87.5%;
+
+  a {
+    text-decoration: none;
+  }
+  > ul > * > a {
+    font-weight: 500;
+  }
+}
+.breakout,
+.breakout-all {
+  > img,
+  > figure {
+    margin-bottom: 1rem;
+  }
+}
+.faded {
+  a {
+    text-decoration-style: dotted;
+  }
+}
+/*```
+<!--section--> */

package/assets/breakout.css

@@ -0,0 +1,98 @@
+/* <!--section:code-->```css */
+.breakout,
+.breakout-all {
+  /* Prepare the container for breakout elements */
+  padding-inline: 10%;
+  max-width: calc(10% + 65ch + 10%);
+
+  /* Breakout direct children only */
+  & > * {
+    &:is(
+      table,
+      pre,
+      figure, video, iframe, canvas,
+      img, picture,
+      /* Custom utility classes for other tags that need to be broken out */
+      .breakout-item,
+      .breakout-item-max
+    ) {
+      width: fit-content;
+      min-width: 100%;
+      max-width: 125%;
+      margin-left: 50%;
+      transform: translateX(-50%);
+    }
+
+    /* Respect img/picture min-width */
+    &:is(img, picture) {
+      min-width: auto;
+    }
+
+    /* Max out the width of the element */
+    &.breakout-item-max {
+      width: 125% !important; /* !important is for cases like figure.breakout-item-max @TODO */
+    }
+  }
+}
+.breakout-all > * {
+  &:is(h2, h3, h4, h5, h6, hr):not([class]) {
+    position: relative;
+
+    &::before {
+      content: "";
+      display: block;
+      position: absolute;
+      background: gray;
+      opacity: 12.5%;
+    }
+  }
+
+  &:is(h2, h3, h4, h5, h6):not([class]) {
+    &::before {
+      width: 10em;
+      right: 100%;
+      margin-right: 0.8ch;
+      height: 0.25em;
+      top: 50%;
+      transform: translateY(-50%);
+      background: linear-gradient(to left, gray, transparent);
+    }
+
+    /* @TODO: add to tricks-wiki why `*` works here, but `&` fails */
+    &:where(hr + *) {
+      &::before {
+        display: none !important;
+      }
+    }
+  }
+  &:is(hr) {
+    height: 0.5rem;
+    border: none;
+    overflow: visible;
+
+    &::before {
+      width: 100vw;
+      left: 50%;
+      height: 100%;
+      transform: translateX(-50%);
+    }
+  }
+}
+/*```
+<!--section:docs,summary-->
+
+Framework-agnostic utilities for breaking out images and figures beyond their container width.
+
+Use the `.breakout` class to allow elements to extend beyond their parent container.
+
+<!--section:docs-->
+
+```html
+<div class="breakout">
+  <img src="image.jpg" alt="Description" />
+</div>
+```
+
+The breakout container has `10%` inline padding and a max-width of `calc(10% + 65ch + 10%)`. The breakout utilities support images, pictures, figures, canvas, audio, video, tables, pre, iframe, and other media elements. Tables inside `.breakout` are specifically enhanced for horizontal scrolling and full-bleed mobile display. This is automatically included when you import the stylesheet.
+
+<!--section--> */

package/assets/float-label.core.css

@@ -0,0 +1,44 @@
+/* Moved here from https://github.com/anyblades/float-label-css for easier maintenance
+<!--section:docs-->
+
+First, we target either:
+1. `<label>` which `:has` inner form inputs (classless approach)
+2. or explicit `.has-float-label` class (alternative approach)
+```css */
+label:has(input:not([type="checkbox"], [type="radio"], [type="range"]), textarea, select),
+.has-float-label {
+  display: block;
+  position: relative;
+  /*
+```
+Then, we define the default/fallback state (when the float label should be minimized):
+```css */
+  > span,
+  label {
+    position: absolute;
+    left: 0;
+    top: 0;
+    cursor: text;
+    font-size: 75%;
+  }
+  /*
+```
+Finally, we detect if placeholder is shown, but not in focus. That means we can safely hide it, and enlarge the float label instead:
+```css */
+  *:placeholder-shown:not(:focus)::placeholder {
+    opacity: 0;
+  }
+  &:has(*:placeholder-shown:not(:focus)) {
+    > span,
+    label {
+      font-size: inherit;
+      opacity: 50%;
+    }
+  }
+}
+/*
+```
+The `:has(*:placeholder-shown:not(:focus))` trick allows this input state information to *propagate* to the parent level. This enables modern CSS to target inner float label (`<span>` or `<label>`) regardless of its position relative to the input field.
+
+Historically, this was not possible: the float label had to be placed after the input field to be targeted using the `input:focus + label` selector.
+<!--section--> */

package/assets/float-label.css

@@ -0,0 +1,76 @@
+/* Float Label CSS v2.0.0-alpha */
+/* Moved here from https://github.com/anyblades/float-label-css for easier maintenance
+<!--section:docs-->
+
+First, we target either:
+1. `<label>` which `:has` inner form inputs (classless approach)
+2. or explicit `.has-float-label` class (alternative approach)
+```css */
+label:has(input:not([type="checkbox"], [type="radio"], [type="range"]), textarea, select),
+.has-float-label {
+  display: block;
+  position: relative;
+  /*
+```
+Then, we define the default/fallback state (when the float label should be minimized):
+```css */
+  > span,
+  label {
+    position: absolute;
+    left: 0;
+    top: 0;
+    cursor: text;
+    font-size: 75%;
+  }
+  /*
+```
+Finally, we detect if placeholder is shown, but not in focus. That means we can safely hide it, and enlarge the float label instead:
+```css */
+  *:placeholder-shown:not(:focus)::placeholder {
+    opacity: 0;
+  }
+  &:has(*:placeholder-shown:not(:focus)) {
+    > span,
+    label {
+      font-size: inherit;
+      opacity: 50%;
+    }
+  }
+}
+/*
+```
+The `:has(*:placeholder-shown:not(:focus))` trick allows this input state information to *propagate* to the parent level. This enables modern CSS to target inner float label (`<span>` or `<label>`) regardless of its position relative to the input field.
+
+Historically, this was not possible: the float label had to be placed after the input field to be targeted using the `input:focus + label` selector.
+<!--section--> */
+label:has(input:not([type="checkbox"], [type="radio"], [type="range"]), textarea, select),
+.has-float-label {
+  /* Default/fallback state */
+  > span,
+  label {
+    padding-inline-start: calc(1rem + 1px); /* match Pico's padding + border */
+    padding-block-start: 0.25rem;
+    opacity: 75%;
+    transition: all 0.25s;
+  }
+  input,
+  textarea,
+  select {
+    margin-block-start: 0; /* reset Pico */
+    padding-inline-start: 1rem; /* match Pico */
+    padding-block: 1.125rem 0.375rem; /* match Pico's total: 2 x 0.75rem = 1.5rem */
+
+    &::placeholder {
+      opacity: 100%;
+      transition: all 0.25s;
+    }
+  }
+
+  /* Enlarged state */
+  &:has(*:placeholder-shown:not(:focus)) {
+    > span,
+    label {
+      padding-block: 0.75rem; /* match Pico */
+    }
+  }
+}

package/assets/float-label.theme.css

@@ -0,0 +1,31 @@
+label:has(input:not([type="checkbox"], [type="radio"], [type="range"]), textarea, select),
+.has-float-label {
+  /* Default/fallback state */
+  > span,
+  label {
+    padding-inline-start: calc(1rem + 1px); /* match Pico's padding + border */
+    padding-block-start: 0.25rem;
+    opacity: 75%;
+    transition: all 0.25s;
+  }
+  input,
+  textarea,
+  select {
+    margin-block-start: 0; /* reset Pico */
+    padding-inline-start: 1rem; /* match Pico */
+    padding-block: 1.125rem 0.375rem; /* match Pico's total: 2 x 0.75rem = 1.5rem */
+
+    &::placeholder {
+      opacity: 100%;
+      transition: all 0.25s;
+    }
+  }
+
+  /* Enlarged state */
+  &:has(*:placeholder-shown:not(:focus)) {
+    > span,
+    label {
+      padding-block: 0.75rem; /* match Pico */
+    }
+  }
+}

package/assets/link-icon.css

@@ -0,0 +1,55 @@
+/* Extends https://github.com/picocss/pico/blob/main/scss/content/_link.scss
+<!--section:code-->
+```css */
+a {
+  /* Use inline flex only if link contains an icon */
+  &:has(> i) {
+    display: inline-flex;
+    gap: 0.375ch; /* =3/8 */
+    overflow-y: clip; /* to work in pair with text-underline-offset in Safari */
+  }
+  > i {
+    font-style: normal;
+    float: left; /*                 ✅ Chrome ❌ Safari */
+    text-underline-offset: -2em; /* ❌ Chrome ✅ Safari - to clip it with overflow-y */
+
+    /* Favicons */
+    > img {
+      height: 1.25em;
+      margin-block: calc(-0.25em / 2);
+      display: inline-block; /* for Tailwind CSS Typography */
+    }
+
+    /* Font Awesome */
+    &[class^="fa-"],
+    &[class*=" fa-"] {
+      line-height: inherit;
+      --fa-width: auto;
+    }
+    &.fa-lg {
+      line-height: normal;
+    }
+  }
+}
+/*```
+> **PRO-TIP** for 11ty: https://blades.ninja/build-awesome-11ty/processors/#auto-link-favicons
+
+<!--section:docs,summary-->
+
+Use Blades' `<i>`-helper to wrap emojis, favicons, or simply drop Font Awesome icons inside links. It automatically handles sizing and alignment while preventing underline on icons.
+
+<!--section:docs-->
+
+Compare:
+
+| Without Blades <hr class="lg">                                                                          | With Blades' `<i>`-helper <hr class="lg">                                                                      | Clean HTML without `<span>ning` <hr class="x2"> |
+| ------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
+| [🥷 Link with emoji](#)                                                                                 | [<i>🥷</i> Link with emoji](#)                                                                                 | `<a><i>🥷</i> Text</a>`                         |
+| [![](https://www.google.com/s2/favicons?domain=any.digital&sz=64) Multi-line link <br> with favicon](#) | [<i>![](https://www.google.com/s2/favicons?domain=any.digital&sz=64)</i> Multi-line link <br> with favicon](#) | `<a><i><img src="..."></i> Text</a>`            |
+| [<b class="fa-brands fa-github fa-lg"></b> Link with Font Awesome icon](#)                              | [<i class="fa-brands fa-github fa-lg"></i> Link with Font Awesome icon](#)                                     | `<a><i class="fa-..."></i> Text</a>`            |
+
+---
+
+[How we made it ↗ &nbsp;<small>(on Codepen)</small>](https://codepen.io/editor/anydigital/pen/019d2b94-5616-75dc-a23e-e111869d5237){role=button .outline}
+
+<!--section--> */

package/assets/responsive-table.css

@@ -0,0 +1,55 @@
+/* <!--section:code-->
+```css */
+table.responsive,
+.breakout > table:not(.does-not-exist),
+.breakout-all > table:not(.does-not-exist) {
+  /* Center horizontally */
+  margin-left: 50%;
+  transform: translateX(-50%);
+
+  /* Let them full-bleed */
+  width: max-content;
+  min-width: auto;
+  max-width: 100vw;
+  padding-inline: 7.5%;
+
+  /* Let them scroll */
+  display: block;
+  overflow-x: auto;
+  -webkit-overflow-scrolling: touch; /* Smooth scroll for iOS */
+
+  th,
+  td {
+    padding-inline-start: 0;
+  }
+}
+/*```
+<!--#TODO:css-blade-->
+Soft-increase selector specificity trick:
+
+`table:not(.does-not-exist)` (inspired by postcss) is used here to increase specificity against selectors like `&:is(table, .table)`
+
+<!--section:docs,summary-->
+
+`<table class="responsive">` allows a table to full-bleed and scroll on mobile.
+
+<!--section:docs-->
+
+| Term              | Description <hr class="x2">                                                                                                                                                                  | Link                                                |
+| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- |
+| Responsive design | Approach to web design that aims to make web pages render well on a variety of devices and window or screen sizes from minimum to maximum display size to ensure usability and satisfaction. | https://en.wikipedia.org/wiki/Responsive_web_design |
+
+{.responsive}
+
+---
+
+Tables inside https://blades.ninja/css/breakout/ are responsive by default.
+
+Living examples:
+
+- https://any.digital/insights/ai-ide/
+- https://any.digital/insights/css-frameworks/
+- https://any.digital/insights/ssg/
+- https://blades.ninja/build-awesome-11ty/#min-starters
+
+<!--section--> */

package/blades.gemspec

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+Gem::Specification.new do |spec|
+  spec.name          = "blades"
+  spec.version       = "0.28.0-alpha.2"
+  spec.authors       = ["Anton Staroverov"]
+
+  spec.summary       = "Framework-agnostic CSS utilities and single-file Liquid 'blades' for modern web development."
+  spec.homepage      = "https://github.com/anyblades/blades"
+  spec.license       = "MIT"
+
+  spec.files = Dir.glob("{_includes,assets}/**/*")
+  # puts "spec.files: #{spec.files.inspect}"
+
+  spec.add_runtime_dependency "jekyll", ">= 3.5", "< 5.0"
+end

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@anyblades/blades",
+  "version": "0.28.0-alpha.2",
+  "description": "Framework-agnostic CSS utilities and single-file Liquid 'blades' for modern web development.",
+  "style": "./assets/blades.css",
+  "exports": {
+    ".": "./src/blades.css",
+    "./core": "./src/blades.core.css",
+    "./theme": "./src/blades.theme.css",
+    "./float-label": "./src/float-label.css",
+    "./unreduce-motion": "./src/_unreduce-motion.css"
+  },
+  "scripts": {
+    "postcss": "postcss './src/!(_)*.css' --dir ./assets",
+    "build": "npm run postcss -- --no-map",
+    "start": "npm run postcss -- --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anyblades/blades.git"
+  },
+  "keywords": [
+    "css",
+    "utilities",
+    "helpers",
+    "atomic",
+    "cdn"
+  ],
+  "author": "Anton Staroverov",
+  "license": "MIT",
+  "devDependencies": {
+    "postcss": "^8.4.33",
+    "postcss-cli": "^11.0.0",
+    "postcss-import": "^16.1.1",
+    "prettier-plugin-jinja-template": "^2.1.0"
+  }
+}

package/postcss.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  plugins: {
+    "postcss-import": {},
+  },
+};

package/src/_code.css

@@ -0,0 +1,45 @@
+/* <!--section:docs-->
+### Code
+Extends https://github.com/picocss/pico/blob/main/scss/content/_code.scss
+```css */
+pre {
+  padding: 1rem 1.5rem;
+  padding-inline-end: 2rem;
+
+  @media screen and (max-width: 767px) {
+    border-radius: 0;
+  }
+}
+
+code {
+  /* Code block caption via data-attr (to display filename, etc.) */
+  &[data-caption] {
+    &::before {
+      content: attr(data-caption);
+      display: block;
+      margin-bottom: 1rem;
+      opacity: 50%;
+      font-style: italic;
+    }
+  }
+
+  &:where(pre > *) {
+    padding: 0;
+  }
+}
+
+/*** Extends https://github.com/PrismJS/prism/blob/master/plugins/treeview/prism-treeview.css ***/
+.token.treeview-part {
+  .entry-line {
+    width: 2.5em !important;
+    opacity: 25%;
+  }
+  .entry-name:last-child {
+    opacity: 50%;
+
+    &::before {
+      display: none !important;
+    }
+  }
+}
+/*``` <!--section--> */

package/src/_layout.css

@@ -0,0 +1,47 @@
+/* Extends https://github.com/picocss/pico/blob/main/scss/layout/
+<!--section:docs-intro-->
+
+Global styles:
+```css */
+html {
+  /* Prevent horizontal overflow and scrolling, modern way. */
+  overflow-x: clip;
+}
+body {
+  /* Ensure `body` takes at least the full height of the viewport (using dynamic viewport height for better mobile support). */
+  min-height: 100dvh;
+}
+/*```
+<!--section:docs-->
+
+### Auto-columns
+```css */
+.columns,
+[data-is-toc] > ul,
+[data-is-toc] > ol {
+  columns: 30ch auto; /* 2 cols max for 65ch container */
+
+  /* Avoid breaking inside elements, such as nested lists */
+  > * {
+    break-inside: avoid;
+  }
+}
+/*```
+
+Table of contents (`[data-is-toc]`) has auto-columns by default.
+
+### Jump to top
+```css */
+[data-jump-to="top"] {
+  position: fixed;
+  bottom: 0;
+  right: 0;
+  padding-top: 50vh;
+  opacity: 25%;
+
+  &:hover {
+    opacity: 75%;
+  }
+}
+/*```
+<!--section--> */