alepha 0.15.1 → 0.15.3

package/dist/react/form/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/react/form/hooks/useFormState.ts","../../../src/react/form/components/FormState.tsx","../../../src/react/form/errors/FormValidationError.ts","../../../src/react/form/services/FormModel.ts","../../../src/react/form/hooks/useForm.ts","../../../src/react/form/index.ts"],"sourcesContent":["import { type TObject, TypeBoxError } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useEffect, useState } from \"react\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nexport interface UseFormStateReturn {\n  loading: boolean;\n  dirty: boolean;\n  values?: Record<string, any>;\n  error?: Error;\n}\n\nexport const useFormState = <\n  T extends TObject,\n  Keys extends keyof UseFormStateReturn,\n>(\n  target: FormModel<T> | { form: FormModel<T>; path: string },\n  _events: Keys[] = [\"loading\", \"dirty\", \"error\"] as Keys[],\n): Pick<UseFormStateReturn, Keys> => {\n  const alepha = useAlepha();\n  const events = _events as string[];\n\n  const [dirty, setDirty] = useState(false);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<Error | undefined>(undefined);\n  const [values, setValues] = useState<Record<string, any> | undefined>(\n    undefined,\n  );\n\n  const form = \"form\" in target ? target.form : target;\n  const path = \"path\" in target ? target.path : undefined;\n\n  const hasValues = events.includes(\"values\");\n  const hasErrors = events.includes(\"error\");\n  const hasDirty = events.includes(\"dirty\");\n  const hasLoading = events.includes(\"loading\");\n\n  useEffect(() => {\n    const listeners: Function[] = [];\n\n    if (hasErrors || hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:change\", (event) => {\n          if (event.id === form.id) {\n            if (!path || event.path === path) {\n              if (hasDirty) {\n                setDirty(true);\n              }\n              if (hasErrors) {\n                setError(undefined);\n              }\n            }\n            if (hasValues) {\n              setValues(form.currentValues);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasValues) {\n      listeners.push(\n        alepha.events.on(\"form:reset\", (event) => {\n          if (event.id === form.id) {\n            setValues(event.values);\n          }\n        }),\n      );\n    }\n\n    if (hasLoading) {\n      listeners.push(\n        alepha.events.on(\"form:submit:begin\", (event) => {\n          if (event.id === form.id) {\n            setLoading(true);\n          }\n        }),\n        alepha.events.on(\"form:submit:end\", (event) => {\n          if (event.id === form.id) {\n            setLoading(false);\n          }\n        }),\n      );\n    }\n\n    if (hasValues || hasDirty) {\n      listeners.push(\n        alepha.events.on(\"form:submit:success\", (event) => {\n          if (event.id === form.id) {\n            if (hasValues) {\n              setValues(event.values);\n            }\n            if (hasDirty) {\n              setDirty(false);\n            }\n          }\n        }),\n      );\n    }\n\n    if (hasErrors) {\n      listeners.push(\n        alepha.events.on(\"form:submit:error\", (event) => {\n          if (event.id === form.id) {\n            if (\n              !path ||\n              (event.error instanceof TypeBoxError &&\n                event.error.value.path === path)\n            ) {\n              setError(event.error);\n            }\n          }\n        }),\n      );\n    }\n\n    return () => {\n      for (const unsub of listeners) {\n        unsub();\n      }\n    };\n  }, []);\n\n  return {\n    dirty,\n    loading,\n    error,\n    values,\n  } as Pick<UseFormStateReturn, Keys>;\n};\n","import type { TObject } from \"alepha\";\nimport type { ReactNode } from \"react\";\nimport { useFormState } from \"../hooks/useFormState.ts\";\nimport type { FormModel } from \"../services/FormModel.ts\";\n\nconst FormState = <T extends TObject>(props: {\n  form: FormModel<T>;\n  children: (state: { loading: boolean; dirty: boolean }) => ReactNode;\n}) => {\n  const formState = useFormState(props.form);\n  return props.children({\n    loading: formState.loading,\n    dirty: formState.dirty,\n  });\n};\n\nexport default FormState;\n","import { TypeBoxError } from \"alepha\";\n\nexport class FormValidationError extends TypeBoxError {\n  readonly name = \"ValidationError\";\n\n  constructor(options: {\n    message: string;\n    path: string;\n  }) {\n    super({\n      message: options.message,\n      instancePath: options.path,\n      schemaPath: \"\",\n      keyword: \"not\",\n      params: {},\n    });\n  }\n}\n","import type { TArray } from \"alepha\";\nimport {\n  $inject,\n  Alepha,\n  type Static,\n  type TObject,\n  type TSchema,\n  t,\n} from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport type { ChangeEvent, InputHTMLAttributes } from \"react\";\n\n/**\n * FormModel is a dynamic form handler that generates form inputs based on a provided TypeBox schema.\n * It manages form state, handles input changes, and processes form submissions with validation.\n *\n * It means to be injected and used within React components to provide a structured way to create and manage forms.\n *\n * @see {@link useForm}\n */\nexport class FormModel<T extends TObject> {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n  protected readonly values: Record<string, any> = {};\n  protected submitInProgress = false;\n\n  public input: SchemaToInput<T>;\n\n  public get submitting(): boolean {\n    return this.submitInProgress;\n  }\n\n  constructor(\n    public readonly id: string,\n    public readonly options: FormCtrlOptions<T>,\n  ) {\n    this.options = options;\n\n    if (options.initialValues) {\n      this.values = this.alepha.codec.decode(\n        options.schema,\n        options.initialValues,\n      ) as Record<string, any>;\n    }\n\n    this.input = this.createProxyFromSchema(options, options.schema, {\n      store: this.values,\n      parent: \"\",\n    });\n  }\n\n  public get element(): HTMLFormElement {\n    return window.document.getElementById(this.id)! as HTMLFormElement;\n  }\n\n  public get currentValues(): Record<string, any> {\n    return this.restructureValues(this.values);\n  }\n\n  public get props() {\n    return {\n      id: this.id,\n      noValidate: true,\n      onSubmit: (ev?: FormEventLike) => {\n        ev?.preventDefault?.();\n        this.submit();\n      },\n      onReset: (event: FormEventLike) => this.reset(event),\n    };\n  }\n\n  public readonly reset = (event: FormEventLike) => {\n    // clear values in place to maintain proxy reference\n    for (const key in this.values) {\n      delete this.values[key];\n    }\n\n    this.options.onReset?.();\n\n    return this.alepha.events.emit(\n      \"form:reset\",\n      {\n        id: this.id,\n        values: this.values,\n      },\n      {\n        catch: true,\n      },\n    );\n  };\n\n  public readonly submit = async () => {\n    if (this.submitInProgress) {\n      this.log.warn(\n        \"Form submission already in progress, ignoring duplicate submit.\",\n      );\n      return;\n    }\n\n    // emit both action and form events\n    await this.alepha.events.emit(\"react:action:begin\", {\n      type: \"form\",\n      id: this.id,\n    });\n    await this.alepha.events.emit(\"form:submit:begin\", {\n      id: this.id,\n    });\n\n    this.submitInProgress = true;\n\n    const options = this.options;\n    const form = this.element;\n    const args = {\n      form,\n    };\n\n    try {\n      let values: Record<string, any> = this.restructureValues(this.values);\n\n      if (t.schema.isSchema(options.schema)) {\n        values = this.alepha.codec.decode(options.schema, values) as Record<\n          string,\n          any\n        >;\n      }\n\n      await options.handler(values as any, args);\n\n      await this.alepha.events.emit(\"react:action:success\", {\n        type: \"form\",\n        id: this.id,\n      });\n      await this.alepha.events.emit(\"form:submit:success\", {\n        id: this.id,\n        values,\n      });\n    } catch (error) {\n      this.log.error(\"Form submission error:\", error);\n\n      options.onError?.(error as Error, args);\n\n      await this.alepha.events.emit(\"react:action:error\", {\n        type: \"form\",\n        id: this.id,\n        error: error as Error,\n      });\n      await this.alepha.events.emit(\"form:submit:error\", {\n        error: error as Error,\n        id: this.id,\n      });\n    } finally {\n      this.submitInProgress = false;\n    }\n\n    await this.alepha.events.emit(\"react:action:end\", {\n      type: \"form\",\n      id: this.id,\n    });\n    await this.alepha.events.emit(\"form:submit:end\", {\n      id: this.id,\n    });\n  };\n\n  /**\n   * Restructures flat keys like \"address.city\" into nested objects like { address: { city: ... } }\n   * Values are already typed from onChange, so no conversion is needed.\n   */\n  protected restructureValues(store: Record<string, any>): Record<string, any> {\n    const values: Record<string, any> = {};\n\n    for (const [key, value] of Object.entries(store)) {\n      if (key.includes(\".\")) {\n        // nested object: restructure flat key to nested structure\n        this.restructureNestedValue(values, key, value);\n      } else {\n        // value is already typed, just copy it\n        values[key] = value;\n      }\n    }\n\n    return values;\n  }\n\n  /**\n   * Helper to restructure a flat key like \"address.city\" into nested object structure.\n   * The value is already typed, so we just assign it to the nested path.\n   */\n  protected restructureNestedValue(\n    values: Record<string, any>,\n    key: string,\n    value: any,\n  ) {\n    const pathSegments = key.split(\".\");\n    const finalPropertyKey = pathSegments.pop();\n    if (!finalPropertyKey) {\n      return;\n    }\n\n    let currentObjectLevel = values;\n\n    // traverse/create the nested structure\n    for (const segment of pathSegments) {\n      currentObjectLevel[segment] ??= {};\n      currentObjectLevel = currentObjectLevel[segment];\n    }\n\n    // value is already typed from onChange, just assign it\n    currentObjectLevel[finalPropertyKey] = value;\n  }\n\n  protected createProxyFromSchema<T extends TObject>(\n    options: FormCtrlOptions<T>,\n    schema: TSchema,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): SchemaToInput<T> {\n    const parent = context.parent || \"\";\n    return new Proxy<SchemaToInput<T>>({} as SchemaToInput<T>, {\n      get: (_, prop: string) => {\n        if (!options.schema || !t.schema.isObject(schema)) {\n          return {};\n        }\n\n        if (prop in schema.properties) {\n          // // it's a nested object, create another proxy\n          // if (t.schema.isObject(schema.properties[prop])) {\n          //   return this.createProxyFromSchema(\n          //     options,\n          //     schema.properties[prop],\n          //     {\n          //       parent: parent ? `${parent}.${prop}` : prop,\n          //       store: context.store,\n          //     },\n          //   );\n          // }\n\n          return this.createInputFromSchema<T>(\n            prop as keyof Static<T> & string,\n            options,\n            schema,\n            schema.required?.includes(prop as string) || false,\n            context,\n          );\n        }\n      },\n    });\n  }\n\n  protected createInputFromSchema<T extends TObject>(\n    name: keyof Static<T> & string,\n    options: FormCtrlOptions<T>,\n    schema: TObject,\n    required: boolean,\n    context: {\n      parent: string;\n      store: Record<string, any>;\n    },\n  ): BaseInputField {\n    const parent = context.parent || \"\";\n    const field = schema.properties?.[name];\n    if (!field) {\n      return {\n        path: \"\",\n        required,\n        props: {} as InputHTMLAttributes<unknown>,\n        schema: schema,\n        set: () => {},\n        form: this,\n      };\n    }\n\n    const isRequired = schema.required?.includes(name) ?? false;\n    const key = parent ? `${parent}.${name}` : name;\n    const path = `/${key.replaceAll(\".\", \"/\")}`;\n\n    const set = (value: any, sync = true) => {\n      // Convert to typed value immediately based on schema\n      const typedValue = this.getValueFromInput(value, field);\n\n      if (context.store[key] === typedValue) {\n        // no change, do not update\n        // return; <- disabled for now, as some inputs may need to sync even if value is same\n      }\n\n      context.store[key] = typedValue;\n\n      if (options.onChange) {\n        options.onChange(key, typedValue, context.store);\n      }\n\n      this.alepha.events.emit(\n        \"form:change\",\n        {\n          id: this.id,\n          path: path,\n          value: typedValue,\n        },\n        {\n          catch: true,\n        },\n      );\n\n      if (sync) {\n        const inputElement = window.document.querySelector(\n          `[data-path=\"${path}\"]`,\n        );\n        if (inputElement instanceof HTMLInputElement) {\n          if (t.schema.isBoolean(field)) {\n            inputElement.value = value;\n            inputElement.checked = Boolean(value);\n          } else {\n            inputElement.value = value;\n          }\n        }\n      }\n    };\n\n    const attr: InputHTMLAttributesLike = {\n      name: key,\n      autoComplete: \"off\",\n      onChange: (event: ChangeEvent<HTMLInputElement> | string | number) => {\n        if (typeof event === \"string\") {\n          // If the event is a string, it means it's a direct value change\n          set(event, false);\n          return;\n        }\n\n        if (typeof event === \"number\") {\n          // Some inputs might return number directly\n          set(event, false);\n          return;\n        }\n\n        if (t.schema.isBoolean(field)) {\n          if (event.target.value === \"true\") {\n            set(true, false);\n          } else if (event.target.value === \"false\") {\n            set(false, false);\n          } else if (event.target.value === \"\") {\n            set(undefined, false);\n          } else {\n            set(event.target.checked, false);\n          }\n        } else {\n          set(event.target.value, false);\n        }\n      },\n    };\n\n    (attr as any)[\"data-path\"] = path;\n\n    if (options.id) {\n      attr.id = `${options.id}-${key}`;\n      (attr as any)[\"data-testid\"] = attr.id;\n    }\n\n    if (t.schema.isString(field)) {\n      if (field.maxLength != null) {\n        attr.maxLength = Number(field.maxLength);\n      }\n\n      if (field.minLength != null) {\n        attr.minLength = Number(field.minLength);\n      }\n    }\n\n    if (options.initialValues?.[name] != null) {\n      attr.defaultValue = this.valueToInputEntry(options.initialValues[name]);\n    } else if (\"default\" in field && field.default != null) {\n      attr.defaultValue = this.valueToInputEntry(field.default);\n    }\n\n    if (isRequired) {\n      attr.required = true;\n    }\n\n    if (\"description\" in field && typeof field.description === \"string\") {\n      attr[\"aria-label\"] = field.description;\n    }\n\n    if (t.schema.isInteger(field) || t.schema.isNumber(field)) {\n      attr.type = \"number\";\n    } else if (name === \"password\") {\n      attr.type = \"password\";\n    } else if (name === \"email\") {\n      attr.type = \"email\";\n    } else if (name === \"url\") {\n      attr.type = \"url\";\n    } else if (t.schema.isString(field)) {\n      if (field.format === \"binary\") {\n        attr.type = \"file\";\n      } else if (field.format === \"date\") {\n        attr.type = \"date\";\n      } else if (field.format === \"time\") {\n        attr.type = \"time\";\n      } else if (field.format === \"date-time\") {\n        attr.type = \"datetime-local\";\n      } else {\n        attr.type = \"text\";\n      }\n    } else if (t.schema.isBoolean(field)) {\n      attr.type = \"checkbox\";\n    }\n\n    if (options.onCreateField) {\n      const customAttr = options.onCreateField(name, field);\n      Object.assign(attr, customAttr);\n    }\n\n    // if type = object, add items: { [key: string]: InputField }\n    if (t.schema.isObject(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        items: this.createProxyFromSchema(options, field, {\n          parent: key,\n          store: context.store,\n        }),\n      } as ObjectInputField<any>;\n    }\n\n    // if type = array, add items: InputField[]\n    if (t.schema.isArray(field)) {\n      return {\n        path,\n        props: attr,\n        schema: field,\n        set,\n        form: this,\n        required,\n        items: [], // <- will be populated dynamically in the UI\n      } as ArrayInputField<any>;\n    }\n\n    return {\n      path,\n      props: attr,\n      schema: field,\n      set,\n      form: this,\n      required,\n    };\n  }\n\n  /**\n   * Convert an input value to the correct type based on the schema.\n   * Handles raw DOM values (strings, booleans from checkboxes, Files, etc.)\n   */\n  protected getValueFromInput(input: any, schema: TSchema): any {\n    if (input instanceof File) {\n      // for file inputs, return the File object directly\n      if (t.schema.isString(schema) && schema.format === \"binary\") {\n        return input;\n      }\n      // for now, ignore other formats\n      return null;\n    }\n\n    if (t.schema.isBoolean(schema)) {\n      // Handle string representations from Select components (Yes/No dropdown)\n      if (input === \"true\") return true;\n      if (input === \"false\") return false;\n      if (input === \"\" || input === null || input === undefined)\n        return undefined;\n      // Handle actual boolean values\n      return !!input;\n    }\n\n    if (t.schema.isNumber(schema)) {\n      const num = Number(input);\n      return Number.isNaN(num) ? null : num;\n    }\n\n    if (t.schema.isString(schema)) {\n      if (schema.format === \"date\") {\n        return new Date(input).toISOString().slice(0, 10); // For date input\n      }\n      if (schema.format === \"time\") {\n        return new Date(`1970-01-01T${input}`).toISOString().slice(11, 16); // For time input\n      }\n      if (schema.format === \"date-time\") {\n        return new Date(input).toISOString(); // For datetime-local input\n      }\n      return String(input);\n    }\n\n    return input; // fallback for other types\n  }\n\n  protected valueToInputEntry(value: any): string | number | boolean {\n    if (value === null || value === undefined) {\n      return \"\";\n    }\n\n    if (typeof value === \"boolean\") {\n      return value;\n    }\n\n    if (typeof value === \"number\") {\n      return value;\n    }\n\n    if (typeof value === \"string\") {\n      return value;\n    }\n\n    if (value instanceof Date) {\n      return value.toISOString().slice(0, 16); // For datetime-local input\n    }\n\n    return value;\n  }\n}\n\nexport type SchemaToInput<T extends TObject> = {\n  [K in keyof T[\"properties\"]]: InputField<T[\"properties\"][K]>;\n};\n\nexport interface FormEventLike {\n  preventDefault?: () => void;\n  stopPropagation?: () => void;\n}\n\nexport type InputField<T extends TSchema> = T extends TObject\n  ? ObjectInputField<T>\n  : T extends TArray<infer U>\n    ? ArrayInputField<U>\n    : BaseInputField;\n\nexport interface BaseInputField {\n  path: string;\n  required: boolean;\n  props: InputHTMLAttributesLike;\n  schema: TSchema;\n  set: (value: any) => void;\n  form: FormModel<any>;\n  items?: any;\n}\n\nexport interface ObjectInputField<T extends TObject> extends BaseInputField {\n  items: SchemaToInput<T>;\n}\n\nexport interface ArrayInputField<T extends TSchema> extends BaseInputField {\n  items: Array<InputField<T>>;\n}\n\nexport type InputHTMLAttributesLike = Pick<\n  InputHTMLAttributes<unknown>,\n  | \"id\"\n  | \"name\"\n  | \"type\"\n  | \"value\"\n  | \"defaultValue\"\n  | \"required\"\n  | \"maxLength\"\n  | \"minLength\"\n  | \"aria-label\"\n  | \"autoComplete\"\n> & {\n  value?: any;\n  defaultValue?: any;\n  onChange?: (event: any) => void;\n};\n\nexport type FormCtrlOptions<T extends TObject> = {\n  /**\n   * The schema defining the structure and validation rules for the form.\n   * This should be a TypeBox schema object.\n   */\n  schema: T;\n\n  /**\n   * Callback function to handle form submission.\n   * This function will receive the parsed and validated form values.\n   */\n  handler: (values: Static<T>, args: { form: HTMLFormElement }) => unknown;\n\n  /**\n   * Optional initial values for the form fields.\n   * This can be used to pre-populate the form with existing data.\n   */\n  initialValues?: Partial<Static<T>>;\n\n  /**\n   * Optional function to create custom field attributes.\n   * This can be used to add custom validation, styles, or other attributes.\n   */\n  onCreateField?: (\n    name: keyof Static<T> & string,\n    schema: TSchema,\n  ) => InputHTMLAttributes<unknown>;\n\n  /**\n   * If defined, this will generate a unique ID for each field, prefixed with this string.\n   *\n   * > \"username\" with id=\"form-123\" will become \"form-123-username\".\n   *\n   * If omitted, IDs will not be generated.\n   */\n  id?: string;\n\n  onError?: (error: Error, args: { form: HTMLFormElement }) => void;\n\n  onChange?: (key: string, value: any, store: Record<string, any>) => void;\n\n  onReset?: () => void;\n};\n","import type { TObject } from \"alepha\";\nimport { useAlepha } from \"alepha/react\";\nimport { useId, useMemo } from \"react\";\nimport { type FormCtrlOptions, FormModel } from \"../services/FormModel.ts\";\n\n/**\n * Custom hook to create a form with validation and field management.\n * This hook uses TypeBox schemas to define the structure and validation rules for the form.\n * It provides a way to handle form submission, field creation, and value management.\n *\n * @example\n * ```tsx\n * import { t } from \"alepha\";\n *\n * const form = useForm({\n *   schema: t.object({\n *     username: t.text(),\n *     password: t.text(),\n *   }),\n *   handler: (values) => {\n *     console.log(\"Form submitted with values:\", values);\n *   },\n * });\n *\n * return (\n *   <form {...form.props}>\n *     <input {...form.input.username.props} />\n *     <input {...form.input.password.props} />\n *     <button type=\"submit\">Submit</button>\n *   </form>\n * );\n * ```\n */\nexport const useForm = <T extends TObject>(\n  options: FormCtrlOptions<T>,\n  deps: any[] = [],\n): FormModel<T> => {\n  const alepha = useAlepha();\n  const formId = useId();\n\n  return useMemo(() => {\n    return alepha.inject(FormModel<T>, {\n      lifetime: \"transient\",\n      args: [options.id || formId, options],\n    });\n  }, deps);\n};\n","import { $module } from \"alepha\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport { default as FormState } from \"./components/FormState.tsx\";\nexport * from \"./errors/FormValidationError.ts\";\nexport * from \"./hooks/useForm.ts\";\nexport * from \"./hooks/useFormState.ts\";\nexport * from \"./services/FormModel.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  interface Hooks {\n    \"form:change\": { id: string; path: string; value: any };\n    \"form:reset\": { id: string; values: Record<string, any> };\n    \"form:submit:begin\": { id: string };\n    \"form:submit:success\": { id: string; values: Record<string, any> };\n    \"form:submit:error\": { id: string; error: Error };\n    \"form:submit:end\": { id: string };\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * | type | quality | stability |\n * |------|---------|-----------|\n * | frontend | rare | stable |\n *\n * Type-safe forms with validation.\n *\n * **Features:**\n * - Form state management\n * - TypeBox schema validation\n * - Field-level error handling\n * - Submit handling with loading state\n * - Form reset\n *\n * @module alepha.react.form\n */\nexport const AlephaReactForm = $module({\n  name: \"alepha.react.form\",\n});\n"],"mappings":"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"}

