@mframework/core 0.0.1

package/src/types/compat/legacy.ts

@@ -0,0 +1,19 @@
+// Legacy compatibility types (keeps older @mframework/types shapes available)
+export interface Product {
+  id?: string
+  title?: string
+  description?: string
+  price?: number
+}
+
+export interface Session { id?: string; userId?: string; token?: string }
+export interface User { id?: string; email?: string; name?: string }
+
+// Re-export canonical types under legacy names for compatibility
+export type { SearchQuery } from '../search/query'
+export type { SearchResult } from '../search/result'
+export type { AuthSession } from '../auth/session'
+export type { CommerceCart, CommerceCartItem } from '../commerce/cart'
+export type { CommercePrice } from '../commerce/product'
+
+

package/src/types/config.ts

@@ -0,0 +1,9 @@
+export interface M FrameworkConfig {
+  env: 'development' | 'production' | 'test'
+  appName?: string
+  logger?: {
+    level?: 'debug' | 'info' | 'warn' | 'error'
+  }
+  // Extension point for modules
+  [key: string]: unknown
+}

package/src/types/core/common.ts

@@ -0,0 +1,2 @@
+export type Maybe<T> = T | null | undefined
+export type ID = string | number

package/src/types/core/error.ts

@@ -0,0 +1,11 @@
+export type MeeoviErrorCode =
+  | 'NETWORK'
+  | 'TIMEOUT'
+  | 'BAD_REQUEST'
+  | 'NOT_FOUND'
+  | 'UNKNOWN'
+
+export interface MeeoviError extends Error {
+  code: MeeoviErrorCode
+  cause?: unknown
+}

package/src/types/core/id.ts

@@ -0,0 +1 @@
+export type ID = string

package/src/types/core/pagination.ts

@@ -0,0 +1,6 @@
+export interface Paginated<T> {
+  items: T[]
+  total: number
+  page: number
+  pageSize: number
+}

package/src/types/core/result.ts

@@ -0,0 +1,11 @@
+export type Ok<T> = {
+  ok: true
+  data: T
+}
+
+export type Err<E = string> = {
+  ok: false
+  error: E
+}
+
+export type Result<T, E = string> = Ok<T> | Err<E>

package/src/types/core/utility.ts

@@ -0,0 +1,7 @@
+export type Maybe<T> = T | null | undefined
+
+export type ValueOf<T> = T[keyof T]
+
+export type DeepPartial<T> = {
+  [K in keyof T]?: T[K] extends object ? DeepPartial<T[K]> : T[K]
+}

package/src/types/events.ts

@@ -0,0 +1,47 @@
+import { M FrameworkAdapterKey } from './adapters'
+
+export interface M FrameworkEventMap {
+  'app:ready': { context: unknown }
+  'app:error': { error: unknown }
+  // emitted when a module/registry registers an adapter at runtime
+  'adapter:registered': { key: M FrameworkAdapterKey }
+  // modules extend this via declaration merging
+}
+
+export type M FrameworkEventKey = keyof M FrameworkEventMap
+
+export type M FrameworkEventHandler<K extends M FrameworkEventKey> = (
+  payload: M FrameworkEventMap[K]
+) => void | Promise<void>
+
+export interface M FrameworkEventBus {
+  on<K extends M FrameworkEventKey>(event: K, handler: M FrameworkEventHandler<K>): void
+  off<K extends M FrameworkEventKey>(event: K, handler: M FrameworkEventHandler<K>): void
+  emit<K extends M FrameworkEventKey>(event: K, payload: M FrameworkEventMap[K]): Promise<void>
+}
+
+export function createEventBus(): M FrameworkEventBus {
+  const handlers = new Map<string, Set<M FrameworkEventHandler<any>>>()
+
+  return {
+    on(event, handler) {
+      if (!handlers.has(event)) {
+        handlers.set(event, new Set())
+      }
+      handlers.get(event)!.add(handler as M FrameworkEventHandler<any>)
+    },
+
+    off(event, handler) {
+      handlers.get(event)?.delete(handler as M FrameworkEventHandler<any>)
+    },
+
+    async emit(event, payload) {
+      const set = handlers.get(event)
+      if (!set || set.size === 0) return
+
+      for (const handler of set) {
+        await handler(payload as any)
+      }
+    }
+  }
+}

