@questpie/admin 1.1.1 → 2.0.0

package/dist/client/builder/admin-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-builder.mjs","names":["state: TState","listViews: Record<string, any>","editViews: Record<string, any>"],"sources":["../../../src/client/builder/admin-builder.ts"],"sourcesContent":["/**\n * Admin Builder\n *\n * Main builder class - same pattern as QuestpieBuilder.\n * Single generic TState pattern.\n */\n\nimport {\n\tDEFAULT_LOCALE_CONFIG,\n\ttype Prettify,\n\ttype SetProperty,\n\ttype TypeMerge,\n\ttype UnsetProperty,\n} from \"questpie/shared\";\nimport type {\n\tAdminBuilderState,\n\tFilterEditViews,\n\tFilterListViews,\n} from \"./admin-types\";\nimport { type PageBuilder, page } from \"./page/page\";\nimport type { MaybeLazyComponent } from \"./types/common\";\nimport type { DefaultViewsConfig } from \"./types/views\";\nimport { type WidgetBuilder, widget } from \"./widget/widget\";\n\nexport class AdminBuilder<TState extends AdminBuilderState> {\n\tconstructor(public readonly state: TState) {}\n\n\tstatic empty<TApp = any>(): AdminBuilder<{\n\t\t\"~app\": TApp;\n\t\tfields: {};\n\t\tcomponents: {};\n\t\tlistViews: {};\n\t\teditViews: {};\n\t\tpages: {};\n\t\twidgets: {};\n\t\tblocks: {};\n\t\ttranslations: {};\n\t\tlocale: { default: string; supported: string[] };\n\t\tdefaultViews: {};\n\t}> {\n\t\treturn new AdminBuilder({\n\t\t\t\"~app\": undefined as TApp,\n\t\t\tfields: {},\n\t\t\tcomponents: {},\n\t\t\tlistViews: {},\n\t\t\teditViews: {},\n\t\t\tpages: {},\n\t\t\twidgets: {},\n\t\t\tblocks: {},\n\t\t\ttranslations: {},\n\t\t\tlocale: DEFAULT_LOCALE_CONFIG,\n\t\t\tdefaultViews: {},\n\t\t});\n\t}\n\n\t/**\n\t * Register field definitions\n\t */\n\tfields<TNewFields extends Record<string, any>>(\n\t\tfields: TNewFields,\n\t): AdminBuilder<\n\t\tSetProperty<\n\t\t\tTState,\n\t\t\t\"fields\",\n\t\t\tPrettify<TypeMerge<TState[\"fields\"], TNewFields>>\n\t\t>\n\t> {\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\tfields: {\n\t\t\t\t...this.state.fields,\n\t\t\t\t...fields,\n\t\t\t},\n\t\t} as any);\n\t}\n\n\t/**\n\t * Register component implementations\n\t */\n\tcomponents<TNewComponents extends Record<string, any>>(\n\t\tcomponents: TNewComponents,\n\t): AdminBuilder<\n\t\tSetProperty<\n\t\t\tTState,\n\t\t\t\"components\",\n\t\t\tPrettify<TypeMerge<TState[\"components\"], TNewComponents>>\n\t\t>\n\t> {\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\tcomponents: {\n\t\t\t\t...this.state.components,\n\t\t\t\t...components,\n\t\t\t},\n\t\t} as any);\n\t}\n\n\t/**\n\t * Register view definitions (auto-sorted by kind)\n\t */\n\tviews<TNewViews extends Record<string, any>>(\n\t\tviews: TNewViews,\n\t): AdminBuilder<\n\t\tPrettify<\n\t\t\tTypeMerge<\n\t\t\t\tUnsetProperty<TState, \"listViews\" | \"editViews\">,\n\t\t\t\t{\n\t\t\t\t\tlistViews: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"listViews\"], FilterListViews<TNewViews>>\n\t\t\t\t\t>;\n\t\t\t\t\teditViews: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"editViews\"], FilterEditViews<TNewViews>>\n\t\t\t\t\t>;\n\t\t\t\t}\n\t\t\t>\n\t\t>\n\t> {\n\t\tconst listViews: Record<string, any> = {};\n\t\tconst editViews: Record<string, any> = {};\n\n\t\tfor (const [name, def] of Object.entries(views)) {\n\t\t\t// ViewBuilders now implement Definition interface, so kind is directly accessible\n\t\t\tconst kind = (def as any).kind;\n\t\t\tif (kind === \"list\") {\n\t\t\t\tlistViews[name] = def;\n\t\t\t} else if (kind === \"edit\") {\n\t\t\t\teditViews[name] = def;\n\t\t\t}\n\t\t}\n\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\tlistViews: { ...this.state.listViews, ...listViews },\n\t\t\teditViews: { ...this.state.editViews, ...editViews },\n\t\t} as any);\n\t}\n\n\t/**\n\t * Register widget definitions\n\t */\n\twidgets<TNewWidgets extends Record<string, any>>(\n\t\twidgets: TNewWidgets,\n\t): AdminBuilder<\n\t\tSetProperty<\n\t\t\tTState,\n\t\t\t\"widgets\",\n\t\t\tPrettify<TypeMerge<TState[\"widgets\"], TNewWidgets>>\n\t\t>\n\t> {\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\twidgets: {\n\t\t\t\t...this.state.widgets,\n\t\t\t\t...widgets,\n\t\t\t},\n\t\t} as any);\n\t}\n\n\t/**\n\t * Register page definitions\n\t */\n\tpages<TNewPages extends Record<string, any>>(\n\t\tpages: TNewPages,\n\t): AdminBuilder<\n\t\tSetProperty<\n\t\t\tTState,\n\t\t\t\"pages\",\n\t\t\tPrettify<TypeMerge<TState[\"pages\"], TNewPages>>\n\t\t>\n\t> {\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\tpages: {\n\t\t\t\t...this.state.pages,\n\t\t\t\t...pages,\n\t\t\t},\n\t\t} as any);\n\t}\n\n\t/**\n\t * Compose another builder (merge modules)\n\t */\n\tuse<TOther extends AdminBuilder<any>>(\n\t\tother: TOther,\n\t): AdminBuilder<\n\t\tPrettify<\n\t\t\tTypeMerge<\n\t\t\t\tUnsetProperty<\n\t\t\t\t\tTState,\n\t\t\t\t\t| \"fields\"\n\t\t\t\t\t| \"listViews\"\n\t\t\t\t\t| \"editViews\"\n\t\t\t\t\t| \"widgets\"\n\t\t\t\t\t| \"pages\"\n\t\t\t\t\t| \"components\"\n\t\t\t\t>,\n\t\t\t\t{\n\t\t\t\t\tfields: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"fields\"], TOther[\"state\"][\"fields\"]>\n\t\t\t\t\t>;\n\t\t\t\t\tlistViews: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"listViews\"], TOther[\"state\"][\"listViews\"]>\n\t\t\t\t\t>;\n\t\t\t\t\teditViews: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"editViews\"], TOther[\"state\"][\"editViews\"]>\n\t\t\t\t\t>;\n\t\t\t\t\twidgets: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"widgets\"], TOther[\"state\"][\"widgets\"]>\n\t\t\t\t\t>;\n\t\t\t\t\tpages: Prettify<TypeMerge<TState[\"pages\"], TOther[\"state\"][\"pages\"]>>;\n\t\t\t\t\tcomponents: Prettify<\n\t\t\t\t\t\tTypeMerge<TState[\"components\"], TOther[\"state\"][\"components\"]>\n\t\t\t\t\t>;\n\t\t\t\t}\n\t\t\t>\n\t\t>\n\t> {\n\t\tconst otherState = (other as any).state;\n\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\tfields: { ...this.state.fields, ...otherState.fields },\n\t\t\tlistViews: { ...this.state.listViews, ...otherState.listViews },\n\t\t\teditViews: { ...this.state.editViews, ...otherState.editViews },\n\t\t\twidgets: { ...this.state.widgets, ...otherState.widgets },\n\t\t\tpages: { ...this.state.pages, ...otherState.pages },\n\t\t\tcomponents: { ...this.state.components, ...otherState.components },\n\t\t} as any);\n\t}\n\n\t/**\n\t * Set default views config\n\t */\n\tdefaultViews<TDefaultViews extends DefaultViewsConfig>(\n\t\tconfig: TDefaultViews,\n\t): AdminBuilder<\n\t\tSetProperty<\n\t\t\tTState,\n\t\t\t\"defaultViews\",\n\t\t\tPrettify<TypeMerge<TState[\"defaultViews\"], TDefaultViews>>\n\t\t>\n\t> {\n\t\treturn new AdminBuilder({\n\t\t\t...this.state,\n\t\t\tdefaultViews: {\n\t\t\t\t...(this.state.defaultViews || {}),\n\t\t\t\t...config,\n\t\t\t},\n\t\t} as any);\n\t}\n\n\t/**\n\t * Create a page definition\n\t *\n\t * Creates a custom admin page outside of collections/globals.\n\t *\n\t * @example\n\t * ```ts\n\t * const builder = qa<AppCMS>().use(adminModule);\n\t *\n\t * const analyticsPage = builder.page(\"analytics\", {\n\t *   component: AnalyticsPage,\n\t * })\n\t * ```\n\t */\n\tpage<TName extends string, TComponent extends MaybeLazyComponent>(\n\t\tname: TName,\n\t\tconfig: { component: TComponent },\n\t): PageBuilder<{\n\t\tname: TName;\n\t\tcomponent: TComponent;\n\t\tpath: undefined;\n\t}> {\n\t\treturn page(name, config);\n\t}\n\n\t/**\n\t * Create a widget definition\n\t *\n\t * Creates a dashboard widget.\n\t *\n\t * @example\n\t * ```ts\n\t * const builder = qa<AppCMS>().use(adminModule);\n\t *\n\t * const statsWidget = builder.widget(\"stats\", {\n\t *   component: StatsWidget,\n\t * })\n\t * ```\n\t */\n\twidget<TName extends string, TComponent extends MaybeLazyComponent>(\n\t\tname: TName,\n\t\tconfig: { component: TComponent },\n\t): WidgetBuilder<{\n\t\tname: TName;\n\t\t\"~config\": any;\n\t\tcomponent: TComponent;\n\t}> {\n\t\treturn widget(name, config);\n\t}\n}\n"],"mappings":";;;;;;;;;;;AAwBA,IAAa,eAAb,MAAa,aAA+C;CAC3D,YAAY,AAAgBA,OAAe;EAAf;;CAE5B,OAAO,QAYJ;AACF,SAAO,IAAI,aAAa;GACvB,QAAQ;GACR,QAAQ,EAAE;GACV,YAAY,EAAE;GACd,WAAW,EAAE;GACb,WAAW,EAAE;GACb,OAAO,EAAE;GACT,SAAS,EAAE;GACX,QAAQ,EAAE;GACV,cAAc,EAAE;GAChB,QAAQ;GACR,cAAc,EAAE;GAChB,CAAC;;;;;CAMH,OACC,QAOC;AACD,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,QAAQ;IACP,GAAG,KAAK,MAAM;IACd,GAAG;IACH;GACD,CAAQ;;;;;CAMV,WACC,YAOC;AACD,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,YAAY;IACX,GAAG,KAAK,MAAM;IACd,GAAG;IACH;GACD,CAAQ;;;;;CAMV,MACC,OAeC;EACD,MAAMC,YAAiC,EAAE;EACzC,MAAMC,YAAiC,EAAE;AAEzC,OAAK,MAAM,CAAC,MAAM,QAAQ,OAAO,QAAQ,MAAM,EAAE;GAEhD,MAAM,OAAQ,IAAY;AAC1B,OAAI,SAAS,OACZ,WAAU,QAAQ;YACR,SAAS,OACnB,WAAU,QAAQ;;AAIpB,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,WAAW;IAAE,GAAG,KAAK,MAAM;IAAW,GAAG;IAAW;GACpD,WAAW;IAAE,GAAG,KAAK,MAAM;IAAW,GAAG;IAAW;GACpD,CAAQ;;;;;CAMV,QACC,SAOC;AACD,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,SAAS;IACR,GAAG,KAAK,MAAM;IACd,GAAG;IACH;GACD,CAAQ;;;;;CAMV,MACC,OAOC;AACD,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,OAAO;IACN,GAAG,KAAK,MAAM;IACd,GAAG;IACH;GACD,CAAQ;;;;;CAMV,IACC,OAiCC;EACD,MAAM,aAAc,MAAc;AAElC,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,QAAQ;IAAE,GAAG,KAAK,MAAM;IAAQ,GAAG,WAAW;IAAQ;GACtD,WAAW;IAAE,GAAG,KAAK,MAAM;IAAW,GAAG,WAAW;IAAW;GAC/D,WAAW;IAAE,GAAG,KAAK,MAAM;IAAW,GAAG,WAAW;IAAW;GAC/D,SAAS;IAAE,GAAG,KAAK,MAAM;IAAS,GAAG,WAAW;IAAS;GACzD,OAAO;IAAE,GAAG,KAAK,MAAM;IAAO,GAAG,WAAW;IAAO;GACnD,YAAY;IAAE,GAAG,KAAK,MAAM;IAAY,GAAG,WAAW;IAAY;GAClE,CAAQ;;;;;CAMV,aACC,QAOC;AACD,SAAO,IAAI,aAAa;GACvB,GAAG,KAAK;GACR,cAAc;IACb,GAAI,KAAK,MAAM,gBAAgB,EAAE;IACjC,GAAG;IACH;GACD,CAAQ;;;;;;;;;;;;;;;;CAiBV,KACC,MACA,QAKE;AACF,SAAO,KAAK,MAAM,OAAO;;;;;;;;;;;;;;;;CAiB1B,OACC,MACA,QAKE;AACF,SAAO,OAAO,MAAM,OAAO"}

