@markuplint/ml-spec 1.7.0 → 2.0.0-dev.20211213.0

package/src/get-attr-specs.spec.ts

@@ -0,0 +1,44 @@
+import htmlSpec from '@markuplint/html-spec';
+
+import { getAttrSpecs } from './get-attr-specs';
+
+describe('getSpec', () => {
+	test('svg:image[x]', () => {
+		const specs = getAttrSpecs('svg:image', htmlSpec);
+		const x = specs?.find(spec => spec.name === 'x');
+		expect(x).toStrictEqual({
+			ref: 'https://svgwg.org/svg2-draft/geometry.html#XProperty',
+			defaultValue: '0',
+			name: 'x',
+			type: ['<svg-length>', '<percentage>'],
+			animatable: true,
+		});
+	});
+
+	test('svg:foreignObject[x]', () => {
+		const specs = getAttrSpecs('svg:foreignObject', htmlSpec);
+		const x = specs?.find(spec => spec.name === 'x');
+		expect(x).toStrictEqual({
+			ref: 'https://svgwg.org/svg2-draft/geometry.html#XProperty',
+			defaultValue: '0',
+			description:
+				'The x coordinate of the foreignObject. Value type: <length>|<percentage> ; Default value: 0; Animatable: yes',
+			name: 'x',
+			type: ['<svg-length>', '<percentage>'],
+			animatable: true,
+		});
+	});
+
+	test('svg:linearGradient[xlink:href]', () => {
+		const specs = getAttrSpecs('svg:linearGradient', htmlSpec);
+		const x = specs?.find(spec => spec.name === 'xlink:href');
+		expect(x).toStrictEqual({
+			ref: 'https://www.w3.org/TR/xlink11/#link-locators',
+			description:
+				'Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.An <IRI> reference to another <linearGradient> element that will be used as a template. Value type: <IRI> ; Default value: none; Animatable: yes',
+			name: 'xlink:href',
+			type: 'URL',
+			deprecated: true,
+		});
+	});
+});

package/src/get-attr-specs.ts

@@ -0,0 +1,97 @@
+import type { MLMLSpec, Attribute } from './types';
+
+import path from 'path';
+
+export function getAttrSpecs(nameWithNS: string, { specs, def }: MLMLSpec) {
+	const elSpec = specs.find(spec => spec.name === nameWithNS);
+
+	if (!elSpec) {
+		return null;
+	}
+	const globalAttrs = def['#globalAttrs'];
+	let attrs: Record<string, Partial<Attribute>> = {};
+
+	for (const catName in elSpec.globalAttrs) {
+		// @ts-ignore
+		const catAttrs: boolean | string[] = elSpec.globalAttrs[catName];
+		if (!catAttrs) {
+			continue;
+		}
+		if (typeof catAttrs === 'boolean') {
+			const global = globalAttrs[catName];
+			attrs = {
+				...attrs,
+				...global,
+			};
+			continue;
+		}
+		if (Array.isArray(catAttrs)) {
+			const global = globalAttrs[catName];
+			if (!global) {
+				continue;
+			}
+			catAttrs.forEach(selectedName => {
+				const selected = global[selectedName];
+				attrs[selectedName] = {
+					...attrs[selectedName],
+					...selected,
+				};
+			});
+			continue;
+		}
+	}
+
+	for (const attrName in elSpec.attributes) {
+		const attr = elSpec.attributes[attrName];
+		if (!attr) {
+			continue;
+		}
+
+		const current = attrs[attrName] as Omit<Attribute, 'name'> | undefined;
+
+		attrs[attrName] = {
+			description: '',
+			...current,
+			...attr,
+		};
+	}
+
+	const attrList: Attribute[] = Object.keys(attrs).map<Attribute>(name => {
+		const attr = attrs[name];
+		return { name, type: 'Any', ...attr };
+	});
+
+	for (const attr of attrList) {
+		if (!attr.type) {
+			throw new Error(
+				`The type is empty in the ${attr.name} attribute of the ${nameWithNS} element (${path.resolve(
+					process.cwd(),
+					'packages',
+					'@markuplint',
+					'html-spec',
+					'src',
+					'attributes',
+					nameWithNS.replace(':', '_') + '.json',
+				)})`,
+			);
+		}
+	}
+
+	attrList.sort(nameCompare);
+
+	return attrList;
+}
+
+type HasName = { name: string };
+
+export function nameCompare(a: HasName | string, b: HasName | string) {
+	const nameA = typeof a === 'string' ? a : a.name.toUpperCase();
+	const nameB = typeof b === 'string' ? b : b.name.toUpperCase();
+	if (nameA < nameB) {
+		return -1;
+	}
+	if (nameA > nameB) {
+		return 1;
+	}
+	return 0;
+}