package/src/types/index.ts

@@ -0,0 +1,49 @@
+// Core
+export * from './core/result'
+export * from './core/utility'
+export * from './core/pagination'
+export * from './core/id'
+export { Maybe } from './core/common'
+export * from './core/error'
+
+// Auth
+export * from './auth/user'
+export * from './auth/session'
+export * from './auth/providers'
+export * from './auth/inputs'
+export * from './auth/adapter'
+
+// Commerce
+export * from './commerce/product'
+export * from './commerce/cart'
+export * from './commerce/order'
+export * from './commerce/adapter'
+
+// Search
+export * from './search/query'
+export * from './search/result'
+export * from './search/facet'
+export * from './search/result'
+export * from './search/opensearch'
+export * from './search/adapter'
+
+// UI
+export * from './ui/form'
+export * from './ui/state'
+export * from './ui/pagination'
+export * from './ui/component'
+export type * from './ui/blocks';
+export type * from './ui/content';
+export type * from './ui/meta';
+export type * from './ui/system';
+export type * from './ui/help';
+export type * from './ui/os';
+export type * from './ui/schema';
+export type * from './ui/api/global-search';
+
+// SDK
+export * from './sdk/errors'
+export * from './sdk/endpoint'
+export * from './sdk/request'
+export * from './sdk/response'
+export * from './sdk/adapter'

package/src/types/module.ts

@@ -0,0 +1,18 @@
+import type { M FrameworkContext } from '../runtime/context'
+import type { M FrameworkAdapterKey, M FrameworkAdapterOf } from './adapters'
+
+export type M FrameworkModuleAdapters = Partial<{
+  [K in M FrameworkAdapterKey]: M FrameworkAdapterOf<K>
+}>
+
+export interface M FrameworkModuleLifecycle {
+  onAppInit?(ctx: M FrameworkContext): Promise<void> | void
+  onBeforeRequest?(ctx: M FrameworkContext): Promise<void> | void
+  onAfterRequest?(ctx: M FrameworkContext): Promise<void> | void
+}
+
+export interface M FrameworkModule extends M FrameworkModuleLifecycle {
+  id: string
+  adapters?: M FrameworkModuleAdapters
+  setup?(ctx: M FrameworkContext): void | Promise<void>
+}

package/src/types/sdk/adapter.ts

@@ -0,0 +1,10 @@
+import type { RequestOptions } from './request'
+import type { APIResponse } from './response'
+
+export interface TransportAdapter {
+  request<T = unknown>(
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE',
+    path: string,
+    options?: RequestOptions
+  ): Promise<APIResponse<T>>
+}

package/src/types/sdk/endpoint.ts

@@ -0,0 +1,11 @@
+export interface EndpointConfig<
+  Params = unknown,
+  Body = unknown,
+  Response = unknown
+> {
+  path: string
+  method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'
+  params?: Params
+  body?: Body
+  response: Response
+}

package/src/types/sdk/errors.ts

@@ -0,0 +1,6 @@
+export interface APIError {
+  status: number
+  message: string
+  code?: string
+  details?: unknown
+}

package/src/types/sdk/request.ts

@@ -0,0 +1,6 @@
+export interface RequestOptions {
+  params?: Record<string, string | number>
+  query?: Record<string, string | number | boolean>
+  body?: unknown
+  headers?: Record<string, string>
+}

package/src/types/sdk/response.ts

@@ -0,0 +1,5 @@
+export interface APIResponse<T = unknown> {
+  status: number
+  data: T
+  error?: string
+}

package/src/types/search/adapter.ts

@@ -0,0 +1,7 @@
+import type { BaseAdapter } from '../../adapters/common'
+import { SearchQuery } from './query'
+import type { SearchResult } from './result'
+
+export interface SearchAdapter<TItem = unknown> extends BaseAdapter {
+  search(query: SearchQuery): Promise<SearchResult<TItem>>
+}