package/dist/client/builder/admin-types.d.mts

@@ -0,0 +1,73 @@
+import { SimpleMessages } from "../i18n/simple.mjs";
+import { MaybeLazyComponent } from "./types/common.mjs";
+import { FieldDefinition } from "./field/field.mjs";
+import { PageDefinition } from "./page/page.mjs";
+import { LocaleConfig } from "./types/ui-config.mjs";
+import { DefaultViewsConfig } from "./types/views.mjs";
+import { EditViewDefinition, ListViewDefinition } from "./view/view.mjs";
+import { WidgetDefinition } from "./widget/widget.mjs";
+
+//#region src/client/builder/admin-types.d.ts
+
+/**
+ * Translations map: locale -> key -> message
+ */
+type TranslationsMap = Record<string, SimpleMessages>;
+type FieldDefinitionMap = Record<string, FieldDefinition<string, any>>;
+type ListViewDefinitionMap = Record<string, ListViewDefinition<string, any>>;
+type EditViewDefinitionMap = Record<string, EditViewDefinition<string, any>>;
+type PageDefinitionMap = Record<string, PageDefinition<string>>;
+type WidgetDefinitionMap = Record<string, WidgetDefinition<string, any>>;
+type ComponentDefinitionMap = Record<string, MaybeLazyComponent<any>>;
+type BlockDefinitionMap = Record<string, never>;
+/**
+ * Admin builder state - definition-time configuration (type-inferrable)
+ *
+ * FLAT structure - everything is top-level and mergeable, just like QuestpieBuilderState.
+ * No "module" wrapper!
+ *
+ * TApp: Backend Questpie app type - provides collection/global names for autocomplete
+ */
+interface AdminBuilderState<TApp = any, TFields extends FieldDefinitionMap = FieldDefinitionMap, TComponents extends ComponentDefinitionMap = ComponentDefinitionMap, TListViews extends ListViewDefinitionMap = ListViewDefinitionMap, TEditViews extends EditViewDefinitionMap = EditViewDefinitionMap, TPages extends PageDefinitionMap = PageDefinitionMap, TWidgets extends WidgetDefinitionMap = WidgetDefinitionMap, TBlocks extends BlockDefinitionMap = BlockDefinitionMap, TTranslations extends TranslationsMap = TranslationsMap> {
+  "~app": TApp;
+  fields: TFields;
+  components: TComponents;
+  listViews: TListViews;
+  editViews: TEditViews;
+  pages: TPages;
+  widgets: TWidgets;
+  blocks: TBlocks;
+  translations: TTranslations;
+  locale: LocaleConfig;
+  defaultViews: DefaultViewsConfig;
+}
+/**
+ * Get view kind from either Builder (state.kind) or Definition (kind)
+ * Normalizes the two patterns into one
+ */
+type GetViewKind<T> = T extends {
+  state: {
+    kind: infer K;
+  };
+} ? K : T extends {
+  kind: infer K;
+} ? K : never;
+/**
+ * Check if a view is a list view (works with both Builder and Definition)
+ */
+type IsListView<T> = GetViewKind<T> extends "list" ? true : false;
+/**
+ * Check if a view is an edit view (works with both Builder and Definition)
+ */
+type IsEditView<T> = GetViewKind<T> extends "edit" ? true : false;
+/**
+ * Filter record to only list views
+ */
+type FilterListViews<T extends Record<string, any>> = { [K in keyof T as IsListView<T[K]> extends true ? K : never]: T[K] };
+/**
+ * Filter record to only edit views
+ */
+type FilterEditViews<T extends Record<string, any>> = { [K in keyof T as IsEditView<T[K]> extends true ? K : never]: T[K] };
+//#endregion
+export { AdminBuilderState, BlockDefinitionMap, ComponentDefinitionMap, EditViewDefinitionMap, FieldDefinitionMap, FilterEditViews, FilterListViews, ListViewDefinitionMap, PageDefinitionMap, TranslationsMap, WidgetDefinitionMap };
+//# sourceMappingURL=admin-types.d.mts.map

