react-semaphor 0.1.532 → 0.1.534

package/dist/types/lib/utils/physical-source-identity.d.ts

@@ -1,12 +0,0 @@
-import { SelectedEntity } from '../types/explorer-types.js';
-export type PhysicalEntityIdentityHint = {
-    qualifiedEntityName?: string;
-    entityName?: string;
-    entityId?: string;
-};
-export declare function isPhysicalSelectedEntity(value: unknown): value is SelectedEntity;
-export declare function selectUniquePhysicalEntityByIdentity(input: {
-    entities: readonly unknown[];
-    connectionType: string | undefined;
-    identity: PhysicalEntityIdentityHint;
-}): SelectedEntity | undefined;

package/dist/types/lib/utils/qualified-entity-name.d.ts

@@ -1,2 +0,0 @@
-import { DatabaseEntityReference } from '../types/explorer-types.js';
-export declare function getQualifiedEntityName(target: Pick<DatabaseEntityReference, 'type' | 'database' | 'schema' | 'name'>): string;

package/dist/types/lib/utils/relative-date-description.d.ts

@@ -1,38 +0,0 @@
-import { RelativeDateFilter } from '../../shared/analytics-protocol/relative-date-filter.js';
-import { CalendarContext } from '../../shared/report-runtime-context/index.js';
-import { ResolvedTemporalValueFormatPreferences } from '../../shared/value-format-preferences/index.js';
-export type RelativeDateDescription = {
-    label: string;
-    /** The window as of the calendar's anchor, or null when the browser can't know it. */
-    range: {
-        start: Date;
-        end: Date;
-    } | null;
-};
-export type RelativeDateCalendar = Pick<CalendarContext, 'tz' | 'weekStart' | 'anchor'>;
-export declare const RELATIVE_DATES_FOLLOW_CALENDAR = "Dates follow your calendar each time the card runs.";
-/** A window that counts back from the latest data has no dates the browser can know. */
-export declare const RELATIVE_DATES_FOLLOW_DATA = "Dates count back from the latest data each time the card runs.";
-/** What a latest-value condition reads as (analytics kernel K13). */
-export declare const LATEST_VALUE_LABEL = "Latest value";
-/** Display-only description of a relative date; the server resolves the real window. */
-export declare function describeRelativeDate(relative: RelativeDateFilter, calendar: RelativeDateCalendar): RelativeDateDescription;
-/** What a relative date reads as: its label, and its dates when known. */
-export type RelativeDateSummary = {
-    label: string;
-    /** The current window as the shared date-input presenter writes it. */
-    dates: string | null;
-    /** The current window itself, when `dates` is known. */
-    range: {
-        start: Date;
-        end: Date;
-    } | null;
-};
-/**
- * The label and today's dates of a relative date, written in the viewer's
- * date preferences: the same text a text card shows for a date filter.
- */
-export declare function summarizeRelativeDate(relative: RelativeDateFilter, context: {
-    calendar: RelativeDateCalendar;
-    preferences: ResolvedTemporalValueFormatPreferences;
-}): RelativeDateSummary;

package/dist/types/lib/utils/resolve-selected-sheet-id.d.ts

@@ -1,11 +0,0 @@
-type SheetLike = {
-    id?: string | null;
-};
-type ResolveSelectedSheetIdArgs = {
-    selectedSheetId?: string | null;
-    preservedSelectedSheetId?: string | null;
-    defaultSheetId?: string | null;
-    sheets?: SheetLike[] | null;
-};
-export declare function resolveSelectedSheetId({ selectedSheetId, preservedSelectedSheetId, defaultSheetId, sheets, }: ResolveSelectedSheetIdArgs): string | null;
-export {};

package/dist/types/lib/utils/role-display-mappings.d.ts

@@ -1,44 +0,0 @@
-import { VisualDisplayPreferences } from '../types/common-types.js';
-import { CurrentUser } from '../../components/sharing-and-management/hooks/use-current-user-info.js';
-/**
- * Get role-based display overrides
- * @param user - Current user with role information
- * @returns Display preference overrides based on user role
- */
-export declare function getRoleBasedDisplayOverrides(user: CurrentUser | null): VisualDisplayPreferences['overrides'] | undefined;
-/**
- * Check if user has edit permissions
- * @param user - Current user
- * @returns true if user can edit
- */
-export declare function canUserEdit(user: CurrentUser | null): boolean;
-/**
- * Check if user has filter permissions
- * @param user - Current user
- * @returns true if user can use filters
- */
-export declare function canUserUseFilters(user: CurrentUser | null): boolean;
-/**
- * Check if user can access dashboard management panel
- * @param user - Current user
- * @returns true if user can access dashboard management
- */
-export declare function canUserManageDashboards(user: CurrentUser | null): boolean;
-/**
- * Check if user can create new dashboards
- * @param user - Current user
- * @returns true if user can create dashboards
- */
-export declare function canUserCreateDashboards(user: CurrentUser | null): boolean;
-/**
- * Check if user can access the Visuals tab
- * @param user - Current user
- * @returns true if user can access visuals
- */
-export declare function canUserAccessVisuals(user: CurrentUser | null): boolean;
-/**
- * Check if user can manage groups (create, edit, delete groups)
- * @param user - Current user
- * @returns true if user can manage groups
- */
-export declare function canUserManageGroups(user: CurrentUser | null): boolean;