package/src/get-ns.ts

@@ -0,0 +1,13 @@
+export function getNS(namespaceURI: string) {
+	switch (namespaceURI) {
+		case 'http://www.w3.org/2000/svg': {
+			return 'svg';
+		}
+		case 'http://www.w3.org/1998/Math/MathML': {
+			return 'mml';
+		}
+		default: {
+			return 'html';
+		}
+	}
+}

package/src/get-spec-by-tag-name.ts

@@ -1,8 +1,11 @@
-import { Attribute, MLDOMElementSpec, MLMLSpec, SpecOM } from './types';
+import type { MLDOMElementSpec, MLMLSpec, SpecOM } from './types';
 
-function getSpecOM({ specs }: MLMLSpec): SpecOM {
+import { getAttrSpecs } from './get-attr-specs';
+
+function getSpecOM(spec: MLMLSpec): SpecOM {
 	const som: SpecOM = {};
-	for (const el of specs) {
+	for (const el of spec.specs) {
+		const attributes = getAttrSpecs(el.name, spec);
 		som[el.name] = {
 			experimental: !!el.experimental,
 			obsolete: typeof el.obsolete === 'boolean' ? !!el.obsolete : el.obsolete ? el.obsolete.alt : false,
@@ -10,16 +13,13 @@ function getSpecOM({ specs }: MLMLSpec): SpecOM {
 			nonStandard: !!el.nonStandard,
 			categories: el.categories,
 			permittedStructures: el.permittedStructures,
-			attributes: el.attributes.filter(
-				(attr: Attribute | string): attr is Attribute => !(typeof attr === 'string'),
-			),
+			attributes: Object.values(attributes || {}),
 		};
 	}
 	return som;
 }
 
-export function getSpecByTagName(tagName: string, specs: MLMLSpec): MLDOMElementSpec | null {
+export function getSpecByTagName(nameWithNS: string, specs: MLMLSpec): MLDOMElementSpec | null {
 	const specOM = getSpecOM(specs);
-	tagName = tagName.toLowerCase();
-	return specOM[tagName] || null;
+	return specOM[nameWithNS] || null;
 }

package/src/get-spec.spec.ts

@@ -1,25 +1,26 @@
-import htmlSpec, { Attribute } from '@markuplint/html-spec';
+import htmlSpec from '@markuplint/html-spec';
+
 import { getSpec } from './get-spec';
 
 describe('getSpec', () => {
-	test('', () => {
-		const exAttr: Attribute = {
-			name: 'extended-attr',
+	test('Overriding', () => {
+		const exAttr = {
+			ref: 'N/A',
 			type: 'Boolean',
 			description: 'For the unit test.',
-		};
-		const exAttr2: Attribute = {
-			name: 'extended-attr',
+		} as const;
+		const exAttr2 = {
+			ref: 'N/A',
 			type: 'Boolean',
 			description: 'For the unit test. Override.',
-		};
+		} as const;
 		const mergedSpec = getSpec([
 			htmlSpec,
 			{
 				specs: [
 					{
 						name: 'a',
-						attributes: [exAttr],
+						attributes: { 'extended-attr': exAttr },
 					},
 				],
 			},
@@ -27,17 +28,12 @@ describe('getSpec', () => {
 				specs: [
 					{
 						name: 'a',
-						attributes: [exAttr2],
+						attributes: { 'extended-attr': exAttr2 },
 					},
 				],
 			},
 		]);
 		const aElAttrs = mergedSpec.specs.find(el => el.name === 'a')!.attributes;
-		expect(
-			aElAttrs.find((attr): attr is Attribute => !(typeof attr === 'string') && attr.name === 'href')!.name,
-		).toBe('href');
-		expect(
-			aElAttrs.find((attr): attr is Attribute => !(typeof attr === 'string') && attr.name === exAttr.name),
-		).toStrictEqual(exAttr2);
+		expect(aElAttrs['extended-attr']).toStrictEqual(exAttr2);
 	});
 });

package/src/get-spec.ts

@@ -1,4 +1,5 @@
-import { ElementSpec, ExtendedSpec, MLMLSpec } from '@markuplint/ml-spec';
+import type { ElementSpec, ExtendedSpec, MLMLSpec, Attribute } from './types';
+
 import { mergeArray } from './utils';
 
 /**
@@ -19,8 +20,11 @@ export function getSpec(schemas: readonly [MLMLSpec, ...ExtendedSpec[]]) {
 			if (extendedSpec.def['#ariaAttrs']) {
 				result.def['#ariaAttrs'] = [...result.def['#ariaAttrs'], ...extendedSpec.def['#ariaAttrs']];
 			}
-			if (extendedSpec.def['#globalAttrs']) {
-				result.def['#globalAttrs'] = [...result.def['#globalAttrs'], ...extendedSpec.def['#globalAttrs']];
+			if (extendedSpec.def['#globalAttrs']?.['#extends']) {
+				result.def['#globalAttrs']['#HTMLGlobalAttrs'] = {
+					...(result.def['#globalAttrs']?.['#HTMLGlobalAttrs'] || {}),
+					...(extendedSpec.def['#globalAttrs']?.['#extends'] || {}),
+				};
 			}
 			if (extendedSpec.def['#roles']) {
 				result.def['#roles'] = [...result.def['#roles'], ...extendedSpec.def['#roles']];
@@ -51,7 +55,11 @@ export function getSpec(schemas: readonly [MLMLSpec, ...ExtendedSpec[]]) {
 				specs.push({
 					...elSpec,
 					...exSpec,
-					attributes: mergeArray(elSpec.attributes, exSpec.attributes),
+					globalAttrs: {
+						...elSpec.globalAttrs,
+						...exSpec.globalAttrs,
+					},
+					attributes: mergeAttrSpec(elSpec.attributes, exSpec.attributes),
 					categories: mergeArray(elSpec.categories, exSpec.categories),
 				});
 			}
@@ -62,3 +70,20 @@ export function getSpec(schemas: readonly [MLMLSpec, ...ExtendedSpec[]]) {
 
 	return result;
 }
+
+function mergeAttrSpec(
+	std: Record<string, Attribute>,
+	ex: Record<string, Partial<Attribute>> = {},
+): Record<string, Attribute> {
+	const result: Record<string, Attribute> = {};
+	const keys = Array.from(new Set([...Object.keys(std), ...Object.keys(ex)]));
+	for (const key of keys) {
+		const _std = std[key];
+		const _ex = ex[key];
+		result[key] = {
+			..._std,
+			..._ex,
+		};
+	}
+	return result;
+}

package/src/index.ts

@@ -1,4 +1,7 @@
 export * from './permitted-structres';
+export * from './attributes';
+export * from './get-attr-specs';
 export * from './get-spec-by-tag-name';
 export * from './get-spec';
+export * from './get-ns';
 export * from './types';

package/src/permitted-structres.ts

@@ -24,7 +24,27 @@ export type ContentModel =
 	| '#transparent'
 	| '#embedded'
 	| '#palpable'
-	| '#script-supporting';
+	| '#script-supporting'
+	| '#SVGAnimation'
+	| '#SVGBasicShapes'
+	| '#SVGContainer'
+	| '#SVGDescriptive'
+	| '#SVGFilterPrimitive'
+	| '#SVGFont'
+	| '#SVGGradient'
+	| '#SVGGraphics'
+	| '#SVGGraphicsReferencing'
+	| '#SVGLightSource'
+	| '#SVGNeverRendered'
+	| '#SVGNone'
+	| '#SVGPaintServer'
+	| '#SVGRenderable'
+	| '#SVGShape'
+	| '#SVGStructural'
+	| '#SVGStructurallyExternal'
+	| '#SVGTextContent'
+	| '#SVGTextContentChild'
+	| '#SVGOtherXMLNamespace';
 export type PermittedContentSpec = PermittedContent[];
 
 export interface PermittedStructuresSchema {
@@ -37,6 +57,12 @@ export interface PermittedStructuresSchema {
 			  }
 			| {
 					parent: string;
+					/**
+					 * Not support yet
+					 */
+					hasNotAttr?: string;
+					_TODO_?: string;
+					_parent?: string;
 			  };
 		contents: PermittedContentSpec | boolean;
 	}[];
@@ -49,24 +75,28 @@ export interface PermittedContentRequire {
 	notAllowedDescendants?: Node[];
 	max?: number;
 	min?: number;
+	_TODO_?: string;
 }
 export interface PermittedContentOptional {
 	optional: Target;
 	ignore?: Target;
 	notAllowedDescendants?: Node[];
 	max?: number;
+	_TODO_?: string;
 }
 export interface PermittedContentOneOrMore {
 	oneOrMore: Target | PermittedContentSpec;
 	ignore?: Target;
 	notAllowedDescendants?: Node[];
 	max?: number;
+	_TODO_?: string;
 }
 export interface PermittedContentZeroOrMore {
 	zeroOrMore: Target | PermittedContentSpec;
 	ignore?: Target;
 	notAllowedDescendants?: Node[];
 	max?: number;
+	_TODO_?: string;
 }
 export interface PermittedContentChoice {
 	choice:
@@ -80,7 +110,9 @@ export interface PermittedContentChoice {
 				PermittedContentSpec,
 				PermittedContentSpec,
 		  ];
+	_TODO_?: string;
 }
 export interface PermittedContentInterleave {
 	interleave: [PermittedContentSpec, PermittedContentSpec, ...PermittedContentSpec[]];
+	_TODO_?: string;
 }

package/src/types.ts

@@ -1,4 +1,6 @@
-import { ContentModel, PermittedStructuresSchema } from './permitted-structres';
+import type { AttributeJSON } from '.';
+import type { AttributeType, GlobalAttributes } from './attributes';
+import type { ContentModel, PermittedStructuresSchema } from './permitted-structres';
 
 /**
  * markuplit Markup-language spec
@@ -9,7 +11,10 @@ export interface MLMLSpec {
 	specs: ElementSpec[];
 }
 
-type ExtendedElementSpec = Partial<ElementSpec> & { name: ElementSpec['name'] };
+export type ExtendedElementSpec = Partial<Omit<ElementSpec, 'name' | 'attributes'>> & {
+	name: ElementSpec['name'];
+	attributes?: Record<string, Partial<Attribute>>;
+};
 
 export type ExtendedSpec = {
 	cites?: Cites;
@@ -23,9 +28,13 @@ export type ExtendedSpec = {
 export type Cites = string[];
 
 export type SpecDefs = {
-	'#globalAttrs': Attribute[];
-	'#roles': ARIRRoleAttribute[];
+	'#globalAttrs': Partial<{
+		'#extends': Record<string, Partial<Attribute>>;
+		'#HTMLGlobalAttrs': Record<string, Partial<Attribute>>;
+		[OtherGlobalAttrs: string]: Record<string, Partial<Attribute>>;
+	}>;
 	'#ariaAttrs': ARIAAttribute[];
+	'#roles': ARIRRoleAttribute[];
 	'#contentModels': { [model in ContentModel]?: string[] };
 };
 
@@ -38,6 +47,12 @@ export type ElementSpec = {
 	 */
 	name: string;
 
+	/**
+	 * Namespaces in XML
+	 * @see https://www.w3.org/TR/xml-names/
+	 */
+	namespace?: 'http://www.w3.org/1999/xhtml' | 'http://www.w3.org/2000/svg' | 'http://www.w3.org/1998/Math/MathML';
+
 	/**
 	 * Reference URL
 	 */
@@ -111,10 +126,15 @@ export type ElementSpec = {
 	 */
 	omittion: ElementSpecOmittion;
 
+	/**
+	 * Global Attributes
+	 */
+	globalAttrs: GlobalAttributes;
+
 	/**
 	 * Attributes
 	 */
-	attributes: (Attribute | string)[];
+	attributes: Record<string, Attribute>;
 };
 
 /**
@@ -141,63 +161,16 @@ type ElementCondition = {
 
 export type Attribute = {
 	name: string;
-	type: AttributeType;
-	description: string;
+	type: AttributeType | AttributeType[];
+	description?: string;
 	caseSensitive?: true;
 	experimental?: true;
 	obsolete?: true;
-	deprecated?: true;
+	deprecated?: boolean;
 	nonStandard?: true;
-	required?: true | AttributeCondition;
-	requiredEither?: string[];
-	enum?: string[];
-	noUse?: boolean;
-	condition?: AttributeCondition;
-};
-
-export type AttributeCondition = {
-	ancestor?: string;
-	self?: string | string[];
-};
+} & ExtendableAttributeSpec;
 
-// type AttributeCtegory = 'global' | 'xml' | 'aria' | 'eventhandler' | 'form' | 'particular';
-
-export type AttributeType =
-	| 'String'
-	| 'NonEmptyString'
-	| 'Boolean'
-	| 'Function' // JavaScript function body
-	| 'Date'
-	| 'Int' // Integer
-	| 'Uint' // Non-negative integer
-	| 'Float' // Floating-point number
-	| 'NonZeroUint' // Non-negative integer greater than zero
-	| 'AcceptList' // https://html.spec.whatwg.org/multipage/input.html#attr-input-accept
-	| 'AutoComplete' // https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill-detail-tokens
-	| 'BCP47' // https://tools.ietf.org/html/bcp47
-	| 'Color' // https://drafts.csswg.org/css-color/#typedef-color
-	| 'ColSpan' // https://html.spec.whatwg.org/multipage/tables.html#attr-tdth-colspan
-	| 'Coords' // https://html.spec.whatwg.org/multipage/image-maps.html#attr-area-coords
-	| 'DateTime' // https://html.spec.whatwg.org/multipage/text-level-semantics.html#datetime-value
-	| 'Destination' // https://html.spec.whatwg.org/multipage/semantics.html#attr-link-as
-	| 'DOMID'
-	| 'DOMIDList'
-	| 'ItemType' // https://html.spec.whatwg.org/multipage/microdata.html#attr-itemtype
-	| 'LinkSizes' // https://html.spec.whatwg.org/multipage/semantics.html#attr-link-sizes
-	| 'LinkType' // https://html.spec.whatwg.org/multipage/links.html#linkTypes
-	| 'LinkTypeList' // https://html.spec.whatwg.org/multipage/links.html#linkTypes
-	| 'MediaQuery' // https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#valid-media-query-list
-	| 'MediaQueryList' // https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#valid-media-query-list
-	| 'MIMEType' // https://mimesniff.spec.whatwg.org/#valid-mime-type
-	| 'ReferrerPolicy' // https://html.spec.whatwg.org/multipage/urls-and-fetching.html#referrer-policy-attributes
-	| 'RowSpan' // https://html.spec.whatwg.org/multipage/tables.html#attr-tdth-rowspan
-	| 'SourceSizeList' // https://html.spec.whatwg.org/multipage/images.html#sizes-attributes
-	| 'SrcSet' // https://html.spec.whatwg.org/multipage/images.html#srcset-attribute
-	| 'TabIndex' // https://html.spec.whatwg.org/multipage/interaction.html#attr-tabindex
-	| 'Target' // https://html.spec.whatwg.org/multipage/links.html#attr-hyperlink-target
-	| 'URL' // https://html.spec.whatwg.org/multipage/urls-and-fetching.html#valid-url-potentially-surrounded-by-spaces
-	| 'URLHash' // https://html.spec.whatwg.org/multipage/common-microsyntaxes.html#valid-hash-name-reference
-	| 'URLList'; // https://html.spec.whatwg.org/multipage/urls-and-fetching.html#valid-url-potentially-surrounded-by-spaces
+type ExtendableAttributeSpec = Omit<AttributeJSON, 'ref' | '_TODO_' | 'type'>;
 
 export type ARIRRoleAttribute = {
 	name: string;

package/tsconfig.test.json

@@ -1,8 +1,3 @@
 {
-	"extends": "../../../tsconfig.json",
-	"compilerOptions": {
-		"composite": true
-	},
-	"include": ["./src/**/*"],
-	"exclude": ["node_modules"]
+	"extends": "../../../tsconfig.json"
 }