package/src/types/search/facet.ts

@@ -0,0 +1,9 @@
+export interface FacetValue {
+  value: string
+  count: number
+}
+
+export interface Facet {
+  field: string
+  values: FacetValue[]
+}

package/src/types/search/opensearch.ts

@@ -0,0 +1,19 @@
+export interface OpenSearchHit<T = unknown> {
+  _source: T
+}
+
+export interface OpenSearchHits<T = unknown> {
+  total: { value: number }
+  hits: Array<OpenSearchHit<T>>
+}
+
+export interface OpenSearchAggregations {
+  [key: string]: {
+    buckets: Array<{ key: string; doc_count: number }>
+  }
+}
+
+export interface OpenSearchResponse<T = unknown> {
+  hits: OpenSearchHits<T>
+  aggregations?: OpenSearchAggregations
+}

package/src/types/search/query.ts

@@ -0,0 +1,19 @@
+export interface SearchFilter {
+  field: string
+  value: string | number | boolean
+}
+
+export interface SortOption {
+  field: string
+  direction: 'asc' | 'desc'
+}
+
+export interface SearchQuery {
+  q: string
+  filters?: SearchFilter[]
+  sort?: SortOption[]
+  page?: number
+  limit?: number
+  offset?: number
+  pageSize?: number
+}

package/src/types/search/result.ts

@@ -0,0 +1,17 @@
+export interface SearchResultItem {
+  id: string
+  type: 'product' | 'category' | 'content' | string
+  title: string
+  description?: string
+  image?: string
+  url?: string
+}
+
+export interface SearchResult<TItem = SearchResultItem> {
+  items: TItem[]
+  total: number
+  // back-compat: some consumers expect totalPages
+  totalPages?: number
+  page: number
+  pageSize: number
+}

package/src/types/ui/api/global-search.ts

@@ -0,0 +1,8 @@
+export interface GlobalSearchResult {
+	id?: string;
+	title?: string;
+	type?: string;
+	description?: string;
+	image?: string;
+	url?: string;
+}

package/src/types/ui/blocks/block-button-group.ts

@@ -0,0 +1,7 @@
+import type { BlockButton } from './block-button';
+
+export interface BlockButtonGroup {
+	id: string;
+	buttons: (string | BlockButton)[] | null;
+	alignment: 'left' | 'center' | null;
+}

package/src/types/ui/blocks/block-button.ts

@@ -0,0 +1,14 @@
+import type { Post, Page } from '../content';
+
+export interface BlockButton {
+	id: string;
+	sort: number | null;
+	type: ('pages' | 'posts' | 'external') | null;
+	label: string | null;
+	color: 'primary' | 'white' | 'gray' | 'white' | 'black';
+	variant: 'solid' | 'outline' | 'ghost' | 'link' | 'soft';
+	page: string | Page | null;
+	post: string | Post | null;
+	external_url: string | null;
+	icon: string | null;
+}

package/src/types/ui/blocks/block-column.ts

@@ -0,0 +1,20 @@
+import type { File } from '../system';
+import type { BlockButtonGroup } from '.';
+
+export interface BlockColumn {
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	rows?: (number | BlockColumnRow)[];
+}
+
+export interface BlockColumnRow {
+	block_columns?: (string | BlockColumn) | null;
+	content?: string | null;
+	headline?: string | null;
+	id?: string;
+	image?: (string | File) | null;
+	image_position?: string | null;
+	title?: string | null;
+	button_group?: (string | BlockButtonGroup) | null;
+}

package/src/types/ui/blocks/block-cta.ts

@@ -0,0 +1,10 @@
+import type { BlockButtonGroup } from '.';
+
+export interface BlockCta {
+	buttons?: { [key: string]: any } | null;
+	content?: string | null;
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	button_group?: (string | BlockButtonGroup) | null;
+}

package/src/types/ui/blocks/block-divider.ts

@@ -0,0 +1,4 @@
+export interface BlockDivider {
+	id?: string;
+	title?: string | null;
+}

