Merge branch 'main' into main

ksen0 · web-flow · commit 4a970b7c396a · 2025-03-17T14:28:54.000+01:00
diff --git a/src/components/AnnotatedCode/index.astro b/src/components/AnnotatedCode/index.astro
@@ -95,7 +95,7 @@ for (const attr of codeTag.attributes) {
         return (
           <tr class="[&>*]:align-top [&>*]:m-0 [&>*:not(:first-child)]:py-2 [&>*:not(:first-child)]:pl-6 [&>*:not(:first-child)]:max-w-xl">
             <td class="align-top p-0" style="height:100%; margin:0">
-            <pre {...preAttrs} style={`${getPreStyle(i)};height:100%`}><code {...codeAttrs} set:html={lineNodes.map((n) => n.outerHTML).join('\n')} /></pre>
+            <pre {...preAttrs} style={`${getPreStyle(i)};overflow:visible;white-space:pre-wrap;word-wrap:break-word;height:100%;`}><code {...codeAttrs} set:html={lineNodes.map((n) => n.outerHTML).join('\n')} /></pre>
             </td>
             {props.columns ? (
               <Fragment set:html={row.slot ? Astro.slots.render(row.slot) : undefined} />
diff --git a/src/components/ReferenceDirectoryWithFilter/index.tsx b/src/components/ReferenceDirectoryWithFilter/index.tsx
@@ -3,6 +3,7 @@ import { useMemo, useRef, useState } from "preact/hooks";
 import { type JSX } from "preact";
 import { Icon } from "../Icon";
 import flask from "@src/content/ui/images/icons/flask.svg?raw"; 
+import warning from "@src/content/ui/images/icons/warning.svg?raw"; 
 
 type ReferenceDirectoryEntry = ReferenceDocContentItem & {
   data: {
@@ -43,6 +44,10 @@ const getOneLineDescription = (description: string): string => {
   let [oneLineDescription] = description.replace(/\n/g, " ").trim()
     .match(firstParagraphRegex) ?? [];
 
+  if (!oneLineDescription && description) {
+    oneLineDescription = description;
+  }
+
   if(oneLineDescription){
     oneLineDescription = oneLineDescription
       .replace(/^<p>|<\/p>$/g, "")
@@ -108,6 +113,12 @@ export const ReferenceDirectoryWithFilter = ({
                     dangerouslySetInnerHTML={{ __html: flask }}
                   />
                 )}
+                {entry.data.deprecated && (
+                  <div
+                    className="inline-block mr-2 w-[16px] h-[16px] mb-[-2px]"
+                    dangerouslySetInnerHTML={{ __html: warning }}
+                  />
+                )}
                 <span dangerouslySetInnerHTML={{ __html: entry.data.title }} />
               </span>
               <p
diff --git a/src/content/people/en/animesh-sinha.yaml b/src/content/people/en/animesh-sinha.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Animesh Sinha
+url: http://www.facebook.com/AnimeshSinha1309
diff --git a/src/content/people/en/ashish-karn.yaml b/src/content/people/en/ashish-karn.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Ashish Karn
+url: https://karn-ashish-16.onrender.com/
diff --git a/src/content/people/en/bojidar-marinov.yaml b/src/content/people/en/bojidar-marinov.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Bojidar Marinov
+url: https://bojidar-bg.dev/
diff --git a/src/content/people/en/casey-conchinha.yaml b/src/content/people/en/casey-conchinha.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Casey Conchinha
+url: http://kccon.ch
diff --git a/src/content/people/en/crh82.yaml b/src/content/people/en/crh82.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: crh82
+url: https://github.com/crh82
diff --git a/src/content/people/en/darren-kessner.yaml b/src/content/people/en/darren-kessner.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Darren Kessner
+url: https://dkessner.github.io/
diff --git a/src/content/people/en/davidblitz.yaml b/src/content/people/en/davidblitz.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: davidblitz
+url: https://github.com/davidblitz
diff --git a/src/content/people/en/gabriel-sroka.yaml b/src/content/people/en/gabriel-sroka.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Gabriel Sroka
+url: https://gabrielsroka.github.io
diff --git a/src/content/people/en/greg-albers.yaml b/src/content/people/en/greg-albers.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Greg Albers
+url: https://geealbers.net/
diff --git a/src/content/people/en/greg-stanton.yaml b/src/content/people/en/greg-stanton.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Greg Stanton
+url: https://www.youtube.com/c/HigherMathNotes
diff --git a/src/content/people/en/kathryn-lichlyter.yaml b/src/content/people/en/kathryn-lichlyter.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Kathryn Lichlyter
+url: https://github.com/katlich112358
diff --git a/src/content/people/en/keshav-gupta.yaml b/src/content/people/en/keshav-gupta.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Keshav Gupta
+url: https://keshav-portfolio-resume.netlify.app/
diff --git a/src/content/people/en/kristian-hamilton.yaml b/src/content/people/en/kristian-hamilton.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Kristian Hamilton
+url: http://www.khamilton.co.uk
diff --git a/src/content/people/en/marco-macarena.yaml b/src/content/people/en/marco-macarena.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Marco Macarena
+url: http://macarena.pro.br
diff --git a/src/content/people/en/mayank-verma.yaml b/src/content/people/en/mayank-verma.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Mayank Verma
+url: https://github.com/webermayank
diff --git a/src/content/people/en/ritesh-patil.yaml b/src/content/people/en/ritesh-patil.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Ritesh Patil
+url: http://riteshpatil.com
diff --git a/src/content/people/en/seyko.yaml b/src/content/people/en/seyko.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Seyko
+url: https://github.com/seyko1
diff --git a/src/content/people/en/vaivaswat-dubey.yaml b/src/content/people/en/vaivaswat-dubey.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Vaivaswat Dubey
+url: https://github.com/Vaivaswat2244
diff --git a/src/content/people/en/xevi-h.-aqeel.yaml b/src/content/people/en/xevi-h.-aqeel.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Xevi H. Aqeel
+url: http://kinardist.media
diff --git a/src/content/people/en/xin-xin.yaml b/src/content/people/en/xin-xin.yaml
@@ -0,0 +1,3 @@
+category: contributor
+name: Xin Xin
+url: https://github.com/xinemata
diff --git a/src/content/reference/config.ts b/src/content/reference/config.ts
@@ -64,6 +64,7 @@ export const referenceSchema = z.object({
   submodule: z.string().optional(),
   file: z.string(),
   description: z.string().optional(),
+  deprecated: z.string().optional(),
   line: z.number().or(z.string().transform((v) => parseInt(v, 10))),
   params: z.array(paramSchema).optional(),
   overloads: z.array(z.object({ params: z.array(paramSchema) })).optional(),
diff --git a/src/content/text-detail/hi/code-of-conduct.mdx b/src/content/text-detail/hi/code-of-conduct.mdx
@@ -0,0 +1,23 @@
+---
+title: "आचार संहिता"
+---
+
+- **अपनी भाषा का ध्यान रखें.** निम्नलिखित में से कोई भी व्यवहार अस्वीकार्य है:
+
+  - लिंग, पहचान, यौन पसंद, रंग, जाति, भाषा, सोचने का तरीका, शरीर का आकार, क्षमता, वर्ग, धर्म, संस्कृति, समूह, राजनीति, उम्र, हुनर, काम या पृष्ठभूमि के बारे में बुरे कमेंट न करें।
+  - हिंसा की धमकी न दें।
+  - किसी को जानबूझकर न डराएं।
+  - बिना मतलब के या बिना चेतावनी के यौन या हिंसा वाली चीज़ें न दिखाएं।
+  - किसी पर बिना चाहे यौन ध्यान न दें।
+  - किसी का पीछा न करें।
+  - या किसी भी तरह से परेशान न करें।
+
+  सोच-समझकर काम करें। अगर कुछ ऐसा है जिससे दूसरे शायद परेशान हों, तो उसे न डालें।
+
+- **सम्मान करें।** जब राय अलग हो, तो दूसरों के विचारों पर गुस्सा न करें। याद रखें, हर बात को शांति और ध्यान से समझें।
+- **ध्यान रखें।** सोचें कि आपकी बात से समुदाय के लोगों पर क्या असर होगा।
+- **खुले विचारों वाले बनें। ** नए लोगों और नए विचारों का स्वागत करें। हमारा ग्रुप हमेशा बदल रहा है, और हम अच्छे बदलावों का स्वागत करते हैं।
+
+अगर आपको लगे कि कोई नियम तोड़ रहा है, तो [hello@p5js.org](mailto:hello@p5js.org) पर ईमेल करके बताएं। अपना नाम और घटना के बारे में लिखें, हम जल्दी ही आपसे संपर्क करेंगे।
+
+कभी-कभी, नियम तोड़ने वालों को पता नहीं होता कि उनकी हरकत गलत है, और बात करने से मामला ठीक हो जाता है। लेकिन, अगर कोई बार-बार ऐसा करे, तो p5.js टीम जो ठीक लगे वो कर सकती है, जैसे कि उसे p5.js से हटाना और दूसरों को बताना कि वो परेशान करने वाला है।
diff --git a/src/content/text-detail/hi/contact.mdx b/src/content/text-detail/hi/contact.mdx
@@ -0,0 +1,5 @@
+---
+title: "संपर्क करें"
+---
+
+आप हमसे [hello@p5js.org](mailto:hello@p5js.org) पर संपर्क कर सकते हैं।
diff --git a/src/content/ui/en.yaml b/src/content/ui/en.yaml
@@ -186,6 +186,7 @@ calloutTitles:
   "Try this!": "Try this!"
   Tip: Tip
   Note: Note
+  Warning: Warning
 LibrariesLayout:
   View All: View All
   Featured: Featured
diff --git a/src/content/ui/images/icons/warning.svg b/src/content/ui/images/icons/warning.svg
@@ -0,0 +1,5 @@
+<svg width="100%" height="100%" viewBox="0 0 30 30" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M15 3L2 27H28L15 3Z" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>
+<path d="M15 10V19" stroke="currentColor" stroke-width="2" stroke-linejoin="round"/>
+<circle cx="15" cy="22.3361" r="1" stroke-width="2" stroke="currentColor"/>
+</svg>
diff --git a/src/layouts/ReferenceItemLayout.astro b/src/layouts/ReferenceItemLayout.astro
@@ -20,6 +20,7 @@ import type {
 import { setJumpToState } from "../globals/state";
 import { p5Version } from "../globals/p5-version";
 import flask from "@src/content/ui/images/icons/flask.svg?raw"; 
+import warning from "@src/content/ui/images/icons/warning.svg?raw"; 
 
 const { entry, relatedEntries } = Astro.props;
 const currentLocale = getCurrentLocale(Astro.url.pathname);
@@ -106,6 +107,18 @@ const descriptionParts = description.split(
           <p>{t('experimentalApi', 'description')}</p>
         </div>
       )}
+      {entry.data.deprecated && (
+        <div class="deprecated">
+          <h5>
+            <div
+              class="inline-block mr-2 w-[20px] h-[20px] mb-[-2px]"
+              set:html={warning}
+            />
+            {t('calloutTitles', 'Warning')}
+          </h5>
+          <p set:html={entry.data.deprecated} />
+        </div>
+      )}
       {descriptionParts.map((part) => {
         if (part.startsWith('<pre')) {
           const exampleCode = part
diff --git a/src/scripts/builders/reference.ts b/src/scripts/builders/reference.ts
@@ -255,6 +255,7 @@ const convertToMDX = async (
     file: doc.file.replace(/.*p5\.js\/(.*)/, "$1"),
     description: doc.description ?? "",
     line: doc.line,
+    deprecated: doc.deprecated,
   } as Record<string, unknown>;
 
   // Add specific frontmatter based on the type of doc
diff --git a/src/scripts/parsers/reference.ts b/src/scripts/parsers/reference.ts
@@ -128,8 +128,7 @@ export const saveYuidocOutput = async (
     const inPath = path.join(__dirname, "in", inDirName);
     console.log(inPath)
     await new Promise((resolve, reject) => {
-      exec(`yuidoc -p --outdir ${outputFilePath} ${flags} ${inputPath}`, { cwd: inPath }, (error, stdout) => {
-        if (error) {
+exec(`yuidoc -p --outdir "${outputFilePath.replace(/"/g, '\\"')}" ${flags} ${inputPath}`, { cwd: inPath }, (error, stdout) => {        if (error) {
           console.error(`Error running YUIDoc command: ${error}`);
           reject(error);
         } else {
diff --git a/styles/global.scss b/styles/global.scss
@@ -291,7 +291,7 @@ pre.code-box,
   white-space: break-spaces;
 }
 
-.callout, .experimental {
+.callout, .experimental, .deprecated {
   padding: var(--spacing-sm);
   border-radius: 20px;
   background-color: var(--bg-magenta-20);
@@ -308,7 +308,7 @@ pre.code-box,
   }
 }
 
-.experimental {
+.experimental, .deprecated {
   background-color: var(--bg-yellow);
 }
 
diff --git a/types/parsers.interface.ts b/types/parsers.interface.ts
@@ -49,7 +49,7 @@ export type ReferenceOverload = {
 export type ReferenceOverloads = ReferenceOverload[];
 
 /* Represents the definition of a class within the project, including its properties, methods, and inheritance information. */
-export interface ReferenceClassDefinition extends Chainable {
+export interface ReferenceClassDefinition extends Chainable, Deprecatable, MaybeBeta {
   name: string; // The name of the class.
   shortname: string; // A shorter or abbreviated name for the class.
   classitems: ReferenceParam[]; // Parameters or properties of the class.
@@ -92,6 +92,10 @@ interface Chainable {
   chainable: number;
 }
 
+interface Deprecatable {
+  deprecated?: string; // If this item is deprecated, a description of why.
+}
+
 /* Represents the return value of a method or constructor */
 interface Return {
   description: string;
@@ -103,7 +107,7 @@ interface MaybeBeta {
 }
 
 /* Represents a method within a class */
-export interface ReferenceClassItemMethod extends BaseClassItem, Chainable, MaybeBeta {
+export interface ReferenceClassItemMethod extends BaseClassItem, Chainable, MaybeBeta, Deprecatable {
   params?: ReferenceParam[];
   return?: Return;
   example?: string[];
@@ -119,7 +123,7 @@ interface MethodOverload {
 }
 
 /* Represents a property within a class */
-export interface ReferenceClassItemProperty extends BaseClassItem {
+export interface ReferenceClassItemProperty extends BaseClassItem, Deprecatable {
   type: string;
 }
 

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: Animesh Sinha`
	`3`	`+url: http://www.facebook.com/AnimeshSinha1309`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: Ashish Karn`
	`3`	`+url: https://karn-ashish-16.onrender.com/`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: Bojidar Marinov`
	`3`	`+url: https://bojidar-bg.dev/`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: Casey Conchinha`
	`3`	`+url: http://kccon.ch`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: crh82`
	`3`	`+url: https://github.com/crh82`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: Darren Kessner`
	`3`	`+url: https://dkessner.github.io/`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: davidblitz`
	`3`	`+url: https://github.com/davidblitz`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+category: contributor`
	`2`	`+name: Gabriel Sroka`
	`3`	`+url: https://gabrielsroka.github.io`