package/dist/client/builder/admin-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-types.d.mts","names":[],"sources":["../../../src/client/builder/admin-types.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAsCA;AACA;AACA;AACY,KAlBA,eAAA,GAAkB,MAkBA,CAAA,MAAG,EAlBY,cAkBN,CAAA;AAgBtB,KA5BL,kBAAA,GAAqB,MA4BC,CAAA,MAAA,EA5Bc,eA4Bd,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA;AAEjB,KA7BL,qBAAA,GAAwB,MA6BnB,CAAA,MAAA,EA3BhB,kBA2BgB,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA;AAAqB,KAzB1B,qBAAA,GAAwB,MAyBE,CAAA,MAAA,EAvBrC,kBAuBqC,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA;AACjB,KAtBT,iBAAA,GAAoB,MAsBX,CAAA,MAAA,EAtB0B,cAsB1B,CAAA,MAAA,CAAA,CAAA;AAAyB,KArBlC,mBAAA,GAAsB,MAqBY,CAAA,MAAA,EArBG,gBAqBH,CAAA,MAAA,EAAA,GAAA,CAAA,CAAA;AAC1B,KArBR,sBAAA,GAAyB,MAqBjB,CAAA,MAAA,EArBgC,kBAqBhC,CAAA,GAAA,CAAA,CAAA;AAAwB,KApBhC,kBAAA,GAAqB,MAoBW,CAAA,MAAA,EAAA,KAAA,CAAA;;;;;;;;;AAKH,UATxB,iBASwB,CAAA,OAAA,GAAA,EAAA,gBAPxB,kBAOwB,GAPH,kBAOG,EAAA,oBANpB,sBAMoB,GANK,sBAML,EAAA,mBALrB,qBAKqB,GALG,qBAKH,EAAA,mBAJrB,qBAIqB,GAJG,qBAIH,EAAA,eAHzB,iBAGyB,GAHL,iBAGK,EAAA,iBAFvB,mBAEuB,GAFD,mBAEC,EAAA,gBADxB,kBACwB,GADH,kBACG,EAAA,sBAAlB,eAAkB,GAAA,eAAA,CAAA,CAAA;EAGhC,MAAA,EAAA,IAAA;EAGA,MAAA,EAAA,OAAA;EACI,UAAA,EAAA,WAAA;EACD,SAAA,EAAA,UAAA;EACA,SAAA,EAAA,UAAA;EACJ,KAAA,EAAA,MAAA;EACE,OAAA,EAAA,QAAA;EACD,MAAA,EAAA,OAAA;EACM,YAAA,EAAA,aAAA;EAGN,MAAA,EAAA,YAAA;EACM,YAAA,EAAA,kBAAA;;;;;;KA4EH,iBAAiB;;;;QAE1B;;;;;;KAOS,gBAAgB,YAAY;;;;KAK5B,gBAAgB,YAAY;;;;KAK5B,0BAA0B,qCACzB,KAAK,WAAW,EAAE,mBAAmB,YAAY,EAAE;;;;KAMpD,0BAA0B,qCACzB,KAAK,WAAW,EAAE,mBAAmB,YAAY,EAAE"}

