feat: scaffold Fragment entity types and GetFragmentParams [DX-926] (#2999)

* feat: scaffold Fragment entity types and GetFragmentParams [DX-926]

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

* fix: use ExperienceDimensionKeyMap and narrow slots union in FragmentProps

- Replace inline dimensionKeyMap struct with ExperienceDimensionKeyMap (shared
  named type from experience.ts, mirrors upstream DimensionKeyMap)
- Drop TreeNode from slots union — upstream contract (experienceCommonFields)
  uses ViewNode | FragmentNode | InlineFragmentNode; SDK drops deprecated ViewNode
  leaving FragmentNode | InlineFragmentNode, matching ExperienceProps.slots exactly
- Remove unused TreeNode import from component-type

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore: prettier

---------

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
Co-authored-by: Tyler Pina <tyler.pina@contentful.com>

Author: 3 people

lib/common-types.ts

@@ -2965,6 +2965,8 @@ export type GetExperienceParams = GetSpaceEnvironmentParams & { experienceId: st
 /** @internal */
 export type GetDataAssemblyParams = GetSpaceEnvironmentParams & { dataAssemblyId: string }
 /** @internal */
+export type GetFragmentParams = GetSpaceEnvironmentParams & { fragmentId: string }
+/** @internal */
 export type GetTemplateParams = GetSpaceEnvironmentParams & { templateId: string }
 /** @internal */
 export type GetContentTypeParams = GetSpaceEnvironmentParams & { contentTypeId: string }

lib/entities/fragment.ts

@@ -0,0 +1,74 @@
+import type { Except } from 'type-fest'
+import type {
+  CursorPaginatedCollectionProp,
+  CursorPaginationParams,
+  ExoMetadataProps,
+  Link,
+} from '../common-types'
+import type {
+  ComponentTypeViewport,
+  DimensionedDesignPropertyValue,
+  FragmentNode,
+} from './component-type'
+import type {
+  ExperienceContentBindings,
+  ExperienceDimensionKeyMap,
+  InlineFragmentNode,
+} from './experience'
+
+export type FragmentSys = {
+  id: string
+  type: 'Fragment'
+  version: number
+  space: Link<'Space'>
+  environment: Link<'Environment'>
+  componentType: Link<'ComponentType'>
+  archivedAt?: string
+  archivedBy?: Link<'User'>
+  archivedVersion?: number
+  createdAt: string
+  updatedAt: string
+  createdBy: Link<'User'>
+  updatedBy: Link<'User'>
+  variant?: string
+  variantType?: string
+  variantDimension?: string
+  publishedAt?: string
+  publishedVersion?: number
+  publishedCounter?: number
+  firstPublishedAt?: string
+  publishedBy?: Link<'User'> | Link<'AppDefinition'>
+  localeStatus?: Record<string, 'draft' | 'published' | 'changed'>
+}
+
+export type FragmentProps = {
+  sys: FragmentSys
+  name: string
+  description: string
+  viewports: ComponentTypeViewport[]
+  designProperties: Record<string, DimensionedDesignPropertyValue>
+  dimensionKeyMap: ExperienceDimensionKeyMap
+  contentBindings?: ExperienceContentBindings
+  metadata?: ExoMetadataProps
+  slots?: Record<string, Array<FragmentNode | InlineFragmentNode>>
+}
+
+export type CreateFragmentProps = Except<FragmentProps, 'sys'> & {
+  componentTypeId: string
+}
+
+export type UpdateFragmentProps = Omit<FragmentProps, 'sys'> & {
+  sys: {
+    id: string
+    type: 'Fragment'
+    version: number
+  }
+  componentTypeId: string
+}
+
+export type FragmentQueryOptions = CursorPaginationParams & {
+  order?: string
+  [key: string]: unknown
+}
+
+export type FragmentCollection = CursorPaginatedCollectionProp<FragmentProps>