package/dist/types/lib/utils/semantic-metric-format-defaults.d.ts

@@ -1,3 +0,0 @@
-import { TCardPreferences, TCard } from '../types/common-types.js';
-import { MetricField } from '../types/explorer-types.js';
-export declare function seedSemanticMetricFormatDefaults(card: TCard | undefined, metricField: MetricField, currentPreferences: TCardPreferences | undefined): TCardPreferences | null;

package/dist/types/lib/utils/slot-validation.d.ts

@@ -1,12 +0,0 @@
-import { SlotDefinition } from '../../components/visual/custom-visual/custom-visual-types.js';
-import { TCard } from '../types/common-types.js';
-export type SlotWarning = {
-    type: 'missing-required' | 'wrong-type' | 'too-few-inputs';
-    message: string;
-};
-export declare function getSlotForPosition(slots: SlotDefinition[] | undefined, position: number): SlotDefinition | null;
-export declare function validateSlotConfiguration({ slots, cards, minInputs, }: {
-    slots?: SlotDefinition[];
-    cards: Array<TCard | null>;
-    minInputs?: number;
-}): SlotWarning[];

package/dist/types/lib/utils/stable-serialize.d.ts

@@ -1 +0,0 @@
-export declare function stableSerialize(value: unknown): string;

package/dist/types/lib/utils/summary-eligibility.d.ts

@@ -1,7 +0,0 @@
-import { TCard } from '../types/common-types.js';
-type SummaryTypedCardLike = Pick<TCard, 'config' | 'type'> | null | undefined;
-export declare function isSummarySupportedCardType(cardType: string | undefined): cardType is "kpi";
-export declare function isCardSummaryEnabled(card: SummaryTypedCardLike): boolean;
-export declare function isCardSummaryVisibleOnCard(card: SummaryTypedCardLike): boolean;
-export declare function isCardIncludedInDashboardSummary(card: SummaryTypedCardLike): boolean;
-export {};

package/dist/types/lib/utils/summary-filter-utils.d.ts

@@ -1,2 +0,0 @@
-import { TFilterValue } from '../../components/surfboard/filter/types.js';
-export declare function inferValueTypeFromUnknown(value: unknown): TFilterValue['valueType'];

package/dist/types/lib/utils/table-comparison-utils.d.ts

@@ -1,9 +0,0 @@
-import { MetricField } from '../types/explorer-types.js';
-import { MetricComparisonKind } from './metric-comparison-config.js';
-import { ComparisonMetadataEntry, ComparisonMetadataMap } from '../types/query-types.js';
-export { isInternalComparisonOutputKey } from './comparison-output-keys.js';
-export type TableComparisonKind = MetricComparisonKind;
-export declare function getComparisonSuffix(comparisonKind: TableComparisonKind | undefined): string;
-export declare function getComparisonDataKey(_metricLabel: string, _comparisonKind: TableComparisonKind | undefined, metadata?: ComparisonMetadataEntry): string | undefined;
-export declare function getComparisonLabel(metricLabel: string, _comparisonKind: TableComparisonKind | undefined): string;
-export declare function getComparisonMetadataEntry(comparisonMetadata: ComparisonMetadataMap | undefined, metric: MetricField): ComparisonMetadataEntry | undefined;

package/dist/types/lib/utils/text-card-runtime-utils.d.ts

@@ -1,6 +0,0 @@
-import { TCard } from '../types/common-types.js';
-export declare function hasTextCardStructuredContent(card: TCard | undefined): boolean;
-export declare function hasStaticTextCardContent(card: TCard | undefined): boolean;
-export declare function isQueryBackedTextCard(card: TCard | undefined): boolean;
-export declare function shouldRenderTextCardDynamically(card: TCard | undefined): boolean;
-export declare function shouldPreserveQueryBackedTextCardOnStandardSave(card: TCard | undefined): boolean;

