@zvk/composite 0.1.2 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @zvk/composite Changelog
 
+## [0.1.3](https://github.com/brandon-schabel/zvk/compare/composite-v0.1.2...composite-v0.1.3) (2026-06-20)
+
+
+### Features
+
+* improve package release workflow and repo maintainability ([#22](https://github.com/brandon-schabel/zvk/issues/22)) ([a41cb66](https://github.com/brandon-schabel/zvk/commit/a41cb66554496f241c5a8e30b29a76c8b8ca92b3))
+
 ## [0.1.2](https://github.com/brandon-schabel/zvk/compare/composite-v0.1.1...composite-v0.1.2) (2026-06-19)
 
 

package/README.md

@@ -13,6 +13,21 @@ Components are UI-only and accept typed props, slots, and callbacks. They do not
 
 Composite typography inherits the shared `@zvk/ui` font-family slots: primary for body/control text, secondary for titles and navigation accents, and tertiary wherever composed UI primitives render code or technical values.
 
+## Domain Ownership
+
+The package is organized around product-surface domains so repeated shell structure stays readable without creating new public import groups. This map is for internal ownership and review; it does not add domain barrel imports to the public API.
+
+- `shell`: `AppWorkspaceShell`, `PageScaffold`, `FeatureShell`
+- `navigation`: `WorkspaceHeader`, `BreadcrumbPageHeader`, `SectionedWorkspaceShell`, `EntitySwitcherMenu`, `CommandPaletteShell`, `LinkAction`
+- `state`: `StateSurface`, `RouteStateFrame`
+- `forms`: `FormSurface`, `ConfirmActionDialog`
+- `data`: `EntityCard`, `EntityListSection`, `SummaryMetricGrid`, `DataTablePageFrame`, `DataTableControlBar`
+- `workflow`: `IntegrationStatusCard`, `WorkflowStatusCard`, `ProcessListPanel`
+- `settings`: `SettingsHubList`, `ParameterEditor`, `SettingsSectionStack`
+- `ai`: `ProviderModelSelector`, `ConversationDirectory`, `StickyComposer`
+- `activity`: `ActivityFeed`
+- `detail`: `DetailInspectorPanel`
+
 ## What Composite Does Not Own
 
 `@zvk/composite` owns repeated product-surface structure, semantic markup, accessible labels for the UI it renders, token-backed spacing, density-aware layout, and typed slots. It deliberately does not own app policy or runtime orchestration.
@@ -27,6 +42,15 @@ Keep these in the consuming app or a more specific package:
 - AI provider catalogs, model compatibility, prompt state, tool execution, attachments, message history, and AI SDK integration;
 - analytics, telemetry, business copy, domain transforms, date formatting, and error classification.
 
+## Public Stability
+
+- All current component subpaths and the root export are stable public API.
+- Watched surfaces may evolve only through additive, UI-only props, callbacks, and tests; keep them app-agnostic and preserve the current import paths.
+- `./styles.css` is a stable stylesheet export.
+- `./package.json` is stable metadata and tooling export, not a component surface.
+
+Watched surfaces: `EntitySwitcherMenu`, `CommandPaletteShell`, `ConfirmActionDialog`, `IntegrationStatusCard`, `WorkflowStatusCard`, `ProcessListPanel`, `ActivityFeed`, `ParameterEditor`, `ProviderModelSelector`, `ConversationDirectory`, `StickyComposer`, and `DataTableControlBar`.
+
 ## App Surface Exports
 
 App surfaces are intentionally router-agnostic and UI-only:
@@ -92,6 +116,18 @@ import { LinkAction } from "@zvk/composite/link-action";
 
 These components should stay focused on visual structure, semantics, and affordances; routing, domain mapping, and data orchestration remain in the consuming app.
 
+## Future Feature Acceptance
+
+Accept a new composite only when all of these are true:
+
+- [ ] It replaces repeated product-surface structure, not a primitive control or wrapper `div`.
+- [ ] Its name and props stay app-agnostic.
+- [ ] It composes public `@zvk/ui` exports, existing public composites, or local presentational helpers only.
+- [ ] Routing, persistence, data fetching, auth, billing, validation, table engines, AI SDKs, analytics, policy checks, and business rules stay in the app or a more specific package.
+- [ ] It fits an existing domain owner or clearly justifies a new owner in this README and the composite skill.
+- [ ] It can be covered by package export map, root export, internal domain barrel, CSS aggregate, type fixture, SSR import smoke, export validation, tarball inspection, README guidance, preview example, and skill update.
+- [ ] It remains SSR-safe at module initialization and deterministic in initial render.
+
 ## Migration Guide
 
 Migrate repeated app-owned shells into `@zvk/composite` only when the repeated part is visual structure and interaction affordance, not domain behavior.
@@ -420,3 +456,7 @@ import { DataTableControlBar } from "@zvk/composite/data-table-control-bar";
   selectionSummary="3 selected"
 />;
 ```
+
+## Repo Skill
+
+Use `.codex/skills/use-zvk-composite/SKILL.md` when maintaining this package.

package/dist/domains/activity.d.ts

@@ -0,0 +1,2 @@
+export { ActivityFeed } from "../activity/activity-feed.js";
+export type { ActivityFeedGroup, ActivityFeedItem, ActivityFeedProps, ActivityFeedTone } from "../activity/activity-feed.js";

package/dist/domains/activity.js

@@ -0,0 +1 @@
+export { ActivityFeed } from "../activity/activity-feed.js";

package/dist/domains/ai.d.ts

@@ -0,0 +1,6 @@
+export { ConversationDirectory } from "../ai/conversation-directory.js";
+export type { ConversationDirectoryGroup, ConversationDirectoryItem, ConversationDirectoryProps } from "../ai/conversation-directory.js";
+export { ProviderModelSelector } from "../ai/provider-model-selector.js";
+export type { ProviderModelGroup, ProviderModelItem, ProviderModelSelectorProps } from "../ai/provider-model-selector.js";
+export { StickyComposer } from "../ai/sticky-composer.js";
+export type { StickyComposerProps } from "../ai/sticky-composer.js";

package/dist/domains/ai.js

@@ -0,0 +1,3 @@
+export { ConversationDirectory } from "../ai/conversation-directory.js";
+export { ProviderModelSelector } from "../ai/provider-model-selector.js";
+export { StickyComposer } from "../ai/sticky-composer.js";

package/dist/domains/data.d.ts

@@ -0,0 +1,10 @@
+export { DataTableControlBar } from "../data/data-table-control-bar.js";
+export type { DataTableControlBarProps } from "../data/data-table-control-bar.js";
+export { DataTablePageFrame } from "../data/data-table-page-frame.js";
+export type { DataTablePageFrameProps } from "../data/data-table-page-frame.js";
+export { EntityCard } from "../lists/entity-card.js";
+export type { EntityCardProps } from "../lists/entity-card.js";
+export { EntityListSection } from "../lists/entity-list-section.js";
+export type { EntityListSectionProps } from "../lists/entity-list-section.js";
+export { SummaryMetricGrid } from "../lists/summary-metric-grid.js";
+export type { SummaryMetric, SummaryMetricGridActionPosition, SummaryMetricGridColumns, SummaryMetricGridProps } from "../lists/summary-metric-grid.js";

package/dist/domains/data.js

@@ -0,0 +1,5 @@
+export { DataTableControlBar } from "../data/data-table-control-bar.js";
+export { DataTablePageFrame } from "../data/data-table-page-frame.js";
+export { EntityCard } from "../lists/entity-card.js";
+export { EntityListSection } from "../lists/entity-list-section.js";
+export { SummaryMetricGrid } from "../lists/summary-metric-grid.js";

package/dist/domains/detail.d.ts

@@ -0,0 +1,2 @@
+export { DetailInspectorPanel } from "../detail/detail-inspector-panel.js";
+export type { DetailInspectorPanelProps, DetailInspectorSection } from "../detail/detail-inspector-panel.js";

package/dist/domains/detail.js

@@ -0,0 +1 @@
+export { DetailInspectorPanel } from "../detail/detail-inspector-panel.js";

package/dist/domains/forms.d.ts

@@ -0,0 +1,4 @@
+export { ConfirmActionDialog } from "../forms/confirm-action-dialog.js";
+export type { ConfirmActionDialogProps, ConfirmActionDialogTone } from "../forms/confirm-action-dialog.js";
+export { FormSurface } from "../forms/form-surface.js";
+export type { FormSurfaceProps } from "../forms/form-surface.js";

package/dist/domains/forms.js

@@ -0,0 +1,2 @@
+export { ConfirmActionDialog } from "../forms/confirm-action-dialog.js";
+export { FormSurface } from "../forms/form-surface.js";

package/dist/domains/navigation.d.ts

@@ -0,0 +1,10 @@
+export { BreadcrumbPageHeader, WorkspaceHeader } from "../navigation/workspace-header.js";
+export type { BreadcrumbPageHeaderItem, BreadcrumbPageHeaderProps, WorkspaceHeaderAlign, WorkspaceHeaderHeadingLevel, WorkspaceHeaderProps } from "../navigation/workspace-header.js";
+export { CommandPaletteShell } from "../navigation/command-palette-shell.js";
+export type { CommandPaletteCommand, CommandPaletteGroup, CommandPaletteShellProps } from "../navigation/command-palette-shell.js";
+export { EntitySwitcherMenu } from "../navigation/entity-switcher-menu.js";
+export type { EntitySwitcherGroup, EntitySwitcherItem, EntitySwitcherMenuProps, EntitySwitcherMenuSize } from "../navigation/entity-switcher-menu.js";
+export { LinkAction } from "../navigation/link-action.js";
+export type { LinkActionProps } from "../navigation/link-action.js";
+export { SectionedWorkspaceShell } from "../navigation/sectioned-workspace-shell.js";
+export type { SectionedWorkspaceItem, SectionedWorkspaceSection, SectionedWorkspaceShellProps } from "../navigation/sectioned-workspace-shell.js";

package/dist/domains/navigation.js

@@ -0,0 +1,5 @@
+export { BreadcrumbPageHeader, WorkspaceHeader } from "../navigation/workspace-header.js";
+export { CommandPaletteShell } from "../navigation/command-palette-shell.js";
+export { EntitySwitcherMenu } from "../navigation/entity-switcher-menu.js";
+export { LinkAction } from "../navigation/link-action.js";
+export { SectionedWorkspaceShell } from "../navigation/sectioned-workspace-shell.js";

package/dist/domains/settings.d.ts

@@ -0,0 +1,6 @@
+export { ParameterEditor } from "../settings/parameter-editor.js";
+export type { ParameterEditorDensity, ParameterEditorGroup, ParameterEditorProps, ParameterEditorRow } from "../settings/parameter-editor.js";
+export { SettingsHubList } from "../lists/settings-hub-list.js";
+export type { SettingsHubItem, SettingsHubListProps } from "../lists/settings-hub-list.js";
+export { SettingsSectionStack } from "../settings/settings-section-stack.js";
+export type { SettingsSection, SettingsSectionStackProps } from "../settings/settings-section-stack.js";

package/dist/domains/settings.js

@@ -0,0 +1,3 @@
+export { ParameterEditor } from "../settings/parameter-editor.js";
+export { SettingsHubList } from "../lists/settings-hub-list.js";
+export { SettingsSectionStack } from "../settings/settings-section-stack.js";

package/dist/domains/shell.d.ts

@@ -0,0 +1,6 @@
+export { AppWorkspaceShell } from "../navigation/app-workspace-shell.js";
+export type { AppWorkspaceShellProps } from "../navigation/app-workspace-shell.js";
+export { FeatureShell } from "../layout/feature-shell.js";
+export type { FeatureShellProps } from "../layout/feature-shell.js";
+export { PageScaffold } from "../layout/page-scaffold.js";
+export type { PageScaffoldMaxWidth, PageScaffoldProps } from "../layout/page-scaffold.js";

package/dist/domains/shell.js

@@ -0,0 +1,3 @@
+export { AppWorkspaceShell } from "../navigation/app-workspace-shell.js";
+export { FeatureShell } from "../layout/feature-shell.js";
+export { PageScaffold } from "../layout/page-scaffold.js";

package/dist/domains/state.d.ts

@@ -0,0 +1,4 @@
+export { RouteStateFrame } from "../state/route-state-frame.js";
+export type { RouteStateFrameProps, RouteStateFrameStatus } from "../state/route-state-frame.js";
+export { StateSurface } from "../state/state-surface.js";
+export type { StateSurfaceAlign, StateSurfaceProps, StateSurfaceSize, StateSurfaceState } from "../state/state-surface.js";

package/dist/domains/state.js

@@ -0,0 +1,2 @@
+export { RouteStateFrame } from "../state/route-state-frame.js";
+export { StateSurface } from "../state/state-surface.js";

package/dist/domains/workflow.d.ts

@@ -0,0 +1,6 @@
+export { IntegrationStatusCard } from "../integrations/integration-status-card.js";
+export type { IntegrationStatusCardProps, IntegrationStatusTone } from "../integrations/integration-status-card.js";
+export { ProcessListPanel } from "../workflows/process-list-panel.js";
+export type { ProcessListPanelItem, ProcessListPanelProps } from "../workflows/process-list-panel.js";
+export { WorkflowStatusCard } from "../workflows/workflow-status-card.js";
+export type { WorkflowStatusCardProps, WorkflowStatusTone } from "../workflows/workflow-status-card.js";

package/dist/domains/workflow.js

@@ -0,0 +1,3 @@
+export { IntegrationStatusCard } from "../integrations/integration-status-card.js";
+export { ProcessListPanel } from "../workflows/process-list-panel.js";
+export { WorkflowStatusCard } from "../workflows/workflow-status-card.js";

package/dist/index.d.ts

@@ -1,56 +1,10 @@
-export { ActivityFeed } from "./activity/activity-feed.js";
-export type { ActivityFeedGroup, ActivityFeedItem, ActivityFeedProps, ActivityFeedTone } from "./activity/activity-feed.js";
-export { PageScaffold } from "./layout/page-scaffold.js";
-export type { PageScaffoldMaxWidth, PageScaffoldProps } from "./layout/page-scaffold.js";
-export { FeatureShell } from "./layout/feature-shell.js";
-export type { FeatureShellProps } from "./layout/feature-shell.js";
-export { AppWorkspaceShell } from "./navigation/app-workspace-shell.js";
-export type { AppWorkspaceShellProps } from "./navigation/app-workspace-shell.js";
-export { CommandPaletteShell } from "./navigation/command-palette-shell.js";
-export type { CommandPaletteCommand, CommandPaletteGroup, CommandPaletteShellProps } from "./navigation/command-palette-shell.js";
-export { EntitySwitcherMenu } from "./navigation/entity-switcher-menu.js";
-export type { EntitySwitcherGroup, EntitySwitcherItem, EntitySwitcherMenuProps, EntitySwitcherMenuSize } from "./navigation/entity-switcher-menu.js";
-export { BreadcrumbPageHeader, WorkspaceHeader } from "./navigation/workspace-header.js";
-export type { BreadcrumbPageHeaderProps, BreadcrumbPageHeaderItem, WorkspaceHeaderAlign, WorkspaceHeaderHeadingLevel, WorkspaceHeaderProps } from "./navigation/workspace-header.js";
-export { SectionedWorkspaceShell } from "./navigation/sectioned-workspace-shell.js";
-export type { SectionedWorkspaceItem, SectionedWorkspaceSection, SectionedWorkspaceShellProps } from "./navigation/sectioned-workspace-shell.js";
-export { StateSurface } from "./state/state-surface.js";
-export type { StateSurfaceAlign, StateSurfaceProps, StateSurfaceSize, StateSurfaceState } from "./state/state-surface.js";
-export { RouteStateFrame } from "./state/route-state-frame.js";
-export type { RouteStateFrameProps, RouteStateFrameStatus } from "./state/route-state-frame.js";
-export { EntityCard } from "./lists/entity-card.js";
-export type { EntityCardProps } from "./lists/entity-card.js";
-export { EntityListSection } from "./lists/entity-list-section.js";
-export type { EntityListSectionProps } from "./lists/entity-list-section.js";
-export { SummaryMetricGrid } from "./lists/summary-metric-grid.js";
-export type { SummaryMetric, SummaryMetricGridActionPosition, SummaryMetricGridColumns, SummaryMetricGridProps } from "./lists/summary-metric-grid.js";
-export { SettingsHubList } from "./lists/settings-hub-list.js";
-export type { SettingsHubItem, SettingsHubListProps } from "./lists/settings-hub-list.js";
-export { ConfirmActionDialog } from "./forms/confirm-action-dialog.js";
-export type { ConfirmActionDialogProps, ConfirmActionDialogTone } from "./forms/confirm-action-dialog.js";
-export { FormSurface } from "./forms/form-surface.js";
-export type { FormSurfaceProps } from "./forms/form-surface.js";
-export { IntegrationStatusCard } from "./integrations/integration-status-card.js";
-export type { IntegrationStatusCardProps, IntegrationStatusTone } from "./integrations/integration-status-card.js";
-export { WorkflowStatusCard } from "./workflows/workflow-status-card.js";
-export type { WorkflowStatusCardProps, WorkflowStatusTone } from "./workflows/workflow-status-card.js";
-export { ProcessListPanel } from "./workflows/process-list-panel.js";
-export type { ProcessListPanelItem, ProcessListPanelProps } from "./workflows/process-list-panel.js";
-export { ParameterEditor } from "./settings/parameter-editor.js";
-export type { ParameterEditorDensity, ParameterEditorGroup, ParameterEditorProps, ParameterEditorRow } from "./settings/parameter-editor.js";
-export { SettingsSectionStack } from "./settings/settings-section-stack.js";
-export type { SettingsSection, SettingsSectionStackProps } from "./settings/settings-section-stack.js";
-export { ProviderModelSelector } from "./ai/provider-model-selector.js";
-export type { ProviderModelGroup, ProviderModelItem, ProviderModelSelectorProps } from "./ai/provider-model-selector.js";
-export { ConversationDirectory } from "./ai/conversation-directory.js";
-export type { ConversationDirectoryGroup, ConversationDirectoryItem, ConversationDirectoryProps } from "./ai/conversation-directory.js";
-export { StickyComposer } from "./ai/sticky-composer.js";
-export type { StickyComposerProps } from "./ai/sticky-composer.js";
-export { DetailInspectorPanel } from "./detail/detail-inspector-panel.js";
-export type { DetailInspectorPanelProps, DetailInspectorSection } from "./detail/detail-inspector-panel.js";
-export { DataTablePageFrame } from "./data/data-table-page-frame.js";
-export { DataTableControlBar } from "./data/data-table-control-bar.js";
-export { LinkAction } from "./navigation/link-action.js";
-export type { LinkActionProps } from "./navigation/link-action.js";
-export type { DataTableControlBarProps } from "./data/data-table-control-bar.js";
-export type { DataTablePageFrameProps } from "./data/data-table-page-frame.js";
+export * from "./domains/activity.js";
+export * from "./domains/shell.js";
+export * from "./domains/navigation.js";
+export * from "./domains/state.js";
+export * from "./domains/data.js";
+export * from "./domains/forms.js";
+export * from "./domains/workflow.js";
+export * from "./domains/settings.js";
+export * from "./domains/ai.js";
+export * from "./domains/detail.js";

package/dist/index.js

@@ -1,28 +1,10 @@
-export { ActivityFeed } from "./activity/activity-feed.js";
-export { PageScaffold } from "./layout/page-scaffold.js";
-export { FeatureShell } from "./layout/feature-shell.js";
-export { AppWorkspaceShell } from "./navigation/app-workspace-shell.js";
-export { CommandPaletteShell } from "./navigation/command-palette-shell.js";
-export { EntitySwitcherMenu } from "./navigation/entity-switcher-menu.js";
-export { BreadcrumbPageHeader, WorkspaceHeader } from "./navigation/workspace-header.js";
-export { SectionedWorkspaceShell } from "./navigation/sectioned-workspace-shell.js";
-export { StateSurface } from "./state/state-surface.js";
-export { RouteStateFrame } from "./state/route-state-frame.js";
-export { EntityCard } from "./lists/entity-card.js";
-export { EntityListSection } from "./lists/entity-list-section.js";
-export { SummaryMetricGrid } from "./lists/summary-metric-grid.js";
-export { SettingsHubList } from "./lists/settings-hub-list.js";
-export { ConfirmActionDialog } from "./forms/confirm-action-dialog.js";
-export { FormSurface } from "./forms/form-surface.js";
-export { IntegrationStatusCard } from "./integrations/integration-status-card.js";
-export { WorkflowStatusCard } from "./workflows/workflow-status-card.js";
-export { ProcessListPanel } from "./workflows/process-list-panel.js";
-export { ParameterEditor } from "./settings/parameter-editor.js";
-export { SettingsSectionStack } from "./settings/settings-section-stack.js";
-export { ProviderModelSelector } from "./ai/provider-model-selector.js";
-export { ConversationDirectory } from "./ai/conversation-directory.js";
-export { StickyComposer } from "./ai/sticky-composer.js";
-export { DetailInspectorPanel } from "./detail/detail-inspector-panel.js";
-export { DataTablePageFrame } from "./data/data-table-page-frame.js";
-export { DataTableControlBar } from "./data/data-table-control-bar.js";
-export { LinkAction } from "./navigation/link-action.js";
+export * from "./domains/activity.js";
+export * from "./domains/shell.js";
+export * from "./domains/navigation.js";
+export * from "./domains/state.js";
+export * from "./domains/data.js";
+export * from "./domains/forms.js";
+export * from "./domains/workflow.js";
+export * from "./domains/settings.js";
+export * from "./domains/ai.js";
+export * from "./domains/detail.js";

package/dist/styles.css

@@ -251,26 +251,6 @@
 }
 
 
-/* src/layout/feature-shell.css */
-@layer zvk-composite-components {
-  :where(.zvk-composite-feature-shell) {
-    container-type: inline-size;
-    min-inline-size: 0;
-    width: 100%;
-  }
-
-  @container (max-width: 36rem) {
-    :where(.zvk-composite-feature-shell .zvk-composite-workspace-header) {
-      grid-template-columns: minmax(0, 1fr);
-    }
-
-    :where(.zvk-composite-feature-shell .zvk-composite-workspace-header__controls) {
-      justify-content: start;
-    }
-  }
-}
-
-
 /* src/navigation/app-workspace-shell.css */
 @layer zvk-composite-components {
   :where(.zvk-composite-app-workspace-shell) {
@@ -923,6 +903,26 @@
 }
 
 
+/* src/layout/feature-shell.css */
+@layer zvk-composite-components {
+  :where(.zvk-composite-feature-shell) {
+    container-type: inline-size;
+    min-inline-size: 0;
+    width: 100%;
+  }
+
+  @container (max-width: 36rem) {
+    :where(.zvk-composite-feature-shell .zvk-composite-workspace-header) {
+      grid-template-columns: minmax(0, 1fr);
+    }
+
+    :where(.zvk-composite-feature-shell .zvk-composite-workspace-header__controls) {
+      justify-content: start;
+    }
+  }
+}
+
+
 /* src/navigation/link-action.css */
 @layer zvk-composite-components {
   :where(.zvk-composite-link-action) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zvk/composite",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Drop-in composite React components built from @zvk/ui primitives for product workspaces.",
   "private": false,
   "type": "module",
@@ -197,7 +197,7 @@
     "react-dom": "^19.0.0"
   },
   "dependencies": {
-    "@zvk/ui": "^0.1.9"
+    "@zvk/ui": "^0.1.11"
   },
   "tsd": {
     "directory": "tests/types"