package/dist/client/builder/admin.d.mts

@@ -0,0 +1,121 @@
+import { AdminBuilderState } from "./admin-types.mjs";
+import { AdminBuilder } from "./admin-builder.mjs";
+import { RegisteredAdmin } from "./registry.mjs";
+
+//#region src/client/builder/admin.d.ts
+
+/**
+ * Extract state from a builder or return the value as-is.
+ * Builders have a `state` property, plain configs do not.
+ */
+type ExtractBuilderState<T> = T extends {
+  state: infer S;
+} ? S : T;
+/**
+ * Map over a record and extract state from each builder value.
+ */
+type ExtractBuilderStates<T> = { [K in keyof T]: ExtractBuilderState<T[K]> };
+/**
+ * Input type for Admin - accepts either an AdminBuilder or Admin instance
+ */
+type AdminInput<TState$1 extends AdminBuilderState = AdminBuilderState> = AdminBuilder<TState$1> | Admin<TState$1>;
+/**
+ * Admin runtime instance
+ *
+ * Provides methods to access admin configuration at runtime.
+ *
+ * @example
+ * ```ts
+ * import { Admin } from "@questpie/admin/builder";
+ *
+ * // Direct usage - pass builder to AdminLayoutProvider
+ * <AdminLayoutProvider admin={admin} ... />
+ *
+ * // Or create Admin instance explicitly if needed
+ * const adminInstance = Admin.normalize(adminBuilder);
+ * ```
+ */
+declare class Admin<TState$1 extends AdminBuilderState = AdminBuilderState> {
+  readonly state: TState$1;
+  constructor(state: TState$1);
+  /**
+   * Normalize input to Admin instance (internal helper)
+   */
+  static normalize<TState$1 extends AdminBuilderState>(input: AdminInput<TState$1>): Admin<TState$1>;
+  /**
+   * Get all custom page configurations.
+   * Automatically extracts `.state` from builders.
+   */
+  getPages(): ExtractBuilderStates<TState$1["pages"]>;
+  /**
+   * Get all registered component implementations.
+   */
+  getComponents(): ExtractBuilderStates<TState$1["components"]>;
+  /**
+   * Get a specific component implementation by name.
+   */
+  getComponent(name: string): ExtractBuilderState<TState$1["components"][string]> | undefined;
+  /**
+   * Get configuration for a specific page.
+   * Automatically extracts `.state` from builder.
+   */
+  getPageConfig(name: string): ExtractBuilderState<TState$1["pages"][string]> | undefined;
+  /**
+   * Get default views configuration
+   */
+  getDefaultViews(): TState$1["defaultViews"];
+  /**
+   * Get locale configuration
+   */
+  getLocale(): TState$1["locale"];
+  /**
+   * Get available locales
+   */
+  getAvailableLocales(): string[];
+  /**
+   * Get default locale
+   */
+  getDefaultLocale(): string;
+  /**
+   * Get human-readable label for a locale
+   */
+  getLocaleLabel(locale: string): string;
+  /**
+   * Get translations map from builder state
+   * Used by AdminProvider to initialize i18n
+   */
+  getTranslations(): TState$1["translations"];
+  /**
+   * Get all registered field definitions
+   */
+  getFields(): TState$1["fields"];
+  /**
+   * Get a specific field definition
+   */
+  getField(name: string): TState$1["fields"][string] | undefined;
+  /**
+   * Get all registered list view definitions
+   */
+  getListViews(): TState$1["listViews"];
+  /**
+   * Get all registered edit view definitions
+   */
+  getEditViews(): TState$1["editViews"];
+  /**
+   * Get all registered widget definitions
+   */
+  getWidgets(): TState$1["widgets"];
+}
+/**
+ * Infer the CMS type from an Admin instance
+ */
+type InferAdminCMS<TAdmin> = TAdmin extends Admin<infer TState> ? TState extends {
+  "~app": infer TApp;
+} ? TApp : unknown : unknown;
+/**
+ * Get the registered Admin type (from module augmentation)
+ */
+type AppAdmin = RegisteredAdmin extends AdminBuilder<infer TState> ? Admin<TState> : Admin<AdminBuilderState>;
+//#endregion
+export { Admin, AdminInput, AppAdmin, InferAdminCMS };
+//# sourceMappingURL=admin.d.mts.map