package/src/types/ui/blocks/block-faq.ts

@@ -0,0 +1,12 @@
+export interface BlockFaq {
+	faqs?: BlockFaqQuestion[] | null;
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	alignment?: 'left' | 'center' | null;
+}
+
+export interface BlockFaqQuestion {
+	title: string | null;
+	answer: string | null;
+}

package/src/types/ui/blocks/block-form.ts

@@ -0,0 +1,8 @@
+import type { Form } from '../content';
+
+export interface BlockForm {
+	form?: (string | Form) | null;
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+}

package/src/types/ui/blocks/block-gallery.ts

@@ -0,0 +1,14 @@
+import type { File } from '../system';
+
+export interface BlockGallery {
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	gallery_items?: BlockGalleryFile[] | null;
+}
+export interface BlockGalleryFile {
+	block_gallery?: (string | BlockGallery) | null;
+	directus_files_id?: (string | File) | null;
+	id?: number;
+	sort?: number | null;
+}

package/src/types/ui/blocks/block-hero.ts

@@ -0,0 +1,12 @@
+import type { File } from '../system';
+import type { BlockButtonGroup } from '.';
+
+export interface BlockHero {
+	id?: string;
+	title?: string | null;
+	headline?: string | null;
+	content?: string | null;
+	image?: (string | File) | null;
+	image_position?: 'left' | 'right' | null;
+	button_group?: (string | BlockButtonGroup) | null;
+}

package/src/types/ui/blocks/block-html.ts

@@ -0,0 +1,4 @@
+export interface BlockHtml {
+	id?: string;
+	raw_html?: string | null;
+}

package/src/types/ui/blocks/block-logocloud.ts

@@ -0,0 +1,14 @@
+import type { File } from '../system';
+
+export interface BlockLogocloud {
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	logos?: (string | BlockLogocloudFile)[];
+}
+export interface BlockLogocloudFile {
+	id?: string;
+	sort?: number | null;
+	block_logocloud_id?: (string | BlockLogocloud) | null;
+	directus_files_id?: (string | File) | null;
+}

package/src/types/ui/blocks/block-quote.ts

@@ -0,0 +1,11 @@
+import type { File } from '../system';
+
+export interface BlockQuote {
+	background_color?: string | null;
+	content?: string | null;
+	headline?: string | null;
+	id?: string;
+	image?: (string | File) | null;
+	subtitle?: string | null;
+	title?: string | null;
+}

package/src/types/ui/blocks/block-richtext.ts

@@ -0,0 +1,7 @@
+export interface BlockRichtext {
+	content?: string | null;
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	alignment?: 'left' | 'center' | null;
+}

package/src/types/ui/blocks/block-steps.ts

@@ -0,0 +1,22 @@
+import type { File } from '../system';
+import type { BlockButtonGroup } from '.';
+
+export interface BlockStep {
+	id?: string;
+	title?: string | null;
+	headline?: string | null;
+	/** If enabled, image position is mframeworkd between left and right. */
+	mframework_image_position?: boolean;
+	/** Show the step numbers on the website. For example: (Step 1, Step 2, etc) */
+	show_step_numbers?: boolean | null;
+	steps?: (number | BlockStepItem)[];
+}
+export interface BlockStepItem {
+	id?: string;
+	title?: string | null;
+	content?: string | null;
+	image?: (string | File) | null;
+	sort?: number | null;
+	block_steps?: (string | BlockStep) | null;
+	button_group?: (string | BlockButtonGroup) | null;
+}

package/src/types/ui/blocks/block-team.ts

@@ -0,0 +1,6 @@
+export interface BlockTeam {
+	content?: string | null;
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+}

package/src/types/ui/blocks/block-testimonial.ts

@@ -0,0 +1,14 @@
+import type { Testimonial } from '../content';
+
+export interface BlockTestimonial {
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	testimonials?: (string | BlockTestimonialItem)[];
+}
+export interface BlockTestimonialItem {
+	block_testimonials_slider_id?: (string | BlockTestimonial) | null;
+	id?: string;
+	sort?: number | null;
+	testimonials_id?: (string | Testimonial) | null;
+}

