MishkaChelekom.CSS (Mishka Chelekom v0.0.9-beta.2)

Copy Markdown View Source

Tailwind-aware class composition with a swappable merge seam (Layer 3).

classes/1 flattens nested/conditional class inputs (the same shapes HEEx accepts) into a single deduplicated string — last occurrence wins, so a caller's @class reliably overrides defaults. This is the zero-dependency built-in default.

For real Tailwind conflict resolution (e.g. px-2 vs px-4), point the seam at a tailwind_merge-style library:

config :mishka_chelekom, :class_merger, {TailwindMerge, :merge, 1}

The configured merger is resolved at runtime via Application.get_env/3; when unset, the built-in dedupe/1 is used. This mirrors Pyro's approach and keeps the dependency optional.

Summary

Types

input()

Functions

classes(input)

Flattens and merges class inputs into a single class string.

dedupe(class_string)

Built-in default merger: collapses whitespace and removes exact duplicate tokens, keeping the last occurrence so later (caller) classes win. Does not resolve Tailwind utility conflicts — adopt tailwind_merge via the seam for that.

merge(class_string)

Runs the configured class merger over a space-separated class string. Defaults to dedupe/1 (token de-duplication, last wins) when no :class_merger is configured.

Types

input()

@type input() :: String.t() | [input()] | nil | false | {boolean(), input()}

Functions

classes(input)

@spec classes(input()) :: String.t()

Flattens and merges class inputs into a single class string.

Accepts strings, nested lists, nil/false (dropped), and {condition, classes} tuples.

iex> MishkaChelekom.CSS.classes(["px-2 py-1", nil, {true, "font-bold"}, {false, "hidden"}])
"px-2 py-1 font-bold"

dedupe(class_string)

@spec dedupe(String.t()) :: String.t()

Built-in default merger: collapses whitespace and removes exact duplicate tokens, keeping the last occurrence so later (caller) classes win. Does not resolve Tailwind utility conflicts — adopt tailwind_merge via the seam for that.

merge(class_string)

@spec merge(String.t()) :: String.t()

Runs the configured class merger over a space-separated class string. Defaults to dedupe/1 (token de-duplication, last wins) when no :class_merger is configured.