2 definitions in this file:

 The name or identifier of the base design system being extended (e.g., 'Acme Core Design System', 'acme-core', '@acme/design-system'). This is a human-readable or package-level identifier — not a URL. Used by tooling to resolve the base system from a registry, file system, or package manager. URL to the base DSDS document (e.g., 'https://design.acme.com/v2/core.dsds.json', './core.dsds.json'). When provided, tooling MAY fetch and resolve the base document for merge, validation, or documentation generation. The version of the base system this document extends (e.g., '2.0.0', '>=2.0.0', '^3.1.0'). Follows semver conventions. When omitted, tooling SHOULD resolve to the latest available version. Description of the relationship — what this extension adds, changes, or specializes relative to the base system. References: richText The name of the base entity being extended (e.g., 'button', 'color-text-primary', 'form-validation'). MUST match the `name` property of the base entity in the parent system. The name or identifier of the system that owns the base entity (e.g., 'Acme Core Design System', 'acme-core'). When omitted, the base entity is resolved from the system declared in the root document's `extends` property. When provided, allows extending from a system other than the document's default base. Direct URL to the base entity's docs or DSDS definition. Useful for cross-linking in docs sites. The version of the base entity or base system this entity extends (e.g., '2.0.0'). When omitted, inherits the version from the document-level extends declaration. Description of what this entity adds or changes relative to the base — new variants, more props, overridden guidelines, etc. Summary of what this entity changes relative to the base. Each entry describes a specific change. Tooling MAY use these for changelog generation, diff views, or migration guides. When omitted, consuming tools must diff the entities to find changes. References: richText

Design System Documentation Standard (DSDS) 0.1 — Draft Specification

GitHub