package/dist/react/head/index.browser.js

@@ -0,0 +1,423 @@
+import { $inject, $module, Alepha, KIND, Primitive, createPrimitive } from "alepha";
+import { AlephaReact, useInject } from "alepha/react";
+import { $logger } from "alepha/logger";
+import { useCallback, useEffect, useMemo } from "react";
+
+//#region ../../src/react/head/helpers/SeoExpander.ts
+/**
+* Expands Head configuration into SEO meta tags.
+*
+* Generates:
+* - `<meta name="description">` from head.description
+* - `<meta property="og:*">` OpenGraph tags
+* - `<meta name="twitter:*">` Twitter Card tags
+*
+* @example
+* ```ts
+* const helper = new SeoExpander();
+* const { meta, link } = helper.expand({
+*   title: "My App",
+*   description: "Build amazing apps",
+*   image: "https://example.com/og.png",
+*   url: "https://example.com/",
+* });
+* ```
+*/
+var SeoExpander = class {
+	expand(head) {
+		const meta = [];
+		const link = [];
+		if (!(head.description || head.image || head.url || head.siteName || head.locale || head.type || head.og || head.twitter)) return {
+			meta,
+			link
+		};
+		if (head.description) meta.push({
+			name: "description",
+			content: head.description
+		});
+		if (head.url) link.push({
+			rel: "canonical",
+			href: head.url
+		});
+		this.expandOpenGraph(head, meta);
+		this.expandTwitter(head, meta);
+		return {
+			meta,
+			link
+		};
+	}
+	expandOpenGraph(head, meta) {
+		const ogTitle = head.og?.title ?? head.title;
+		const ogDescription = head.og?.description ?? head.description;
+		const ogImage = head.og?.image ?? head.image;
+		if (head.type || ogTitle) meta.push({
+			property: "og:type",
+			content: head.type ?? "website"
+		});
+		if (head.url) meta.push({
+			property: "og:url",
+			content: head.url
+		});
+		if (ogTitle) meta.push({
+			property: "og:title",
+			content: ogTitle
+		});
+		if (ogDescription) meta.push({
+			property: "og:description",
+			content: ogDescription
+		});
+		if (ogImage) {
+			meta.push({
+				property: "og:image",
+				content: ogImage
+			});
+			if (head.imageWidth) meta.push({
+				property: "og:image:width",
+				content: String(head.imageWidth)
+			});
+			if (head.imageHeight) meta.push({
+				property: "og:image:height",
+				content: String(head.imageHeight)
+			});
+			if (head.imageAlt) meta.push({
+				property: "og:image:alt",
+				content: head.imageAlt
+			});
+		}
+		if (head.siteName) meta.push({
+			property: "og:site_name",
+			content: head.siteName
+		});
+		if (head.locale) meta.push({
+			property: "og:locale",
+			content: head.locale
+		});
+	}
+	expandTwitter(head, meta) {
+		const twitterTitle = head.twitter?.title ?? head.title;
+		const twitterDescription = head.twitter?.description ?? head.description;
+		const twitterImage = head.twitter?.image ?? head.image;
+		if (head.twitter?.card || twitterTitle || twitterImage) meta.push({
+			name: "twitter:card",
+			content: head.twitter?.card ?? (twitterImage ? "summary_large_image" : "summary")
+		});
+		if (head.url) meta.push({
+			name: "twitter:url",
+			content: head.url
+		});
+		if (twitterTitle) meta.push({
+			name: "twitter:title",
+			content: twitterTitle
+		});
+		if (twitterDescription) meta.push({
+			name: "twitter:description",
+			content: twitterDescription
+		});
+		if (twitterImage) {
+			meta.push({
+				name: "twitter:image",
+				content: twitterImage
+			});
+			if (head.imageAlt) meta.push({
+				name: "twitter:image:alt",
+				content: head.imageAlt
+			});
+		}
+		if (head.twitter?.site) meta.push({
+			name: "twitter:site",
+			content: head.twitter.site
+		});
+		if (head.twitter?.creator) meta.push({
+			name: "twitter:creator",
+			content: head.twitter.creator
+		});
+	}
+};
+
+//#endregion
+//#region ../../src/react/head/providers/HeadProvider.ts
+/**
+* Provides methods to fill and merge head information into the application state.
+*
+* Used both on server and client side to manage document head.
+*
+* @see {@link SeoExpander}
+* @see {@link ServerHeadProvider}
+* @see {@link BrowserHeadProvider}
+*/
+var HeadProvider = class {
+	log = $logger();
+	seoExpander = $inject(SeoExpander);
+	global = [];
+	/**
+	* Track if we've warned about page-level htmlAttributes to avoid spam.
+	*/
+	warnedAboutHtmlAttributes = false;
+	/**
+	* Resolve global head configuration (from $head primitives only).
+	*
+	* This is used to get htmlAttributes early, before page loaders run.
+	* Only htmlAttributes from global $head are allowed; page-level htmlAttributes
+	* are ignored for early streaming optimization.
+	*
+	* @returns Merged global head with htmlAttributes
+	*/
+	resolveGlobalHead() {
+		const head = {};
+		for (const h of this.global ?? []) {
+			const resolved = typeof h === "function" ? h() : h;
+			if (resolved.htmlAttributes) head.htmlAttributes = {
+				...head.htmlAttributes,
+				...resolved.htmlAttributes
+			};
+		}
+		return head;
+	}
+	fillHead(state) {
+		state.head = { ...state.head };
+		for (const h of this.global ?? []) {
+			const head = typeof h === "function" ? h() : h;
+			this.mergeHead(state, head);
+		}
+		for (const layer of state.layers) if (layer.route?.head && !layer.error) this.fillHeadByPage(layer.route, state, layer.props ?? {});
+	}
+	mergeHead(state, head) {
+		const { meta, link } = this.seoExpander.expand(head);
+		state.head = {
+			...state.head,
+			...head,
+			meta: [
+				...state.head.meta ?? [],
+				...meta,
+				...head.meta ?? []
+			],
+			link: [
+				...state.head.link ?? [],
+				...link,
+				...head.link ?? []
+			],
+			script: [...state.head.script ?? [], ...head.script ?? []]
+		};
+	}
+	fillHeadByPage(page, state, props) {
+		if (!page.head) return;
+		state.head ??= {};
+		const head = typeof page.head === "function" ? page.head(props, state.head) : page.head;
+		const { meta, link } = this.seoExpander.expand(head);
+		state.head.meta = [...state.head.meta ?? [], ...meta];
+		state.head.link = [...state.head.link ?? [], ...link];
+		if (head.title) {
+			state.head ??= {};
+			if (state.head.titleSeparator) state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;
+			else state.head.title = head.title;
+			state.head.titleSeparator = head.titleSeparator;
+		}
+		if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {
+			this.warnedAboutHtmlAttributes = true;
+			this.log.warn("Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, as they are sent before page loaders run for early streaming optimization.");
+		}
+		if (head.bodyAttributes) state.head.bodyAttributes = {
+			...state.head.bodyAttributes,
+			...head.bodyAttributes
+		};
+		if (head.meta) state.head.meta = [...state.head.meta ?? [], ...head.meta ?? []];
+		if (head.link) state.head.link = [...state.head.link ?? [], ...head.link ?? []];
+		if (head.script) state.head.script = [...state.head.script ?? [], ...head.script ?? []];
+	}
+};
+
+//#endregion
+//#region ../../src/react/head/primitives/$head.ts
+/**
+* Set global `<head>` options for the application.
+*/
+const $head = (options) => {
+	return createPrimitive(HeadPrimitive, options);
+};
+var HeadPrimitive = class extends Primitive {
+	provider = $inject(HeadProvider);
+	onInit() {
+		this.provider.global = [...this.provider.global ?? [], this.options];
+	}
+};
+$head[KIND] = HeadPrimitive;
+
+//#endregion
+//#region ../../src/react/head/providers/BrowserHeadProvider.ts
+/**
+* Browser-side head provider that manages document head elements.
+*
+* Used by ReactBrowserProvider and ReactBrowserRouterProvider to update
+* document title, meta tags, and other head elements during client-side
+* navigation.
+*/
+var BrowserHeadProvider = class {
+	alepha = $inject(Alepha);
+	headProvider = $inject(HeadProvider);
+	get document() {
+		return window.document;
+	}
+	/**
+	* Fill head state from route configurations and render to document.
+	* Combines fillHead from HeadProvider with renderHead to the DOM.
+	*
+	* Only runs in browser environment - no-op on server.
+	*/
+	fillAndRenderHead(state) {
+		if (!this.alepha.isBrowser()) return;
+		this.headProvider.fillHead(state);
+		if (state.head) this.renderHead(this.document, state.head);
+	}
+	getHead(document) {
+		return {
+			get title() {
+				return document.title;
+			},
+			get htmlAttributes() {
+				const attrs = {};
+				for (const attr of document.documentElement.attributes) attrs[attr.name] = attr.value;
+				return attrs;
+			},
+			get bodyAttributes() {
+				const attrs = {};
+				for (const attr of document.body.attributes) attrs[attr.name] = attr.value;
+				return attrs;
+			},
+			get meta() {
+				const metas = [];
+				for (const meta of document.head.querySelectorAll("meta[name]")) {
+					const name = meta.getAttribute("name");
+					const content = meta.getAttribute("content");
+					if (name && content) metas.push({
+						name,
+						content
+					});
+				}
+				for (const meta of document.head.querySelectorAll("meta[property]")) {
+					const property = meta.getAttribute("property");
+					const content = meta.getAttribute("content");
+					if (property && content) metas.push({
+						property,
+						content
+					});
+				}
+				return metas;
+			}
+		};
+	}
+	renderHead(document, head) {
+		if (head.title) document.title = head.title;
+		if (head.bodyAttributes) for (const [key, value] of Object.entries(head.bodyAttributes)) if (value) document.body.setAttribute(key, value);
+		else document.body.removeAttribute(key);
+		if (head.htmlAttributes) for (const [key, value] of Object.entries(head.htmlAttributes)) if (value) document.documentElement.setAttribute(key, value);
+		else document.documentElement.removeAttribute(key);
+		if (head.meta) for (const it of head.meta) this.renderMetaTag(document, it);
+		if (head.link) for (const it of head.link) {
+			const { rel, href } = it;
+			let link = document.querySelector(`link[rel="${rel}"][href="${href}"]`);
+			if (!link) {
+				link = document.createElement("link");
+				link.setAttribute("rel", rel);
+				link.setAttribute("href", href);
+				if (it.type) link.setAttribute("type", it.type);
+				if (it.as) link.setAttribute("as", it.as);
+				if (it.crossorigin != null) link.setAttribute("crossorigin", "");
+				document.head.appendChild(link);
+			}
+		}
+		if (head.script) for (const it of head.script) this.renderScriptTag(document, it);
+	}
+	renderScriptTag(document, script) {
+		const el = document.createElement("script");
+		if (typeof script === "string") {
+			el.textContent = script;
+			document.head.appendChild(el);
+			return;
+		}
+		const { content, ...attrs } = script;
+		if (attrs.src) {
+			if (document.querySelector(`script[src="${attrs.src}"]`)) return;
+		}
+		for (const [key, value] of Object.entries(attrs)) if (value === true) el.setAttribute(key, "");
+		else if (value !== void 0 && value !== false) el.setAttribute(key, String(value));
+		if (content) el.textContent = content;
+		document.head.appendChild(el);
+	}
+	renderMetaTag(document, meta) {
+		const { content } = meta;
+		if (meta.property) {
+			const existing = document.querySelector(`meta[property="${meta.property}"]`);
+			if (existing) existing.setAttribute("content", content);
+			else {
+				const newMeta = document.createElement("meta");
+				newMeta.setAttribute("property", meta.property);
+				newMeta.setAttribute("content", content);
+				document.head.appendChild(newMeta);
+			}
+			return;
+		}
+		if (meta.name) {
+			const existing = document.querySelector(`meta[name="${meta.name}"]`);
+			if (existing) existing.setAttribute("content", content);
+			else {
+				const newMeta = document.createElement("meta");
+				newMeta.setAttribute("name", meta.name);
+				newMeta.setAttribute("content", content);
+				document.head.appendChild(newMeta);
+			}
+		}
+	}
+};
+
+//#endregion
+//#region ../../src/react/head/hooks/useHead.ts
+/**
+* ```tsx
+* const App = () => {
+*   const [head, setHead] = useHead({
+*     // will set the document title on the first render
+*     title: "My App",
+*   });
+*
+*   return (
+*     // This will update the document title when the button is clicked
+*     <button onClick={() => setHead({ title: "Change Title" })}>
+*       Change Title {head.title}
+*     </button>
+*   );
+* }
+* ```
+*/
+const useHead = (options) => {
+	const alepha = useInject(Alepha);
+	const current = useMemo(() => {
+		if (!alepha.isBrowser()) return {};
+		return alepha.inject(BrowserHeadProvider).getHead(window.document);
+	}, []);
+	const setHead = useCallback((head) => {
+		if (!alepha.isBrowser()) return;
+		alepha.inject(BrowserHeadProvider).renderHead(window.document, typeof head === "function" ? head(current) : head || {});
+	}, []);
+	useEffect(() => {
+		if (options) setHead(options);
+	}, []);
+	return [current, setHead];
+};
+
+//#endregion
+//#region ../../src/react/head/index.browser.ts
+/**
+* Alepha React Head Module
+*
+* @see {@link BrowserHeadProvider}
+* @module alepha.react.head
+*/
+const AlephaReactHead = $module({
+	name: "alepha.react.head",
+	primitives: [$head],
+	services: [AlephaReact, BrowserHeadProvider]
+});
+
+//#endregion
+export { $head, AlephaReactHead, BrowserHeadProvider, HeadPrimitive, SeoExpander, useHead };
+//# sourceMappingURL=index.browser.js.map