package/dist/client/builder/admin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.mts","names":[],"sources":["../../../src/client/builder/admin.ts"],"sourcesContent":[],"mappings":";;;;;;;;;AAqCA;KAZK,mBAYiC,CAAA,CAAA,CAAA,GAZR,CAYQ,SAAA;EAAoB,KAAA,EAAA,KAAA,EAAA;CACzC,GAAA,CAAA,GAbgD,CAahD;;;;KARZ,oBASI,CAAA,CAAA,CAAA,GAAA,QAsBI,MA9BC,CA8BI,GA9BA,mBA8BA,CA9BoB,CA8BpB,CA9BsB,CA8BtB,CAAA,CAAA,EAAgB;;;;AAMA,KA9BtB,UA8BsB,CAAA,iBA9BI,iBA8BJ,GA9BwB,iBA8BxB,CAAA,GA7B9B,YA6B8B,CA7BjB,QA6BiB,CAAA,GA5B9B,KA4B8B,CA5BxB,QA4BwB,CAAA;;;;;;;;;;;;;;;;;AA0KR,cAhLb,KAgLa,CAAA,iBAhLQ,iBAgLR,GAhL4B,iBAgL5B,CAAA,CAAA;EAOR,SAAA,KAAA,EAtLmB,QAsLnB;EAOA,WAAA,CAAA,KAAA,EA7LmB,QA6LnB;EAOF;;AAYhB;EAUY,OAAA,SAAQ,CAAA,iBArNc,iBAqNd,CAAA,CAAA,KAAA,EApNT,UAoNS,CApNE,QAoNF,CAAA,CAAA,EAnNf,KAmNe,CAnNT,QAmNS,CAAA;EAClB;;;;EAEU,QAAA,CAAA,CAAA,EAvME,oBAuMF,CAvMuB,QAuMvB,CAAA,OAAA,CAAA,CAAA;EAAN;;;mBAjLa,qBAAqB;;;;8BAmBnC,oBAAoB;;;;;+BAepB,oBAAoB;;;;qBAiBJ;;;;eAWN;;;;;;;;;;;;;;;;;qBAmDM;;;;eAWN;;;;0BAOW;;;;kBAOR;;;;kBAOA;;;;gBAOF;;;;;KAYJ,wBACV,eAAe;;;;;;KASL,QAAA,GACV,wBAAwB,6BACpB,MAAM,UACN,MAAM"}

package/dist/client/builder/admin.mjs

