Conversation
- docs/integrations/i18n.md — explains the library's prop-based
translation strategy (i18n-agnostic, no internal l10n calls),
covers @nextcloud/l10n setup, l10n JSON file format, recommended
i18n.js composable pattern, and a full per-component translatable
props reference table
- docs/architecture/customization.md — covers all slot-based
extension points for CnIndexPage: row action menu (actions prop
+ #row-actions slot), Actions dropdown (#action-items), mass
actions (#mass-actions), header buttons (#header-actions), custom
cell renderers (#column-{key}), form field overrides
(#field-{key} / #before-fields / #after-fields), dialog
replacements (#form-dialog / #delete-dialog), and composing
sub-components directly
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Add documentation for every undocumented or partially-documented customisation point found in the component analysis: - Props reference tables (page header, layout, mass actions, columns, form fields) — covers show-title, icon, description, row-key, row-class, inline-action-count, show-view-toggle, add-label, show-mass-*, mass-action-name-field, export-formats, import-options - Events reference table listing all 17 emitted events - Card view customisation — #card, #card-badges, #card-actions slots and view-mode / show-view-toggle props - Dynamic row styling via row-class prop with CSS example - Two-phase dialog pattern — explain confirm → async work → setResult flow; document all 7 setXResult() methods and setValidationErrors() - Programmatic dialog control via openFormDialog(null|row) - Import dialog #import-fields slot with file scope variable - Sidebar #search-extra and #columns-extra slot examples - Inline-action-count examples (controlling overflow behaviour) - CnDataTable and CnPagination direct-composition props tables including scrollable, page-size-options, min-items-to-show, page-info-format, and row-class on CnDataTable Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
- New prop `defaultTab` (default: 'search-tab') — sets the active tab
when the sidebar first opens. Accepts any NcAppSidebarTab id, both
built-in ('search-tab', 'columns-tab') and custom.
- New slot `#tabs` — consumers inject additional NcAppSidebarTab
components; use order ≥ 3 to place them after the built-ins.
- New event `tab-change` — emitted with the tab id whenever the user
switches tabs, allowing the parent to persist the choice.
- Binds NcAppSidebar's :active prop and @update:active to track the
currently open tab internally.
- Update cn-index-sidebar.md props/events/slots tables.
- Update customization.md with sidebar tabs section (default-tab,
custom tabs via #tabs slot, per-tab content via #search-extra /
#columns-extra).
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Adds css/index.css at the package root so consumers can import '@conduction/nextcloud-vue/css/index.css' when installed via npm. Previously only src/css/index.css existed, causing ESLint import/no-unresolved failures in procest and pipelinq CI. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ore integration
Adds a new string-first API to both composables that connects directly to
useObjectStore, eliminating ~150 LOC of boilerplate from every list view
and ~80 LOC from every detail view.
useListView(objectType, options?):
- Accepts objectType string + options: { sidebarState, defaultPageSize,
defaultSort, debounceMs }
- Returns schema, objects, loading, pagination as computed refs from the
store, plus onSearch (debounced), onSort, onFilterChange, onPageChange,
onPageSizeChange, refresh
- Handles fetchSchema, fetchCollection, sidebar wiring, and cleanup
automatically in onMounted / onBeforeUnmount
- Backward compatible: existing useListView(options) calls unchanged
useDetailView(objectType, id, options?):
- Accepts objectType + id (string or Ref) + options: { router,
listRouteName, detailRouteName }
- Returns object, isNew, loading, saving, editing, showDeleteDialog,
error, validationErrors, onSave, confirmDelete
- Handles fetch on mount, id-change watcher, create/update/delete with
optional router navigation and 422 validation error unpacking
- Backward compatible: existing useDetailView(options) calls unchanged
Also rewrites the composables documentation to reflect the new API.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…and-code fixed store to use baseUrl + updated docs to show defaults
- fetch tags - delete multiple objects by type and id
Add `userIsAdmin` prop to CnIndexSidebar and CnFacetSidebar, and extend `filtersFromSchema()` with `isAdmin` and `filterFn` options. Schema properties with `adminOnly: true` are now hidden from non-admin users, enabling role-based filter visibility without consumer-side logic. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Create .gitattributes
I also added a extra slot to be able to more accurately reproduce the original page layout.
todo: - add this as an "add" option in the CnIndexPage - test test test
fixed issues with table not being scrollable
todo: - add this as an "add" option in the CnIndexPage - test test test
…ure/advanced-form
…CnWidgetWrapper, CnWidgetRenderer, CnTileWidget) + useDashboardView composable + simplify filtersFromSchema
CnChartWidget: replace dynamic import with static import for vue-apexcharts. CnIndexPage: route all row-click emissions through onRowClick method.
Implements right-click context menus
Updates the CnDataTable component to cycle through ascending, descending, and no sort (null) when clicking column headers. This allows users to return the table to its unsorted state.
Implement tri-state sorting to allow clearing table sort
- Add t() from @nextcloud/l10n to 16 components with hardcoded strings - Use function defaults () => t(...) so translation resolves at runtime - Props still accept string overrides from consumer apps - Create l10n/en.json (96 keys, identity-mapped) and l10n/nl.json (Dutch) - All keys use sentence case per ADR-007
- Use t() built-in parameter substitution instead of .replace() chains in CnActionsBar countText computed property - Remove duplicate header-actions slot from CnConfigurationCard (actions slot already exists) - Remove duplicate header-actions slot from CnVersionInfoCard (actions slot already exists) - Revert structural changes to CnSettingsCard header
- Add docs/architecture/slots.md with naming conventions for all slot types (header-actions, actions, row-actions, mass-actions, dialog) - Add docs/components/cn-object-data-widget.md - Add docs/components/cn-object-metadata-widget.md Addresses review feedback on PR #66.
Used by decidesk (3 usages), pipelinq (2), and procest (2). This slot passes per-widget action buttons through to CnWidgetWrapper's #header-actions slot. Document the pattern in slots.md.
…ations feat(i18n): add translation support to all shared components
Rename #header-actions → #actions in all components for consistency. Every component now uses #actions for header action buttons. Components updated: CnDashboardPage, CnDetailPage, CnActionsBar, CnWidgetWrapper, CnDetailCard, CnIndexPage, CnObjectDataWidget, CnObjectMetadataWidget. Updated docs/architecture/slots.md to reflect the standard.
…ations refactor: standardize all header action slots to #actions
Added docs check to quality check and added missing docs
Updated package.lock
Development to beta
SudoThijn
approved these changes
Apr 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
No description provided.