@atlaskit/visually-hidden 3.0.5 → 4.0.0

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @atlaskit/visually-hidden
 
+## 4.0.0
+
+### Major Changes
+
+- [`f2dc9097319f0`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/f2dc9097319f0) - ###
+  Dropped support for _legacy_ Typescript 4 types. **Typescript 5 is now the new minimum**.
+
+  Removes the `typesVersions` property and `dist/types-ts4.5` directory from the dist.
+
+  Types are now exclusively via the `"types": "dist/types/index.d.ts"` property.
+
+  ```diff
+  - "typesVersions": {
+  -    ">=4.5 <4.9": {
+  -        "*": [
+  -            "dist/types-ts4.5/*",
+  -            "dist/types-ts4.5/index.d.ts"
+  -        ]
+  -    }
+  - },
+  ```
+
+## 3.1.0
+
+### Minor Changes
+
+- [`aef119573f01b`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/aef119573f01b) -
+  Autofix: add explicit package exports (barrel removal)
+
 ## 3.0.5
 
 ### Patch Changes

package/dist/cjs/entry-points/types.js

@@ -0,0 +1 @@
+"use strict";

package/dist/cjs/entry-points/visually-hidden.js

@@ -0,0 +1,13 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function get() {
+    return _visuallyHidden.default;
+  }
+});
+var _visuallyHidden = _interopRequireDefault(require("../visually-hidden"));

package/dist/es2019/entry-points/visually-hidden.js

@@ -0,0 +1 @@
+export { default } from '../visually-hidden';

package/dist/esm/entry-points/visually-hidden.js

@@ -0,0 +1 @@
+export { default } from '../visually-hidden';

package/dist/types/entry-points/types.d.ts

@@ -0,0 +1 @@
+export type { VisuallyHiddenProps } from '../types';

package/dist/types/entry-points/visually-hidden.d.ts

@@ -0,0 +1 @@
+export { default } from '../visually-hidden';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/visually-hidden",
-	"version": "3.0.5",
+	"version": "4.0.0",
 	"description": "A utility that hides content from the screen while retaining readability by screen readers for accessibility.",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -41,16 +41,17 @@
 		"@af/accessibility-testing": "workspace:^",
 		"@af/integration-testing": "workspace:^",
 		"@af/visual-regression": "workspace:^",
-		"@atlaskit/button": "^23.10.0",
-		"@atlaskit/docs": "^11.7.0",
-		"@atlaskit/link": "^3.3.0",
-		"@atlaskit/section-message": "^8.12.0",
-		"@atlaskit/toggle": "^15.2.0",
-		"@atlaskit/tokens": "^11.4.0",
+		"@atlaskit/button": "^24.0.0",
+		"@atlaskit/docs": "^12.0.0",
+		"@atlaskit/link": "^4.0.0",
+		"@atlaskit/section-message": "^9.0.0",
+		"@atlaskit/toggle": "^17.0.0",
+		"@atlaskit/tokens": "^14.0.0",
 		"@atlassian/react-compiler-gating": "workspace:^",
 		"@atlassian/ssr-tests": "workspace:^",
 		"@atlassian/structured-docs-types": "workspace:^",
 		"@testing-library/react": "^16.3.0",
+		"react": "^18.2.0",
 		"react-dom": "^18.2.0"
 	},
 	"techstack": {
@@ -74,13 +75,5 @@
 			"deprecation": "no-deprecated-imports"
 		}
 	},
-	"typesVersions": {
-		">=4.5 <4.9": {
-			"*": [
-				"dist/types-ts4.5/*",
-				"dist/types-ts4.5/index.d.ts"
-			]
-		}
-	},
 	"homepage": "https://atlassian.design/components/visually-hidden/"
 }

package/types/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@atlaskit/visually-hidden/types",
+  "main": "../dist/cjs/entry-points/types.js",
+  "module": "../dist/esm/entry-points/types.js",
+  "module:es2019": "../dist/es2019/entry-points/types.js",
+  "sideEffects": [
+    "**/*.compiled.css"
+  ],
+  "types": "../dist/types/entry-points/types.d.ts"
+}

package/visually-hidden/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@atlaskit/visually-hidden/visually-hidden",
+  "main": "../dist/cjs/entry-points/visually-hidden.js",
+  "module": "../dist/esm/entry-points/visually-hidden.js",
+  "module:es2019": "../dist/es2019/entry-points/visually-hidden.js",
+  "sideEffects": [
+    "**/*.compiled.css"
+  ],
+  "types": "../dist/types/entry-points/visually-hidden.d.ts"
+}

package/visually-hidden.docs.tsx

@@ -1,46 +1,48 @@
 import path from 'path';
 
-import type { ComponentStructuredContentSource } from '@atlassian/structured-docs-types';
+import type { StructuredContentSource } from '@atlassian/structured-docs-types/types';
 