@@ -0,0 +1,160 @@
+import { DEFAULT_LOCALE, DEFAULT_LOCALE_CONFIG } from "questpie/shared";
+
+//#region src/client/builder/admin.ts
+/**
+* Admin Runtime Class
+*
+* Wraps AdminBuilder state with runtime methods for accessing configuration.
+* This is what gets passed to AdminProvider and used throughout the admin UI.
+*/
+/**
+* Admin runtime instance
+*
+* Provides methods to access admin configuration at runtime.
+*
+* @example
+* ```ts
+* import { Admin } from "@questpie/admin/builder";
+*
+* // Direct usage - pass builder to AdminLayoutProvider
+* <AdminLayoutProvider admin={admin} ... />
+*
+* // Or create Admin instance explicitly if needed
+* const adminInstance = Admin.normalize(adminBuilder);
+* ```
+*/
+var Admin = class Admin {
+	constructor(state) {
+		this.state = state;
+	}
+	/**
+	* Normalize input to Admin instance (internal helper)
+	*/
+	static normalize(input) {
+		if (input instanceof Admin) return input;
+		return new Admin(input.state);
+	}
+	/**
+	* Get all custom page configurations.
+	* Automatically extracts `.state` from builders.
+	*/
+	getPages() {
+		const pages = this.state.pages ?? {};
+		const result = {};
+		for (const [name, config] of Object.entries(pages)) result[name] = config && typeof config === "object" && "state" in config ? config.state : config;
+		return result;
+	}
+	/**
+	* Get all registered component implementations.
+	*/
+	getComponents() {
+		const components = this.state.components ?? {};
+		const result = {};
+		for (const [name, config] of Object.entries(components)) result[name] = config && typeof config === "object" && "state" in config ? config.state : config;
+		return result;
+	}
+	/**
+	* Get a specific component implementation by name.
+	*/
+	getComponent(name) {
+		const config = this.state.components?.[name];
+		if (!config) return void 0;
+		return config && typeof config === "object" && "state" in config ? config.state : config;
+	}
+	/**
+	* Get configuration for a specific page.
+	* Automatically extracts `.state` from builder.
+	*/
+	getPageConfig(name) {
+		const config = this.state.pages?.[name];
+		if (!config) return void 0;
+		return config && typeof config === "object" && "state" in config ? config.state : config;
+	}
+	/**
+	* Get default views configuration
+	*/
+	getDefaultViews() {
+		return this.state.defaultViews ?? {};
+	}
+	/**
+	* Get locale configuration
+	*/
+	getLocale() {
+		return this.state.locale ?? DEFAULT_LOCALE_CONFIG;
+	}
+	/**
+	* Get available locales
+	*/
+	getAvailableLocales() {
+		return this.getLocale().supported ?? [DEFAULT_LOCALE];
+	}
+	/**
+	* Get default locale
+	*/
+	getDefaultLocale() {
+		return this.getLocale().default ?? DEFAULT_LOCALE;
+	}
+	/**
+	* Get human-readable label for a locale
+	*/
+	getLocaleLabel(locale) {
+		return {
+			en: "English",
+			sk: "Slovencina",
+			cs: "Cestina",
+			de: "Deutsch",
+			fr: "Francais",
+			es: "Espanol",
+			it: "Italiano",
+			pt: "Portugues",
+			pl: "Polski",
+			nl: "Nederlands",
+			ru: "Russkij",
+			uk: "Ukrainska",
+			ja: "Nihongo",
+			ko: "Hangugeo",
+			zh: "Zhongwen"
+		}[locale] ?? locale.toUpperCase();
+	}
+	/**
+	* Get translations map from builder state
+	* Used by AdminProvider to initialize i18n
+	*/
+	getTranslations() {
+		return this.state.translations ?? {};
+	}
+	/**
+	* Get all registered field definitions
+	*/
+	getFields() {
+		return this.state.fields ?? {};
+	}
+	/**
+	* Get a specific field definition
+	*/
+	getField(name) {
+		return this.state.fields?.[name];
+	}
+	/**
+	* Get all registered list view definitions
+	*/
+	getListViews() {
+		return this.state.listViews ?? {};
+	}
+	/**
+	* Get all registered edit view definitions
+	*/
+	getEditViews() {
+		return this.state.editViews ?? {};
+	}
+	/**
+	* Get all registered widget definitions
+	*/
+	getWidgets() {
+		return this.state.widgets ?? {};
+	}
+};
+
+//#endregion
+export { Admin };
+//# sourceMappingURL=admin.mjs.map