package/dist/types/lib/utils/url-parameter-utils.d.ts

@@ -1,60 +0,0 @@
-import { Field } from '../types/explorer-types.js';
-import { URLParameter } from '../types/interaction-types.js';
-/**
- * Converts available fields to attribute parameters
- * Only includes groupBy and pivotBy fields (dimensions), excludes metrics
- *
- * @param fields - Available attributes from card
- * @returns Array of URLParameter objects for attributes
- */
-export declare function fieldsToAttributeParameters(fields: Field[]): URLParameter[];
-/**
- * Gets the fixed list of identifier parameters
- *
- * @returns Array of URLParameter objects for system identifiers
- */
-export declare function getIdentifierParameters(): URLParameter[];
-/**
- * Checks if a parameter is currently used in the URL template
- *
- * @param urlTemplate - The URL template string
- * @param parameterId - The parameter ID to check
- * @returns True if parameter is present in template
- */
-export declare function isParameterUsed(urlTemplate: string, parameterId: string): boolean;
-/**
- * Gets all parameters currently used in a URL template
- *
- * @param urlTemplate - The URL template string
- * @param availableParameters - All available parameters
- * @returns Array of parameters that are used in the template
- */
-export declare function getUsedParameters(urlTemplate: string, availableParameters: URLParameter[]): URLParameter[];
-/**
- * Inserts a parameter placeholder at a specific position in the URL
- *
- * @param urlTemplate - Current URL template
- * @param parameterId - ID of parameter to insert
- * @param cursorPosition - Position in string to insert at
- * @returns Updated URL template and new cursor position
- */
-export declare function insertParameterAtCursor(urlTemplate: string, parameterId: string, cursorPosition: number): {
-    newTemplate: string;
-    newCursorPosition: number;
-};
-/**
- * Formats a parameter for display (with icon)
- *
- * @param param - Parameter to format
- * @returns Display string with appropriate icon
- */
-export declare function formatParameterDisplay(param: URLParameter): string;
-/**
- * Generates a preview URL with mock data
- * Useful for showing users what the final URL will look like
- *
- * @param urlTemplate - The URL template
- * @param parameters - Parameters used in template
- * @returns Preview URL with sample values
- */
-export declare function generatePreviewURL(urlTemplate: string, parameters: URLParameter[]): string;

package/dist/types/lib/utils/window-transform-utils.d.ts

@@ -1,41 +0,0 @@
-import { CardConfig, GroupByField, MetricField, WindowTransform } from '../types/explorer-types.js';
-import { TChartType } from '../charts/types.js';
-export type MetricTransformMode = 'running_total' | 'moving_average' | 'previous_period_delta' | 'percent_of_total';
-export declare function isMetricTransformEnabled(metric: MetricField, mode?: MetricTransformMode): boolean;
-export declare function isRunningTotalEnabled(metric: MetricField): boolean;
-export declare function isSubtotalEnabledAggregateTable(cardType: TChartType, cardConfig: CardConfig): boolean;
-export declare function supportsMetricTransformForMetric({ cardType, cardConfig, metric, transformMode, }: {
-    cardType: TChartType;
-    cardConfig: CardConfig;
-    metric: MetricField;
-    transformMode: MetricTransformMode;
-}): {
-    supported: boolean;
-    reason?: string;
-};
-export declare function supportsRunningTotalForMetric({ cardType, cardConfig, metric, }: {
-    cardType: TChartType;
-    cardConfig: CardConfig;
-    metric: MetricField;
-}): {
-    supported: boolean;
-    reason?: string;
-};
-export declare function getDefaultRunningTotalOrderByField(groupByColumns: GroupByField[]): GroupByField | undefined;
-export declare function getRunningTotalOrderByCandidates(groupByColumns: GroupByField[]): GroupByField[];
-export declare function getDefaultRunningTotalPartitionByFieldIds({ cardType, cardConfig, orderByFieldId, }: {
-    cardType: TChartType;
-    cardConfig: CardConfig;
-    orderByFieldId?: string;
-}): string[];
-export declare function buildDefaultWindowTransform({ transformMode, cardType, cardConfig, fallbackOrderByFieldId, }: {
-    transformMode: MetricTransformMode;
-    cardType: TChartType;
-    cardConfig: CardConfig;
-    fallbackOrderByFieldId?: string;
-}): WindowTransform;
-export declare function buildDefaultRunningTotalTransform({ cardType, cardConfig, fallbackOrderByFieldId, }: {
-    cardType: TChartType;
-    cardConfig: CardConfig;
-    fallbackOrderByFieldId?: string;
-}): WindowTransform;