-const documentation: ComponentStructuredContentSource[] = [
-	{
-		name: 'VisuallyHidden',
-		description:
-			'Content hidden from sight but available to screen readers. Use when meaning is clear visually but not to assistive technology.',
-		status: 'general-availability',
-		import: {
+const documentation: StructuredContentSource = {
+	components: [
+		{
 			name: 'VisuallyHidden',
-			package: '@atlaskit/visually-hidden',
-			type: 'default',
-			packagePath: path.resolve(__dirname),
-			packageJson: require('./package.json'),
-		},
-		usageGuidelines: [
-			'Use when meaning is clear visually but not to assistive technology',
-			'Avoid clutter—verbose screen-reader-only text can be more harmful than helpful',
-			'Use the role prop for semantic meaning when needed',
-		],
-		contentGuidelines: [
-			'Use clear, descriptive hidden content',
-			'Ensure content adds value for screen readers',
-			'Keep content concise but meaningful',
-		],
-		accessibilityGuidelines: [
-			'Use for screen reader only content when visual context is insufficient for AT',
-			'Use role prop for semantic meaning when appropriate',
-			'Balance clarity with brevity—avoid overwhelming screen reader users',
-			'Prefer over aria-label in some cases when screen readers need to translate or announce full phrasing',
-		],
-		examples: [
-			{
-				name: '00 Basic',
-				description: '00 Basic example',
-				source: path.resolve(__dirname, './examples/00-basic.tsx'),
+			description:
+				'Content hidden from sight but available to screen readers. Use when meaning is clear visually but not to assistive technology.',
+			status: 'general-availability',
+			import: {
+				name: 'VisuallyHidden',
+				package: '@atlaskit/visually-hidden',
+				type: 'default',
+				packagePath: path.resolve(__dirname),
+				packageJson: require('./package.json'),
 			},
-		],
-		keywords: ['hidden', 'accessibility', 'screen-reader', 'aria', 'utility'],
-		categories: ['utility'],
-	},
-];
+			usageGuidelines: [
+				'Use when meaning is clear visually but not to assistive technology',
+				'Avoid clutter—verbose screen-reader-only text can be more harmful than helpful',
+				'Use the role prop for semantic meaning when needed',
+			],
+			contentGuidelines: [
+				'Use clear, descriptive hidden content',
+				'Ensure content adds value for screen readers',
+				'Keep content concise but meaningful',
+			],
+			accessibilityGuidelines: [
+				'Use for screen reader only content when visual context is insufficient for AT',
+				'Use role prop for semantic meaning when appropriate',
+				'Balance clarity with brevity—avoid overwhelming screen reader users',
+				'Prefer over aria-label in some cases when screen readers need to translate or announce full phrasing',
+			],
+			examples: [
+				{
+					name: '00 Basic',
+					description: '00 Basic example',
+					source: path.resolve(__dirname, './examples/00-basic.tsx'),
+				},
+			],
+			keywords: ['hidden', 'accessibility', 'screen-reader', 'aria', 'utility'],
+			categories: ['utility'],
+		},
+	],
+};
 
 export default documentation;

package/dist/types-ts4.5/index.d.ts

@@ -1,2 +0,0 @@
-export { default } from './visually-hidden';
-export type { VisuallyHiddenProps } from './types';

package/dist/types-ts4.5/types.d.ts

@@ -1,22 +0,0 @@
-import { type ReactNode } from 'react';
-export type VisuallyHiddenProps = {
-    /**
-     * The element or elements that should be hidden.
-     */
-    children: ReactNode;
-    /**
-     * An ARIA role attribute to aid screen readers.
-     */
-    role?: string;
-    /**
-     * An id may be appropriate for this component if used in conjunction with `aria-describedby`
-     * on a paired element.
-     */
-    id?: string;
-    /**
-     * A `testId` prop is provided for specified elements, which is a unique
-     * string that appears as a data attribute `data-testid` in the rendered code,
-     * serving as a hook for automated tests.
-     */
-    testId?: string;
-};

package/dist/types-ts4.5/visually-hidden.d.ts

@@ -1,26 +0,0 @@
-/**
- * @jsxRuntime classic
- * @jsx jsx
- */
-import { type FC } from 'react';
-import type { VisuallyHiddenProps } from './types';
-/**
- * __Visually hidden__
- *
- * A composable element to apply a visually hidden effect to children.
- * Useful for accessibility compliance.
- *
- * @example
- * ```jsx
- * import VisuallyHidden from '@atlaskit/visually-hidden';
- *
- * export default () => (
- *   <div style={{ border: '1px solid black' }}>
- *      There is text hidden between the brackets [
- *      <VisuallyHidden>Can't see me!</VisuallyHidden>]
- *   </div>
- * );
- * ```
- */
-declare const VisuallyHidden: FC<VisuallyHiddenProps>;
-export default VisuallyHidden;

package/offerings.json

@@ -1,34 +0,0 @@
-[
-	{
-		"name": "VisuallyHidden",
-		"package": "@atlaskit/visually-hidden",
-		"import": {
-			"name": "VisuallyHidden",
-			"package": "@atlaskit/visually-hidden",
-			"type": "default"
-		},
-		"keywords": ["hidden", "accessibility", "screen-reader", "aria", "utility"],
-		"categories": ["utility"],
-		"shortDescription": "A utility component for accessibility.",
-		"status": "general-availability",
-		"accessibilityGuidelines": [
-			"Use for screen reader only content",
-			"Ensure content is meaningful for assistive technology",
-			"Use appropriate ARIA roles when needed",
-			"Consider content context and purpose"
-		],
-		"usageGuidelines": [
-			"Use for screen reader only content",
-			"Provide meaningful hidden content",
-			"Use for accessibility enhancements",
-			"Consider content context and purpose"
-		],
-		"contentGuidelines": [
-			"Use clear, descriptive hidden content",
-			"Ensure content adds value for screen readers",
-			"Use appropriate language and tone",
-			"Keep content concise but meaningful"
-		],
-		"examples": ["./examples/00-basic.tsx"]
-	}
-]