package/src/types/ui/blocks/block-video.ts

@@ -0,0 +1,10 @@
+import type { File } from '../system';
+
+export interface BlockVideo {
+	headline?: string | null;
+	id?: string;
+	title?: string | null;
+	type?: string | null;
+	video_file?: (string | File) | null;
+	video_url?: string | null;
+}

package/src/types/ui/blocks/block.ts

@@ -0,0 +1,49 @@
+import type { BlockColumn } from './block-column';
+import type { BlockCta } from './block-cta';
+import type { BlockFaq } from './block-faq';
+import type { BlockForm } from './block-form';
+import type { BlockGallery } from './block-gallery';
+import type { BlockHero } from './block-hero';
+import type { BlockHtml } from './block-html';
+import type { BlockLogocloud } from './block-logocloud';
+import type { BlockQuote } from './block-quote';
+import type { BlockRichtext } from './block-richtext';
+import type { BlockStep } from './block-steps';
+import type { BlockTeam } from './block-team';
+import type { BlockTestimonial } from './block-testimonial';
+import type { BlockVideo } from './block-video';
+import type { BlockDivider } from './block-divider';
+
+export type BlockType =
+	| 'block_columns'
+	| 'block_cta'
+	| 'block_faqs'
+	| 'block_form'
+	| 'block_gallery'
+	| 'block_hero'
+	| 'block_html'
+	| 'block_logocloud'
+	| 'block_quote'
+	| 'block_richtext'
+	| 'block_steps'
+	| 'block_team'
+	| 'block_testimonials'
+	| 'block_video'
+	| 'block_divider';
+
+export type Block =
+	| BlockColumn
+	| BlockCta
+	| BlockFaq
+	| BlockForm
+	| BlockGallery
+	| BlockHero
+	| BlockHtml
+	| BlockLogocloud
+	| BlockQuote
+	| BlockRichtext
+	| BlockStep
+	| BlockTeam
+	| BlockTestimonial
+	| BlockVideo
+	| BlockDivider;

package/src/types/ui/blocks/index.ts

@@ -0,0 +1,18 @@
+export type * from './block-column';
+export type * from './block-cta';
+export type * from './block-faq';
+export type * from './block-form';
+export type * from './block-gallery';
+export type * from './block-hero';
+export type * from './block-html';
+export type * from './block-logocloud';
+export type * from './block-quote';
+export type * from './block-richtext';
+export type * from './block-steps';
+export type * from './block-team';
+export type * from './block-testimonial';
+export type * from './block-video';
+export type * from './block-button-group';
+export type * from './block-button';
+export type * from './block-divider';
+export type * from './block';

package/src/types/ui/component.ts

@@ -0,0 +1,7 @@
+export interface ComponentSize {
+  size?: 'sm' | 'md' | 'lg'
+}
+
+export interface ComponentVariant {
+  variant?: 'primary' | 'secondary' | 'danger' | 'ghost'
+}

package/src/types/ui/content/category.ts

@@ -0,0 +1,11 @@
+import type { SEO } from '../meta';
+
+export interface Category {
+	color?: string | null;
+	content?: string | null;
+	id?: string;
+	seo?: (string | SEO) | null;
+	slug?: string | null;
+	sort?: number | null;
+	title?: string | null;
+}

package/src/types/ui/content/form.ts

@@ -0,0 +1,20 @@
+import type { User } from '../system';
+
+export interface Form {
+	date_created?: string | null;
+	date_updated?: string | null;
+	id?: string;
+	key?: string | null;
+	on_success?: string | null;
+	redirect_url?: string | null;
+	/** The fields for the form. */
+	schema?: { [key: string]: any }[] | null;
+	sort?: number | null;
+	status?: string;
+	/** The text for the submit button label. */
+	submit_label?: string | null;
+	success_message?: string | null;
+	title?: string | null;
+	user_created?: string | User | null;
+	user_updated?: string | User | null;
+}