@openmfp/ngx 0.14.7 → 0.14.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openmfp/ngx",
-  "version": "0.14.7",
+  "version": "0.14.9",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/openmfp/webcomponents.git"

package/types/openmfp-ngx.d.ts

@@ -249,15 +249,14 @@ interface DeleteResourceConfirmationConfig {
     cancelLabel?: string;
 }
 /**
- * One entry in the {@link TableCardConfig.filterTabs} strip rendered above the
- * table. Clicking a tab activates that filter; the host receives the selected
- * definition via the `filterTabChanged` output and is responsible for applying
- * the filter to its data set.
+ * One entry in the {@link TableCardSearchConfig.filterTabs} strip rendered
+ * above the table. Clicking a tab activates that filter; the host receives the
+ * selected definition via the `filterTabChanged` output and is responsible for
+ * applying the filter to its data set.
  *
  * The strip renders exactly the array of `FieldFilterDefinition` it receives
  * — no extra "All" / no-filter tab is auto-added. If the host wants such an
- * option it must author it as a regular filter entry (e.g.
- * `{ label: 'All', property: '<some-field>', value: '*' }`).
+ * option it must author it as a regular filter entry.
  */
 interface FieldFilterDefinition {
     /** Visible label rendered as the tab text. */
@@ -294,6 +293,37 @@ interface TableCardButtonSettings {
     /** Partial override for the per-row "Delete" button. */
     deleteButton?: Partial<ButtonSettings>;
 }
+/**
+ * Groups all search/filter concerns for `<mfp-declarative-table-card>`. Passing
+ * this object opts the card into showing the search input and (if `filterTabs`
+ * is set) the filter-tab strip. Omit the whole object to hide both.
+ *
+ * `initialSearch` and `initialFilter` are **one-shot seeds** — read once when
+ * the card mounts (or when they first appear) and never re-applied afterwards.
+ * User-driven updates continue to flow through the `searchChanged` and
+ * `filterTabChanged` outputs; the host is expected to keep its own state.
+ */
+interface TableCardSearchConfig {
+    /**
+     * One-shot seed for the search input. Applied to the internal `searchControl`
+     * on first render (or the first time `searchConfig` appears), without
+     * emitting `searchChanged`. Later changes to this value have no effect.
+     */
+    initialSearch?: string;
+    /**
+     * Predefined filters rendered as a horizontal tab strip above the table.
+     * Omit (or pass an empty array) to hide the strip while keeping the search
+     * input visible.
+     */
+    filterTabs?: FieldFilterDefinition[];
+    /**
+     * One-shot seed for the initially selected filter tab. Must match a
+     * `filterTabs` entry by `property`+`value` to take effect. When set, this
+     * takes precedence over any `default: true` flag on filter entries.
+     * User-driven tab changes afterwards flow through `filterTabChanged`.
+     */
+    initialFilter?: FieldFilterDefinition;
+}
 /** Top-level configuration for `<mfp-declarative-table-card>`. */
 interface TableCardConfig {
     /** Card heading. */
@@ -304,19 +334,18 @@ interface TableCardConfig {
     tableConfig: TableConfig;
     /** Overrides for built-in toolbar and row-action buttons. */
     buttonSettings?: TableCardButtonSettings;
-    /** When `true`, shows the search input and button in the card toolbar. */
-    resourcesSearchable?: boolean;
+    /**
+     * Search-and-filter configuration. When present, the card shows the search
+     * input in the toolbar. Its `filterTabs` (if any) render as a strip above
+     * the table. Omit the whole object to hide the search UI and filter strip.
+     */
+    searchConfig?: TableCardSearchConfig;
     /** When set, enables the "Create" button and create dialog. */
     createResourceFormConfig?: ResourceFormConfig;
     /** When set, enables per-row "Edit" button and edit dialog. */
     editResourceFormConfig?: ResourceFormConfig;
     /** When set, enables per-row "Delete" button and confirmation dialog. */
     deleteResourceConfirmationConfig?: DeleteResourceConfirmationConfig;
-    /**
-     * Predefined filters rendered as a horizontal tab strip above the table.
-     * Omit (or pass an empty array) to hide the strip entirely.
-     */
-    filterTabs?: FieldFilterDefinition[];
 }
 
 type SearchState = 'collapsed' | 'expanded' | 'collapsing';
@@ -361,9 +390,9 @@ declare class DeclarativeTableCard<T extends GenericResource> {
     protected searchButtonConfig: _angular_core.Signal<Partial<_openmfp_ngx.ButtonSettings> | undefined>;
     protected effectiveColumns: _angular_core.Signal<TableFieldDefinition[]>;
     protected editInitialValue: _angular_core.Signal<Record<string, unknown>>;
-    /** Filter-tab definitions for the strip rendered above the table. */
+    protected searchConfig: _angular_core.Signal<_openmfp_ngx.TableCardSearchConfig | undefined>;
+    protected resourcesSearchable: _angular_core.Signal<boolean>;
     protected filterTabs: _angular_core.Signal<FieldFilterDefinition[]>;
-    /** Whether the tab strip should render at all. */
     protected hasFilterTabs: _angular_core.Signal<boolean>;
     private readonly injector;
     constructor();
@@ -1296,4 +1325,4 @@ declare class WhatsNew {
 }
 
 export { BooleanValue, CARD_TYPES, Dashboard, DeclarativeForm, DeclarativeTable, DeclarativeTableCard, Favorites, LinkValue, ResourceField, SecretValue, ServiceStatusCard, TagListValue, VisitedServiceCard, WhatsNew };
-export type { ButtonSettings, CardConfig, CardsType, CssRule, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FieldFilterDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, MountCfg, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, RuleCondition, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableConfig, TableFieldDefinition, TransformType, UiSettings, ValueRule };
+export type { ButtonSettings, CardConfig, CardsType, CssRule, DashboardButtonsSettings, DashboardConfig, DeleteResourceConfirmationConfig, FieldDefinition, FieldFilterDefinition, FormFieldChangeEvent, FormFieldDefinition, FormFieldErrors, GenericResource, IconDesignType, ModalSettings, MountCfg, PropertyField, ResourceFieldButtonClickEvent, ResourceFormConfig, RuleCondition, SectionConfig, ServiceStatusItem, ServiceStatusValue, TableCardButtonSettings, TableCardConfig, TableCardFormState, TableCardSearchConfig, TableConfig, TableFieldDefinition, TransformType, UiSettings, ValueRule };