PhiaUiDesign.Catalog.FamilyResolver (phia_ui v0.1.17)

Detects composable component families by analyzing which components share the same module and have naming prefix patterns.

For example: card, card_header, card_title, card_content, card_footer all belong to the "card" family.

Summary

family()

Get the family for a specific component. Returns nil if the component is standalone (no family).

Resolve all component families from the registry.

Get the typical children for a component family. Returns an ordered list suitable for auto-scaffolding.

@type family() :: %{
  root: atom(),
  root_name: String.t(),
  module: module(),
  children: [atom()],
  tier: atom()
}

@spec family_for(atom()) :: family() | nil

Get the family for a specific component. Returns nil if the component is standalone (no family).

@spec resolve_families() :: [family()]

Resolve all component families from the registry.

Returns families where a root component has 1+ child components in the same module with matching name prefix.

@spec scaffold_order(atom()) :: [atom()]

Get the typical children for a component family. Returns an ordered list suitable for auto-scaffolding.