package/dist/types/lib/visuals/frame-object.d.ts

@@ -1,4 +0,0 @@
-import { TCard, TFrame } from '../types/common-types.js';
-export declare function parseFrameObject(frameObject: unknown): TFrame | null;
-export declare function getActiveFrameCard(frame: TFrame | null): TCard | null;
-export declare function getActiveCardFromVisualResource(visualData: unknown): TCard | null;

package/dist/types/shared/analytics-protocol/qualified-identity.d.ts

@@ -1,3 +0,0 @@
-export declare function qualifiedEntityIdentitiesReferToSameEntity(first: string, second: string): boolean;
-export declare function qualifiedFieldIdentitiesReferToSameField(first: string, second: string): boolean;
-export declare function selectMostQualifiedCompatibleEntityIdentity(identities: string[]): string | undefined;

package/dist/types/shared/dashboard-authoring/filter-defaults.d.ts

@@ -1,2 +0,0 @@
-import { TFilter, TFilterValue } from '../../components/surfboard/filter/types.js';
-export declare function createDashboardPlanFilterDefaultValue(filter: TFilter, defaultValue: unknown): TFilterValue | undefined;

package/dist/types/shared/filter-native-data-type.d.ts

@@ -1,59 +0,0 @@
-type NativeDataTypeFieldMeta = {
-    name?: string;
-    qualifiedFieldName?: string;
-    nativeDataType?: string;
-};
-type NativeDataTypeCarrier = {
-    nativeDataType?: string;
-    fieldMeta?: NativeDataTypeFieldMeta;
-};
-export type NativeDataTypeDefinition = NativeDataTypeCarrier & {
-    column: string;
-};
-type NativeDataTypeValue = NativeDataTypeCarrier & {
-    name: string;
-};
-type NativeDataTypeFilterDefinition = NativeDataTypeDefinition & {
-    id: string;
-};
-type NativeDataTypeFilterValue = NativeDataTypeValue & {
-    filterId: string;
-};
-/**
- * Resolves exact database type metadata for one filter field without falling
- * back to normalized analytics/UI datatypes. Metadata is eligible only when
- * its carrier names the field being materialized; the authored definition is
- * authoritative over a matching runtime value.
- */
-export declare function resolveFilterFieldNativeDataType({ fieldName, definition, value, }: {
-    fieldName: string;
-    definition?: NativeDataTypeDefinition;
-    value?: NativeDataTypeValue;
-}): string | undefined;
-/**
- * Materializes one coherent native-type projection on a runtime filter value.
- * The top-level value is canonical transport metadata; when field metadata is
- * present, its native type is kept in sync for historical consumers.
- */
-export declare function materializeFilterValueNativeDataType<TFilterValueShape extends NativeDataTypeValue>({ definition, value, sourceValue, }: {
-    definition?: NativeDataTypeDefinition;
-    value: TFilterValueShape;
-    sourceValue?: NativeDataTypeValue;
-}): TFilterValueShape;
-/**
- * Reconciles runtime filter values with their authored definitions at any
- * execution or hydration seam. Values without a matching definition remain
- * untouched, while matching values cross the same single-value materializer
- * used by interactive and Dashboard Input paths.
- */
-export declare function materializeFilterValuesNativeDataType<TFilterDefinitionShape extends NativeDataTypeFilterDefinition, TFilterValueShape extends NativeDataTypeFilterValue>({ filterDefinitions, filterValues, }: {
-    filterDefinitions: readonly TFilterDefinitionShape[] | undefined;
-    filterValues: TFilterValueShape[];
-}): TFilterValueShape[];
-/**
- * Projects one coherent exact-type view for a filter definition before it
- * crosses a transport or query-identity Adapter. Ineligible nested metadata is
- * removed without discarding unrelated field metadata.
- */
-export declare function materializeFilterDefinitionNativeDataType<TDefinitionShape extends NativeDataTypeDefinition>(definition: TDefinitionShape): TDefinitionShape;
-export {};

package/dist/types/shared/format-utils/formatters/exact-number.d.ts

@@ -1 +0,0 @@
-export declare function formatExactDecimal(value: string, format: Intl.NumberFormat): string;

package/dist/types/shared/format-utils/json-record.d.ts

@@ -1,6 +0,0 @@
-/**
- * Accepts ordinary JSON object records, including records constructed in a
- * different JavaScript realm. Transport parsers must not compare a foreign
- * realm's Object.prototype by identity.
- */
-export declare function isPlainJsonRecord(value: unknown): value is Record<string, unknown>;