package/dist/react/head/index.browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.browser.js","names":[],"sources":["../../../src/react/head/helpers/SeoExpander.ts","../../../src/react/head/providers/HeadProvider.ts","../../../src/react/head/primitives/$head.ts","../../../src/react/head/providers/BrowserHeadProvider.ts","../../../src/react/head/hooks/useHead.ts","../../../src/react/head/index.browser.ts"],"sourcesContent":["import type { Head, HeadMeta } from \"../interfaces/Head.ts\";\n\n/**\n * Expands Head configuration into SEO meta tags.\n *\n * Generates:\n * - `<meta name=\"description\">` from head.description\n * - `<meta property=\"og:*\">` OpenGraph tags\n * - `<meta name=\"twitter:*\">` Twitter Card tags\n *\n * @example\n * ```ts\n * const helper = new SeoExpander();\n * const { meta, link } = helper.expand({\n *   title: \"My App\",\n *   description: \"Build amazing apps\",\n *   image: \"https://example.com/og.png\",\n *   url: \"https://example.com/\",\n * });\n * ```\n */\nexport class SeoExpander {\n  public expand(head: Head): {\n    meta: HeadMeta[];\n    link: Array<{ rel: string; href: string }>;\n  } {\n    const meta: HeadMeta[] = [];\n    const link: Array<{ rel: string; href: string }> = [];\n\n    // Only expand SEO if there's meaningful content beyond just title\n    const hasSeoContent =\n      head.description ||\n      head.image ||\n      head.url ||\n      head.siteName ||\n      head.locale ||\n      head.type ||\n      head.og ||\n      head.twitter;\n\n    if (!hasSeoContent) {\n      return { meta, link };\n    }\n\n    // Base description\n    if (head.description) {\n      meta.push({ name: \"description\", content: head.description });\n    }\n\n    // Canonical URL\n    if (head.url) {\n      link.push({ rel: \"canonical\", href: head.url });\n    }\n\n    // OpenGraph tags\n    this.expandOpenGraph(head, meta);\n\n    // Twitter Card tags\n    this.expandTwitter(head, meta);\n\n    return { meta, link };\n  }\n\n  protected expandOpenGraph(head: Head, meta: HeadMeta[]): void {\n    const ogTitle = head.og?.title ?? head.title;\n    const ogDescription = head.og?.description ?? head.description;\n    const ogImage = head.og?.image ?? head.image;\n\n    if (head.type || ogTitle) {\n      meta.push({ property: \"og:type\", content: head.type ?? \"website\" });\n    }\n    if (head.url) {\n      meta.push({ property: \"og:url\", content: head.url });\n    }\n    if (ogTitle) {\n      meta.push({ property: \"og:title\", content: ogTitle });\n    }\n    if (ogDescription) {\n      meta.push({ property: \"og:description\", content: ogDescription });\n    }\n    if (ogImage) {\n      meta.push({ property: \"og:image\", content: ogImage });\n      if (head.imageWidth) {\n        meta.push({\n          property: \"og:image:width\",\n          content: String(head.imageWidth),\n        });\n      }\n      if (head.imageHeight) {\n        meta.push({\n          property: \"og:image:height\",\n          content: String(head.imageHeight),\n        });\n      }\n      if (head.imageAlt) {\n        meta.push({ property: \"og:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.siteName) {\n      meta.push({ property: \"og:site_name\", content: head.siteName });\n    }\n    if (head.locale) {\n      meta.push({ property: \"og:locale\", content: head.locale });\n    }\n  }\n\n  protected expandTwitter(head: Head, meta: HeadMeta[]): void {\n    const twitterTitle = head.twitter?.title ?? head.title;\n    const twitterDescription = head.twitter?.description ?? head.description;\n    const twitterImage = head.twitter?.image ?? head.image;\n\n    if (head.twitter?.card || twitterTitle || twitterImage) {\n      meta.push({\n        name: \"twitter:card\",\n        content:\n          head.twitter?.card ??\n          (twitterImage ? \"summary_large_image\" : \"summary\"),\n      });\n    }\n    if (head.url) {\n      meta.push({ name: \"twitter:url\", content: head.url });\n    }\n    if (twitterTitle) {\n      meta.push({ name: \"twitter:title\", content: twitterTitle });\n    }\n    if (twitterDescription) {\n      meta.push({ name: \"twitter:description\", content: twitterDescription });\n    }\n    if (twitterImage) {\n      meta.push({ name: \"twitter:image\", content: twitterImage });\n      if (head.imageAlt) {\n        meta.push({ name: \"twitter:image:alt\", content: head.imageAlt });\n      }\n    }\n    if (head.twitter?.site) {\n      meta.push({ name: \"twitter:site\", content: head.twitter.site });\n    }\n    if (head.twitter?.creator) {\n      meta.push({ name: \"twitter:creator\", content: head.twitter.creator });\n    }\n  }\n}\n","import { $inject } from \"alepha\";\nimport { $logger } from \"alepha/logger\";\nimport { SeoExpander } from \"../helpers/SeoExpander.ts\";\nimport type { Head } from \"../interfaces/Head.ts\";\n\n/**\n * Provides methods to fill and merge head information into the application state.\n *\n * Used both on server and client side to manage document head.\n *\n * @see {@link SeoExpander}\n * @see {@link ServerHeadProvider}\n * @see {@link BrowserHeadProvider}\n */\nexport class HeadProvider {\n  protected readonly log = $logger();\n  protected readonly seoExpander = $inject(SeoExpander);\n\n  public global?: Array<Head | (() => Head)> = [];\n\n  /**\n   * Track if we've warned about page-level htmlAttributes to avoid spam.\n   */\n  protected warnedAboutHtmlAttributes = false;\n\n  /**\n   * Resolve global head configuration (from $head primitives only).\n   *\n   * This is used to get htmlAttributes early, before page loaders run.\n   * Only htmlAttributes from global $head are allowed; page-level htmlAttributes\n   * are ignored for early streaming optimization.\n   *\n   * @returns Merged global head with htmlAttributes\n   */\n  public resolveGlobalHead(): Head {\n    const head: Head = {};\n\n    for (const h of this.global ?? []) {\n      const resolved = typeof h === \"function\" ? h() : h;\n      if (resolved.htmlAttributes) {\n        head.htmlAttributes = {\n          ...head.htmlAttributes,\n          ...resolved.htmlAttributes,\n        };\n      }\n    }\n\n    return head;\n  }\n\n  public fillHead(state: HeadState) {\n    state.head = {\n      ...state.head,\n    };\n\n    for (const h of this.global ?? []) {\n      const head = typeof h === \"function\" ? h() : h;\n      this.mergeHead(state, head);\n    }\n\n    for (const layer of state.layers) {\n      if (layer.route?.head && !layer.error) {\n        this.fillHeadByPage(layer.route, state, layer.props ?? {});\n      }\n    }\n  }\n\n  protected mergeHead(state: HeadState, head: Head): void {\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head = {\n      ...state.head,\n      ...head,\n      meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],\n      link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],\n      script: [...(state.head.script ?? []), ...(head.script ?? [])],\n    };\n  }\n\n  protected fillHeadByPage(\n    page: HeadRoute,\n    state: HeadState,\n    props: Record<string, any>,\n  ): void {\n    if (!page.head) {\n      return;\n    }\n\n    state.head ??= {};\n\n    const head =\n      typeof page.head === \"function\"\n        ? page.head(props, state.head)\n        : page.head;\n\n    // Expand SEO fields into meta tags\n    const { meta, link } = this.seoExpander.expand(head);\n    state.head.meta = [...(state.head.meta ?? []), ...meta];\n    state.head.link = [...(state.head.link ?? []), ...link];\n\n    if (head.title) {\n      state.head ??= {};\n\n      if (state.head.titleSeparator) {\n        state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;\n      } else {\n        state.head.title = head.title;\n      }\n\n      state.head.titleSeparator = head.titleSeparator;\n    }\n\n    // htmlAttributes from pages are ignored for early streaming optimization.\n    // Only global $head can set htmlAttributes.\n    if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {\n      this.warnedAboutHtmlAttributes = true;\n      this.log.warn(\n        \"Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, \" +\n          \"as they are sent before page loaders run for early streaming optimization.\",\n      );\n    }\n\n    if (head.bodyAttributes) {\n      state.head.bodyAttributes = {\n        ...state.head.bodyAttributes,\n        ...head.bodyAttributes,\n      };\n    }\n\n    if (head.meta) {\n      state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];\n    }\n\n    if (head.link) {\n      state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];\n    }\n\n    if (head.script) {\n      state.head.script = [\n        ...(state.head.script ?? []),\n        ...(head.script ?? []),\n      ];\n    }\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimal route interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadRoute {\n  head?: Head | ((props: Record<string, any>, previous?: Head) => Head);\n}\n\n/**\n * Minimal state interface for head processing.\n * Avoids circular dependency with alepha/react/router.\n */\ninterface HeadState {\n  head: Head;\n  layers: Array<{\n    route?: HeadRoute;\n    props?: Record<string, any>;\n    error?: Error;\n  }>;\n}\n","import { $inject, createPrimitive, KIND, Primitive } from \"alepha\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"../providers/HeadProvider.ts\";\n\n/**\n * Set global `<head>` options for the application.\n */\nexport const $head = (options: HeadPrimitiveOptions) => {\n  return createPrimitive(HeadPrimitive, options);\n};\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport type HeadPrimitiveOptions = Head | (() => Head);\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport class HeadPrimitive extends Primitive<HeadPrimitiveOptions> {\n  protected readonly provider = $inject(HeadProvider);\n  protected onInit() {\n    this.provider.global = [...(this.provider.global ?? []), this.options];\n  }\n}\n\n$head[KIND] = HeadPrimitive;\n","import { $inject, Alepha } from \"alepha\";\nimport type { Head, HeadMeta } from \"../interfaces/Head.ts\";\nimport { HeadProvider } from \"./HeadProvider.ts\";\n\n/**\n * Browser-side head provider that manages document head elements.\n *\n * Used by ReactBrowserProvider and ReactBrowserRouterProvider to update\n * document title, meta tags, and other head elements during client-side\n * navigation.\n */\nexport class BrowserHeadProvider {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly headProvider = $inject(HeadProvider);\n\n  protected get document(): Document {\n    return window.document;\n  }\n\n  /**\n   * Fill head state from route configurations and render to document.\n   * Combines fillHead from HeadProvider with renderHead to the DOM.\n   *\n   * Only runs in browser environment - no-op on server.\n   */\n  public fillAndRenderHead(state: { head: Head; layers: Array<any> }): void {\n    // Skip on server-side\n    if (!this.alepha.isBrowser()) {\n      return;\n    }\n\n    this.headProvider.fillHead(state as any);\n    if (state.head) {\n      this.renderHead(this.document, state.head);\n    }\n  }\n\n  public getHead(document: Document): Head {\n    return {\n      get title() {\n        return document.title;\n      },\n      get htmlAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.documentElement.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get bodyAttributes() {\n        const attrs: Record<string, string> = {};\n        for (const attr of document.body.attributes) {\n          attrs[attr.name] = attr.value;\n        }\n        return attrs;\n      },\n      get meta() {\n        const metas: HeadMeta[] = [];\n        // Get meta tags with name attribute\n        for (const meta of document.head.querySelectorAll(\"meta[name]\")) {\n          const name = meta.getAttribute(\"name\");\n          const content = meta.getAttribute(\"content\");\n          if (name && content) {\n            metas.push({ name, content });\n          }\n        }\n        // Get meta tags with property attribute (OpenGraph)\n        for (const meta of document.head.querySelectorAll(\"meta[property]\")) {\n          const property = meta.getAttribute(\"property\");\n          const content = meta.getAttribute(\"content\");\n          if (property && content) {\n            metas.push({ property, content });\n          }\n        }\n        return metas;\n      },\n    };\n  }\n\n  public renderHead(document: Document, head: Head): void {\n    if (head.title) {\n      document.title = head.title;\n    }\n\n    if (head.bodyAttributes) {\n      for (const [key, value] of Object.entries(head.bodyAttributes)) {\n        if (value) {\n          document.body.setAttribute(key, value);\n        } else {\n          document.body.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.htmlAttributes) {\n      for (const [key, value] of Object.entries(head.htmlAttributes)) {\n        if (value) {\n          document.documentElement.setAttribute(key, value);\n        } else {\n          document.documentElement.removeAttribute(key);\n        }\n      }\n    }\n\n    if (head.meta) {\n      for (const it of head.meta) {\n        this.renderMetaTag(document, it);\n      }\n    }\n\n    if (head.link) {\n      for (const it of head.link) {\n        const { rel, href } = it;\n        let link = document.querySelector(`link[rel=\"${rel}\"][href=\"${href}\"]`);\n        if (!link) {\n          link = document.createElement(\"link\");\n          link.setAttribute(\"rel\", rel);\n          link.setAttribute(\"href\", href);\n          if (it.type) {\n            link.setAttribute(\"type\", it.type);\n          }\n          if (it.as) {\n            link.setAttribute(\"as\", it.as);\n          }\n          if (it.crossorigin != null) {\n            link.setAttribute(\"crossorigin\", \"\");\n          }\n          document.head.appendChild(link);\n        }\n      }\n    }\n\n    if (head.script) {\n      for (const it of head.script) {\n        this.renderScriptTag(document, it);\n      }\n    }\n  }\n\n  protected renderScriptTag(\n    document: Document,\n    script:\n      | string\n      | (Record<string, string | boolean | undefined> & { content?: string }),\n  ): void {\n    const el = document.createElement(\"script\");\n\n    // Handle plain string as inline script\n    if (typeof script === \"string\") {\n      el.textContent = script;\n      document.head.appendChild(el);\n      return;\n    }\n\n    const { content, ...attrs } = script;\n\n    // For scripts with src, check if already exists\n    if (attrs.src) {\n      const existing = document.querySelector(`script[src=\"${attrs.src}\"]`);\n      if (existing) {\n        return;\n      }\n    }\n\n    for (const [key, value] of Object.entries(attrs)) {\n      if (value === true) {\n        el.setAttribute(key, \"\");\n      } else if (value !== undefined && value !== false) {\n        el.setAttribute(key, String(value));\n      }\n    }\n\n    if (content) {\n      el.textContent = content;\n    }\n\n    document.head.appendChild(el);\n  }\n\n  protected renderMetaTag(document: Document, meta: HeadMeta): void {\n    const { content } = meta;\n\n    // Handle OpenGraph tags (property attribute)\n    if (meta.property) {\n      const existing = document.querySelector(\n        `meta[property=\"${meta.property}\"]`,\n      );\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"property\", meta.property);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n      return;\n    }\n\n    // Handle standard meta tags (name attribute)\n    if (meta.name) {\n      const existing = document.querySelector(`meta[name=\"${meta.name}\"]`);\n      if (existing) {\n        existing.setAttribute(\"content\", content);\n      } else {\n        const newMeta = document.createElement(\"meta\");\n        newMeta.setAttribute(\"name\", meta.name);\n        newMeta.setAttribute(\"content\", content);\n        document.head.appendChild(newMeta);\n      }\n    }\n  }\n}\n","import { Alepha } from \"alepha\";\nimport { useInject } from \"alepha/react\";\nimport { useCallback, useEffect, useMemo } from \"react\";\nimport type { Head } from \"../interfaces/Head.ts\";\nimport { BrowserHeadProvider } from \"../providers/BrowserHeadProvider.ts\";\n\n/**\n * ```tsx\n * const App = () => {\n *   const [head, setHead] = useHead({\n *     // will set the document title on the first render\n *     title: \"My App\",\n *   });\n *\n *   return (\n *     // This will update the document title when the button is clicked\n *     <button onClick={() => setHead({ title: \"Change Title\" })}>\n *       Change Title {head.title}\n *     </button>\n *   );\n * }\n * ```\n */\nexport const useHead = (options?: UseHeadOptions): UseHeadReturn => {\n  const alepha = useInject(Alepha);\n\n  const current = useMemo(() => {\n    if (!alepha.isBrowser()) {\n      return {};\n    }\n\n    return alepha.inject(BrowserHeadProvider).getHead(window.document);\n  }, []);\n\n  const setHead = useCallback((head?: Head | ((previous?: Head) => Head)) => {\n    if (!alepha.isBrowser()) {\n      return;\n    }\n\n    alepha\n      .inject(BrowserHeadProvider)\n      .renderHead(\n        window.document,\n        typeof head === \"function\" ? head(current) : head || {},\n      );\n  }, []);\n\n  useEffect(() => {\n    if (options) {\n      setHead(options);\n    }\n  }, []);\n\n  return [current, setHead];\n};\n\nexport type UseHeadOptions = Head | ((previous?: Head) => Head);\n\nexport type UseHeadReturn = [\n  Head,\n  (head?: Head | ((previous?: Head) => Head)) => void,\n];\n","import { $module } from \"alepha\";\nimport { AlephaReact } from \"alepha/react\";\nimport { $head } from \"./primitives/$head.ts\";\nimport { BrowserHeadProvider } from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./helpers/SeoExpander.ts\";\nexport * from \"./hooks/useHead.ts\";\nexport * from \"./interfaces/Head.ts\";\nexport * from \"./primitives/$head.ts\";\nexport * from \"./providers/BrowserHeadProvider.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Alepha React Head Module\n *\n * @see {@link BrowserHeadProvider}\n * @module alepha.react.head\n */\nexport const AlephaReactHead = $module({\n  name: \"alepha.react.head\",\n  primitives: [$head],\n  services: [AlephaReact, BrowserHeadProvider],\n});\n"],"mappings":"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"}