package/dist/client/builder/admin.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.mjs","names":["state: TState","result: Record<string, any>"],"sources":["../../../src/client/builder/admin.ts"],"sourcesContent":["/**\n * Admin Runtime Class\n *\n * Wraps AdminBuilder state with runtime methods for accessing configuration.\n * This is what gets passed to AdminProvider and used throughout the admin UI.\n */\n\nimport { DEFAULT_LOCALE, DEFAULT_LOCALE_CONFIG } from \"questpie/shared\";\nimport type { AdminBuilder } from \"./admin-builder\";\nimport type { AdminBuilderState } from \"./admin-types\";\nimport type {\n  RegisteredAdmin,\n  RegisteredCMS,\n  RegisteredCollectionNames,\n  RegisteredGlobalNames,\n} from \"./registry\";\n\n// ============================================================================\n// Type Helpers for State Extraction\n// ============================================================================\n\n/**\n * Extract state from a builder or return the value as-is.\n * Builders have a `state` property, plain configs do not.\n */\ntype ExtractBuilderState<T> = T extends { state: infer S } ? S : T;\n\n/**\n * Map over a record and extract state from each builder value.\n */\ntype ExtractBuilderStates<T> = {\n  [K in keyof T]: ExtractBuilderState<T[K]>;\n};\n\n/**\n * Input type for Admin - accepts either an AdminBuilder or Admin instance\n */\nexport type AdminInput<TState extends AdminBuilderState = AdminBuilderState> =\n  | AdminBuilder<TState>\n  | Admin<TState>;\n\n// ============================================================================\n// Admin Class\n// ============================================================================\n\n/**\n * Admin runtime instance\n *\n * Provides methods to access admin configuration at runtime.\n *\n * @example\n * ```ts\n * import { Admin } from \"@questpie/admin/builder\";\n *\n * // Direct usage - pass builder to AdminLayoutProvider\n * <AdminLayoutProvider admin={admin} ... />\n *\n * // Or create Admin instance explicitly if needed\n * const adminInstance = Admin.normalize(adminBuilder);\n * ```\n */\nexport class Admin<TState extends AdminBuilderState = AdminBuilderState> {\n  constructor(public readonly state: TState) {}\n\n  /**\n   * Normalize input to Admin instance (internal helper)\n   */\n  static normalize<TState extends AdminBuilderState>(\n    input: AdminInput<TState>,\n  ): Admin<TState> {\n    if (input instanceof Admin) {\n      return input;\n    }\n    return new Admin(input.state);\n  }\n\n  // ============================================================================\n  // Page Methods\n  // ============================================================================\n\n  /**\n   * Get all custom page configurations.\n   * Automatically extracts `.state` from builders.\n   */\n  getPages(): ExtractBuilderStates<TState[\"pages\"]> {\n    const pages = this.state.pages ?? {};\n    const result: Record<string, any> = {};\n\n    for (const [name, config] of Object.entries(pages)) {\n      // Extract state from builders, pass through plain configs\n      result[name] =\n        config && typeof config === \"object\" && \"state\" in config\n          ? (config as any).state\n          : config;\n    }\n\n    return result as ExtractBuilderStates<TState[\"pages\"]>;\n  }\n\n  // ============================================================================\n  // Component Methods\n  // ============================================================================\n\n  /**\n   * Get all registered component implementations.\n   */\n  getComponents(): ExtractBuilderStates<TState[\"components\"]> {\n    const components = this.state.components ?? {};\n    const result: Record<string, any> = {};\n\n    for (const [name, config] of Object.entries(components)) {\n      result[name] =\n        config && typeof config === \"object\" && \"state\" in config\n          ? (config as any).state\n          : config;\n    }\n\n    return result as ExtractBuilderStates<TState[\"components\"]>;\n  }\n\n  /**\n   * Get a specific component implementation by name.\n   */\n  getComponent(\n    name: string,\n  ): ExtractBuilderState<TState[\"components\"][string]> | undefined {\n    const config = (this.state.components as Record<string, any>)?.[name];\n    if (!config) return undefined;\n\n    return config && typeof config === \"object\" && \"state\" in config\n      ? config.state\n      : config;\n  }\n\n  /**\n   * Get configuration for a specific page.\n   * Automatically extracts `.state` from builder.\n   */\n  getPageConfig(\n    name: string,\n  ): ExtractBuilderState<TState[\"pages\"][string]> | undefined {\n    const config = (this.state.pages as Record<string, any>)?.[name];\n    if (!config) return undefined;\n\n    // Extract state from builder, pass through plain config\n    return config && typeof config === \"object\" && \"state\" in config\n      ? config.state\n      : config;\n  }\n\n  // ============================================================================\n  // UI Configuration Methods\n  // ============================================================================\n\n  /**\n   * Get default views configuration\n   */\n  getDefaultViews(): TState[\"defaultViews\"] {\n    return this.state.defaultViews ?? ({} as TState[\"defaultViews\"]);\n  }\n\n  // ============================================================================\n  // Locale Methods\n  // ============================================================================\n\n  /**\n   * Get locale configuration\n   */\n  getLocale(): TState[\"locale\"] {\n    return this.state.locale ?? DEFAULT_LOCALE_CONFIG;\n  }\n\n  /**\n   * Get available locales\n   */\n  getAvailableLocales(): string[] {\n    return this.getLocale().supported ?? [DEFAULT_LOCALE];\n  }\n\n  /**\n   * Get default locale\n   */\n  getDefaultLocale(): string {\n    return this.getLocale().default ?? DEFAULT_LOCALE;\n  }\n\n  /**\n   * Get human-readable label for a locale\n   */\n  getLocaleLabel(locale: string): string {\n    // TODO: Support custom labels from locale config\n    const labels: Record<string, string> = {\n      en: \"English\",\n      sk: \"Slovencina\",\n      cs: \"Cestina\",\n      de: \"Deutsch\",\n      fr: \"Francais\",\n      es: \"Espanol\",\n      it: \"Italiano\",\n      pt: \"Portugues\",\n      pl: \"Polski\",\n      nl: \"Nederlands\",\n      ru: \"Russkij\",\n      uk: \"Ukrainska\",\n      ja: \"Nihongo\",\n      ko: \"Hangugeo\",\n      zh: \"Zhongwen\",\n    };\n    return labels[locale] ?? locale.toUpperCase();\n  }\n\n  // ============================================================================\n  // Translations Methods\n  // ============================================================================\n\n  /**\n   * Get translations map from builder state\n   * Used by AdminProvider to initialize i18n\n   */\n  getTranslations(): TState[\"translations\"] {\n    return this.state.translations ?? ({} as TState[\"translations\"]);\n  }\n\n  // ============================================================================\n  // Registry Methods (for field/view lookups)\n  // ============================================================================\n\n  /**\n   * Get all registered field definitions\n   */\n  getFields(): TState[\"fields\"] {\n    return this.state.fields ?? ({} as TState[\"fields\"]);\n  }\n\n  /**\n   * Get a specific field definition\n   */\n  getField(name: string): TState[\"fields\"][string] | undefined {\n    return (this.state.fields as Record<string, any>)?.[name];\n  }\n\n  /**\n   * Get all registered list view definitions\n   */\n  getListViews(): TState[\"listViews\"] {\n    return this.state.listViews ?? ({} as TState[\"listViews\"]);\n  }\n\n  /**\n   * Get all registered edit view definitions\n   */\n  getEditViews(): TState[\"editViews\"] {\n    return this.state.editViews ?? ({} as TState[\"editViews\"]);\n  }\n\n  /**\n   * Get all registered widget definitions\n   */\n  getWidgets(): TState[\"widgets\"] {\n    return this.state.widgets ?? ({} as TState[\"widgets\"]);\n  }\n}\n\n// ============================================================================\n// Type Helpers\n// ============================================================================\n\n/**\n * Infer the CMS type from an Admin instance\n */\nexport type InferAdminCMS<TAdmin> =\n  TAdmin extends Admin<infer TState>\n    ? TState extends { \"~app\": infer TApp }\n      ? TApp\n      : unknown\n    : unknown;\n\n/**\n * Get the registered Admin type (from module augmentation)\n */\nexport type AppAdmin =\n  RegisteredAdmin extends AdminBuilder<infer TState>\n    ? Admin<TState>\n    : Admin<AdminBuilderState>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,IAAa,QAAb,MAAa,MAA4D;CACvE,YAAY,AAAgBA,OAAe;EAAf;;;;;CAK5B,OAAO,UACL,OACe;AACf,MAAI,iBAAiB,MACnB,QAAO;AAET,SAAO,IAAI,MAAM,MAAM,MAAM;;;;;;CAW/B,WAAkD;EAChD,MAAM,QAAQ,KAAK,MAAM,SAAS,EAAE;EACpC,MAAMC,SAA8B,EAAE;AAEtC,OAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,MAAM,CAEhD,QAAO,QACL,UAAU,OAAO,WAAW,YAAY,WAAW,SAC9C,OAAe,QAChB;AAGR,SAAO;;;;;CAUT,gBAA4D;EAC1D,MAAM,aAAa,KAAK,MAAM,cAAc,EAAE;EAC9C,MAAMA,SAA8B,EAAE;AAEtC,OAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,WAAW,CACrD,QAAO,QACL,UAAU,OAAO,WAAW,YAAY,WAAW,SAC9C,OAAe,QAChB;AAGR,SAAO;;;;;CAMT,aACE,MAC+D;EAC/D,MAAM,SAAU,KAAK,MAAM,aAAqC;AAChE,MAAI,CAAC,OAAQ,QAAO;AAEpB,SAAO,UAAU,OAAO,WAAW,YAAY,WAAW,SACtD,OAAO,QACP;;;;;;CAON,cACE,MAC0D;EAC1D,MAAM,SAAU,KAAK,MAAM,QAAgC;AAC3D,MAAI,CAAC,OAAQ,QAAO;AAGpB,SAAO,UAAU,OAAO,WAAW,YAAY,WAAW,SACtD,OAAO,QACP;;;;;CAUN,kBAA0C;AACxC,SAAO,KAAK,MAAM,gBAAiB,EAAE;;;;;CAUvC,YAA8B;AAC5B,SAAO,KAAK,MAAM,UAAU;;;;;CAM9B,sBAAgC;AAC9B,SAAO,KAAK,WAAW,CAAC,aAAa,CAAC,eAAe;;;;;CAMvD,mBAA2B;AACzB,SAAO,KAAK,WAAW,CAAC,WAAW;;;;;CAMrC,eAAe,QAAwB;AAmBrC,SAjBuC;GACrC,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACJ,IAAI;GACL,CACa,WAAW,OAAO,aAAa;;;;;;CAW/C,kBAA0C;AACxC,SAAO,KAAK,MAAM,gBAAiB,EAAE;;;;;CAUvC,YAA8B;AAC5B,SAAO,KAAK,MAAM,UAAW,EAAE;;;;;CAMjC,SAAS,MAAoD;AAC3D,SAAQ,KAAK,MAAM,SAAiC;;;;;CAMtD,eAAoC;AAClC,SAAO,KAAK,MAAM,aAAc,EAAE;;;;;CAMpC,eAAoC;AAClC,SAAO,KAAK,MAAM,aAAc,EAAE;;;;;CAMpC,aAAgC;AAC9B,SAAO,KAAK,MAAM,WAAY,EAAE"}

package/dist/client/builder/defaults/components.mjs

@@ -0,0 +1,20 @@
+import { Badge, IconifyIcon } from "../../components/component-renderer.mjs";
+
+//#region src/client/builder/defaults/components.ts
+/**
+* Built-in Component Registry
+*
+* Default component implementations used by the admin UI.
+* Registered through AdminBuilder.components() so nothing is hardcoded.
+*/
+/**
+* Built-in components registry
+*/
+const builtInComponents = {
+	icon: IconifyIcon,
+	badge: Badge
+};
+
+//#endregion
+export { builtInComponents };
+//# sourceMappingURL=components.mjs.map

package/dist/client/builder/defaults/components.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.mjs","names":[],"sources":["../../../../src/client/builder/defaults/components.ts"],"sourcesContent":["/**\n * Built-in Component Registry\n *\n * Default component implementations used by the admin UI.\n * Registered through AdminBuilder.components() so nothing is hardcoded.\n */\n\nimport { Badge, IconifyIcon } from \"../../components/component-renderer\";\n\n/**\n * Built-in components registry\n */\nexport const builtInComponents = {\n  icon: IconifyIcon,\n  badge: Badge,\n} as const;\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,oBAAoB;CAC/B,MAAM;CACN,OAAO;CACR"}