Location Tab

ASSIGN Cascade Assign Rules (Kit / Assembly)

• 1.When assigning a location to a kit or assembly, the user is prompted to also assign to child assets.
• 2.This is NOT automatic -- the user must confirm via a checkbox list of children.
• 3.Each child asset requires its own ManageXxxLocation permission (e.g., ManageAssemblyLocation, ManageComponentLocation).
• 4.Children for which the user lacks permission are shown in the list but disabled/grayed out (opacity-50 cursor-not-allowed).
• 5.User can choose: "Assign to selected" (cascade) or "Assign to {asset} only" (skip children).
• 6."Select All / Deselect All" toggle is provided for convenience.

UNASSIGN Cascade Unassign Rules (Kit / Assembly)

• 1.When removing a location from a kit or assembly, the system checks for children that share the same location via getSharedLocationChildren().
• 2.If shared children are found, a confirmation modal shows a checkbox list of affected children.
• 3.Only children that currently have the same location assigned are shown.
• 4.Each child requires ManageXxxLocation permission -- children without permission are shown disabled.
• 5.User can choose: "Remove from selected" (cascade) or "Remove from {asset} only" (skip children).
• 6.If no children share the location, a simple ConfirmModal is shown instead (no cascade).

Decision Flow

User clicks "Add Location"
  -> LocationSelector modal opens
  -> User searches existing locations
     -> Selects existing location -> proceed to assign
     -> Clicks "Create new location" -> LocationModal opens (create-only)
        -> User enters name + Google Places search
        -> Clicks "Create Location" -> API creates location
        -> New location auto-selected in dropdown -> proceed to assign
  -> Is asset a kit/assembly with children?
     NO  -> assign directly
     YES -> show CascadeAssignModal (checkbox list)
            -> "Assign to selected" -> assign parent + checked children
            -> "Assign to {asset} only" -> assign parent only

User clicks "Remove"
  -> Is asset a kit/assembly with children?
     NO  -> simple ConfirmModal
     YES -> getSharedLocationChildren()
            -> any shared? NO  -> simple ConfirmModal
            -> any shared? YES -> CascadeUnassignModal (checkbox list)
               -> "Remove from selected" -> unassign parent + checked children
               -> "Remove from {asset} only" -> unassign parent only

Split layout: left sidebar (lg:w-80) with scrollable location cards, right panel with Google Map. First location is auto-selected. Map centers on selected location at zoom 13. Clicking a card selects it and re-centers the map.

EmptyState component renders with map pin SVG icon, "No location assigned" title, contextual description ("Assign a location to this {assetType}..."), and an "Add Location" action button (if permission).

Scoped loading state: card with header "Location" and a centered spinner (h-6 w-6 border-t-ag_red) at py-16. Not a full-page loader -- only the content area spins.

When data exists but a refresh is triggered, the sidebar shows a smaller spinner (h-5 w-5) centered at py-8 while the map remains visible.

Rendered via createPortal as a fixed overlay (fixed inset-0 z-50 bg-black/50). Contains a max-w-md rounded-xl bg-white dialog for searching existing locations. "Create new location" button always visible at the bottom of results (or prominently in empty state).

Triggered from "Create new location" button inside LocationSelector. Opens LocationModal in create-only mode. Form fields: location name (required), Google Places autocomplete search, interactive map preview (click to adjust pin), resolved address summary. On create, calls LocationV2Service.createLocation(), adds location to selector dropdown, and auto-selects it.

After selecting a location, if the asset is a kit/assembly with children, a confirmation modal shows a checkbox list of child assets. User selects which children should also receive the location. Requires ManageXxxLocation permission per child type.

For kits and assemblies, removing a location checks for children sharing that location. If found, a confirmation modal lists affected child assets with checkboxes before proceeding with bulk unassign.